Documentation
¶
Overview ¶
Package source defines the read-only Source interface implemented by every VCS backend (GitHub, GHES, GitLab, ...). It only enumerates repos and yields what's needed to clone and dump them, no method mutates the upstream VCS.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Filter ¶
type Filter struct {
Include []string // if non-empty, only repos matching one of these are kept
Exclude []string // repos matching any of these are dropped
}
Filter narrows which repositories a backup run targets. An empty Filter selects everything the credential can see. Include/Exclude are matched by the Source implementation (typically against "owner/name"); Exclude wins over Include.
type GitAuther ¶
type GitAuther interface {
// GitAuthHeader returns a full HTTP header line, e.g. "Authorization: Basic ...".
GitAuthHeader(ctx context.Context) (string, error)
}
GitAuther is an optional interface for Sources that authenticate git clones over HTTPS. The pipeline injects the returned header into git via env, never argv, so the token stays out of process listings. Sources without auth (e.g. local fixtures) simply don't implement it.
type Repo ¶
type Repo struct {
Host string `json:"host"` // VCS host, e.g. "github.com"
Owner string `json:"owner"` // org or user that owns the repo
Name string `json:"name"` // repository name (no owner prefix)
CloneURL string `json:"cloneUrl"` // HTTPS clone URL; credentials are applied at clone time, never embedded here
DefaultBranch string `json:"defaultBranch"` // default branch name, if known
Archived bool `json:"archived"` // upstream archived flag
SizeKB int64 `json:"sizeKb"` // approximate size in KiB, if reported
}
Repo identifies a single repository discovered on a Source, plus the minimal attributes the pipeline needs to back it up.
type Source ¶
type Source interface {
// ListRepos enumerates repositories visible to the configured identity,
// applying the include/exclude filter.
ListRepos(ctx context.Context, f Filter) ([]Repo, error)
// CloneURL returns the URL to clone r over HTTPS. Authentication is supplied
// out of band at clone time (an injected Authorization header); the returned
// URL must not embed credentials.
CloneURL(ctx context.Context, r Repo) (string, error)
// FetchMetadata returns repository metadata as JSON bytes for archival. In the
// walking skeleton this is a minimal repo descriptor; the full per-resource dump
// (issues, PRs, releases, ...) is added later (M5).
FetchMetadata(ctx context.Context, r Repo) ([]byte, error)
}
Source is the read-only interface implemented by every VCS backend.
Invariant: a Source exposes no mutating operation. It can only read.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package github implements the read-only Source for GitHub.com (and, by base URL, GitHub Enterprise Server).
|
Package github implements the read-only Source for GitHub.com (and, by base URL, GitHub Enterprise Server). |
|
Package gitlab implements the read-only Source for GitLab.com and self-managed GitLab.
|
Package gitlab implements the read-only Source for GitLab.com and self-managed GitLab. |