Struct GraphConfigPaths 

pub struct GraphConfigPaths { /* private fields */ }

Path resolver for graph config files

Provides canonical paths for all config-related files and directories under .sqry/graph/config/.

Example

use sqry_core::config::GraphConfigPaths;

let paths = GraphConfigPaths::new("/home/user/project")?;
let config_file = paths.config_file();
let lock_file = paths.lock_file();

Implementations

impl GraphConfigPaths

pub fn new<P: AsRef<Path>>(project_root: P) -> Result<Self>

Create a new path resolver from a project root

Arguments

• project_root - Root directory of the project

Errors

Returns error if the path is invalid or inaccessible

pub fn with_graph_dir<P: AsRef<Path>, G: AsRef<Path>>( project_root: P, graph_dir: G, ) -> Result<Self>

Create path resolver with an explicit graph directory override

This is primarily for testing or when the graph directory is in a non-standard location.

Arguments

• project_root - Root directory of the project
• graph_dir - Override path for .sqry/graph directory

Errors

Returns an error if the project root is invalid or inaccessible.

pub fn graph_dir(&self) -> PathBuf

Get the graph directory path (.sqry/graph)

pub fn config_dir(&self) -> PathBuf

Get the config directory path (.sqry/graph/config)

pub fn config_file(&self) -> PathBuf

Get the canonical config file path (.sqry/graph/config/config.json)

pub fn previous_file(&self) -> PathBuf

Get the previous config file path (.sqry/graph/config/config.json.previous)

pub fn lock_file(&self) -> PathBuf

Get the lock file path (.sqry/graph/config/config.lock)

pub fn corrupt_file(&self, timestamp: &str) -> PathBuf

Generate a corrupt quarantine file path with timestamp

Format: .sqry/graph/config/config.json.corrupt.<timestamp>

Arguments

• timestamp - UTC timestamp in RFC3339 format

pub fn config_dir_exists(&self) -> bool

Check if the config directory exists

Returns true if .sqry/graph/config/ exists and is a directory.

pub fn config_file_exists(&self) -> bool

Check if the config file exists

Returns true if .sqry/graph/config/config.json exists.

pub fn is_network_filesystem(&self) -> Result<bool>

Detect if the path is on a network filesystem

Network filesystems (NFS, CIFS, SMB) can violate atomic rename and fsync durability assumptions. This detection emits warnings to help users avoid data loss scenarios.

Platform Support

• Linux: Uses statfs with f_type magic numbers (NFS, SMB, CIFS, AFS, CODA)
• macOS: Uses statfs with f_fstypename string (nfs, smbfs, afpfs, webdav, ftp)
• Windows: UNC path detection + GetDriveTypeW for mapped network drives
• Other platforms: Returns Ok(false) (assumes local)

Returns

Returns Ok(true) if network filesystem detected, Ok(false) otherwise. On Linux, returns an error if the path doesn’t exist and no ancestor can be found. On macOS and Windows, returns Ok(false) on syscall/API failure (safe default).

Errors

Returns an error on Linux if filesystem inspection fails and no ancestor path exists. macOS and Windows implementations prefer Ok(false) over errors.

pub fn validate(&self, allow_network_fs: bool) -> Result<()>

Validate that the config directory is suitable for operations

Checks:

• Config directory exists (or can be created)
• Not on a network filesystem (unless explicitly allowed)

Arguments

• allow_network_fs - If true, skip network filesystem check

Errors

Returns error if validation fails

Trait Implementations

impl Clone for GraphConfigPaths

fn clone(&self) -> GraphConfigPaths

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GraphConfigPaths

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.