olai-codegen 0.0.5

Proto-driven code generation for REST handlers, clients, and resource registries
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

syntax = "proto3";
package example.catalog.v1;

import "example_models.proto";
import "google/api/annotations.proto";
import "google/api/resource.proto";

option (google.api.resource_definition) = {
  type: "example.io/Catalog"
  pattern: "catalogs/{catalog}"
  plural: "catalogs"
  singular: "catalog"
};

service CatalogService {
  rpc CreateCatalog(CreateCatalogRequest) returns (Catalog) {
    option (google.api.http) = {
      post: "/catalogs"
      body: "*"
    };
  }
  rpc GetCatalog(GetCatalogRequest) returns (Catalog) {
    option (google.api.http) = {get: "/catalogs/{name}"};
  }
  rpc ListCatalogs(ListCatalogsRequest) returns (ListCatalogsResponse) {
    option (google.api.http) = {get: "/catalogs"};
  }
  rpc UpdateCatalog(UpdateCatalogRequest) returns (Catalog) {
    option (google.api.http) = {
      patch: "/catalogs/{name}"
      body: "*"
    };
  }
  rpc DeleteCatalog(DeleteCatalogRequest) returns (DeleteCatalogResponse) {
    option (google.api.http) = {delete: "/catalogs/{name}"};
  }

  // Custom POST RPC without path params — covers `RequestType::Custom(Post)`
  // dispatched as a collection method (the shape used by factory-style
  // RPCs like `GenerateTemporary*Credentials`).
  rpc GenerateCatalogToken(GenerateCatalogTokenRequest) returns (CatalogToken) {
    option (google.api.http) = {
      post: "/catalog-tokens"
      body: "*"
    };
  }

  // Resource-targeted custom GET (path param, not a collection method) — exercises surfacing a
  // custom read on the scoped client (`catalog.get_catalog_status()`) instead of leaving its
  // generated builder orphaned.
  rpc GetCatalogStatus(GetCatalogStatusRequest) returns (CatalogStatus) {
    option (google.api.http) = {get: "/catalogs/{name}/status"};
  }
}

message CreateCatalogRequest {
  Catalog catalog = 1;
}

message GetCatalogRequest {
  string name = 1;
}

message ListCatalogsRequest {
  int32 max_results = 1;
  string page_token = 2;
}

message ListCatalogsResponse {
  repeated Catalog catalogs = 1;
  string next_page_token = 2;
}

message UpdateCatalogRequest {
  string name = 1;
  Catalog catalog = 2;
}

message DeleteCatalogRequest {
  string name = 1;
}

message DeleteCatalogResponse {}

message GenerateCatalogTokenRequest {
  string catalog_id = 1;
}

message CatalogToken {
  string token = 1;
}

message GetCatalogStatusRequest {
  string name = 1;
}

message CatalogStatus {
  string state = 1;
}