feat: tempfile with permission support, adding new *_with_permissions(..., permissions) methods.

Author: Byron

Cargo.lock

@@ -33,7 +33,7 @@ gix-fs = { version = "^0.10.0", path = "../gix-fs" }
 parking_lot = "0.12.1"
 dashmap = { version = "5.1.0", optional = true }
 once_cell = { version = "1.8.0", default-features = false, features = ["race", "std"] }
-tempfile = "3.4.0"
+tempfile = "3.10.0"
 
 signal-hook = { version = "0.3.9", default-features = false, optional = true }
 signal-hook-registry = { version = "1.4.0", optional = true }

gix-tempfile/Cargo.toml

@@ -22,7 +22,13 @@ pub(crate) enum Mode {
 
 /// Utilities
 impl Handle<()> {
-    fn at_path(path: &Path, directory: ContainingDirectory, cleanup: AutoRemove, mode: Mode) -> io::Result<usize> {
+    fn at_path(
+        path: &Path,
+        directory: ContainingDirectory,
+        cleanup: AutoRemove,
+        mode: Mode,
+        permissions: Option<std::fs::Permissions>,
+    ) -> io::Result<usize> {
         let tempfile = {
             let mut builder = tempfile::Builder::new();
             let dot_ext_storage;
@@ -34,6 +40,9 @@ impl Handle<()> {
                 dot_ext_storage = format!(".{}", ext.to_string_lossy());
                 builder.suffix(&dot_ext_storage);
             }
+            if let Some(permissions) = permissions {
+                builder.permissions(permissions);
+            }
             let parent_dir = path.parent().expect("parent directory is present");
             let parent_dir = directory.resolve(parent_dir)?;
             ForksafeTempfile::new(builder.rand_bytes(0).tempfile_in(parent_dir)?, cleanup, mode)
@@ -76,7 +85,20 @@ impl Handle<Closed> {
     /// signal is encountered as destructors won't run. See [the top-level documentation](crate) for more.
     pub fn at(path: impl AsRef<Path>, directory: ContainingDirectory, cleanup: AutoRemove) -> io::Result<Self> {
         Ok(Handle {
-            id: Handle::<()>::at_path(path.as_ref(), directory, cleanup, Mode::Closed)?,
+            id: Handle::<()>::at_path(path.as_ref(), directory, cleanup, Mode::Closed, None)?,
+            _marker: Default::default(),
+        })
+    }
+
+    /// Like [`at`](Self::at()), but with support for filesystem `permissions`.
+    pub fn at_with_permissions(
+        path: impl AsRef<Path>,
+        directory: ContainingDirectory,
+        cleanup: AutoRemove,
+        permissions: std::fs::Permissions,
+    ) -> io::Result<Self> {
+        Ok(Handle {
+            id: Handle::<()>::at_path(path.as_ref(), directory, cleanup, Mode::Closed, Some(permissions))?,
             _marker: Default::default(),
         })
     }
@@ -104,7 +126,20 @@ impl Handle<Writable> {
     /// signal is encountered as destructors won't run. See [the top-level documentation](crate) for more.
     pub fn at(path: impl AsRef<Path>, directory: ContainingDirectory, cleanup: AutoRemove) -> io::Result<Self> {
         Ok(Handle {
-            id: Handle::<()>::at_path(path.as_ref(), directory, cleanup, Mode::Writable)?,
+            id: Handle::<()>::at_path(path.as_ref(), directory, cleanup, Mode::Writable, None)?,
+            _marker: Default::default(),
+        })
+    }
+
+    /// Like [`at`](Self::at()), but with support for filesystem `permissions`.
+    pub fn at_with_permissions(
+        path: impl AsRef<Path>,
+        directory: ContainingDirectory,
+        cleanup: AutoRemove,
+        permissions: std::fs::Permissions,
+    ) -> io::Result<Self> {
+        Ok(Handle {
+            id: Handle::<()>::at_path(path.as_ref(), directory, cleanup, Mode::Writable, Some(permissions))?,
             _marker: Default::default(),
         })
     }

gix-tempfile/src/handle.rs

@@ -207,6 +207,16 @@ pub fn writable_at(
     Handle::<Writable>::at(path, directory, cleanup)
 }
 
+/// Like [`writable_at`], but allows to set the given filesystem `permissions`.
+pub fn writable_at_with_permissions(
+    path: impl AsRef<Path>,
+    directory: ContainingDirectory,
+    cleanup: AutoRemove,
+    permissions: std::fs::Permissions,
+) -> io::Result<Handle<Writable>> {
+    Handle::<Writable>::at_with_permissions(path, directory, cleanup, permissions)
+}
+
 /// A shortcut to [`Handle::<Closed>::at()`] providing a closed temporary file to mark the presence of something.
 pub fn mark_at(
     path: impl AsRef<Path>,
@@ -215,3 +225,13 @@ pub fn mark_at(
 ) -> io::Result<Handle<Closed>> {
     Handle::<Closed>::at(path, directory, cleanup)
 }
+
+/// Like [`mark_at`], but allows to set the given filesystem `permissions`.
+pub fn mark_at_with_permissions(
+    path: impl AsRef<Path>,
+    directory: ContainingDirectory,
+    cleanup: AutoRemove,
+    permissions: std::fs::Permissions,
+) -> io::Result<Handle<Closed>> {
+    Handle::<Closed>::at_with_permissions(path, directory, cleanup, permissions)
+}