change

package
v0.3.0-20260818173219-... Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 18, 2026 License: Apache-2.0 Imports: 0 Imported by: 0

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL