Lib.rs

sley — the embeddable facade over Sley's native Git-equivalent engine.

Downstream code that wants a "just open a repository and read things" entry point should reach for Repository rather than wiring the plumbing crates together by hand. A Repository is a lightweight handle around a resolved git directory: it remembers the git_dir, the common directory (for linked worktrees), and the repository's object format, and hands back the underlying plumbing objects (sley_odb::FileObjectDatabase, sley_refs::FileRefStore, sley_config::GitConfig) on demand.

Embedder surface (feature remote, on by default):

• Repository::config_snapshot — full git config with include / includeIf / hasconfig: resolution.
• Repository::init_mirror — bare mirror defaults (+refs/*:refs/*, mirror = true on origin).
• Repository::copy_reachable_from — pack-based object transfer.
• clone_repository — thin free-function clone of a resolved remote (re-export of sley_remote::clone).
• Repository::remote / remote::RemoteContext — URL rewriting and sley_remote fetch/push/clone/ls-remote orchestration (HTTP v2 fetch, SSH, bundle fetch, thin-pack push). Porcelain paths on the facade (Repository::push, and future commit/checkout helpers) invoke git hooks via hooks when a hook is configured.
• Cancel — cooperative stream cancellation for pack receive/generate: AtomicCancel, CancelFlag, CancellableRead, OperationContext, plus Repository::{fetch,push,push_actions}_with_cancel.
• pack / protocol — repository-free streaming pack indexing and upload-pack sideband demultiplexing for custom storage pipelines.
• hooks — traditional and config-defined hook discovery/execution.
• OpenOptions::respect_environment / Repository::open_from_environment — honor GIT_DIR, GIT_WORK_TREE, and related discovery env vars.
• notes — git notes read/write for round-trip fidelity.
• Repository::capabilities / Repository::transport_capabilities — capability probes before calling in.

For power users the engine crates are re-exported under plumbing (and the most common types are re-exported at the crate root), so a single git = { path = ... } dependency is enough to reach the whole stack.

use sley::Repository;

let repo = Repository::discover(".")?;
let head = repo.head()?;
if let Some(oid) = head.oid {
    let commit = repo.read_commit(&oid)?;
    let _ = commit.tree;
}