aqc-filetree 0.1.0

Walk one directory root into a FileTree: gitignore-aware phase 1 plus rule-driven recovery phase 2.
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

//! Walk one filesystem directory root, return a [`FileTree`].
//!
//! No Git commands, no file reads, no parsing, no product policy. Two phases:
//! phase 1 is gitignore-aware; phase 2 (opt-in via [`RecoveryRules`]) walks
//! WITHOUT gitignore and recovers specific paths from ignored trees, tagged
//! [`EntryOrigin::Recovered`]. Contract: `plan.md` in this directory.

#![expect(
    clippy::type_complexity,
    reason = "Result<Vec<...>, Error> return shapes exceed the strict workspace threshold; the shapes are the crate's declared contract, stated openly rather than aliased away."
)]

// Dev-dependency linked into the lib's test build but exercised only by the
// integration tests in `tests/`.
#[cfg(test)]
use tempfile as _;

mod fs;
mod options;
mod tree;
mod walk;

#[cfg(feature = "api")]
pub use options::RecoveryRules;
#[cfg(feature = "api")]
pub use options::SkipDirPreset;
#[cfg(feature = "api")]
pub use options::SymlinkPolicy;
#[cfg(feature = "api")]
pub use options::WalkError;
#[cfg(feature = "api")]
pub use options::WalkOptions;
#[cfg(feature = "api")]
pub use tree::EntryOrigin;
#[cfg(feature = "api")]
pub use tree::FileEntry;
#[cfg(feature = "api")]
pub use tree::FileKind;
#[cfg(feature = "api")]
pub use tree::FileTree;
#[cfg(feature = "api")]
pub use walk::build_file_tree;