package google.devtools.source.v1

Get desktop application:
View/edit binary Protocol Buffers messages

An alias to a repo revision.

Used in: CloudRepoSourceContext, GerritSourceContext

• AliasContext.Kind kind = 1

  The alias kind.

• string name = 2

  The alias name.

The type of an Alias.

Used in: AliasContext

• ANY = 0

  Do not use.

• FIXED = 1

  Git tag

• MOVABLE = 2

  Git branch

• OTHER = 4

  OTHER is used to specify non-standard aliases, those not of the kinds above. For example, if a Git repo has a ref named "refs/foo/bar", it is considered to be of kind OTHER.

A CloudRepoSourceContext denotes a particular revision in a cloud repo (a repo hosted by the Google Cloud Platform).

Used in: SourceContext

• optional RepoId repo_id = 1

  The ID of the repo.

• oneof revision

  A revision in a cloud repository can be identified by either its revision ID or its Alias.

  • string revision_id = 2

    A revision ID.

  • string alias_name = 3

    The name of an alias (branch, tag, etc.).

  • AliasContext alias_context = 4

    An alias, which may be a branch or tag.

A CloudWorkspaceId is a unique identifier for a cloud workspace. A cloud workspace is a place associated with a repo where modified files can be stored before they are committed.

Used in: CloudWorkspaceSourceContext

• optional RepoId repo_id = 1

  The ID of the repo containing the workspace.

• string name = 2

  The unique name of the workspace within the repo. This is the name chosen by the client in the Source API's CreateWorkspace method.

A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot.

Used in: SourceContext

• optional CloudWorkspaceId workspace_id = 1

  The ID of the workspace.

• string snapshot_id = 2

  The ID of the snapshot. An empty snapshot_id refers to the most recent snapshot.

An ExtendedSourceContext is a SourceContext combined with additional details describing the context.

Used in: clouddebugger.v2.Debuggee

• optional SourceContext context = 1

  Any source context.

• map<string, string> labels = 2

  Labels with user defined metadata.

A SourceContext referring to a Gerrit project.

Used in: SourceContext

• string host_uri = 1

  The URI of a running Gerrit instance.

• string gerrit_project = 2

  The full project name within the host. Projects may be nested, so "project/subproject" is a valid project name. The "repo name" is hostURI/project.

• oneof revision

  A revision in a Gerrit project can be identified by either its revision ID or its alias.

  • string revision_id = 3

    A revision (commit) ID.

  • string alias_name = 4

    The name of an alias (branch, tag, etc.).

  • AliasContext alias_context = 5

    An alias, which may be a branch or tag.

A GitSourceContext denotes a particular revision in a third party Git repository (e.g. GitHub).

Used in: SourceContext

• string url = 1

  Git repository URL.

• string revision_id = 2

  Git commit hash. required.

Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31) and a repo name within that project.

Used in: RepoId

• string project_id = 1

  The ID of the project.

• string repo_name = 2

  The name of the repo. Leave empty for the default repo.

A unique identifier for a cloud repo.

Used in: CloudRepoSourceContext, CloudWorkspaceId

• oneof id

  A cloud repository can be identified by either its project ID and repository name combination, or its globally unique identifier.

  • ProjectRepoId project_repo_id = 1

    A combination of a project ID and a repo name.

  • string uid = 2

    A server-assigned, globally unique identifier.

A SourceContext is a reference to a tree of files. A SourceContext together with a path point to a unique revision of a single file or directory.

Used in: clouddebugger.v2.Debuggee, ExtendedSourceContext

• oneof context

  A SourceContext can refer any one of the following types of repositories.

  • CloudRepoSourceContext cloud_repo = 1

    A SourceContext referring to a revision in a cloud repo.

  • CloudWorkspaceSourceContext cloud_workspace = 2

    A SourceContext referring to a snapshot in a cloud workspace.

  • GerritSourceContext gerrit = 3

    A SourceContext referring to a Gerrit project.

  • GitSourceContext git = 6

    A SourceContext referring to any third party Git repo (e.g. GitHub).