names

package
v0.6.16 Latest Latest
Warning

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

 Go to latest Published: Oct 16, 2023 License: Apache-2.0 Imports: 4 Imported by: 11

Documentation

Index

Constants

View Source 
const Location = "global"

Location is included in resource names immediately following the project_id.

Variables

This section is empty.

Functions

func ExportableName 

func ExportableName(name string, projectID string) string

ExportableName returns a name suitable for export. Its project and location are removed, making it project-local, and any revision ID is removed since revision ids cannot be imported.

Note that currently revision ids are only removed from trailing segments. That's all that we need now, but support for removing internal revision ids could be added if needed.

Also note: this would be a nice function to add to the Name interface but that might require improving the regularity of access to ProjectIDs for different types of Names.

func ValidateRevisionTag 

func ValidateRevisionTag(tag string) error

ValidateRevisionTag returns an error if the provided revision tag is invalid.

Types

type Api 

type Api struct {
	ProjectID string
	ApiID     string
}

Api represents a resource name for an API.

func ParseApi 

func ParseApi(name string) (Api, error)

ParseApi parses the name of an Api.

func ParseApiCollection 

func ParseApiCollection(name string) (Api, error)

ParseApiCollection parses the name of an api collection.

func (Api) Artifact 

func (a Api) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (Api) Deployment 

func (a Api) Deployment(id string) Deployment

Deployment returns an API deployment with the provided ID and this resource as its parent.

func (Api) Parent 

func (a Api) Parent() string

Parent returns this resource's parent project resource name.

func (Api) Project 

func (a Api) Project() Project

Project returns the name of this resource's parent project.

func (Api) String 

func (a Api) String() string

func (Api) Validate 

func (a Api) Validate() error

Validate returns an error if the resource name is invalid. For backward compatibility, names should only be validated at creation time.

func (Api) Version 

func (a Api) Version(id string) Version

Version returns an API version with the provided ID and this resource as its parent.

type Artifact 

type Artifact struct {
	// contains filtered or unexported fields
}

Artifact represents a resource name for an artifact.

func ParseArtifact 

func ParseArtifact(name string) (Artifact, error)

ParseArtifact parses the name of an artifact.

func ParseArtifactCollection 

func ParseArtifactCollection(name string) (Artifact, error)

ParseArtifactCollection parses the name of an artifact collection.

func (Artifact) ApiID 

func (a Artifact) ApiID() string

ApiID returns the artifact's API ID, or empty string if it doesn't have one.

func (Artifact) ArtifactID 

func (a Artifact) ArtifactID() string

ArtifactID returns the artifact's ID.

func (Artifact) DeploymentID 

func (a Artifact) DeploymentID() string

DeploymentID returns the artifact's deployment ID, or empty string if it doesn't have one.

func (Artifact) Parent 

func (a Artifact) Parent() string

Parent returns the resource name of the artifact's parent.

func (Artifact) Project 

func (a Artifact) Project() Project

Project returns the name of this resource's parent project.

func (Artifact) ProjectID 

func (a Artifact) ProjectID() string

ProjectID returns the artifact's project ID, or empty string if it doesn't have one.

func (Artifact) RevisionID 

func (a Artifact) RevisionID() string

RevisionID returns the artifact's revision ID, or empty string if it doesn't have one.

func (Artifact) SpecID 

func (a Artifact) SpecID() string

SpecID returns the artifact's spec ID, or empty string if it doesn't have one.

func (Artifact) String 

func (a Artifact) String() string

func (Artifact) Validate 

func (a Artifact) Validate() error

Validate returns an error if the resource name is invalid. For backward compatibility, names should only be validated at creation time.

func (Artifact) VersionID 

func (a Artifact) VersionID() string

VersionID returns the artifact's version ID, or empty string if it doesn't have one.

type Deployment 

type Deployment struct {
	ProjectID    string
	ApiID        string
	DeploymentID string
}

Deployment represents a resource name for an API deployment.

func ParseDeployment 

func ParseDeployment(name string) (Deployment, error)

ParseDeployment parses the name of a deployment.

func ParseDeploymentCollection 

func ParseDeploymentCollection(name string) (Deployment, error)

func (Deployment) Api 

func (d Deployment) Api() Api

Api returns the parent API for this resource.

func (Deployment) Artifact 

func (d Deployment) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (Deployment) Normal 

func (d Deployment) Normal() Deployment

Normal returns the resource name with normalized identifiers.

func (Deployment) Parent 

func (d Deployment) Parent() string

Parent returns this resource's parent API resource name.

func (Deployment) Project 

func (d Deployment) Project() Project

Project returns the parent project for this resource.

func (Deployment) Revision 

func (d Deployment) Revision(id string) DeploymentRevision

Revision returns an API deployment revision with the provided ID and this resource as its parent.

func (Deployment) String 

func (d Deployment) String() string

func (Deployment) Validate 

func (d Deployment) Validate() error

Validate returns an error if the resource name is invalid. For backward compatibility, names should only be validated at creation time.

type DeploymentRevision 

type DeploymentRevision struct {
	ProjectID    string
	ApiID        string
	DeploymentID string
	RevisionID   string
}

DeploymentRevision represents a resource name for an API deployment revision.

func ParseDeploymentRevision 

func ParseDeploymentRevision(name string) (DeploymentRevision, error)

ParseDeploymentRevision parses the name of a deployment.

func ParseDeploymentRevisionCollection 

func ParseDeploymentRevisionCollection(name string) (DeploymentRevision, error)

func (DeploymentRevision) Api 

func (d DeploymentRevision) Api() Api

Api returns the parent API for this resource.

func (DeploymentRevision) Artifact 

func (s DeploymentRevision) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (DeploymentRevision) Deployment 

func (s DeploymentRevision) Deployment() Deployment

Deployment returns the parent deployment for this resource.

func (DeploymentRevision) Parent 

func (s DeploymentRevision) Parent() string

Parent returns this resource's parent API resource name.

func (DeploymentRevision) Project 

func (d DeploymentRevision) Project() Project

Project returns the parent project for this resource.

func (DeploymentRevision) String 

func (s DeploymentRevision) String() string

type Name 

type Name interface {
	String() string   // all names have a string representation.
	Project() Project // all names are associated with a project
}

Name is an interface that represents resource names.

func Parse 

func Parse(name string) (Name, error)

Parse attempts to parse a string into an resource name.

func ParseResourceCollection 

func ParseResourceCollection(name string) (Name, error)

Parse attempts to parse a string into a resource collection name.

func ParseResourceEntity 

func ParseResourceEntity(name string) (Name, error)

Parse attempts to parse a string into a single resource name.

type Project 

type Project struct {
	ProjectID string
}

Project represents a resource name for a project.

func ParseProject 

func ParseProject(name string) (Project, error)

ParseProject parses the name of a project.

func ParseProjectCollection 

func ParseProjectCollection(name string) (Project, error)

ParseProjectCollection parses the name of a project collection.

func ParseProjectWithLocation 

func ParseProjectWithLocation(name string) (Project, error)

ParseProjectWithLocation parses the name of a project.

func (Project) Api 

func (p Project) Api(id string) Api

Api returns an API with the provided ID and this resource as its parent.

func (Project) Artifact 

func (p Project) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (Project) Project 

func (p Project) Project() Project

Project returns this resource

func (Project) String 

func (p Project) String() string

func (Project) Validate 

func (p Project) Validate() error

Validate returns an error if the resource name is invalid. For backward compatibility, names should only be validated at creation time.

type Spec 

type Spec struct {
	ProjectID string
	ApiID     string
	VersionID string
	SpecID    string
}

Spec represents a resource name for an API spec.

func ParseSpec 

func ParseSpec(name string) (Spec, error)

ParseSpec parses the name of a spec.

func ParseSpecCollection 

func ParseSpecCollection(name string) (Spec, error)

ParseSpecCollection parses the name of a spec collection.

func (Spec) Api 

func (s Spec) Api() Api

Api returns the parent API for this resource.

func (Spec) Artifact 

func (s Spec) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (Spec) Normal 

func (s Spec) Normal() Spec

Normal returns the resource name with normalized identifiers.

func (Spec) Parent 

func (s Spec) Parent() string

Parent returns this resource's parent version resource name.

func (Spec) Project 

func (s Spec) Project() Project

Project returns the parent project for this resource.

func (Spec) Revision 

func (s Spec) Revision(id string) SpecRevision

Revision returns an API spec revision with the provided ID and this resource as its parent.

func (Spec) String 

func (s Spec) String() string

func (Spec) Validate 

func (s Spec) Validate() error

Validate returns an error if the resource name is invalid. For backward compatibility, names should only be validated at creation time.

func (Spec) Version 

func (s Spec) Version() Version

Version returns the parent API version for this resource.

type SpecRevision 

type SpecRevision struct {
	ProjectID  string
	ApiID      string
	VersionID  string
	SpecID     string
	RevisionID string
}

SpecRevision represents a resource name for an API spec revision.

func ParseSpecRevision 

func ParseSpecRevision(name string) (SpecRevision, error)

ParseSpecRevision parses the name of a spec.

func ParseSpecRevisionCollection 

func ParseSpecRevisionCollection(name string) (SpecRevision, error)

ParseSpecRevisionCollection parses the name of a spec revision collection.

func (SpecRevision) Api 

func (s SpecRevision) Api() Api

Api returns the parent API for this resource.

func (SpecRevision) Artifact 

func (s SpecRevision) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (SpecRevision) Parent 

func (s SpecRevision) Parent() string

Parent returns this resource's parent version resource name.

func (SpecRevision) Project 

func (s SpecRevision) Project() Project

Project returns the parent project for this resource.

func (SpecRevision) Spec 

func (s SpecRevision) Spec() Spec

Spec returns the parent spec for this resource.

func (SpecRevision) String 

func (s SpecRevision) String() string

func (SpecRevision) Version 

func (s SpecRevision) Version() Version

Version returns the parent API version for this resource.

type Version 

type Version struct {
	ProjectID string
	ApiID     string
	VersionID string
}

Version represents a resource name for an API version.

func ParseVersion 

func ParseVersion(name string) (Version, error)

ParseVersion parses the name of a version.

func ParseVersionCollection 

func ParseVersionCollection(name string) (Version, error)

ParseVersionCollection parses the name of a version collection.

func (Version) Api 

func (v Version) Api() Api

Api returns the parent API for this resource.

func (Version) Artifact 

func (v Version) Artifact(id string) Artifact

Artifact returns an artifact with the provided ID and this resource as its parent.

func (Version) Parent 

func (v Version) Parent() string

Parent returns this resource's parent API resource name.

func (Version) Project 

func (v Version) Project() Project

Project returns the parent project for this resource.

func (Version) Spec 

func (v Version) Spec(id string) Spec

Spec returns an API spec with the provided ID and this resource as its parent.

func (Version) String 

func (v Version) String() string

func (Version) Validate 

func (v Version) Validate() error

Validate returns an error if the resource name is invalid. For backward compatibility, names should only be validated at creation time.

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.