Struct Modify 

pub struct Modify<'a> { /* private fields */ }

Builder for filesystem modification operations.

All operations are staged and then committed atomically when execute() is called.

Examples

Copy and Move Files

use heroforge_core::Repository;
use heroforge_core::fs::Modify;

let repo = Repository::open_rw("project.forge")?;

let hash = Modify::new(&repo)
    .message("Reorganize project structure")
    .author("developer")
    .copy_file("README.md", "docs/README.md")
    .copy_dir("src", "src_backup")
    .move_file("old_name.rs", "new_name.rs")
    .move_dir("scripts", "tools")
    .execute()?;

Delete Files

let hash = Modify::new(&repo)
    .message("Clean up old files")
    .author("developer")
    .delete_file("deprecated.rs")
    .delete_dir("old_module")
    .delete_matching("**/*.bak")
    .execute()?;

Change Permissions

let hash = Modify::new(&repo)
    .message("Fix permissions")
    .author("developer")
    .make_executable("scripts/build.sh")
    .chmod("config.toml", 0o644)
    .chmod_dir("bin", 0o755)
    .execute()?;

Create Symlinks

let hash = Modify::new(&repo)
    .message("Add convenience symlinks")
    .author("developer")
    .symlink("build", "scripts/build.sh")
    .symlink("latest", "releases/v1.0.0")
    .execute()?;

Write Files

let hash = Modify::new(&repo)
    .message("Update configuration")
    .author("developer")
    .write_str("VERSION", "1.0.0\n")
    .write("data.bin", &[0x00, 0x01, 0x02])
    .touch(".gitkeep")
    .execute()?;

Implementations

impl<'a> Modify<'a>

pub fn new(repo: &'a Repository) -> Self

Create a new Modify builder for the given repository.

pub fn at_commit(self, hash: &str) -> Self

Apply operations starting from a specific commit.

pub fn on_trunk(self) -> Self

Apply operations to trunk tip (default).

pub fn on_branch(self, branch: &str) -> Result<Self>

Apply operations to a branch tip.

pub fn message(self, msg: &str) -> Self

Set the commit message (required).

pub fn author(self, author: &str) -> Self

Set the commit author (required).

pub fn copy_file(self, src: &str, dst: &str) -> Self

Copy a file to a new location.

pub fn copy_dir(self, src: &str, dst: &str) -> Self

Copy a directory and all its contents recursively.

pub fn move_file(self, src: &str, dst: &str) -> Self

Move or rename a file.

pub fn move_dir(self, src: &str, dst: &str) -> Self

Move or rename a directory.

pub fn rename(self, old_path: &str, new_path: &str) -> Self

Rename a file (alias for move_file).

pub fn delete_file(self, path: &str) -> Self

Delete a file.

pub fn delete_dir(self, path: &str) -> Self

Delete a directory and all its contents.

pub fn delete_matching(self, pattern: &str) -> Self

Delete all files matching a glob pattern.

pub fn chmod(self, path: &str, mode: u32) -> Self

Change file permissions using octal notation.

pub fn chmod_permissions(self, path: &str, perms: Permissions) -> Self

Change permissions using a Permissions struct.

pub fn chmod_dir(self, path: &str, mode: u32) -> Self

Change permissions for all files in a directory recursively.

pub fn make_executable(self, path: &str) -> Self

Make a file executable (sets mode to 755).

pub fn symlink(self, link_path: &str, target: &str) -> Self

Create a symbolic link.

pub fn symlink_file(self, link_path: &str, target_file: &str) -> Self

Create a symbolic link to a file (alias for symlink).

pub fn symlink_dir(self, link_path: &str, target_dir: &str) -> Self

Create a symbolic link to a directory (alias for symlink).

pub fn write(self, path: &str, content: &[u8]) -> Self

Write binary content to a file.

pub fn write_str(self, path: &str, content: &str) -> Self

Write a string to a file.

pub fn touch(self, path: &str) -> Self

Create an empty file or update its timestamp.

pub fn execute(self) -> Result<String>

Execute all staged operations and create a commit.

pub fn preview(&self) -> Result<Preview>

Preview the operations without committing.