feat: add FileSnapshot::new() to create free-floating instances.

Author: Byron

gix-fs/src/lib.rs

@@ -2,6 +2,8 @@
 #![deny(rust_2018_idioms, missing_docs)]
 #![forbid(unsafe_code)]
 
+use std::path::PathBuf;
+
 /// Common knowledge about the worktree that is needed across most interactions with the work tree
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone, Copy)]
@@ -25,9 +27,6 @@ pub struct Capabilities {
 mod capabilities;
 
 mod snapshot;
-
-use std::path::PathBuf;
-
 pub use snapshot::{FileSnapshot, SharedFileSnapshot, SharedFileSnapshotMut};
 
 ///

gix-fs/src/snapshot.rs

@@ -10,6 +10,26 @@ pub struct FileSnapshot<T: std::fmt::Debug> {
     modified: std::time::SystemTime,
 }
 
+/// Lifecycle
+impl<T: std::fmt::Debug> FileSnapshot<T> {
+    /// A way for users to create 'fake' snapshot from `value` that isn't actually linked to a file on disk.
+    ///
+    /// This is useful if there are alternative ways of obtaining the contained instance as fallback to trying
+    /// to read it from disk.
+    pub fn new(value: T) -> Self {
+        FileSnapshot {
+            value,
+            modified: std::time::UNIX_EPOCH,
+        }
+    }
+}
+
+impl<T: std::fmt::Debug> From<T> for FileSnapshot<T> {
+    fn from(value: T) -> Self {
+        FileSnapshot::new(value)
+    }
+}
+
 impl<T: Clone + std::fmt::Debug> Clone for FileSnapshot<T> {
     fn clone(&self) -> Self {
         Self {