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
//! Release-provider abstractions and git operations for the
//! phpboyscout Rust toolkit.
//!
//! Formerly `rtb-vcs` in the
//! [rust-tool-base](https://gitlab.com/phpboyscout/rust-tool-base)
//! monorepo — renamed to `rtb-forge` at extraction for name
//! convergence with the GTB family. Only the crate identity changed:
//! types, modules, Cargo features, and the `RTB_VCS_GIT_TOKEN` auth
//! environment variable are exactly those of `rtb-vcs` 0.7.0.
//!
//! # What this crate is
//!
//! Two independent slices:
//!
//! - **Release providers.** A narrow, read-only abstraction over
//! release-source APIs. Tool authors pick one of six backends —
//! GitHub, GitLab, Bitbucket, Gitea, Codeberg, or Direct (bare HTTPS
//! URL) — and `rtb-update` consumes the trait to list, fetch, and
//! download release artefacts. Each backend is behind its own Cargo
//! feature, all default-on.
//! - **Git operations.** The `git` module's `Repo` type: init, open,
//! clone, fetch, status, commit, checkout, walk, diff, blame and
//! push. Behind the default-on `git` feature.
//!
//! # What this crate is not
//!
//! - **Not a release writer.** `ReleaseProvider` has four methods, all
//! of them read-only. Creating releases, uploading assets, and
//! editing tags are deliberately out of scope.
//! - **Not a general git library.** `Repo` covers the operations above
//! and stops: no branch, merge, rebase, stash, tag or remote
//! management.
//! - **Not a caching layer.** Every call hits the wire. Downstream
//! tools add HTTP caching via `reqwest::ClientBuilder::middleware`
//! if they need it.
// `deny`, not `forbid`: `linkme`'s `#[distributed_slice]` emits
// `#[link_section]`, which Rust 1.95+ reports under `unsafe_code`, and
// only `deny` lets each registration module carry a local
// `#![allow(unsafe_code)]`. Any rtb-* crate with a `linkme` site makes
// the same trade. No hand-written `unsafe` block exists in this crate.
// v0.5 git-operations slice — entire module gated on the `git` feature.
// See spec 0023: https://gitlab.com/phpboyscout/rust-tool-base/-/wikis/specs/0023-v0.5-scope
// Shared HTTP helpers for the REST-API backends. `pub(crate)` —
// downstream custom backends roll their own.
pub
pub use ;
pub use ;