Expand description
Pure-Rust git helpers for versioned symbol resolution.
All git operations are performed in-process with gix (gitoxide); no
git binary is required. Commit-signature verification is likewise native
(see [signature]): PGP signatures are checked with rPGP and SSH signatures
with ssh-key, against a caller-supplied set of TrustedKeys.
Remote fetch/clone over the network is HTTPS-only and fully pure-Rust
(rustls). Local filesystem paths and file:// URLs are also supported
(handled in-process). ssh:///scp-like remotes are fetched natively (no
ssh binary) when the optional ssh feature is enabled (see the ssh
module); without it they are rejected with a clear error. Other schemes
(git://, http://) are unsupported.
Structs§
- Trusted
Keys - A cljrs-managed set of public keys trusted to sign commits.
Enums§
- Trusted
KeyError - Errors raised while loading a trusted public key.
- VcsError
Functions§
- cache_
path_ for_ url - Return the local cache path for a given remote URL, without fetching.
- cache_
root - Returns the path to the local git-dep cache root:
~/.cljrs/cache/git/. - fetch_
remote - Clone or fetch a git repository into the local cache.
- find_
repo_ root - Walk upward from
start(a file or directory) to find the root of the enclosing git repository, i.e. the working-tree root. - get_
file_ at_ commit - Return the contents of
rel_path(relative to the repo root) atcommit. - is_
valid_ commit_ hash - Returns
trueifslooks like a valid (abbreviated or full) commit hash: 7–40 lowercase or uppercase hex characters. - verify_
commit_ signature - Verify the PGP or SSH signature on
commitinsiderepo_rootagainst the caller-supplied set oftrustedkeys.