bufmodulebuild

Documentation

Index

• type BuildModuleFileSetOption
  • func WithWorkspace(workspace bufmodule.Workspace) BuildModuleFileSetOption
• type BuildOption
  • func WithExcludePaths(excludePaths []string) BuildOption
  • func WithExcludePathsAllowNotExist(excludePaths []string) BuildOption
  • func WithModuleIdentity(moduleIdentity bufmoduleref.ModuleIdentity) BuildOption
  • func WithPaths(paths []string) BuildOption
  • func WithPathsAllowNotExist(paths []string) BuildOption
• type ModuleBucketBuilder
  • func NewModuleBucketBuilder(logger *zap.Logger) ModuleBucketBuilder
• type ModuleFileSetBuilder
  • func NewModuleFileSetBuilder(logger *zap.Logger, moduleReader bufmodule.ModuleReader) ModuleFileSetBuilder
• type ModuleIncludeBuilder
  • func NewModuleIncludeBuilder(logger *zap.Logger, storageosProvider storageos.Provider) ModuleIncludeBuilder

Types

type BuildModuleFileSetOption

type BuildModuleFileSetOption func(*buildModuleFileSetOptions)

BuildModuleFileSetOption is an option for Build.

func WithWorkspace

func WithWorkspace(workspace bufmodule.Workspace) BuildModuleFileSetOption

WithWorkspace returns a new BuildModuleFileSetOption that specifies a workspace.

type BuildOption

type BuildOption func(*buildOptions)

BuildOption is an option for BuildForBucket.

func WithExcludePaths

func WithExcludePaths(excludePaths []string) BuildOption

WithExcludePaths returns a new BuildOption that specifies files to be excluded from the build.

func WithExcludePathsAllowNotExist

func WithExcludePathsAllowNotExist(excludePaths []string) BuildOption

WithExcludePathsAllowNotExist returns a new BuildOption that specifies files to be excluded from the build, but allows the specified paths to not exist.

func WithModuleIdentity

func WithModuleIdentity(moduleIdentity bufmoduleref.ModuleIdentity) BuildOption

WithModuleIdentity returns a new BuildOption that is used to construct a Module with a ModuleIdentity.

TODO: this is never called TODO: we also have ModuleWithModuleIdentityAndCommit in bufmodule We need to disambiguate module building between bufmodule and bufmodulebuild bufimage and bufimagebuild work, but bufmodule and bufmodulebuild are a mess

func WithPaths

func WithPaths(paths []string) BuildOption

WithPaths returns a new BuildOption that specifies specific file or directory paths to build.

These paths must exist. These paths must be relative to the bucket or include directory paths. These paths will be normalized. Multiple calls to this option and WithPathsAllowNotExist will override previous calls.

This results in ModuleWithTargetPaths being used on the resulting build module. This is done within bufmodulebuild so we can resolve the paths relative to their roots.

func WithPathsAllowNotExist

func WithPathsAllowNotExist(paths []string) BuildOption

WithPathsAllowNotExist returns a new BuildOption that specifies specific file or directory paths to build, but allows the specified paths to not exist.

These paths must exist. These paths must be relative to the bucket or include directory paths. These paths will be normalized. Multiple calls to this option and WithPaths will override previous calls.

This results in ModuleWithPathsAllowNotExist being used on the resulting build module. This is done within bufmodulebuild so we can resolve the paths relative to their roots.

type ModuleBucketBuilder

type ModuleBucketBuilder interface {
	// BuildForBucket builds a module for the given bucket.
	//
	// If paths is empty, all files are built.
	// Paths should be relative to the bucket, not the roots.
	BuildForBucket(
		ctx context.Context,
		readBucket storage.ReadBucket,
		config *bufmoduleconfig.Config,
		options ...BuildOption,
	) (bufmodule.Module, error)
}

ModuleBucketBuilder builds modules for buckets.

func NewModuleBucketBuilder

func NewModuleBucketBuilder(logger *zap.Logger) ModuleBucketBuilder

NewModuleBucketBuilder returns a new BucketBuilder.

type ModuleFileSetBuilder

type ModuleFileSetBuilder interface {
	Build(
		ctx context.Context,
		module bufmodule.Module,
		options ...BuildModuleFileSetOption,
	) (bufmodule.ModuleFileSet, error)
}

ModuleFileSetBuilder builds ModuleFileSets from Modules.

func NewModuleFileSetBuilder

func NewModuleFileSetBuilder(
	logger *zap.Logger,
	moduleReader bufmodule.ModuleReader,
) ModuleFileSetBuilder

NewModuleFileSetBuilder returns a new ModuleSetProvider.

type ModuleIncludeBuilder

type ModuleIncludeBuilder interface {
	// BuildForIncludes builds a module for the given includes and file paths.
	BuildForIncludes(
		ctx context.Context,
		includeDirPaths []string,
		options ...BuildOption,
	) (bufmodule.Module, error)
}

ModuleIncludeBuilder builds modules for includes.

This is used for protoc.

func NewModuleIncludeBuilder

func NewModuleIncludeBuilder(
	logger *zap.Logger,
	storageosProvider storageos.Provider,
) ModuleIncludeBuilder

NewModuleIncludeBuilder returns a new ModuleIncludeBuilder.

TODO: we should parse includeDirPaths for modules as well in theory would be nice to be able to do buf alpha protoc -I path/to/dir -I buf.build/foo/bar/v1