feat(clients): ops: 20 Google Cloud operations APIs, 418 Discovery-derived calls

Compute, Cloud Run, Functions, GKE, Build, Artifact Registry, IAM, IAM
Credentials, Resource Manager, Service Usage, Logging, Monitoring, Scheduler,
Tasks, Workflows, Eventarc, Billing, Asset, Org Policy. Generated call table
checked against Discovery, validated plans, dry-run default for writes
(enable/disable never live), /google/ops demo routes, live read-only probe.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-25 15:23:56 +01:00
co-authored by Claude Sonnet 5.5
parent 3db67fcf1f
commit 18ec8b720e
46 changed files with 4702 additions and 3 deletions
+67
View File
@@ -0,0 +1,67 @@
#pragma once
// The ONE table of REST calls the ops package makes (calls.cpp, generated from
// Google's Discovery documents by tools/gen_calls.py and re-checked by
// tools/check_discovery.py). Code builds every URL from this table, never from
// a literal. The rpc id is Discovery's method id (`run.projects.locations.services.get`).
#include <cstddef>
#include <string>
#include <string_view>
#include "clients/request.h"
#include "google/endpoints.h"
namespace molo::google::ops {
struct Product {
const char* name; // discovery name, also the rpc id prefix
const char* version; // v1, v2, v3
const char* root_url; // https://run.googleapis.com (no trailing slash)
const char* service_path; // "compute/v1" or "" when the path carries the version
const char* revision; // discovery revision the table was generated from
};
// Read never changes state. Write changes or creates state. Destructive
// deletes or irreversibly stops something: callers have no default.
enum class Safety { kRead, kWrite, kDestructive };
struct CallSpec {
const char* rpc;
const char* http; // GET POST PATCH PUT DELETE
const char* path; // discovery path, e.g. "v2/{+parent}/services"
const char* safety; // "R" "W" "D"
const char* kind; // "" | "lro" (google.longrunning) | "compute" (compute Operation)
const char* items_key; // list response array, "" when not a list call
const char* body_fields; // comma list: request body top level fields
const char* query_params; // comma list
const char* path_shapes; // "name=projects/*/locations/*" per path parameter, space separated
Safety safe() const;
clients::Method method() const;
std::string product() const; // rpc prefix
bool has_body_field(std::string_view f) const;
bool has_query(std::string_view q) const;
bool is_list() const { return items_key[0] != '\0'; }
bool is_lro() const { return std::string_view(kind) == "lro"; }
bool is_compute_operation() const { return std::string_view(kind) == "compute"; }
// Empty when the parameter has no declared shape.
std::string shape_of(std::string_view param) const;
};
const Product* products();
std::size_t product_count();
const CallSpec* call_table();
std::size_t call_count();
// Throws GoogleError::invalid for an unknown name.
const Product& product_named(const std::string& name);
const CallSpec& call_named(const std::string& rpc);
const CallSpec* find_call(const std::string& rpc);
// Where requests go: root_url + service_path. The table path is appended.
ServiceEndpoint endpoint_of(const Product& p);
// Where google.longrunning operation names are polled: root_url + "/" + version.
ServiceEndpoint operation_endpoint_of(const Product& p);
} // namespace molo::google::ops