fastgrpc3 0.1.0__py3-none-any.whl

fastgrpc3/__init__.py

@@ -0,0 +1,75 @@
+"""fastgrpc3: a FastAPI-like gRPC framework for Python, powered by protoruf."""
+
+from fastgrpc3.api.app import GrpcApp
+from fastgrpc3.api.client import Channel, GrpcClient
+from fastgrpc3.api.config import Compression, Keepalive, RetryPolicy
+from fastgrpc3.api.context import Context
+from fastgrpc3.api.deps import Depends, blocking, non_blocking
+from fastgrpc3.api.errors import (
+    BadRequest,
+    ErrorInfo,
+    FieldViolation,
+    GrpcError,
+    StatusCode,
+    register_detail,
+)
+from fastgrpc3.api.metadata import Metadata
+from fastgrpc3.api.security import MTLS, TLS, BearerToken, Insecure
+from fastgrpc3.api.service import GrpcService
+from fastgrpc3.runtime.dispatch import CallNext
+from fastgrpc3.schema import (
+    Lock,
+    LockError,
+    MethodDef,
+    Schema,
+    SchemaError,
+    SchemaRegistry,
+    ServiceDef,
+)
+from fastgrpc3.transport import Transport, TransportCapabilities, available_transports
+from fastgrpc3.types import ProtoEnum, ProtoField, ProtoModel, field, key, proto_enum
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "MTLS",
+    "TLS",
+    "BadRequest",
+    "BearerToken",
+    "CallNext",
+    "Channel",
+    "Compression",
+    "Context",
+    "Depends",
+    "ErrorInfo",
+    "FieldViolation",
+    "GrpcApp",
+    "GrpcClient",
+    "GrpcError",
+    "GrpcService",
+    "Insecure",
+    "Keepalive",
+    "Lock",
+    "LockError",
+    "Metadata",
+    "MethodDef",
+    "ProtoEnum",
+    "ProtoField",
+    "ProtoModel",
+    "RetryPolicy",
+    "Schema",
+    "SchemaError",
+    "SchemaRegistry",
+    "ServiceDef",
+    "StatusCode",
+    "Transport",
+    "TransportCapabilities",
+    "__version__",
+    "available_transports",
+    "blocking",
+    "field",
+    "key",
+    "non_blocking",
+    "proto_enum",
+    "register_detail",
+]

fastgrpc3/__main__.py

@@ -0,0 +1,7 @@
+"""`python -m fastgrpc3`: same as the `fastgrpc3` command."""
+
+import sys
+
+from fastgrpc3.cli import main
+
+sys.exit(main())

fastgrpc3/_proto/__init__.py

@@ -0,0 +1 @@
+# Generated by fastgrpc3: do not edit.

fastgrpc3/_proto/_descriptor.py

@@ -0,0 +1,130 @@
+# Generated by fastgrpc3: do not edit.
+"""Compiled descriptor of the generated modules (without source info)."""
+
+DESCRIPTOR = (
+    b"\x0a\xbf\x03\x0a\x15google/rpc/code.proto\x12\x0agoogle.rpc*\xb7\x02\x0a\x04Code\x12\x06\x0a"
+    b"\x02OK\x10\x00\x12\x0d\x0a\x09CANCELLED\x10\x01\x12\x0b\x0a\x07UNKNOWN\x10\x02\x12\x14\x0a"
+    b"\x10INVALID_ARGUMENT\x10\x03\x12\x15\x0a\x11DEADLINE_EXCEEDED\x10\x04\x12\x0d\x0a\x09NOT_FOUN"
+    b"D\x10\x05\x12\x12\x0a\x0eALREADY_EXISTS\x10\x06\x12\x15\x0a\x11PERMISSION_DENIED\x10\x07\x12"
+    b"\x13\x0a\x0fUNAUTHENTICATED\x10\x10\x12\x16\x0a\x12RESOURCE_EXHAUSTED\x10\x08\x12\x17\x0a\x13"
+    b"FAILED_PRECONDITION\x10\x09\x12\x0b\x0a\x07ABORTED\x10\x0a\x12\x10\x0a\x0cOUT_OF_RANGE\x10"
+    b"\x0b\x12\x11\x0a\x0dUNIMPLEMENTED\x10\x0c\x12\x0c\x0a\x08INTERNAL\x10\x0d\x12\x0f\x0a\x0bUNAV"
+    b"AILABLE\x10\x0e\x12\x0d\x0a\x09DATA_LOSS\x10\x0fBX\x0a\x0ecom.google.rpcB\x09CodeProtoP\x01Z3"
+    b"google.golang.org/genproto/googleapis/rpc/code;code\xa2\x02\x03RPCb\x06proto3\x0a\xfb\x01\x0a"
+    b"\x1egoogle/protobuf/duration.proto\x12\x0fgoogle.protobuf\x22:\x0a\x08Duration\x12\x18\x0a"
+    b"\x07seconds\x18\x01 \x01(\x03R\x07seconds\x12\x14\x0a\x05nanos\x18\x02 \x01(\x05R\x05nanosB"
+    b"\x83\x01\x0a\x13com.google.protobufB\x0dDurationProtoP\x01Z1google.golang.org/protobuf/types/"
+    b"known/durationpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06pro"
+    b"to3\x0a\x8c\x0f\x0a\x1egoogle/rpc/error_details.proto\x12\x0agoogle.rpc\x1a\x1egoogle/protobu"
+    b"f/duration.proto\x22\xb9\x01\x0a\x09ErrorInfo\x12\x16\x0a\x06reason\x18\x01 \x01(\x09R\x06rea"
+    b"son\x12\x16\x0a\x06domain\x18\x02 \x01(\x09R\x06domain\x12?\x0a\x08metadata\x18\x03 \x03(\x0b"
+    b"2#.google.rpc.ErrorInfo.MetadataEntryR\x08metadata\x1a;\x0a\x0dMetadataEntry\x12\x10\x0a\x03k"
+    b"ey\x18\x01 \x01(\x09R\x03key\x12\x14\x0a\x05value\x18\x02 \x01(\x09R\x05value:\x028\x01\x22G"
+    b"\x0a\x09RetryInfo\x12:\x0a\x0bretry_delay\x18\x01 \x01(\x0b2\x19.google.protobuf.DurationR"
+    b"\x0aretryDelay\x22H\x0a\x09DebugInfo\x12#\x0a\x0dstack_entries\x18\x01 \x03(\x09R\x0cstackEnt"
+    b"ries\x12\x16\x0a\x06detail\x18\x02 \x01(\x09R\x06detail\x22\x8e\x04\x0a\x0cQuotaFailure\x12B"
+    b"\x0a\x0aviolations\x18\x01 \x03(\x0b2\x22.google.rpc.QuotaFailure.ViolationR\x0aviolations"
+    b"\x1a\xb9\x03\x0a\x09Violation\x12\x18\x0a\x07subject\x18\x01 \x01(\x09R\x07subject\x12 \x0a"
+    b"\x0bdescription\x18\x02 \x01(\x09R\x0bdescription\x12\x1f\x0a\x0bapi_service\x18\x03 \x01("
+    b"\x09R\x0aapiService\x12!\x0a\x0cquota_metric\x18\x04 \x01(\x09R\x0bquotaMetric\x12\x19\x0a"
+    b"\x08quota_id\x18\x05 \x01(\x09R\x07quotaId\x12b\x0a\x10quota_dimensions\x18\x06 \x03(\x0b27.g"
+    b"oogle.rpc.QuotaFailure.Violation.QuotaDimensionsEntryR\x0fquotaDimensions\x12\x1f\x0a\x0bquot"
+    b"a_value\x18\x07 \x01(\x03R\x0aquotaValue\x121\x0a\x12future_quota_value\x18\x08 \x01(\x03H"
+    b"\x00R\x10futureQuotaValue\x88\x01\x01\x1aB\x0a\x14QuotaDimensionsEntry\x12\x10\x0a\x03key\x18"
+    b"\x01 \x01(\x09R\x03key\x12\x14\x0a\x05value\x18\x02 \x01(\x09R\x05value:\x028\x01B\x15\x0a"
+    b"\x13_future_quota_value\x22\xbd\x01\x0a\x13PreconditionFailure\x12I\x0a\x0aviolations\x18\x01"
+    b" \x03(\x0b2).google.rpc.PreconditionFailure.ViolationR\x0aviolations\x1a[\x0a\x09Violation"
+    b"\x12\x12\x0a\x04type\x18\x01 \x01(\x09R\x04type\x12\x18\x0a\x07subject\x18\x02 \x01(\x09R\x07"
+    b"subject\x12 \x0a\x0bdescription\x18\x03 \x01(\x09R\x0bdescription\x22\x8c\x02\x0a\x0aBadReque"
+    b"st\x12P\x0a\x10field_violations\x18\x01 \x03(\x0b2%.google.rpc.BadRequest.FieldViolationR\x0f"
+    b"fieldViolations\x1a\xab\x01\x0a\x0eFieldViolation\x12\x14\x0a\x05field\x18\x01 \x01(\x09R\x05"
+    b"field\x12 \x0a\x0bdescription\x18\x02 \x01(\x09R\x0bdescription\x12\x16\x0a\x06reason\x18\x03"
+    b" \x01(\x09R\x06reason\x12I\x0a\x11localized_message\x18\x04 \x01(\x0b2\x1c.google.rpc.Localiz"
+    b"edMessageR\x10localizedMessage\x22O\x0a\x0bRequestInfo\x12\x1d\x0a\x0arequest_id\x18\x01 \x01"
+    b"(\x09R\x09requestId\x12!\x0a\x0cserving_data\x18\x02 \x01(\x09R\x0bservingData\x22\x90\x01"
+    b"\x0a\x0cResourceInfo\x12#\x0a\x0dresource_type\x18\x01 \x01(\x09R\x0cresourceType\x12#\x0a"
+    b"\x0dresource_name\x18\x02 \x01(\x09R\x0cresourceName\x12\x14\x0a\x05owner\x18\x03 \x01(\x09R"
+    b"\x05owner\x12 \x0a\x0bdescription\x18\x04 \x01(\x09R\x0bdescription\x22o\x0a\x04Help\x12+\x0a"
+    b"\x05links\x18\x01 \x03(\x0b2\x15.google.rpc.Help.LinkR\x05links\x1a:\x0a\x04Link\x12 \x0a\x0b"
+    b"description\x18\x01 \x01(\x09R\x0bdescription\x12\x10\x0a\x03url\x18\x02 \x01(\x09R\x03url"
+    b"\x22D\x0a\x10LocalizedMessage\x12\x16\x0a\x06locale\x18\x01 \x01(\x09R\x06locale\x12\x18\x0a"
+    b"\x07message\x18\x02 \x01(\x09R\x07messageBl\x0a\x0ecom.google.rpcB\x11ErrorDetailsProtoP\x01Z"
+    b"?google.golang.org/genproto/googleapis/rpc/errdetails;errdetails\xa2\x02\x03RPCb\x06proto3"
+    b"\x0a\xe4\x01\x0a\x19google/protobuf/any.proto\x12\x0fgoogle.protobuf\x226\x0a\x03Any\x12\x19"
+    b"\x0a\x08type_url\x18\x01 \x01(\x09R\x07typeUrl\x12\x14\x0a\x05value\x18\x02 \x01(\x0cR\x05val"
+    b"ueBv\x0a\x13com.google.protobufB\x08AnyProtoP\x01Z,google.golang.org/protobuf/types/known/any"
+    b"pb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3\x0a\x90\x02\x0a\x17goo"
+    b"gle/rpc/status.proto\x12\x0agoogle.rpc\x1a\x19google/protobuf/any.proto\x22f\x0a\x06Status"
+    b"\x12\x12\x0a\x04code\x18\x01 \x01(\x05R\x04code\x12\x18\x0a\x07message\x18\x02 \x01(\x09R\x07"
+    b"message\x12.\x0a\x07details\x18\x03 \x03(\x0b2\x14.google.protobuf.AnyR\x07detailsB^\x0a\x0ec"
+    b"om.google.rpcB\x0bStatusProtoP\x01Z7google.golang.org/genproto/googleapis/rpc/status;status"
+    b"\xa2\x02\x03RPCb\x06proto3\x0a\xe7\x06\x0a\x1bgrpc/health/v1/health.proto\x12\x0egrpc.health."
+    b"v1\x22.\x0a\x12HealthCheckRequest\x12\x18\x0a\x07service\x18\x01 \x01(\x09R\x07service\x22"
+    b"\xb1\x01\x0a\x13HealthCheckResponse\x12I\x0a\x06status\x18\x01 \x01(\x0e21.grpc.health.v1.Hea"
+    b"lthCheckResponse.ServingStatusR\x06status\x22O\x0a\x0dServingStatus\x12\x0b\x0a\x07UNKNOWN"
+    b"\x10\x00\x12\x0b\x0a\x07SERVING\x10\x01\x12\x0f\x0a\x0bNOT_SERVING\x10\x02\x12\x13\x0a\x0fSER"
+    b"VICE_UNKNOWN\x10\x03\x22\x13\x0a\x11HealthListRequest\x22\xc4\x01\x0a\x12HealthListResponse"
+    b"\x12L\x0a\x08statuses\x18\x01 \x03(\x0b20.grpc.health.v1.HealthListResponse.StatusesEntryR"
+    b"\x08statuses\x1a`\x0a\x0dStatusesEntry\x12\x10\x0a\x03key\x18\x01 \x01(\x09R\x03key\x129\x0a"
+    b"\x05value\x18\x02 \x01(\x0b2#.grpc.health.v1.HealthCheckResponseR\x05value:\x028\x012\xfd\x01"
+    b"\x0a\x06Health\x12P\x0a\x05Check\x12\x22.grpc.health.v1.HealthCheckRequest\x1a#.grpc.health.v"
+    b"1.HealthCheckResponse\x12M\x0a\x04List\x12!.grpc.health.v1.HealthListRequest\x1a\x22.grpc.hea"
+    b"lth.v1.HealthListResponse\x12R\x0a\x05Watch\x12\x22.grpc.health.v1.HealthCheckRequest\x1a#.gr"
+    b"pc.health.v1.HealthCheckResponse0\x01Bp\x0a\x11io.grpc.health.v1B\x0bHealthProtoP\x01Z,google"
+    b".golang.org/grpc/health/grpc_health_v1\xa2\x02\x0cGrpcHealthV1\xaa\x02\x0eGrpc.Health.V1b\x06"
+    b"proto3\x0a\xd0\x0d\x0a#grpc/reflection/v1/reflection.proto\x12\x12grpc.reflection.v1\x22\xf3"
+    b"\x02\x0a\x17ServerReflectionRequest\x12\x12\x0a\x04host\x18\x01 \x01(\x09R\x04host\x12*\x0a"
+    b"\x10file_by_filename\x18\x03 \x01(\x09H\x00R\x0efileByFilename\x126\x0a\x16file_containing_sy"
+    b"mbol\x18\x04 \x01(\x09H\x00R\x14fileContainingSymbol\x12b\x0a\x19file_containing_extension"
+    b"\x18\x05 \x01(\x0b2$.grpc.reflection.v1.ExtensionRequestH\x00R\x17fileContainingExtension\x12"
+    b"B\x0a\x1dall_extension_numbers_of_type\x18\x06 \x01(\x09H\x00R\x19allExtensionNumbersOfType"
+    b"\x12%\x0a\x0dlist_services\x18\x07 \x01(\x09H\x00R\x0clistServicesB\x11\x0a\x0fmessage_reques"
+    b"t\x22f\x0a\x10ExtensionRequest\x12'\x0a\x0fcontaining_type\x18\x01 \x01(\x09R\x0econtainingTy"
+    b"pe\x12)\x0a\x10extension_number\x18\x02 \x01(\x05R\x0fextensionNumber\x22\xae\x04\x0a\x18Serv"
+    b"erReflectionResponse\x12\x1d\x0a\x0avalid_host\x18\x01 \x01(\x09R\x09validHost\x12V\x0a\x10or"
+    b"iginal_request\x18\x02 \x01(\x0b2+.grpc.reflection.v1.ServerReflectionRequestR\x0foriginalReq"
+    b"uest\x12f\x0a\x18file_descriptor_response\x18\x04 \x01(\x0b2*.grpc.reflection.v1.FileDescript"
+    b"orResponseH\x00R\x16fileDescriptorResponse\x12r\x0a\x1eall_extension_numbers_response\x18\x05"
+    b" \x01(\x0b2+.grpc.reflection.v1.ExtensionNumberResponseH\x00R\x1ballExtensionNumbersResponse"
+    b"\x12_\x0a\x16list_services_response\x18\x06 \x01(\x0b2'.grpc.reflection.v1.ListServiceRespons"
+    b"eH\x00R\x14listServicesResponse\x12J\x0a\x0eerror_response\x18\x07 \x01(\x0b2!.grpc.reflectio"
+    b"n.v1.ErrorResponseH\x00R\x0derrorResponseB\x12\x0a\x10message_response\x22L\x0a\x16FileDescri"
+    b"ptorResponse\x122\x0a\x15file_descriptor_proto\x18\x01 \x03(\x0cR\x13fileDescriptorProto\x22j"
+    b"\x0a\x17ExtensionNumberResponse\x12$\x0a\x0ebase_type_name\x18\x01 \x01(\x09R\x0cbaseTypeName"
+    b"\x12)\x0a\x10extension_number\x18\x02 \x03(\x05R\x0fextensionNumber\x22T\x0a\x13ListServiceRe"
+    b"sponse\x12=\x0a\x07service\x18\x01 \x03(\x0b2#.grpc.reflection.v1.ServiceResponseR\x07service"
+    b"\x22%\x0a\x0fServiceResponse\x12\x12\x0a\x04name\x18\x01 \x01(\x09R\x04name\x22S\x0a\x0dError"
+    b"Response\x12\x1d\x0a\x0aerror_code\x18\x01 \x01(\x05R\x09errorCode\x12#\x0a\x0derror_message"
+    b"\x18\x02 \x01(\x09R\x0cerrorMessage2\x89\x01\x0a\x10ServerReflection\x12u\x0a\x14ServerReflec"
+    b"tionInfo\x12+.grpc.reflection.v1.ServerReflectionRequest\x1a,.grpc.reflection.v1.ServerReflec"
+    b"tionResponse(\x010\x01Bf\x0a\x15io.grpc.reflection.v1B\x15ServerReflectionProtoP\x01Z4google."
+    b"golang.org/grpc/reflection/grpc_reflection_v1b\x06proto3\x0a\x94\x0e\x0a(grpc/reflection/v1al"
+    b"pha/reflection.proto\x12\x17grpc.reflection.v1alpha\x22\xf8\x02\x0a\x17ServerReflectionReques"
+    b"t\x12\x12\x0a\x04host\x18\x01 \x01(\x09R\x04host\x12*\x0a\x10file_by_filename\x18\x03 \x01("
+    b"\x09H\x00R\x0efileByFilename\x126\x0a\x16file_containing_symbol\x18\x04 \x01(\x09H\x00R\x14fi"
+    b"leContainingSymbol\x12g\x0a\x19file_containing_extension\x18\x05 \x01(\x0b2).grpc.reflection."
+    b"v1alpha.ExtensionRequestH\x00R\x17fileContainingExtension\x12B\x0a\x1dall_extension_numbers_o"
+    b"f_type\x18\x06 \x01(\x09H\x00R\x19allExtensionNumbersOfType\x12%\x0a\x0dlist_services\x18\x07"
+    b" \x01(\x09H\x00R\x0clistServicesB\x11\x0a\x0fmessage_request\x22f\x0a\x10ExtensionRequest\x12"
+    b"'\x0a\x0fcontaining_type\x18\x01 \x01(\x09R\x0econtainingType\x12)\x0a\x10extension_number"
+    b"\x18\x02 \x01(\x05R\x0fextensionNumber\x22\xc7\x04\x0a\x18ServerReflectionResponse\x12\x1d"
+    b"\x0a\x0avalid_host\x18\x01 \x01(\x09R\x09validHost\x12[\x0a\x10original_request\x18\x02 \x01("
+    b"\x0b20.grpc.reflection.v1alpha.ServerReflectionRequestR\x0foriginalRequest\x12k\x0a\x18file_d"
+    b"escriptor_response\x18\x04 \x01(\x0b2/.grpc.reflection.v1alpha.FileDescriptorResponseH\x00R"
+    b"\x16fileDescriptorResponse\x12w\x0a\x1eall_extension_numbers_response\x18\x05 \x01(\x0b20.grp"
+    b"c.reflection.v1alpha.ExtensionNumberResponseH\x00R\x1ballExtensionNumbersResponse\x12d\x0a"
+    b"\x16list_services_response\x18\x06 \x01(\x0b2,.grpc.reflection.v1alpha.ListServiceResponseH"
+    b"\x00R\x14listServicesResponse\x12O\x0a\x0eerror_response\x18\x07 \x01(\x0b2&.grpc.reflection."
+    b"v1alpha.ErrorResponseH\x00R\x0derrorResponseB\x12\x0a\x10message_response\x22L\x0a\x16FileDes"
+    b"criptorResponse\x122\x0a\x15file_descriptor_proto\x18\x01 \x03(\x0cR\x13fileDescriptorProto"
+    b"\x22j\x0a\x17ExtensionNumberResponse\x12$\x0a\x0ebase_type_name\x18\x01 \x01(\x09R\x0cbaseTyp"
+    b"eName\x12)\x0a\x10extension_number\x18\x02 \x03(\x05R\x0fextensionNumber\x22Y\x0a\x13ListServ"
+    b"iceResponse\x12B\x0a\x07service\x18\x01 \x03(\x0b2(.grpc.reflection.v1alpha.ServiceResponseR"
+    b"\x07service\x22%\x0a\x0fServiceResponse\x12\x12\x0a\x04name\x18\x01 \x01(\x09R\x04name\x22S"
+    b"\x0a\x0dErrorResponse\x12\x1d\x0a\x0aerror_code\x18\x01 \x01(\x05R\x09errorCode\x12#\x0a\x0de"
+    b"rror_message\x18\x02 \x01(\x09R\x0cerrorMessage2\x93\x01\x0a\x10ServerReflection\x12\x7f\x0a"
+    b"\x14ServerReflectionInfo\x120.grpc.reflection.v1alpha.ServerReflectionRequest\x1a1.grpc.refle"
+    b"ction.v1alpha.ServerReflectionResponse(\x010\x01Bs\x0a\x1aio.grpc.reflection.v1alphaB\x15Serv"
+    b"erReflectionProtoP\x01Z9google.golang.org/grpc/reflection/grpc_reflection_v1alpha\xb8\x01\x01"
+    b"b\x06proto3"
+)

fastgrpc3/_proto/google/__init__.py

@@ -0,0 +1 @@
+# Generated by fastgrpc3: do not edit.

fastgrpc3/_proto/google/rpc/__init__.py

@@ -0,0 +1 @@
+# Generated by fastgrpc3: do not edit.

fastgrpc3/_proto/google/rpc/code_models.py

@@ -0,0 +1,155 @@
+# Generated by fastgrpc3 from google/rpc/code.proto: do not edit.
+"""Models of google/rpc/code.proto."""
+
+from __future__ import annotations
+
+from fastgrpc3.types import ProtoEnum
+
+
+class Code(ProtoEnum, proto="google.rpc.Code", prefix="", file="google/rpc/code.proto"):
+    """The canonical error codes for gRPC APIs.
+
+
+    Sometimes multiple error codes may apply.  Services should return
+    the most specific error code that applies.  For example, prefer
+    `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
+    Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
+    """
+
+    # Not an error; returned on success.
+    #
+    # HTTP Mapping: 200 OK
+    OK = 0
+    # The operation was cancelled, typically by the caller.
+    #
+    # HTTP Mapping: 499 Client Closed Request
+    CANCELLED = 1
+    # Unknown error.  For example, this error may be returned when
+    # a `Status` value received from another address space belongs to
+    # an error space that is not known in this address space.  Also
+    # errors raised by APIs that do not return enough error information
+    # may be converted to this error.
+    #
+    # HTTP Mapping: 500 Internal Server Error
+    UNKNOWN = 2
+    # The client specified an invalid argument.  Note that this differs
+    # from `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments
+    # that are problematic regardless of the state of the system
+    # (e.g., a malformed file name).
+    #
+    # HTTP Mapping: 400 Bad Request
+    INVALID_ARGUMENT = 3
+    # The deadline expired before the operation could complete. For operations
+    # that change the state of the system, this error may be returned
+    # even if the operation has completed successfully.  For example, a
+    # successful response from a server could have been delayed long
+    # enough for the deadline to expire.
+    #
+    # HTTP Mapping: 504 Gateway Timeout
+    DEADLINE_EXCEEDED = 4
+    # Some requested entity (e.g., file or directory) was not found.
+    #
+    # Note to server developers: if a request is denied for an entire class
+    # of users, such as gradual feature rollout or undocumented allowlist,
+    # `NOT_FOUND` may be used. If a request is denied for some users within
+    # a class of users, such as user-based access control, `PERMISSION_DENIED`
+    # must be used.
+    #
+    # HTTP Mapping: 404 Not Found
+    NOT_FOUND = 5
+    # The entity that a client attempted to create (e.g., file or directory)
+    # already exists.
+    #
+    # HTTP Mapping: 409 Conflict
+    ALREADY_EXISTS = 6
+    # The caller does not have permission to execute the specified
+    # operation. `PERMISSION_DENIED` must not be used for rejections
+    # caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
+    # instead for those errors). `PERMISSION_DENIED` must not be
+    # used if the caller can not be identified (use `UNAUTHENTICATED`
+    # instead for those errors). This error code does not imply the
+    # request is valid or the requested entity exists or satisfies
+    # other pre-conditions.
+    #
+    # HTTP Mapping: 403 Forbidden
+    PERMISSION_DENIED = 7
+    # Some resource has been exhausted, perhaps a per-user quota, or
+    # perhaps the entire file system is out of space.
+    #
+    # HTTP Mapping: 429 Too Many Requests
+    RESOURCE_EXHAUSTED = 8
+    # The operation was rejected because the system is not in a state
+    # required for the operation's execution.  For example, the directory
+    # to be deleted is non-empty, an rmdir operation is applied to
+    # a non-directory, etc.
+    #
+    # Service implementors can use the following guidelines to decide
+    # between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
+    #  (a) Use `UNAVAILABLE` if the client can retry just the failing call.
+    #  (b) Use `ABORTED` if the client should retry at a higher level. For
+    #      example, when a client-specified test-and-set fails, indicating the
+    #      client should restart a read-modify-write sequence.
+    #  (c) Use `FAILED_PRECONDITION` if the client should not retry until
+    #      the system state has been explicitly fixed. For example, if an "rmdir"
+    #      fails because the directory is non-empty, `FAILED_PRECONDITION`
+    #      should be returned since the client should not retry unless
+    #      the files are deleted from the directory.
+    #
+    # HTTP Mapping: 400 Bad Request
+    FAILED_PRECONDITION = 9
+    # The operation was aborted, typically due to a concurrency issue such as
+    # a sequencer check failure or transaction abort.
+    #
+    # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+    # `ABORTED`, and `UNAVAILABLE`.
+    #
+    # HTTP Mapping: 409 Conflict
+    ABORTED = 10
+    # The operation was attempted past the valid range.  E.g., seeking or
+    # reading past end-of-file.
+    #
+    # Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
+    # be fixed if the system state changes. For example, a 32-bit file
+    # system will generate `INVALID_ARGUMENT` if asked to read at an
+    # offset that is not in the range [0,2^32-1], but it will generate
+    # `OUT_OF_RANGE` if asked to read from an offset past the current
+    # file size.
+    #
+    # There is a fair bit of overlap between `FAILED_PRECONDITION` and
+    # `OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific
+    # error) when it applies so that callers who are iterating through
+    # a space can easily look for an `OUT_OF_RANGE` error to detect when
+    # they are done.
+    #
+    # HTTP Mapping: 400 Bad Request
+    OUT_OF_RANGE = 11
+    # The operation is not implemented or is not supported/enabled in this
+    # service.
+    #
+    # HTTP Mapping: 501 Not Implemented
+    UNIMPLEMENTED = 12
+    # Internal errors.  This means that some invariants expected by the
+    # underlying system have been broken.  This error code is reserved
+    # for serious errors.
+    #
+    # HTTP Mapping: 500 Internal Server Error
+    INTERNAL = 13
+    # The service is currently unavailable.  This is most likely a
+    # transient condition, which can be corrected by retrying with
+    # a backoff. Note that it is not always safe to retry
+    # non-idempotent operations.
+    #
+    # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+    # `ABORTED`, and `UNAVAILABLE`.
+    #
+    # HTTP Mapping: 503 Service Unavailable
+    UNAVAILABLE = 14
+    # Unrecoverable data loss or corruption.
+    #
+    # HTTP Mapping: 500 Internal Server Error
+    DATA_LOSS = 15
+    # The request does not have valid authentication credentials for the
+    # operation.
+    #
+    # HTTP Mapping: 401 Unauthorized
+    UNAUTHENTICATED = 16