chore: buf format

docs/apidocs.swagger.yaml

@@ -301,12 +301,16 @@ paths:
           type: integer
           format: int32
         - name: pageToken
-          description: "A page token, received from a previous `ListMemos` call.\r\nProvide this to retrieve the subsequent page."
+          description: |-
+            A page token, received from a previous `ListMemos` call.
+            Provide this to retrieve the subsequent page.
           in: query
           required: false
           type: string
         - name: filter
-          description: "Filter is used to filter memos returned in the list.\r\nFormat: \"creator == 'users/{uid}' && visibilities == ['PUBLIC', 'PROTECTED']\""
+          description: |-
+            Filter is used to filter memos returned in the list.
+            Format: "creator == 'users/{uid}' && visibilities == ['PUBLIC', 'PROTECTED']"
           in: query
           required: false
           type: string
@@ -347,12 +351,17 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "name is the name of the user to get stats for.\r\nFormat: users/{id}"
+          description: |-
+            name is the name of the user to get stats for.
+            Format: users/{id}
           in: query
           required: false
           type: string
         - name: timezone
-          description: "timezone location\r\nFormat: uses tz identifier\r\nhttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones"
+          description: |-
+            timezone location
+            Format: uses tz identifier
+            https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
           in: query
           required: false
           type: string
@@ -399,7 +408,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: filter
-          description: "Filter is used to filter memos returned.\r\nFormat: \"creator == 'users/{uid}' && visibilities == ['PUBLIC', 'PROTECTED']\""
+          description: |-
+            Filter is used to filter memos returned.
+            Format: "creator == 'users/{uid}' && visibilities == ['PUBLIC', 'PROTECTED']"
           in: query
           required: false
           type: string
@@ -532,7 +543,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: filter
-          description: "Filter is used to filter users returned in the list.\r\nFormat: \"username == 'frank'\""
+          description: |-
+            Filter is used to filter users returned in the list.
+            Format: "username == 'frank'"
           in: query
           required: false
           type: string
@@ -693,7 +706,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The resource name of the workspace setting.\r\nFormat: settings/{setting}"
+          description: |-
+            The resource name of the workspace setting.
+            Format: settings/{setting}
           in: path
           required: true
           type: string
@@ -715,7 +730,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: setting.name
-          description: "name is the name of the setting.\r\nFormat: settings/{setting}"
+          description: |-
+            name is the name of the setting.
+            Format: settings/{setting}
           in: path
           required: true
           type: string
@@ -751,7 +768,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: identityProvider.name
-          description: "The name of the identityProvider.\r\nFormat: identityProviders/{id}"
+          description: |-
+            The name of the identityProvider.
+            Format: identityProviders/{id}
           in: path
           required: true
           type: string
@@ -789,7 +808,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: inbox.name
-          description: "The name of the inbox.\r\nFormat: inboxes/{id}"
+          description: |-
+            The name of the inbox.
+            Format: inboxes/{id}
           in: path
           required: true
           type: string
@@ -833,7 +854,10 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: memo.name
-          description: "The name of the memo.\r\nFormat: memos/{id}\r\nid is the system generated id."
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
+            id is the system generated id.
           in: path
           required: true
           type: string
@@ -851,7 +875,9 @@ paths:
                 $ref: '#/definitions/v1RowStatus'
               creator:
                 type: string
-                title: "The name of the creator.\r\nFormat: users/{id}"
+                title: |-
+                  The name of the creator.
+                  Format: users/{id}
               createTime:
                 type: string
                 format: date-time
@@ -904,7 +930,9 @@ paths:
                 readOnly: true
               parent:
                 type: string
-                title: "The name of the parent memo.\r\nFormat: memos/{id}"
+                title: |-
+                  The name of the parent memo.
+                  Format: memos/{id}
                 readOnly: true
       tags:
         - MemoService
@@ -923,7 +951,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_1
-          description: "The name of the identityProvider to get.\r\nFormat: identityProviders/{id}"
+          description: |-
+            The name of the identityProvider to get.
+            Format: identityProviders/{id}
           in: path
           required: true
           type: string
@@ -945,7 +975,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_1
-          description: "The name of the identityProvider to delete.\r\nFormat: identityProviders/{id}"
+          description: |-
+            The name of the identityProvider to delete.
+            Format: identityProviders/{id}
           in: path
           required: true
           type: string
@@ -967,7 +999,10 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_2
-          description: "The name of the resource.\r\nFormat: resources/{id}\r\nid is the system generated unique identifier."
+          description: |-
+            The name of the resource.
+            Format: resources/{id}
+            id is the system generated unique identifier.
           in: path
           required: true
           type: string
@@ -989,7 +1024,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_2
-          description: "The name of the inbox to delete.\r\nFormat: inboxes/{id}"
+          description: |-
+            The name of the inbox to delete.
+            Format: inboxes/{id}
           in: path
           required: true
           type: string
@@ -1011,7 +1048,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_3
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1033,7 +1072,10 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_3
-          description: "The name of the resource.\r\nFormat: resources/{id}\r\nid is the system generated unique identifier."
+          description: |-
+            The name of the resource.
+            Format: resources/{id}
+            id is the system generated unique identifier.
           in: path
           required: true
           type: string
@@ -1056,7 +1098,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name_4
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1078,7 +1122,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1100,7 +1146,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1122,7 +1170,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1143,7 +1193,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1171,7 +1223,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1198,7 +1252,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1219,7 +1275,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1246,7 +1304,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}. Use \"memos/-\" to list all properties."
+          description: |-
+            The name of the memo.
+            Format: memos/{id}. Use "memos/-" to list all properties.
           in: path
           required: true
           type: string
@@ -1269,7 +1329,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}. Use \"memos/-\" to rebuild all memos."
+          description: |-
+            The name of the memo.
+            Format: memos/{id}. Use "memos/-" to rebuild all memos.
           in: path
           required: true
           type: string
@@ -1296,7 +1358,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1317,7 +1381,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1344,7 +1410,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1366,7 +1434,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1393,7 +1463,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1415,7 +1487,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the memo.\r\nFormat: memos/{id}"
+          description: |-
+            The name of the memo.
+            Format: memos/{id}
           in: path
           required: true
           type: string
@@ -1442,7 +1516,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1464,13 +1540,17 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: parent
-          description: "The parent, who owns the tags.\r\nFormat: memos/{id}. Use \"memos/-\" to list all tags."
+          description: |-
+            The parent, who owns the tags.
+            Format: memos/{id}. Use "memos/-" to list all tags.
           in: path
           required: true
           type: string
           pattern: memos/[^/]+
         - name: filter
-          description: "Filter is used to filter memos.\r\nFormat: \"creator == 'users/{uid}' && visibilities == ['PUBLIC', 'PROTECTED']\""
+          description: |-
+            Filter is used to filter memos.
+            Format: "creator == 'users/{uid}' && visibilities == ['PUBLIC', 'PROTECTED']"
           in: query
           required: false
           type: string
@@ -1492,7 +1572,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: parent
-          description: "The parent, who owns the tags.\r\nFormat: memos/{id}. Use \"memos/-\" to delete all tags."
+          description: |-
+            The parent, who owns the tags.
+            Format: memos/{id}. Use "memos/-" to delete all tags.
           in: path
           required: true
           type: string
@@ -1523,7 +1605,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: parent
-          description: "The parent, who owns the tags.\r\nFormat: memos/{id}. Use \"memos/-\" to rename all tags."
+          description: |-
+            The parent, who owns the tags.
+            Format: memos/{id}. Use "memos/-" to rename all tags.
           in: path
           required: true
           type: string
@@ -1550,7 +1634,10 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: resource.name
-          description: "The name of the resource.\r\nFormat: resources/{id}\r\nid is the system generated unique identifier."
+          description: |-
+            The name of the resource.
+            Format: resources/{id}
+            id is the system generated unique identifier.
           in: path
           required: true
           type: string
@@ -1582,7 +1669,9 @@ paths:
                 format: int64
               memo:
                 type: string
-                title: "The related memo.\r\nFormat: memos/{id}"
+                title: |-
+                  The related memo.
+                  Format: memos/{id}
       tags:
         - ResourceService
   /api/v1/{setting.name}:
@@ -1600,7 +1689,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: setting.name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1637,7 +1728,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: user.name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1691,7 +1784,9 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the user.\r\nFormat: users/{id}"
+          description: |-
+            The name of the user.
+            Format: users/{id}
           in: path
           required: true
           type: string
@@ -1724,7 +1819,10 @@ paths:
             $ref: '#/definitions/googlerpcStatus'
       parameters:
         - name: name
-          description: "The name of the resource.\r\nFormat: resources/{id}\r\nid is the system generated unique identifier."
+          description: |-
+            The name of the resource.
+            Format: resources/{id}
+            id is the system generated unique identifier.
           in: path
           required: true
           type: string
@@ -1905,7 +2003,9 @@ definitions:
     properties:
       name:
         type: string
-        title: "The name of the identityProvider.\r\nFormat: identityProviders/{id}"
+        title: |-
+          The name of the identityProvider.
+          Format: identityProviders/{id}
       type:
         $ref: '#/definitions/apiv1IdentityProviderType'
       title:
@@ -1949,7 +2049,9 @@ definitions:
     properties:
       name:
         type: string
-        title: "The name of the user.\r\nFormat: users/{id}"
+        title: |-
+          The name of the user.
+          Format: users/{id}
       locale:
         type: string
         description: The preferred locale of the user.
@@ -2008,7 +2110,9 @@ definitions:
     properties:
       name:
         type: string
-        title: "name is the name of the setting.\r\nFormat: settings/{setting}"
+        title: |-
+          name is the name of the setting.
+          Format: settings/{setting}
       generalSetting:
         $ref: '#/definitions/apiv1WorkspaceGeneralSetting'
       storageSetting:
@@ -2023,7 +2127,9 @@ definitions:
         description: storage_type is the storage type.
       filepathTemplate:
         type: string
-        title: "The template of file path.\r\ne.g. assets/{timestamp}_{filename}"
+        title: |-
+          The template of file path.
+          e.g. assets/{timestamp}_{filename}
       uploadSizeLimitMb:
         type: string
         format: int64
@@ -2292,7 +2398,9 @@ definitions:
         additionalProperties:
           type: integer
           format: int32
-        description: "stats is the stats of memo creating/updating activities.\r\nkey is the year-month-day string. e.g. \"2020-01-01\"."
+        description: |-
+          stats is the stats of memo creating/updating activities.
+          key is the year-month-day string. e.g. "2020-01-01".
   v1HeadingNode:
     type: object
     properties:
@@ -2326,7 +2434,9 @@ definitions:
     properties:
       name:
         type: string
-        title: "The name of the inbox.\r\nFormat: inboxes/{id}"
+        title: |-
+          The name of the inbox.
+          Format: inboxes/{id}
       sender:
         type: string
         title: 'Format: users/{id}'
@@ -2446,7 +2556,10 @@ definitions:
         additionalProperties:
           type: integer
           format: int32
-        description: "tag_amounts is the amount of tags.\r\nkey is the tag name. e.g. \"tag1\".\r\nvalue is the amount of the tag."
+        description: |-
+          tag_amounts is the amount of tags.
+          key is the tag name. e.g. "tag1".
+          value is the amount of the tag.
   v1ListMemosResponse:
     type: object
     properties:
@@ -2457,7 +2570,9 @@ definitions:
           $ref: '#/definitions/v1Memo'
       nextPageToken:
         type: string
-        description: "A token, which can be sent as `page_token` to retrieve the next page.\r\nIf this field is omitted, there are no subsequent pages."
+        description: |-
+          A token, which can be sent as `page_token` to retrieve the next page.
+          If this field is omitted, there are no subsequent pages.
   v1ListResourcesResponse:
     type: object
     properties:
@@ -2505,7 +2620,10 @@ definitions:
     properties:
       name:
         type: string
-        description: "The name of the memo.\r\nFormat: memos/{id}\r\nid is the system generated id."
+        description: |-
+          The name of the memo.
+          Format: memos/{id}
+          id is the system generated id.
       uid:
         type: string
         description: The user defined id of the memo.
@@ -2513,7 +2631,9 @@ definitions:
         $ref: '#/definitions/v1RowStatus'
       creator:
         type: string
-        title: "The name of the creator.\r\nFormat: users/{id}"
+        title: |-
+          The name of the creator.
+          Format: users/{id}
       createTime:
         type: string
         format: date-time
@@ -2566,7 +2686,9 @@ definitions:
         readOnly: true
       parent:
         type: string
-        title: "The name of the parent memo.\r\nFormat: memos/{id}"
+        title: |-
+          The name of the parent memo.
+          Format: memos/{id}
         readOnly: true
   v1MemoProperty:
     type: object
@@ -2588,10 +2710,14 @@ definitions:
     properties:
       memo:
         type: string
-        title: "The name of memo.\r\nFormat: \"memos/{uid}\""
+        title: |-
+          The name of memo.
+          Format: "memos/{uid}"
       relatedMemo:
         type: string
-        title: "The name of related memo.\r\nFormat: \"memos/{uid}\""
+        title: |-
+          The name of related memo.
+          Format: "memos/{uid}"
       type:
         $ref: '#/definitions/v1MemoRelationType'
   v1MemoRelationType:
@@ -2740,7 +2866,9 @@ definitions:
         format: int32
       creator:
         type: string
-        title: "The name of the creator.\r\nFormat: users/{id}"
+        title: |-
+          The name of the creator.
+          Format: users/{id}
       contentId:
         type: string
       reactionType:
@@ -2774,7 +2902,10 @@ definitions:
     properties:
       name:
         type: string
-        description: "The name of the resource.\r\nFormat: resources/{id}\r\nid is the system generated unique identifier."
+        description: |-
+          The name of the resource.
+          Format: resources/{id}
+          id is the system generated unique identifier.
       uid:
         type: string
         description: The user defined id of the resource.
@@ -2796,7 +2927,9 @@ definitions:
         format: int64
       memo:
         type: string
-        title: "The related memo.\r\nFormat: memos/{id}"
+        title: |-
+          The related memo.
+          Format: memos/{id}
   v1RestoreMarkdownRequest:
     type: object
     properties:
@@ -2920,7 +3053,9 @@ definitions:
     properties:
       name:
         type: string
-        title: "The name of the user.\r\nFormat: users/{id}"
+        title: |-
+          The name of the user.
+          Format: users/{id}
       id:
         type: integer
         format: int32
@@ -2994,7 +3129,9 @@ definitions:
     properties:
       owner:
         type: string
-        title: "The name of instance owner.\r\nFormat: \"users/{id}\""
+        title: |-
+          The name of instance owner.
+          Format: "users/{id}"
       version:
         type: string
         title: version is the current version of instance

proto/api/v1/idp_service.proto

@@ -22,7 +22,7 @@ service IdentityProviderService {
   // CreateIdentityProvider creates an identity provider.
   rpc CreateIdentityProvider(CreateIdentityProviderRequest) returns (IdentityProvider) {
     option (google.api.http) = {
-      post: "/api/v1/identityProviders",
+      post: "/api/v1/identityProviders"
       body: "identity_provider"
     };
   }

proto/api/v1/memo_service.proto

@@ -53,7 +53,7 @@ service MemoService {
   // ExportMemos exports memos.
   rpc ExportMemos(ExportMemosRequest) returns (ExportMemosResponse) {
     option (google.api.http) = {
-      post: "/api/v1/memos:export",
+      post: "/api/v1/memos:export"
       body: "*"
     };
   }
@@ -112,7 +112,7 @@ service MemoService {
   // CreateMemoComment creates a comment for a memo.
   rpc CreateMemoComment(CreateMemoCommentRequest) returns (Memo) {
     option (google.api.http) = {
-      post: "/api/v1/{name=memos/*}/comments",
+      post: "/api/v1/{name=memos/*}/comments"
       body: "comment"
     };
     option (google.api.method_signature) = "name";
@@ -135,7 +135,7 @@ service MemoService {
   // UpsertMemoReaction upserts a reaction for a memo.
   rpc UpsertMemoReaction(UpsertMemoReactionRequest) returns (Reaction) {
     option (google.api.http) = {
-      post: "/api/v1/{name=memos/*}/reactions",
+      post: "/api/v1/{name=memos/*}/reactions"
       body: "*"
     };
     option (google.api.method_signature) = "name";

proto/api/v1/resource_service.proto

@@ -16,7 +16,7 @@ service ResourceService {
   // CreateResource creates a new resource.
   rpc CreateResource(CreateResourceRequest) returns (Resource) {
     option (google.api.http) = {
-      post: "/api/v1/resources",
+      post: "/api/v1/resources"
       body: "resource"
     };
   }
@@ -41,7 +41,7 @@ service ResourceService {
   // UpdateResource updates a resource.
   rpc UpdateResource(UpdateResourceRequest) returns (Resource) {
     option (google.api.http) = {
-      patch: "/api/v1/{resource.name=resources/*}",
+      patch: "/api/v1/{resource.name=resources/*}"
       body: "resource"
     };
     option (google.api.method_signature) = "resource,update_mask";

proto/api/v1/workspace_setting_service.proto

@@ -17,7 +17,7 @@ service WorkspaceSettingService {
   // SetWorkspaceSetting updates the setting.
   rpc SetWorkspaceSetting(SetWorkspaceSettingRequest) returns (WorkspaceSetting) {
     option (google.api.http) = {
-      patch: "/api/v1/workspace/{setting.name=settings/*}",
+      patch: "/api/v1/workspace/{setting.name=settings/*}"
       body: "setting"
     };
     option (google.api.method_signature) = "setting";