Documentation
¶
Overview ¶
Package change holds the shared code-change identity used across SubmitQueue, Stovepipe, and other repo-local domains. A Change names code to act on via provider URIs; the URI parsers live in the github, phabricator, and git subpackages.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Change ¶
type Change struct {
// URIs identifies the change(s) to land (RFC 3986 compliant): scheme://<host[:port]>/<path>.
// The scheme identifies the change provider, the authority is the provider instance the
// change lives on, and the path contains provider-specific resource identifiers.
//
// Supported formats:
// GitHub PR: "github://<host[:port]>/<org>/<repo>/pull/<pr>/<head_commit_sha>"
// Phabricator Diff: "phab://<host[:port]>/D<revision>/<diff>"
// git ref/commit: "git://<host[:port]>/<repo>/<ref>/<sha>"
// Example: "github://github.example.com/uber/submitqueue/pull/123/c3a4d5e6f7890123456789abcdef0123456789ab"
//
// Head/commit SHAs must be the full 40-char lowercase hex form.
//
// One URI is one unit of change — a single pull request, revision, or
// commit. A list is an ordered set of distinct changes (a stack), not one
// change described several ways: order is significant, each entry applies
// on top of the last, and each yields its own result. An integration
// strategy chosen for a change applies to every URI in the list, the same
// way to each.
URIs []string `json:"uris"`
}
Change represents a code change identified by URIs from a code change provider (e.g., GitHub Pull Request, Phabricator Diff). The provider is extracted from the URI scheme. The object is immutable after creation.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package changeutil holds small helpers shared across the entity/change provider subpackages (github, git, ...).
|
Package changeutil holds small helpers shared across the entity/change provider subpackages (github, git, ...). |
|
Package git parses change IDs that use the git:// URI scheme.
|
Package git parses change IDs that use the git:// URI scheme. |
Click to show internal directories.
Click to hide internal directories.