librarian

package
v0.12.0 Latest Latest
Warning

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

Go to latest
Published: May 4, 2026 License: Apache-2.0 Imports: 35 Imported by: 0

Documentation

Overview

Package librarian provides functionality for onboarding, generating and releasing Google Cloud client libraries.

Index

Constants

This section is empty.

Variables

View Source
var ErrLibraryNotFound = errors.New("library not found")

ErrLibraryNotFound is returned when the specified library is not found in config.

View Source
var ErrMissingGoogleapisSource = errors.New("must specify googleapis source")

ErrMissingGoogleapisSource is returned when the googleapis source is missing.

View Source
var (

	// IgnoredChanges defines the list of the files that are
	// to be ignored as changes during the bump and publish commands.
	// It is norm that a repository does not have all the files listed here.
	IgnoredChanges = []string{
		".repo-metadata.json",
		"docs/README.rst",
	}
)

Functions

func FindLibrary added in v0.8.4

func FindLibrary(c *config.Config, name string) (*config.Library, error)

FindLibrary returns a library with the given name from the config.

func LoadSources added in v0.8.4

func LoadSources(ctx context.Context, src *config.Sources) (*sources.Sources, error)

LoadSources fetches all source repositories needed for generation in parallel. It returns a *sources.Sources struct with all directories populated.

func ResolvePreview added in v0.10.0

func ResolvePreview(lib *config.Library, language string) *config.Library

ResolvePreview returns a library where fields from lib.Preview override those in the base lib, if set. If lib.Preview is not set or lib itself is nil this returns nil.

func Run

func Run(ctx context.Context, args ...string) error

Run executes the librarian command with the given arguments.

func RunTidyOnConfig added in v0.8.0

func RunTidyOnConfig(ctx context.Context, repoDir string, cfg *config.Config) error

RunTidyOnConfig formats and validates the provided librarian configuration and writes it to disk, relative to the specified repository root directory.

func Version added in v0.8.0

func Version() string

Version return the version information for the binary, which is constructed following https://go.dev/ref/mod#versions.

Types

This section is empty.

Directories

Path Synopsis
Package dart provides functionality for generating and releasing Dart client libraries.
Package dart provides functionality for generating and releasing Dart client libraries.
Package gcloud provides gcloud command binary generation for librarian.
Package gcloud provides gcloud command binary generation for librarian.
Package golang provides functionality for generating Go client libraries.
Package golang provides functionality for generating Go client libraries.
Package java provides Java specific functionality for librarian.
Package java provides Java specific functionality for librarian.
Package nodejs provides Node.js-specific functionality for librarian.
Package nodejs provides Node.js-specific functionality for librarian.
Package python provides Python specific functionality for librarian.
Package python provides Python specific functionality for librarian.
Package rust provides Rust specific functionality for librarian.
Package rust provides Rust specific functionality for librarian.
Package surfer provides surfer-specific functionality for librarian.
Package surfer provides surfer-specific functionality for librarian.
Package swift provides functionality for generating Swift client libraries.
Package swift provides functionality for generating Swift client libraries.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL