From 342b836349ef0b35245546060711593e2f6eb8ec Mon Sep 17 00:00:00 2001 From: Alice Kober-Sotzek Date: Wed, 5 Dec 2018 17:42:47 +0100 Subject: [PATCH] reviewdb.proto: Reformat and add comments Change-Id: I63a99582ad566e62541d02df8e6693e00301a123 --- proto/reviewdb.proto | 212 +++++++++++++++++++++++++++---------------- 1 file changed, 134 insertions(+), 78 deletions(-) diff --git a/proto/reviewdb.proto b/proto/reviewdb.proto index 6f505e4f65..f26cbb8246 100644 --- a/proto/reviewdb.proto +++ b/proto/reviewdb.proto @@ -14,142 +14,198 @@ 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; + 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; + 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; + 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; + 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; + 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; + required int32 id = 1; } +// Serialized form of com.google.gerrit.reviewdb.client.LabelId. +// Next ID: 2 message LabelId { - required string id = 1; + 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; + 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; + 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; - optional fixed64 written_on = 3; - optional string message = 4; - optional PatchSet_Id patchset = 5; - optional string tag = 6; - optional Account_Id real_author = 7; + required ChangeMessage_Key key = 1; + optional Account_Id author_id = 2; + optional fixed64 written_on = 3; + optional string message = 4; + optional PatchSet_Id patchset = 5; + optional string tag = 6; + 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; + optional string id = 1; } +// Serialized form of com.google.gerrit.reviewdb.client.Project.NameKey. +// Next ID: 2 message Project_NameKey { - optional string name = 1; + 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; + 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; - optional int32 row_version = 3; - optional fixed64 created_on = 4; - optional fixed64 last_updated_on = 5; - optional Account_Id owner_account_id = 7; - optional Branch_NameKey dest = 8; - optional uint32 status = 10; - optional int32 current_patch_set_id = 12; - optional string subject = 13; - optional string topic = 14; - optional string original_subject = 17; - optional string submission_id = 18; - optional Account_Id assignee = 19; - optional bool is_private = 20; - optional bool work_in_progress = 21; - optional bool review_started = 22; - optional Change_Id revert_of = 23; - optional string note_db_state = 101; + required Change_Id change_id = 1; + optional Change_Key change_key = 2; + optional int32 row_version = 3; + optional fixed64 created_on = 4; + optional fixed64 last_updated_on = 5; + optional Account_Id owner_account_id = 7; + optional Branch_NameKey dest = 8; + optional uint32 status = 10; + optional int32 current_patch_set_id = 12; + optional string subject = 13; + optional string topic = 14; + optional string original_subject = 17; + optional string submission_id = 18; + optional Account_Id assignee = 19; + optional bool is_private = 20; + optional bool work_in_progress = 21; + 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; - optional int32 end_line = 3; - optional int32 end_character = 4; + optional int32 start_line = 1; + optional int32 start_character = 2; + optional int32 end_line = 3; + 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; - optional Account_Id author_id = 3; - optional fixed64 written_on = 4; - optional uint32 status = 5; - optional int32 side = 6; - optional string message = 7; - optional string parent_uuid = 8; - optional CommentRange range = 9; - optional string tag = 10; - optional Account_Id real_author = 11; - optional bool unresolved = 12; + required PatchLineComment_Key key = 1; + optional int32 line_nbr = 2; + optional Account_Id author_id = 3; + optional fixed64 written_on = 4; + optional uint32 status = 5; + optional int32 side = 6; + optional string message = 7; + optional string parent_uuid = 8; + optional CommentRange range = 9; + optional string tag = 10; + optional Account_Id real_author = 11; + 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; - optional fixed64 granted = 3; - optional string tag = 6; - optional Account_Id real_account_id = 7; - optional bool post_submit = 8; + required PatchSetApproval_Key key = 1; + optional int32 value = 2; + optional fixed64 granted = 3; + 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; + 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; - optional Account_Id uploader_account_id = 3; - optional fixed64 created_on = 4; - optional string groups = 6; - optional string push_certificate = 8; - optional string description = 9; + required PatchSet_Id id = 1; + optional RevId revision = 2; + optional Account_Id uploader_account_id = 3; + optional fixed64 created_on = 4; + 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; + required CurrentSchemaVersion_Key singleton = 1; + optional int32 version_nbr = 2; }