reviewdb.proto: Reformat and add comments

Change-Id: I63a99582ad566e62541d02df8e6693e00301a123
This commit is contained in:
Alice Kober-Sotzek 2018-12-05 17:42:47 +01:00
parent eab0f799fc
commit 342b836349
1 changed files with 134 additions and 78 deletions

View File

@ -14,51 +14,72 @@
syntax = "proto2";
package devtools.gerritcodereview;
option java_package = "com.google.gerrit.proto.reviewdb";
package devtools.gerritcodereview;
// Serialized form of com.google.gerrit.reviewdb.client.Change.Id.
// Next ID: 2
message Change_Id {
required int32 id = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.ChangeMessage.
// Next ID: 3
message ChangeMessage_Key {
required Change_Id change_id = 1;
required string uuid = 2;
}
// Serialized form of com.google.gerrit.reviewdb.client.PatchSet.Id.
// Next ID: 3
message PatchSet_Id {
required Change_Id change_id = 1;
required int32 patch_set_id = 2;
}
// Serialized form of com.google.gerrit.reviewdb.client.Patch.Key.
// Next ID: 3
message Patch_Key {
required PatchSet_Id patch_set_id = 1;
required string file_name = 2;
}
// Serialized form of com.google.gerrit.reviewdb.client.PatchLineComment.Key.
// Next ID: 3
message PatchLineComment_Key {
required Patch_Key patch_key = 1;
required string uuid = 2;
}
// Serialized form of com.google.gerrit.reviewdb.client.Account.Id.
// Next ID: 2
message Account_Id {
required int32 id = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.LabelId.
// Next ID: 2
message LabelId {
required string id = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.PatchSetApproval.Key.
// Next ID: 4
message PatchSetApproval_Key {
required PatchSet_Id patch_set_id = 1;
required Account_Id account_id = 2;
required LabelId category_id = 3;
}
// Serialized form of com.google.gerrit.reviewdb.client.CurrentSchemaVersion.Key.
// Next ID: 2
message CurrentSchemaVersion_Key {
required string one = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.ChangeMessage.
// Next ID: 8
message ChangeMessage {
required ChangeMessage_Key key = 1;
optional Account_Id author_id = 2;
@ -69,19 +90,27 @@ message ChangeMessage {
optional Account_Id real_author = 7;
}
// Serialized form of com.google.gerrit.reviewdb.client.Change.Key.
// Next ID: 2
message Change_Key {
optional string id = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.Project.NameKey.
// Next ID: 2
message Project_NameKey {
optional string name = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.Branch.NameKey.
// Next ID: 3
message Branch_NameKey {
optional Project_NameKey project_name = 1;
optional string branch_name = 2;
}
// Serialized form of com.google.gerrit.reviewdb.client.Change.
// Next ID: 24
message Change {
required Change_Id change_id = 1;
optional Change_Key change_key = 2;
@ -102,8 +131,17 @@ message Change {
optional bool review_started = 22;
optional Change_Id revert_of = 23;
optional string note_db_state = 101;
// Deleted fields, should not be reused:
reserved 6; // sortkey
reserved 9; // open
reserved 11; // nbrPatchSets
reserved 15; // lastSha1MergeTested
reserved 16; // mergeable
}
// Serialized form of com.google.gerrit.reviewdb.client.CommentRange.
// Next ID: 5
message CommentRange {
optional int32 start_line = 1;
optional int32 start_character = 2;
@ -111,6 +149,8 @@ message CommentRange {
optional int32 end_character = 4;
}
// Serialized form of com.google.gerrit.reviewdb.client.PatchLineComment.
// Next ID: 13
message PatchLineComment {
required PatchLineComment_Key key = 1;
optional int32 line_nbr = 2;
@ -126,6 +166,8 @@ message PatchLineComment {
optional bool unresolved = 12;
}
// Serialized form of com.google.gerrit.reviewdb.client.PatchSetApproval.
// Next ID: 9
message PatchSetApproval {
required PatchSetApproval_Key key = 1;
optional int32 value = 2;
@ -133,12 +175,20 @@ message PatchSetApproval {
optional string tag = 6;
optional Account_Id real_account_id = 7;
optional bool post_submit = 8;
// Deleted fields, should not be reused:
reserved 4; // changeOpen
reserved 5; // changeSortKey
}
// Serialized form of com.google.gerrit.reviewdb.client.RevId.
// Next ID: 2
message RevId {
optional string id = 1;
}
// Serialized form of com.google.gerrit.reviewdb.client.PatchSet.
// Next ID: 10
message PatchSet {
required PatchSet_Id id = 1;
optional RevId revision = 2;
@ -147,8 +197,14 @@ message PatchSet {
optional string groups = 6;
optional string push_certificate = 8;
optional string description = 9;
// Deleted fields, should not be reused:
reserved 5; // draft
reserved 7; // pushCertficate
}
// Serialized form of com.google.gerrit.reviewdb.client.CurrentSchemaVersion.
// Next ID: 3
message CurrentSchemaVersion {
required CurrentSchemaVersion_Key singleton = 1;
optional int32 version_nbr = 2;