package maintpb

Get desktop application:
View/edit binary Protocol Buffers messages

BoolChange represents a change to a boolean value. (Notably, the wrapper type permits representing a change to false.)

Used in: GithubIssueMutation, GithubMilestone

• bool val = 1

Used in: Mutation

• string project = 1

  Project is the Gerrit server and project, without scheme (https implied) or trailing slash.

  "go.googlesource.com/go", "go.googlesource.com/net", etc

• repeated GitCommit commits = 2

  Commits to add.

• repeated GitRef refs = 3

  git refs to update.

• repeated string deleted_refs = 4

  deleted_refs are ref names to delete.

Used in: GerritMutation, GitMutation

• string sha1 = 1

  the full lowercase 40-hex-byte sha1 sum

• bytes raw = 2

  raw is the "git cat-file commit $sha1" output.

• optional GitDiffTree diff_tree = 3

git diff-tree --numstat oldtree newtree

Used in: GitCommit

• repeated GitDiffTreeFile file = 1

GitDiffTreeFile represents one line of `git diff-tree --numstat` output.

Used in: GitDiffTree

• string file = 1

• int64 added = 2

• int64 deleted = 3

• bool binary = 4

Used in: Mutation

• optional GitRepo repo = 1

• optional GitCommit commit = 2

  commit adds a commit, or adds new information to a commit if fields are added in the future.

Used in: GerritMutation

• string ref = 1

  ref is the git ref name, such as: HEAD refs/heads/master refs/changes/00/14700/1 refs/changes/00/14700/meta refs/meta/config

• string sha1 = 2

  sha1 is the lowercase hex sha1

GitRepo identifies a git repo being mutated.

Used in: GitMutation

• string go_repo = 1

  If go_repo is set, it identifies a go.googlesource.com/<go_repo> repo.

Used in: GithubIssueEvent

• string owner = 1

  "golang"

• string repo = 2

  "go"

• string commit_id = 3

  "0beec7b5ea3f0fdbc95d0dd47f3c5bc275da8a33"

Contents of a dismissed review event - when someone leaves a review requesting changes and someone else dismisses it. See https://developer.github.com/v3/issues/events for more information.

Used in: GithubIssueEvent

• int64 review_id = 1

  ID of the review being dismissed

• string dismissal_message = 3

• string state = 4

  commented, approved, changes_requested

Used in: GithubIssueMutation

• int64 id = 1

• optional GithubUser user = 2

  not present in edits later

• string body = 3

  may not be present in edits later (if only reactions changed? TODO: investigate)

• optional google.protobuf.Timestamp created = 4

  not present in edits later

• optional google.protobuf.Timestamp updated = 5

See https://developer.github.com/v3/activity/events/types/#issuesevent for some info.

Used in: GithubIssueMutation

• int64 id = 1

  Required:

• string event_type = 2

  event_type can be one of "assigned", "unassigned", "labeled", "unlabeled", "opened", "edited", "milestoned", "demilestoned", "closed", "reopened", "referenced", "renamed" or anything else that Github adds in the future.

• int64 actor_id = 3

• optional google.protobuf.Timestamp created = 4

  time of the event

• optional GithubLabel label = 5

  label is populated for "labeled" and "unlabeled" events. The label will usually not have an ID, due to Github's API not returning one.

• optional GithubMilestone milestone = 6

  milestone is populated for "milestoned" and "demilestoned" events. The label will usually not have an ID, due to Github's API not returning one.

• int64 assignee_id = 7

  For "assigned", "unassigned":

  always same as actor_id it seems? Github API doesn't say.

• int64 assigner_id = 8

• optional GithubCommit commit = 9

  For "referenced", "closed":

• string rename_from = 11

  For "renamed" events:

• string rename_to = 12

• int64 reviewer_id = 13

• int64 review_requester_id = 14

• optional GithubTeam team_reviewer = 16

• optional GithubDismissedReviewEvent dismissed_review = 15

  Contents of a dismissed review event, see dismissed_review in https://developer.github.com/v3/issues/events/ for more info

• bytes other_json = 10

  other_json is usually empty. If Github adds event types or fields in the future, this captures those added fields. If non-empty it will be a JSON object with the fields that weren't understood.

Used in: Mutation

• string owner = 1

  "golang"

• string repo = 2

  "go"

• int32 number = 3

  1, 2, 3... (not the ID)

• bool not_exist = 13

  not_exist is set true if the issue has been found to not exist. If true, the owner/repo/number fields above must still be set. If a future issue mutation for the same number arrives without not_exist set, then the issue comes back to life.

• int64 id = 12

  unique across all repos

• optional GithubUser user = 4

  only set for new/updated issues, not new comments

• repeated GithubUser assignees = 10

  who the issue is assigned to

• repeated int64 deleted_assignees = 11

  IDs of users to delete from the assignee list

• optional google.protobuf.Timestamp created = 5

  only needed on new issues

• optional google.protobuf.Timestamp updated = 6

  only set on updated issue text

• string title = 9

  issue title

• optional StringChange body_change = 31

  body_change changes the body field (the top post, which isn't a comment). It is now used in preference to the old body field.

• string body = 7

  body was the old way to change the body, but it doesn't support removing the body text, which is common on PRs. New mutations use body_change instead.

• bool no_milestone = 15

  true unsets any previously-set milestone; false ignored.

• int64 milestone_id = 16

  When setting a milestone, only the milestone_id must be set. TODO: allow num or title to be used if Github only returns those? So far unneeded. The num and title, if non-zero, are treated as if they were a GithubMutation.Milestone update.

  sets milestone to this milestone id (e.g. 2386495, global?)

• int64 milestone_num = 17

  sets milestone to this milestone number (e.g. 2, per-repo)

• string milestone_title = 18

• optional BoolChange closed = 19

• optional BoolChange locked = 25

• bool pull_request = 28

  true is the issue is a Pull Request

• optional google.protobuf.Timestamp closed_at = 21

• optional GithubUser closed_by = 22

• repeated int64 remove_label = 23

  label IDs to remove

• repeated GithubLabel add_label = 24

• repeated GithubIssueCommentMutation comment = 8

• optional GithubIssueSyncStatus comment_status = 14

• repeated GithubIssueEvent event = 26

  new events to add

• optional GithubIssueSyncStatus event_status = 27

• repeated GithubReview review = 29

  new reviews to add

• optional GithubIssueSyncStatus review_status = 30

GithubIssueSyncStatus notes where syncing is at for comments on an issue, This mutation type is only made at/after the same top-level mutation which created the corresponding comments.

Used in: GithubIssueMutation

• optional google.protobuf.Timestamp server_date = 1

  server_date is the "Date" response header from Github for the final HTTP response.

Used in: GithubIssueEvent, GithubIssueMutation, GithubMutation

• int64 id = 1

• string name = 2

Used in: GithubIssueEvent, GithubMutation

• int64 id = 1

  required

• string title = 2

  Following only need to be non-zero on changes:

• optional BoolChange closed = 3

• int64 number = 4

Used in: Mutation

• string owner = 1

  "golang"

• string repo = 2

  "go"

• repeated GithubLabel labels = 3

  Updated labels. (All must have id set at least)

• repeated GithubMilestone milestones = 4

  Updated milestones. (All must have id set at least)

Contents of a pull request review - when someone comments, requests changes, or approves changes on a pull request. See https://developer.github.com/v3/pulls/reviews/ for more information.

Used in: GithubIssueMutation

• int64 id = 1

  Required:

• int64 actor_id = 2

• optional google.protobuf.Timestamp created = 3

  time of the event

• string body = 4

  body of the review comment

• string state = 5

  COMMENTED, APPROVED, CHANGES_REQUESTED

• string commit_id = 6

• string actor_association = 7

• bytes other_json = 8

  other_json is usually empty.

Used in: GithubIssueEvent

• int64 id = 1

• string slug = 2

Used in: GithubIssueCommentMutation, GithubIssueMutation

• int64 id = 1

• string login = 2

• optional GithubIssueMutation github_issue = 1

  issue-specific changes

• optional GithubMutation github = 3

  labels, milestones (not issue-specific)

• optional GitMutation git = 2

• optional GerritMutation gerrit = 4

StringChange represents a change to a boolean value. (Notably, the wrapper type permits representing a change to the empty string.)

Used in: GithubIssueMutation

• string val = 1