utils

package
v1.67.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 22, 2024 License: Apache-2.0 Imports: 15 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (

	// VersionedSegment is a regex to extract the API version from
	// an HTTP path.
	VersionedSegment = regexp.MustCompile(`\{\$api_version\}`)
)

Functions

func DeclarativeFriendlyResource added in v1.6.0 

func DeclarativeFriendlyResource(d desc.Descriptor) *desc.MessageDescriptor

DeclarativeFriendlyResource returns the declarative-friendly resource associated with this descriptor.

For messages: If the message is annotated with google.api.resource and style: DECLARATIVE_FRIENDLY is set, that message is returned. If the message is a standard method request message for a resource with google.api.resource and style:DECLARATIVE_FRIENDLY set, then the resource is returned.

For methods: If the output message is a declarative-friendly resource, it is returned. If the method begins with "List" and the first repeated field is a declarative-friendly resource, the resource is returned. If the method begins with "Delete", the return type is Empty, and an appropriate resource message is found and is declarative-friendly, that resource is returned. If the method is a custom method where a matching resource is found (by subset checks on the name) and is declarative-friendly, the resource is returned.

If there is no declarative-friendly resource, it returns nil.

func ExtractRevisionResource added in v1.67.3 

func ExtractRevisionResource(m *desc.MethodDescriptor) (string, bool)

ExtractRevisionResource uses the appropriate revision method regular expression to capture and extract the resource noun in the method name. If the given method is not one of the standard revision RPCs, it returns empty string and false.

func FindFieldDotNotation added in v1.36.2 

func FindFieldDotNotation(msg *desc.MessageDescriptor, ref string) *desc.FieldDescriptor

FindFieldDotNotation returns a field descriptor from a given message that corresponds to the dot separated path e.g. "book.name". If the path is unresolable the method returns nil. This is especially useful for resolving path variables in google.api.http and nested fields in google.api.method_signature annotations.

func FindMessage added in v1.6.0 

func FindMessage(f *desc.FileDescriptor, name string) *desc.MessageDescriptor

FindMessage looks for a message in a file and all imports within the same package.

func FindMethod added in v1.6.0 

func FindMethod(f *desc.FileDescriptor, name string) *desc.MethodDescriptor

FindMethod searches a file and all imports within the same package, and returns the method with a given name, or nil if none is found.

func FindResource added in v1.36.2 

func FindResource(reference string, file *desc.FileDescriptor) *apb.ResourceDescriptor

FindResource returns first resource of type matching the reference param. resource Type name being referenced. It looks within a given file and its depenedencies, it cannot search within the entire protobuf package. This is especially useful for resolving google.api.resource_reference annotations.

func FindResourceChildren added in v1.55.0 

func FindResourceChildren(parent *apb.ResourceDescriptor, file *desc.FileDescriptor) []*apb.ResourceDescriptor

FindResourceChildren attempts to search for other resources defined in the package that are parented by the given resource.

func FindResourceMessage added in v1.57.0 

func FindResourceMessage(reference string, file *desc.FileDescriptor) *desc.MessageDescriptor

FindResourceMessage returns the message containing the first resource of type matching the resource Type name being referenced. It looks within a given file and its depenedencies, it cannot search within the entire protobuf package. This is especially useful for resolving google.api.resource_reference annotations to the message that owns a resource.

func GetAllDependencies added in v1.21.0 

func GetAllDependencies(file *desc.FileDescriptor) map[string]*desc.FileDescriptor

GetAllDependencies returns all dependencies.

func GetFieldBehavior 

func GetFieldBehavior(f *desc.FieldDescriptor) stringset.Set

GetFieldBehavior returns a stringset.Set of FieldBehavior annotations for the given field.

func GetFieldInfo added in v1.58.0 

func GetFieldInfo(fd *desc.FieldDescriptor) *apb.FieldInfo

func GetFormat added in v1.58.0 

func GetFormat(fd *desc.FieldDescriptor) apb.FieldInfo_Format

func GetListResourceMessage added in v1.48.0 

func GetListResourceMessage(m *desc.MethodDescriptor) *desc.MessageDescriptor

GetListResourceMessage returns the resource for a list method, nil otherwise.

func GetMetadataType added in v1.32.3 

func GetMetadataType(m *desc.MethodDescriptor) *desc.MessageDescriptor

GetMetadataType returns the message referred to by the (google.longrunning.operation_info).metadata_type annotation.

func GetMethodSignatures 

func GetMethodSignatures(m *desc.MethodDescriptor) [][]string

GetMethodSignatures returns the `google.api.method_signature` annotations.

func GetOperationInfo 

func GetOperationInfo(m *desc.MethodDescriptor) *lrpb.OperationInfo

GetOperationInfo returns the google.longrunning.operation_info annotation.

func GetOperationResponseType added in v1.48.0 

func GetOperationResponseType(m *desc.MethodDescriptor) *desc.MessageDescriptor

GetOperationResponseType returns the message referred to by the (google.longrunning.operation_info).response_type annotation.

func GetRepeatedMessageFields added in v1.31.0 

func GetRepeatedMessageFields(m *desc.MessageDescriptor) []*desc.FieldDescriptor

GetRepeatedMessageFields returns all fields labeled `repeated` of type Message in the given message, sorted in field number order.

func GetResource 

func GetResource(m *desc.MessageDescriptor) *apb.ResourceDescriptor

GetResource returns the google.api.resource annotation.

func GetResourceDefinitions added in v1.1.0 

func GetResourceDefinitions(f *desc.FileDescriptor) []*apb.ResourceDescriptor

GetResourceDefinitions returns the google.api.resource_definition annotations for a file.

func GetResourceMessageName added in v1.63.4 

func GetResourceMessageName(m *desc.MethodDescriptor, expectedVerb string) string

GetResourceMessageName returns the resource message type name from method

func GetResourceNameField added in v1.57.0 

func GetResourceNameField(r *apb.ResourceDescriptor) string

GetResourceNameField is a convenience method for getting the name of the field that represents the resource's name. This is either set by the `name_field` attribute, or defaults to "name".

func GetResourcePlural added in v1.49.0 

func GetResourcePlural(r *apb.ResourceDescriptor) string

GetResourcePlural is a convenience method for getting the `plural` field of a resource.

func GetResourceReference 

func GetResourceReference(f *desc.FieldDescriptor) *apb.ResourceReference

GetResourceReference returns the google.api.resource_reference annotation.

func GetResourceSingular added in v1.49.0 

func GetResourceSingular(r *apb.ResourceDescriptor) string

GetResourceSingular returns the resource singular. The empty string is returned if the singular cannot be found. Since the singular is not always annotated, it extracts it from multiple different locations including: 1. the singular annotation 2. the type definition

func GetResponseType added in v1.32.3 

func GetResponseType(m *desc.MethodDescriptor) *desc.MessageDescriptor

GetResponseType returns the OutputType if the response is not an LRO, or the ResponseType otherwise.

func GetTypeName 

func GetTypeName(f *desc.FieldDescriptor) string

GetTypeName returns the name of the type of the field, as a string, regardless of primitive, message, etc.

func HasFieldInfo added in v1.58.0 

func HasFieldInfo(fd *desc.FieldDescriptor) bool

func HasFormat added in v1.58.0 

func HasFormat(fd *desc.FieldDescriptor) bool

func HasHTTPRules added in v1.36.2 

func HasHTTPRules(m *desc.MethodDescriptor) bool

HasHTTPRules returns true when the given method descriptor is annotated with a google.api.http option.

func HasResourceReference added in v1.57.0 

func HasResourceReference(f *desc.FieldDescriptor) bool

HasResourceReference returns if the field has a google.api.resource_reference annotation.

func IsCommitRevisionMethod added in v1.67.3 

func IsCommitRevisionMethod(m *desc.MethodDescriptor) bool

IsCommitRevisionMethod returns true if this is an AIP-162 Commit method, false otherwise.

func IsCommonProto 

func IsCommonProto(f *desc.FileDescriptor) bool

IsCommonProto returns true if a proto file is considered "common".

func IsCreateMethod added in v1.48.0 

func IsCreateMethod(m *desc.MethodDescriptor) bool

IsCreateMethod returns true if this is a AIP-133 Create method.

func IsCreateMethodWithResolvedReturnType added in v1.65.0 

func IsCreateMethodWithResolvedReturnType(m *desc.MethodDescriptor) bool

IsCreateMethodWithResolvedReturnType returns true if this is a AIP-133 Create method with a non-nil response type. This method should be used for filtering in linter rules which access the response type of the method, to avoid crashing due to dereferencing a nil pointer to the response.

func IsCreateRequestMessage added in v1.55.1 

func IsCreateRequestMessage(m *desc.MessageDescriptor) bool

Returns true if this is an AIP-133 Get request message, false otherwise.

func IsCustomMethod added in v1.66.2 

func IsCustomMethod(m *desc.MethodDescriptor) bool

IsCustomMethod returns true if this is a AIP-136 Custom Method

func IsDeclarativeFriendlyMessage added in v1.5.0 

func IsDeclarativeFriendlyMessage(m *desc.MessageDescriptor) bool

IsDeclarativeFriendlyMessage returns true if the descriptor is declarative-friendly (if DeclarativeFriendlyResource(m) is not nil).

func IsDeclarativeFriendlyMethod added in v1.5.0 

func IsDeclarativeFriendlyMethod(m *desc.MethodDescriptor) bool

IsDeclarativeFriendlyMethod returns true if the method is for a declarative-friendly resource (if DeclarativeFriendlyResource(m) is not nil).

func IsDeleteMethod added in v1.55.1 

func IsDeleteMethod(m *desc.MethodDescriptor) bool

Returns true if this is a AIP-135 Delete method, false otherwise.

func IsDeleteRequestMessage added in v1.55.1 

func IsDeleteRequestMessage(m *desc.MessageDescriptor) bool

Returns true if this is an AIP-135 Delete request message, false otherwise.

func IsDeleteRevisionMethod added in v1.67.3 

func IsDeleteRevisionMethod(m *desc.MethodDescriptor) bool

IsDeleteRevisionMethod returns true if this is an AIP-162 Delete Revision method, false otherwise.

func IsGetMethod added in v1.48.0 

func IsGetMethod(m *desc.MethodDescriptor) bool

IsGetMethod returns true if this is a AIP-131 Get method.

func IsGetRequestMessage added in v1.55.1 

func IsGetRequestMessage(m *desc.MessageDescriptor) bool

Returns true if this is an AIP-131 Get request message, false otherwise.

func IsLegacyListRevisionsMethod added in v1.64.0 

func IsLegacyListRevisionsMethod(m *desc.MethodDescriptor) bool

IsLegacyListRevisions identifies such a method by having the appropriate method name, having a `name` field instead of parent, and a HTTP suffix of `listRevisions`.

func IsListMethod added in v1.48.0 

func IsListMethod(m *desc.MethodDescriptor) bool

IsListMethod return true if this is an AIP-132 List method

func IsListRequestMessage added in v1.55.1 

func IsListRequestMessage(m *desc.MessageDescriptor) bool

Return true if this is an AIP-132 List request message, false otherwise.

func IsListResponseMessage added in v1.55.1 

func IsListResponseMessage(m *desc.MessageDescriptor) bool

Return true if this is an AIP-132 List response message, false otherwise.

func IsListRevisionsRequestMessage added in v1.55.1 

func IsListRevisionsRequestMessage(m *desc.MessageDescriptor) bool

IsListRevisionsRequestMessage returns true if this is an AIP-162 List Revisions request message, false otherwise.

func IsListRevisionsResponseMessage added in v1.55.1 

func IsListRevisionsResponseMessage(m *desc.MessageDescriptor) bool

IsListRevisionsResponseMessage returns true if this is an AIP-162 List Revisions response message, false otherwise.

func IsOperation added in v1.45.0 

func IsOperation(m *desc.MessageDescriptor) bool

IsOperation returns if the message is a longrunning Operation or not.

func IsResource added in v1.5.0 

func IsResource(m *desc.MessageDescriptor) bool

IsResource returns true if the message has a populated google.api.resource annotation with a non-empty "type" field.

func IsResourceRevision added in v1.57.0 

func IsResourceRevision(m *desc.MessageDescriptor) bool

IsResourceRevision determines if the given message represents a resource revision as described in AIP-162.

func IsRevisionRelationship added in v1.57.0 

func IsRevisionRelationship(parent, revision *apb.ResourceDescriptor) bool

IsRevisionRelationship determines if the "revision" resource is actually a revision of the "parent" resource.

func IsRollbackRevisionMethod added in v1.67.3 

func IsRollbackRevisionMethod(m *desc.MethodDescriptor) bool

IsRollbackRevisionMethod returns true if this is an AIP-162 Rollback method, false otherwise.

func IsSingletonResource added in v1.21.0 

func IsSingletonResource(m *desc.MessageDescriptor) bool

IsSingletonResource returns true if the given message is a singleton resource according to its pattern.

func IsSingletonResourcePattern added in v1.67.0 

func IsSingletonResourcePattern(pattern string) bool

IsSingletonResource returns true if the given message is a singleton resource according to its pattern.

func IsStandardMethod added in v1.66.2 

func IsStandardMethod(m *desc.MethodDescriptor) bool

IsStandardMethod returns true if this is a AIP-130 Standard Method

func IsStreaming added in v1.57.1 

func IsStreaming(m *desc.MethodDescriptor) bool

IsStreaming returns if the method is either client or server streaming.

func IsTagRevisionMethod added in v1.67.3 

func IsTagRevisionMethod(m *desc.MethodDescriptor) bool

IsTagRevisionMethod returns true if this is an AIP-162 Tag Revision method, false otherwise.

func IsUpdateMethod added in v1.48.0 

func IsUpdateMethod(m *desc.MethodDescriptor) bool

IsUpdateMethod returns true if this is a AIP-134 Update method

func IsUpdateRequestMessage added in v1.55.1 

func IsUpdateRequestMessage(m *desc.MessageDescriptor) bool

Returns true if this is an AIP-134 Update request message, false otherwise.

func LintFieldMask added in v1.27.0 

func LintFieldMask(f *desc.FieldDescriptor) []lint.Problem

LintFieldMask returns a problem if the field is not a singular google.protobuf.FieldMask.

func LintFieldPresent added in v1.13.0 

func LintFieldPresent(m *desc.MessageDescriptor, field string) (*desc.FieldDescriptor, []lint.Problem)

LintFieldPresent returns a problem if the given message does not have the given field.

func LintFieldPresentAndSingularString added in v1.13.0 

func LintFieldPresentAndSingularString(field string) func(*desc.MessageDescriptor) []lint.Problem

LintFieldPresentAndSingularString returns a problem if a message does not have the given singular-string field.

func LintFieldResourceReference added in v1.7.0 

func LintFieldResourceReference(f *desc.FieldDescriptor) []lint.Problem

LintFieldResourceReference returns a problem if the field does not have a resource reference annotation.

func LintHTTPMethod added in v1.7.0 

func LintHTTPMethod(verb string) func(*desc.MethodDescriptor) []lint.Problem

LintHTTPMethod returns a problem for each HTTP rule whose HTTP method is not the given one.

func LintHTTPURIHasNameVariable added in v1.22.0 

func LintHTTPURIHasNameVariable(m *desc.MethodDescriptor) []lint.Problem

LintHTTPURIHasNameVariable returns a problem if any of the given method's HTTP rules do not have a name variable in the URI.

func LintHTTPURIHasParentVariable added in v1.20.0 

func LintHTTPURIHasParentVariable(m *desc.MethodDescriptor) []lint.Problem

LintHTTPURIHasParentVariable returns a problem if any of the given method's HTTP rules do not have a parent variable in the URI.

func LintHTTPURIHasVariable added in v1.22.0 

func LintHTTPURIHasVariable(m *desc.MethodDescriptor, v string) []lint.Problem

LintHTTPURIHasVariable returns a problem if any of the given method's HTTP rules do not have the given variable in the URI.

func LintHTTPURIVariableCount added in v1.26.0 

func LintHTTPURIVariableCount(m *desc.MethodDescriptor, n int) []lint.Problem

LintHTTPURIVariableCount returns a problem if the given method's HTTP rules do not contain the given number of variables in the URI.

func LintMethodHasMatchingRequestName added in v1.7.1 

func LintMethodHasMatchingRequestName(m *desc.MethodDescriptor) []lint.Problem

LintMethodHasMatchingRequestName returns a problem if the given method's request type does not have a name matching the method's, with a "Request" suffix.

func LintMethodHasMatchingResponseName added in v1.17.0 

func LintMethodHasMatchingResponseName(m *desc.MethodDescriptor) []lint.Problem

LintMethodHasMatchingResponseName returns a problem if the given method's response type does not have a name matching the method's, with a "Response" suffix.

func LintNoHTTPBody added in v1.7.0 

func LintNoHTTPBody(m *desc.MethodDescriptor) []lint.Problem

LintNoHTTPBody returns a problem for each HTTP rule whose body is not "".

func LintNotOneof added in v1.30.0 

func LintNotOneof(f *desc.FieldDescriptor) []lint.Problem

LintNotOneof returns a problem if the field is a oneof.

func LintOutputOnlyField added in v1.21.0 

func LintOutputOnlyField(f *desc.FieldDescriptor) []lint.Problem

LintOutputOnlyField returns a problem if the field's behavior is not OUTPUT_ONLY.

func LintRequiredField added in v1.7.0 

func LintRequiredField(f *desc.FieldDescriptor) []lint.Problem

LintRequiredField returns a problem if the field's behavior is not REQUIRED.

func LintSingularBoolField added in v1.21.0 

func LintSingularBoolField(f *desc.FieldDescriptor) []lint.Problem

LintSingularBoolField returns a problem if the field is not a singular bool.

func LintSingularField added in v1.30.0 

func LintSingularField(f *desc.FieldDescriptor, t *builder.FieldType, want string) []lint.Problem

LintSingularField returns a problem if the field is not singular i.e. it is repeated.

func LintSingularStringField added in v1.13.0 

func LintSingularStringField(f *desc.FieldDescriptor) []lint.Problem

LintSingularStringField returns a problem if the field is not a singular string.

func LintWildcardHTTPBody added in v1.7.0 

func LintWildcardHTTPBody(m *desc.MethodDescriptor) []lint.Problem

LintWildcardHTTPBody returns a problem for each HTTP rule whose body is not "*".

func ListResponseResourceName added in v1.55.1 

func ListResponseResourceName(m *desc.MessageDescriptor) string

Returns the name of the resource type from the response message name based on Standard List response message naming convention. If the message is not a Standard List response message, empty string is returned.

func SeparateInternalComments added in v1.50.0 

func SeparateInternalComments(comments ...string) struct {
	Internal []string
	External []string
}

SeparateInternalComments splits the given comment block into "external" and "internal" comments based on https://google.aip.dev/192#internal-comments.

func SplitResourceTypeName added in v1.43.0 

func SplitResourceTypeName(typ string) (service string, typeName string, ok bool)

SplitResourceTypeName splits the `Resource.type` field into the service name and the resource type name.

func ToLowerCamelCase added in v1.47.0 

func ToLowerCamelCase(s string) string

ToLowerCamelCase returns the lowerCamelCase of a string, including removing delimiters (_,-,., ) and using them to denote a new word.

func ToPlural 

func ToPlural(s string) string

ToPlural converts a string to its plural form.

func ToSingular added in v1.18.0 

func ToSingular(s string) string

ToSingular converts a string to its singular form.

func ToUpperCamelCase added in v1.47.0 

func ToUpperCamelCase(s string) string

ToUpperCamelCase returns the UpperCamelCase of a string, including removing delimiters (_,-,., ) and using them to denote a new word.

Types

type HTTPRule 

type HTTPRule struct {
	// The HTTP method. Guaranteed to be in all caps.
	// This is set to "CUSTOM" if the Custom property is set.
	Method string

	// The HTTP URI (the value corresponding to the selected HTTP method).
	URI string

	// The `body` value forwarded from the generated proto's HttpRule.
	Body string

	// The `response_body` value forwarded from the generated proto's HttpRule.
	ResponseBody string
}

HTTPRule defines a parsed, easier-to-query equivalent to `apb.HttpRule`.

func GetHTTPRules 

func GetHTTPRules(m *desc.MethodDescriptor) []*HTTPRule

GetHTTPRules returns a slice of HTTP rules for a given method descriptor.

Note: This returns a slice -- it takes the google.api.http annotation, and then flattens the values in `additional_bindings`. This allows rule authors to simply range over all of the HTTP rules, since the common case is to want to apply the checks to all of them.

func (*HTTPRule) GetPlainURI 

func (h *HTTPRule) GetPlainURI() string

GetPlainURI returns the URI with variable segment information removed.

func (*HTTPRule) GetVariables 

func (h *HTTPRule) GetVariables() map[string]string

GetVariables returns the variable segments in a URI as a map.

For a given variable, the key is the variable's field path. The value is the variable's template, which will match segment(s) of the URL.

For more details on the path template syntax, see https://github.com/googleapis/googleapis/blob/6e1a5a066659794f26091674e3668229e7750052/google/api/http.proto#L224.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.