heroforge-core 0.2.2

Pure Rust core library for reading and writing Fossil SCM repositories
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

# Repository API

Fluent, chainable API for repository operations.

## Pattern

```rust
repo.operation()           // Start
    .option(value)         // Configure
    .option(value)         // Configure more
    .execute()?            // Run
```

## Commits

```rust
// Initial commit
let hash = repo.commit()
    .message("Initial commit")
    .author("admin")
    .initial()
    .execute()?;

// Add files
let hash = repo.commit()
    .message("Add feature")
    .author("developer")
    .parent(&previous_hash)
    .file("README.md", b"# Project")
    .file("src/lib.rs", b"pub fn hello() {}")
    .execute()?;
```

## Branches

```rust
// List
let branches = repo.branches().list()?;

// Create
repo.branches()
    .create("feature-x")
    .from_branch("trunk")
    .author("developer")
    .execute()?;

// Get tip
let checkin = repo.branches().get("feature-x")?.tip()?;
```

## Tags

```rust
// At branch
repo.tags()
    .create("v1.0.0")
    .at_branch("trunk")
    .author("developer")
    .execute()?;

// At commit
repo.tags()
    .create("v1.0.1")
    .at_commit(&hash)
    .author("developer")
    .execute()?;
```

## Reading Files

```rust
// From trunk
let content = repo.files().on_trunk().read("README.md")?;
let text = repo.files().on_trunk().read_string("config.json")?;

// From branch
let content = repo.files().on_branch("feature").read("src/lib.rs")?;

// From tag
let content = repo.files().at_tag("v1.0.0").read("Cargo.toml")?;

// List/find
let files = repo.files().on_trunk().list()?;
let rust_files = repo.files().on_trunk().find("**/*.rs")?;
```

## Filesystem Operations

```rust
// Modify (atomic commit)
repo.fs().modify()
    .message("Reorganize project")
    .author("developer")
    .copy_file("README.md", "docs/README.md")
    .copy_dir("src", "backup/src")
    .move_file("old.txt", "archive/old.txt")
    .delete_file("temp.log")
    .delete_dir("cache")
    .chmod("scripts/run.sh", 0o755)
    .make_executable("bin/app")
    .symlink("lib/latest", "lib/v2.0")
    .execute()?;

// Find files
let files = repo.fs().find()
    .pattern("**/*.rs")
    .ignore("target/**")
    .ignore_hidden(true)
    .paths()?;

// Quick checks (no commit)
let exists = repo.fs().exists("README.md")?;
let is_dir = repo.fs().is_dir("src")?;
let size = repo.fs().du("**/*.rs")?;
let count = repo.fs().count("**/*.rs")?;
```

## History

```rust
// Recent commits
let commits = repo.history().limit(10).list()?;

// Specific commit
let commit = repo.history().get("abc123")?;
```

## Users

```rust
// List
let users = repo.users().list()?;

// Create
repo.users()
    .create("developer")
    .password("secret")
    .capabilities("ei")
    .execute()?;
```