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
//! SHA-1/SHA-256 Git index v2/v3/v4 entries and synchronous per-worktree storage.
//!
//! [`Index::parse`] and [`Index::encode`] work with caller-owned bytes. In a repository,
//! [`crate::Repository::read_index`] distinguishes absent storage from an empty index;
//! [`crate::Repository::edit_index`] holds the lock until [`IndexEdit::commit`] publishes an
//! explicit edit. [`Entry`] carries paths, stages, modes, and cached stat information.
//!
//! An index records candidate tree entries and cached filesystem metadata. [`Index`] validates
//! format structure without resolving objects or touching working files. Paths remain bytes;
//! format validity does not establish checkout safety on any host filesystem.
//! [`Index::tree_id`] computes the proposed tree identity without reading objects or trusting
//! caches.
//!
//! Intent-to-add, skip-worktree and assume-valid are retained as data; no staging, sparse-checkout
//! or stat-skipping policy is implemented. Split indexes resolve their immutable shared file on
//! repository reads; unchanged publication preserves that dependency and edits publish a full
//! index. [`IndexEdit::make_standalone`] explicitly removes that dependency without changing
//! entries or version, while retaining both storage snapshots for publication checks. Sparse
//! directories retain tree identities; explicit expansion reads their trees without materializing
//! files. Unknown mandatory extensions are refused. Optional extensions are opaque and round-trip
//! unchanged. Editing discards derived caches, retains resolve-undo records and refuses unknown
//! optional extensions. See [`Index::replace_entries`]. Explicit
//! [`IndexEdit::discard_optional_extensions`] permits caller-selected optional data loss, and
//! [`IndexEdit::replace_index`] installs a complete standalone draft without releasing its guards.
//! [`crate::Repository::edit_index_at_with_options`] separately opts into alternate split storage
//! or replacing a symlink leaf after reading through it; default admission stays unchanged.
//!
//! [`crate::Repository::read_index`] distinguishes absence from an empty index.
//! [`crate::Repository::edit_index`] locks before reading; [`IndexEdit::commit`] publishes the
//! edited snapshot. These operations are synchronous and never stage content, scan a worktree,
//! run hooks, or honor environment overrides such as `GIT_INDEX_FILE`.
//!
//! ```
//! use girt::ObjectId;
//! use girt::index::{Entry, Index, Limits, Mode};
//! let entry = Entry::new(
//! b"hello.txt".to_vec(),
//! Mode::Regular,
//! ObjectId::for_blob(girt::ObjectFormat::Sha1, b"hello\n"),
//! );
//! let index = Index::new(girt::ObjectFormat::Sha1, vec![entry], Limits::default())?;
//! let bytes = index.encode(Limits::default())?;
//! assert_eq!(
//! Index::parse(girt::ObjectFormat::Sha1, &bytes, Limits::default())?,
//! index
//! );
//! # Ok::<(), girt::index::Error>(())
//! ```
pub use ;
pub use ;
pub use ;
pub use ;
pub use WriteTreeError;