fs: add chmod

Author: ahaoboy

API.md

@@ -114,6 +114,8 @@ Available globally
 
 [writeFileSync](https://nodejs.org/api/fs.html#fswritefilesyncfile-data-options)
 
+[chmodSync](https://nodejs.org/api/fs.html#fschmodsyncpath-mode)
+
 ## fs/promises
 
 [access](https://nodejs.org/api/fs.html#fsstatpath-options-callback)
@@ -136,6 +138,8 @@ Available globally
 
 [writeFile](https://nodejs.org/api/fs.html#fspromiseswritefilefile-data-options)
 
+[chmod](https://nodejs.org/api/fs.html#fspromiseschmodpath-mode)
+
 ## module
 
 [createRequire](https://nodejs.org/api/module.html#modulecreaterequirefilename)

modules/llrt_fs/src/chmod.rs

@@ -0,0 +1,36 @@
+#[cfg(unix)]
+use llrt_utils::result::ResultExt;
+use rquickjs::{Ctx, Result};
+#[cfg(unix)]
+use std::os::unix::prelude::PermissionsExt;
+
+pub async fn chmod(ctx: Ctx<'_>, path: String, mode: u32) -> Result<()> {
+    #[cfg(unix)]
+    {
+        tokio::fs::set_permissions(&path, PermissionsExt::from_mode(mode))
+            .await
+            .or_throw_msg(&ctx, &["Can't set permissions of \"", &path, "\""].concat())?;
+    }
+    #[cfg(not(unix))]
+    {
+        _ = ctx;
+        _ = path;
+        _ = mode;
+    }
+    Ok(())
+}
+
+pub fn chmod_sync(ctx: Ctx<'_>, path: String, mode: u32) -> Result<()> {
+    #[cfg(unix)]
+    {
+        std::fs::set_permissions(&path, PermissionsExt::from_mode(mode))
+            .or_throw_msg(&ctx, &["Can't set permissions of \"", &path, "\""].concat())?;
+    }
+    #[cfg(not(unix))]
+    {
+        _ = ctx;
+        _ = path;
+        _ = mode;
+    }
+    Ok(())
+}

modules/llrt_fs/src/lib.rs

@@ -1,6 +1,7 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 mod access;
+mod chmod;
 mod file_handle;
 mod mkdir;
 mod open;
@@ -18,6 +19,7 @@ use rquickjs::{
 use rquickjs::{Class, Ctx, Object, Result};
 
 use self::access::{access, access_sync};
+use self::chmod::{chmod, chmod_sync};
 use self::file_handle::FileHandle;
 use self::mkdir::{mkdir, mkdir_sync, mkdtemp, mkdtemp_sync};
 use self::open::open;
@@ -95,6 +97,7 @@ impl ModuleDef for FsModule {
         declare.declare("statSync")?;
         declare.declare("writeFileSync")?;
         declare.declare("constants")?;
+        declare.declare("chmodSync")?;
 
         declare.declare("default")?;
 
@@ -123,6 +126,7 @@ impl ModuleDef for FsModule {
             default.set("rmSync", Func::from(rmfile_sync))?;
             default.set("statSync", Func::from(stat_fn_sync))?;
             default.set("writeFileSync", Func::from(write_file_sync))?;
+            default.set("chmodSync", Func::from(chmod_sync))?;
 
             Ok(())
         })
@@ -145,6 +149,7 @@ fn export_promises<'js>(ctx: &Ctx<'js>, exports: &Object<'js>) -> Result<()> {
     exports.set("rm", Func::from(Async(rmfile)))?;
     exports.set("rmdir", Func::from(Async(rmdir)))?;
     exports.set("stat", Func::from(Async(stat_fn)))?;
+    exports.set("chmod", Func::from(Async(chmod)))?;
 
     Ok(())
 }

types/fs.d.ts

@@ -325,4 +325,12 @@ declare module "fs" {
    * @param [mode=fs.constants.F_OK]
    */
   export function accessSync(path: PathLike, mode?: Mode): void;
+
+  /**
+   * For detailed information, see the documentation of the asynchronous version of
+   * this API: {@link chmod}.
+   *
+   * See the POSIX [`chmod(2)`](http://man7.org/linux/man-pages/man2/chmod.2.html) documentation for more detail.
+   */
+  export function chmodSync(path: PathLike, mode: Mode): void;
 }

types/fs/promises.d.ts

@@ -502,4 +502,10 @@ declare module "fs/promises" {
         }
       | BufferEncoding
   ): Promise<string>;
+
+  /**
+   * Changes the permissions of a file.
+   * @return Fulfills with `undefined` upon success.
+   */
+  function chmod(path: PathLike, mode: Mode): Promise<void>;
 }