proto

package
v0.0.0-...-8023e94 Latest Latest
Warning

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

Go to latest
Published: Feb 27, 2021 License: BSD-2-Clause Imports: 5 Imported by: 0

README

Fint protobufs

The .proto files here are the source of truth. Copybara should automatically copy files from here to the other places they're needed.

To update the compiled / generated files when the .proto files change, run update.sh (located in this directory).

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	Static_Optimize_name = map[int32]string{
		0: "OPTIMIZE_UNSPECIFIED",
		1: "DEBUG",
		2: "RELEASE",
	}
	Static_Optimize_value = map[string]int32{
		"OPTIMIZE_UNSPECIFIED": 0,
		"DEBUG":                1,
		"RELEASE":              2,
	}
)

Enum value maps for Static_Optimize.

View Source
var (
	Static_Arch_name = map[int32]string{
		0: "ARCH_UNSPECIFIED",
		1: "ARM64",
		2: "X64",
	}
	Static_Arch_value = map[string]int32{
		"ARCH_UNSPECIFIED": 0,
		"ARM64":            1,
		"X64":              2,
	}
)

Enum value maps for Static_Arch.

View Source
var File_context_proto protoreflect.FileDescriptor
View Source
var File_set_artifacts_proto protoreflect.FileDescriptor
View Source
var File_static_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type Context

type Context struct {

	// Absolute path to the root of the Fuchsia checkout.
	CheckoutDir string `protobuf:"bytes,1,opt,name=checkout_dir,json=checkoutDir,proto3" json:"checkout_dir,omitempty"`
	// Absolute path to the build output directory.
	BuildDir string `protobuf:"bytes,2,opt,name=build_dir,json=buildDir,proto3" json:"build_dir,omitempty"`
	// Absolute path to a directory where build artifacts intended to be
	// exposed to the caller should be written.
	ArtifactDir string `protobuf:"bytes,3,opt,name=artifact_dir,json=artifactDir,proto3" json:"artifact_dir,omitempty"`
	// Files changed in the commit being tested.
	ChangedFiles []*Context_ChangedFile `protobuf:"bytes,4,rep,name=changed_files,json=changedFiles,proto3" json:"changed_files,omitempty"`
	// Passed through to the `sdk_id` gn arg.
	SdkId string `protobuf:"bytes,5,opt,name=sdk_id,json=sdkId,proto3" json:"sdk_id,omitempty"`
	// Cache directory that's persisted between builds.
	CacheDir string `protobuf:"bytes,6,opt,name=cache_dir,json=cacheDir,proto3" json:"cache_dir,omitempty"`
	// Passed through to the `build_info_version` gn arg.
	ReleaseVersion string `protobuf:"bytes,7,opt,name=release_version,json=releaseVersion,proto3" json:"release_version,omitempty"`
	// Paths to directories that contain alternate versions of these toolchains.
	// For each one, if set, we'll use the toolchain version at the specified path
	// instead of the version included in the checkout.
	ClangToolchainDir string `protobuf:"bytes,8,opt,name=clang_toolchain_dir,json=clangToolchainDir,proto3" json:"clang_toolchain_dir,omitempty"`
	GccToolchainDir   string `protobuf:"bytes,9,opt,name=gcc_toolchain_dir,json=gccToolchainDir,proto3" json:"gcc_toolchain_dir,omitempty"`
	RustToolchainDir  string `protobuf:"bytes,10,opt,name=rust_toolchain_dir,json=rustToolchainDir,proto3" json:"rust_toolchain_dir,omitempty"`
	// Whether to build for the purposes of collecting coverage.
	CollectCoverage bool `protobuf:"varint,11,opt,name=collect_coverage,json=collectCoverage,proto3" json:"collect_coverage,omitempty"`
	// Use this many jobs if building with Goma (ignored otherwise).
	GomaJobCount int32 `protobuf:"varint,12,opt,name=goma_job_count,json=gomaJobCount,proto3" json:"goma_job_count,omitempty"`
	// contains filtered or unexported fields
}

Context contains all of the dynamic configuration values for building Fuchsia. These values are context-dependent in that they vary based on git history and local filesystem layout, so they can only be known at runtime and cannot come from data checked into version control.

func (*Context) Descriptor deprecated

func (*Context) Descriptor() ([]byte, []int)

Deprecated: Use Context.ProtoReflect.Descriptor instead.

func (*Context) GetArtifactDir

func (x *Context) GetArtifactDir() string

func (*Context) GetBuildDir

func (x *Context) GetBuildDir() string

func (*Context) GetCacheDir

func (x *Context) GetCacheDir() string

func (*Context) GetChangedFiles

func (x *Context) GetChangedFiles() []*Context_ChangedFile

func (*Context) GetCheckoutDir

func (x *Context) GetCheckoutDir() string

func (*Context) GetClangToolchainDir

func (x *Context) GetClangToolchainDir() string

func (*Context) GetCollectCoverage

func (x *Context) GetCollectCoverage() bool

func (*Context) GetGccToolchainDir

func (x *Context) GetGccToolchainDir() string

func (*Context) GetGomaJobCount

func (x *Context) GetGomaJobCount() int32

func (*Context) GetReleaseVersion

func (x *Context) GetReleaseVersion() string

func (*Context) GetRustToolchainDir

func (x *Context) GetRustToolchainDir() string

func (*Context) GetSdkId

func (x *Context) GetSdkId() string

func (*Context) ProtoMessage

func (*Context) ProtoMessage()

func (*Context) ProtoReflect

func (x *Context) ProtoReflect() protoreflect.Message

func (*Context) Reset

func (x *Context) Reset()

func (*Context) String

func (x *Context) String() string

type Context_ChangedFile

type Context_ChangedFile struct {

	// Relative path to the file within the checkout.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// contains filtered or unexported fields
}

func (*Context_ChangedFile) Descriptor deprecated

func (*Context_ChangedFile) Descriptor() ([]byte, []int)

Deprecated: Use Context_ChangedFile.ProtoReflect.Descriptor instead.

func (*Context_ChangedFile) GetPath

func (x *Context_ChangedFile) GetPath() string

func (*Context_ChangedFile) ProtoMessage

func (*Context_ChangedFile) ProtoMessage()

func (*Context_ChangedFile) ProtoReflect

func (x *Context_ChangedFile) ProtoReflect() protoreflect.Message

func (*Context_ChangedFile) Reset

func (x *Context_ChangedFile) Reset()

func (*Context_ChangedFile) String

func (x *Context_ChangedFile) String() string

type SetArtifacts

type SetArtifacts struct {

	// A brief error log populated in case of a recognized failure mode (e.g.
	// `gn gen` failure due to a broken build graph).
	FailureSummary string `protobuf:"bytes,1,opt,name=failure_summary,json=failureSummary,proto3" json:"failure_summary,omitempty"`
	// The path to the `gn gen` tracelog.
	GnTracePath string `protobuf:"bytes,2,opt,name=gn_trace_path,json=gnTracePath,proto3" json:"gn_trace_path,omitempty"`
	// Whether the caller can skip calling `fint build`, based on the changed
	// files included in the context spec. Will always be false unless the
	// static spec's `skip_if_unaffected` field is set.
	SkipBuild bool `protobuf:"varint,3,opt,name=skip_build,json=skipBuild,proto3" json:"skip_build,omitempty"`
	// Whether the caller should set up Goma before invoking `fint build`.
	UseGoma  bool                   `protobuf:"varint,4,opt,name=use_goma,json=useGoma,proto3" json:"use_goma,omitempty"`
	Metadata *SetArtifacts_Metadata `protobuf:"bytes,5,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

SetArtifacts contains information about the manifests and other metadata produced by `fint set`.

func (*SetArtifacts) Descriptor deprecated

func (*SetArtifacts) Descriptor() ([]byte, []int)

Deprecated: Use SetArtifacts.ProtoReflect.Descriptor instead.

func (*SetArtifacts) GetFailureSummary

func (x *SetArtifacts) GetFailureSummary() string

func (*SetArtifacts) GetGnTracePath

func (x *SetArtifacts) GetGnTracePath() string

func (*SetArtifacts) GetMetadata

func (x *SetArtifacts) GetMetadata() *SetArtifacts_Metadata

func (*SetArtifacts) GetSkipBuild

func (x *SetArtifacts) GetSkipBuild() bool

func (*SetArtifacts) GetUseGoma

func (x *SetArtifacts) GetUseGoma() bool

func (*SetArtifacts) ProtoMessage

func (*SetArtifacts) ProtoMessage()

func (*SetArtifacts) ProtoReflect

func (x *SetArtifacts) ProtoReflect() protoreflect.Message

func (*SetArtifacts) Reset

func (x *SetArtifacts) Reset()

func (*SetArtifacts) String

func (x *SetArtifacts) String() string

type SetArtifacts_Metadata

type SetArtifacts_Metadata struct {
	Board      string   `protobuf:"bytes,1,opt,name=board,proto3" json:"board,omitempty"`
	Optimize   string   `protobuf:"bytes,2,opt,name=optimize,proto3" json:"optimize,omitempty"`
	Product    string   `protobuf:"bytes,3,opt,name=product,proto3" json:"product,omitempty"`
	TargetArch string   `protobuf:"bytes,4,opt,name=target_arch,json=targetArch,proto3" json:"target_arch,omitempty"`
	Variants   []string `protobuf:"bytes,5,rep,name=variants,proto3" json:"variants,omitempty"`
	// contains filtered or unexported fields
}

Metadata contains `fint set` parameters that are needed for post-processing steps by users of fint. We expose all of these values as strings, even `optimize` and `target_arch` (which are enums in static.proto), to make processing easier for consumers.

func (*SetArtifacts_Metadata) Descriptor deprecated

func (*SetArtifacts_Metadata) Descriptor() ([]byte, []int)

Deprecated: Use SetArtifacts_Metadata.ProtoReflect.Descriptor instead.

func (*SetArtifacts_Metadata) GetBoard

func (x *SetArtifacts_Metadata) GetBoard() string

func (*SetArtifacts_Metadata) GetOptimize

func (x *SetArtifacts_Metadata) GetOptimize() string

func (*SetArtifacts_Metadata) GetProduct

func (x *SetArtifacts_Metadata) GetProduct() string

func (*SetArtifacts_Metadata) GetTargetArch

func (x *SetArtifacts_Metadata) GetTargetArch() string

func (*SetArtifacts_Metadata) GetVariants

func (x *SetArtifacts_Metadata) GetVariants() []string

func (*SetArtifacts_Metadata) ProtoMessage

func (*SetArtifacts_Metadata) ProtoMessage()

func (*SetArtifacts_Metadata) ProtoReflect

func (x *SetArtifacts_Metadata) ProtoReflect() protoreflect.Message

func (*SetArtifacts_Metadata) Reset

func (x *SetArtifacts_Metadata) Reset()

func (*SetArtifacts_Metadata) String

func (x *SetArtifacts_Metadata) String() string

type Static

type Static struct {

	// The optimization level for the build.
	Optimize Static_Optimize `protobuf:"varint,1,opt,name=optimize,proto3,enum=fint.Static_Optimize" json:"optimize,omitempty"`
	// The board to build.
	Board string `protobuf:"bytes,2,opt,name=board,proto3" json:"board,omitempty"`
	// The product file to build.
	Product string `protobuf:"bytes,3,opt,name=product,proto3" json:"product,omitempty"`
	// Whether to skip building the basic images needed to boot and test on
	// Fuchsia.
	ExcludeImages bool `protobuf:"varint,4,opt,name=exclude_images,json=excludeImages,proto3" json:"exclude_images,omitempty"`
	// Extra args to pass to gn gen.
	GnArgs []string `protobuf:"bytes,5,rep,name=gn_args,json=gnArgs,proto3" json:"gn_args,omitempty"`
	// Extra targets to pass to Ninja.
	NinjaTargets []string `protobuf:"bytes,6,rep,name=ninja_targets,json=ninjaTargets,proto3" json:"ninja_targets,omitempty"`
	// Fuchsia packages to build and include in the base set.
	BasePackages []string `protobuf:"bytes,7,rep,name=base_packages,json=basePackages,proto3" json:"base_packages,omitempty"`
	// Fuchsia packages to build and include in the cache set.
	CachePackages []string `protobuf:"bytes,8,rep,name=cache_packages,json=cachePackages,proto3" json:"cache_packages,omitempty"`
	// Fuchsia packages to build and include in the universe set.
	UniversePackages []string `protobuf:"bytes,9,rep,name=universe_packages,json=universePackages,proto3" json:"universe_packages,omitempty"`
	// Whether to build host tests.
	IncludeHostTests bool `protobuf:"varint,10,opt,name=include_host_tests,json=includeHostTests,proto3" json:"include_host_tests,omitempty"`
	// The target CPU architecture.
	TargetArch Static_Arch `protobuf:"varint,11,opt,name=target_arch,json=targetArch,proto3,enum=fint.Static_Arch" json:"target_arch,omitempty"`
	// Values of select_variant GN argument.
	Variants []string `protobuf:"bytes,12,rep,name=variants,proto3" json:"variants,omitempty"`
	// Whether to include archives in the build.
	IncludeArchives bool `protobuf:"varint,13,opt,name=include_archives,json=includeArchives,proto3" json:"include_archives,omitempty"`
	// Whether to skip the ninja build if we're running in CQ and none of the
	// changed files affect the build.
	SkipIfUnaffected bool `protobuf:"varint,14,opt,name=skip_if_unaffected,json=skipIfUnaffected,proto3" json:"skip_if_unaffected,omitempty"`
	// The path within the checkout of a file containing historical test duration
	// data specific to the current build config.
	TestDurationsFile string `protobuf:"bytes,15,opt,name=test_durations_file,json=testDurationsFile,proto3" json:"test_durations_file,omitempty"`
	// If `test_durations_file` doesn't exist within the checkout, use this file
	// instead. It's not specific to the current build config, but it can be
	// assumed to always exist.
	DefaultTestDurationsFile string `` /* 138-byte string literal not displayed */
	// Whether to use goma for running ninja. Will be ignored (and goma will not
	// be used) when building with some experimental toolchain versions.
	UseGoma bool `protobuf:"varint,17,opt,name=use_goma,json=useGoma,proto3" json:"use_goma,omitempty"`
	// Whether to generate a listing of the commands run during the build.
	GenerateCompdb bool `protobuf:"varint,18,opt,name=generate_compdb,json=generateCompdb,proto3" json:"generate_compdb,omitempty"`
	// Host-only targets to build.
	HostLabels []string `protobuf:"bytes,21,rep,name=host_labels,json=hostLabels,proto3" json:"host_labels,omitempty"`
	// Whether to use a go cache when building.
	EnableGoCache bool `protobuf:"varint,22,opt,name=enable_go_cache,json=enableGoCache,proto3" json:"enable_go_cache,omitempty"`
	// Whether to use a rust cache when building.
	EnableRustCache bool `protobuf:"varint,23,opt,name=enable_rust_cache,json=enableRustCache,proto3" json:"enable_rust_cache,omitempty"`
	// Which IDE files to generate.
	IdeFiles []string `protobuf:"bytes,24,rep,name=ide_files,json=ideFiles,proto3" json:"ide_files,omitempty"`
	// Passed to --json-ide-script GN flag; GN will execute each of these scripts
	// after regenerating the project.json IDE file.
	JsonIdeScripts []string `protobuf:"bytes,25,rep,name=json_ide_scripts,json=jsonIdeScripts,proto3" json:"json_ide_scripts,omitempty"`
	// Whether to build images for paving (rather than netbooting). Ignored if
	// `exclude_images` is true.
	Pave bool `protobuf:"varint,26,opt,name=pave,proto3" json:"pave,omitempty"`
	// contains filtered or unexported fields
}

Static contains all of the non-dynamic configuration values for building Fuchsia. These values are "static" in the sense that they don't vary depending on things like git history or local environment, so they can be checked into version control.

func (*Static) Descriptor deprecated

func (*Static) Descriptor() ([]byte, []int)

Deprecated: Use Static.ProtoReflect.Descriptor instead.

func (*Static) GetBasePackages

func (x *Static) GetBasePackages() []string

func (*Static) GetBoard

func (x *Static) GetBoard() string

func (*Static) GetCachePackages

func (x *Static) GetCachePackages() []string

func (*Static) GetDefaultTestDurationsFile

func (x *Static) GetDefaultTestDurationsFile() string

func (*Static) GetEnableGoCache

func (x *Static) GetEnableGoCache() bool

func (*Static) GetEnableRustCache

func (x *Static) GetEnableRustCache() bool

func (*Static) GetExcludeImages

func (x *Static) GetExcludeImages() bool

func (*Static) GetGenerateCompdb

func (x *Static) GetGenerateCompdb() bool

func (*Static) GetGnArgs

func (x *Static) GetGnArgs() []string

func (*Static) GetHostLabels

func (x *Static) GetHostLabels() []string

func (*Static) GetIdeFiles

func (x *Static) GetIdeFiles() []string

func (*Static) GetIncludeArchives

func (x *Static) GetIncludeArchives() bool

func (*Static) GetIncludeHostTests

func (x *Static) GetIncludeHostTests() bool

func (*Static) GetJsonIdeScripts

func (x *Static) GetJsonIdeScripts() []string

func (*Static) GetNinjaTargets

func (x *Static) GetNinjaTargets() []string

func (*Static) GetOptimize

func (x *Static) GetOptimize() Static_Optimize

func (*Static) GetPave

func (x *Static) GetPave() bool

func (*Static) GetProduct

func (x *Static) GetProduct() string

func (*Static) GetSkipIfUnaffected

func (x *Static) GetSkipIfUnaffected() bool

func (*Static) GetTargetArch

func (x *Static) GetTargetArch() Static_Arch

func (*Static) GetTestDurationsFile

func (x *Static) GetTestDurationsFile() string

func (*Static) GetUniversePackages

func (x *Static) GetUniversePackages() []string

func (*Static) GetUseGoma

func (x *Static) GetUseGoma() bool

func (*Static) GetVariants

func (x *Static) GetVariants() []string

func (*Static) ProtoMessage

func (*Static) ProtoMessage()

func (*Static) ProtoReflect

func (x *Static) ProtoReflect() protoreflect.Message

func (*Static) Reset

func (x *Static) Reset()

func (*Static) String

func (x *Static) String() string

type Static_Arch

type Static_Arch int32
const (
	Static_ARCH_UNSPECIFIED Static_Arch = 0 // See OPTIMIZE_UNSPECIFIED for rationale.
	Static_ARM64            Static_Arch = 1
	Static_X64              Static_Arch = 2
)

func (Static_Arch) Descriptor

func (Static_Arch) Enum

func (x Static_Arch) Enum() *Static_Arch

func (Static_Arch) EnumDescriptor deprecated

func (Static_Arch) EnumDescriptor() ([]byte, []int)

Deprecated: Use Static_Arch.Descriptor instead.

func (Static_Arch) Number

func (x Static_Arch) Number() protoreflect.EnumNumber

func (Static_Arch) String

func (x Static_Arch) String() string

func (Static_Arch) Type

type Static_Optimize

type Static_Optimize int32
const (
	// If new values are added to an enum, a client using an old version of the
	// protobuf definition will have all new values mapped to the enum's zero
	// value. So it's important that the zero value be "special" rather than a
	// regular value so the client can easily detect that something is wrong.
	// See http://go/totw-4 for more info.
	// TODO(olivernewman): Link to a public explanation if and when it becomes
	// available.
	Static_OPTIMIZE_UNSPECIFIED Static_Optimize = 0
	Static_DEBUG                Static_Optimize = 1
	Static_RELEASE              Static_Optimize = 2
)

func (Static_Optimize) Descriptor

func (Static_Optimize) Enum

func (x Static_Optimize) Enum() *Static_Optimize

func (Static_Optimize) EnumDescriptor deprecated

func (Static_Optimize) EnumDescriptor() ([]byte, []int)

Deprecated: Use Static_Optimize.Descriptor instead.

func (Static_Optimize) Number

func (Static_Optimize) String

func (x Static_Optimize) String() string

func (Static_Optimize) Type

Jump to

Keyboard shortcuts

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