Back to godoc.org

Package annopb

v0.0.0-...-1557bcf
Latest Go to latest

The latest major version is .

Published: Aug 13, 2020 | License: Apache-2.0 | Module: github.com/luci/luci-go

Overview

Package annopb contains protobuf definitions for legacy annotation.

The package name here must match the protobuf package name, as the generated files will reside in the same directory.

Index

Constants

const ContentTypeAnnotations = "text/x-chrome-infra-annotations; version=2"

ContentTypeAnnotations is a stream content type for annotation streams.

Variables

var (
	Status_name = map[int32]string{
		0: "RUNNING",
		1: "SUCCESS",
		2: "FAILURE",
		3: "PENDING",
	}
	Status_value = map[string]int32{
		"RUNNING": 0,
		"SUCCESS": 1,
		"FAILURE": 2,
		"PENDING": 3,
	}
)

Enum value maps for Status.

var (
	FailureDetails_Type_name = map[int32]string{
		0: "GENERAL",
		1: "EXCEPTION",
		2: "INFRA",
		3: "DM_DEPENDENCY_FAILED",
		4: "CANCELLED",
		5: "EXPIRED",
	}
	FailureDetails_Type_value = map[string]int32{
		"GENERAL":              0,
		"EXCEPTION":            1,
		"INFRA":                2,
		"DM_DEPENDENCY_FAILED": 3,
		"CANCELLED":            4,
		"EXPIRED":              5,
	}
)

Enum value maps for FailureDetails_Type.

var File_go_chromium_org_luci_luciexe_legacy_annotee_proto_annotations_proto protoreflect.FileDescriptor

func ExtractProperties

func ExtractProperties(s *Step) (*structpb.Struct, error)

ExtractProperties returns a flat list of properties from a tree of steps. If multiple step nodes have a property of the same name, the last one in the preorder traversal wins.

type AnnotationLink struct {

	// An optional display label for the link.
	Label string `protobuf:"bytes,1,opt,name=label,proto3" json:"label,omitempty"`
	// If present, this link is an alias for another link with this name, and
	// should be rendered in relation to that link.
	AliasLabel string `protobuf:"bytes,2,opt,name=alias_label,json=aliasLabel,proto3" json:"alias_label,omitempty"`
	// Types that are assignable to Value:
	//	*AnnotationLink_Url
	//	*AnnotationLink_LogdogStream
	//	*AnnotationLink_IsolateObject
	//	*AnnotationLink_DmLink
	Value isAnnotationLink_Value `protobuf_oneof:"value"`
	// contains filtered or unexported fields
}

A Link is an optional label followed by a typed link to an external resource.

func (*AnnotationLink) Descriptor

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

Deprecated: Use AnnotationLink.ProtoReflect.Descriptor instead.

func (*AnnotationLink) GetAliasLabel

func (x *AnnotationLink) GetAliasLabel() string
func (x *AnnotationLink) GetDmLink() *DMLink

func (*AnnotationLink) GetIsolateObject

func (x *AnnotationLink) GetIsolateObject() *IsolateObject

func (*AnnotationLink) GetLabel

func (x *AnnotationLink) GetLabel() string

func (*AnnotationLink) GetLogdogStream

func (x *AnnotationLink) GetLogdogStream() *LogdogStream

func (*AnnotationLink) GetUrl

func (x *AnnotationLink) GetUrl() string

func (*AnnotationLink) GetValue

func (m *AnnotationLink) GetValue() isAnnotationLink_Value

func (*AnnotationLink) ProtoMessage

func (*AnnotationLink) ProtoMessage()

func (*AnnotationLink) ProtoReflect

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

func (*AnnotationLink) Reset

func (x *AnnotationLink) Reset()

func (*AnnotationLink) String

func (x *AnnotationLink) String() string
type AnnotationLink_DmLink struct {
	// (One of) A link to a Dungeon Master object.
	DmLink *DMLink `protobuf:"bytes,6,opt,name=dm_link,json=dmLink,proto3,oneof"`
}
type AnnotationLink_IsolateObject struct {
	// (One of) An isolate server link.
	IsolateObject *IsolateObject `protobuf:"bytes,5,opt,name=isolate_object,json=isolateObject,proto3,oneof"`
}
type AnnotationLink_LogdogStream struct {
	// (One of) A LogDog stream link.
	LogdogStream *LogdogStream `protobuf:"bytes,4,opt,name=logdog_stream,json=logdogStream,proto3,oneof"`
}
type AnnotationLink_Url struct {
	// A URL.
	Url string `protobuf:"bytes,3,opt,name=url,proto3,oneof"`
}
type DMLink struct {

	// The Dungeon Master server. If empty, this is the default Isolate server
	// specified by the project's LUCI config.
	Server string `protobuf:"bytes,1,opt,name=server,proto3" json:"server,omitempty"`
	// The quest name.
	Quest string `protobuf:"bytes,2,opt,name=quest,proto3" json:"quest,omitempty"`
	// The attempt number.
	Attempt int64 `protobuf:"varint,3,opt,name=attempt,proto3" json:"attempt,omitempty"`
	// The execution number.
	Execution int64 `protobuf:"varint,4,opt,name=execution,proto3" json:"execution,omitempty"`
	// contains filtered or unexported fields
}

DMLink is a Dungeon Master execution specification.

func (*DMLink) Descriptor

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

Deprecated: Use DMLink.ProtoReflect.Descriptor instead.

func (*DMLink) GetAttempt

func (x *DMLink) GetAttempt() int64

func (*DMLink) GetExecution

func (x *DMLink) GetExecution() int64

func (*DMLink) GetQuest

func (x *DMLink) GetQuest() string

func (*DMLink) GetServer

func (x *DMLink) GetServer() string

func (*DMLink) ProtoMessage

func (*DMLink) ProtoMessage()

func (*DMLink) ProtoReflect

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

func (*DMLink) Reset

func (x *DMLink) Reset()

func (*DMLink) String

func (x *DMLink) String() string

type FailureDetails

type FailureDetails struct {
	Type FailureDetails_Type `protobuf:"varint,1,opt,name=type,proto3,enum=annotation.FailureDetails_Type" json:"type,omitempty"`
	// An optional string describing the failure.
	Text string `protobuf:"bytes,2,opt,name=text,proto3" json:"text,omitempty"`
	// If the failure type is DEPENDENCY_FAILED, the failed dependencies should be
	// listed here.
	FailedDmDependency []*DMLink `protobuf:"bytes,3,rep,name=failed_dm_dependency,json=failedDmDependency,proto3" json:"failed_dm_dependency,omitempty"`
	// contains filtered or unexported fields
}

FailureType provides more details on the nature of the Status.

func (*FailureDetails) Descriptor

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

Deprecated: Use FailureDetails.ProtoReflect.Descriptor instead.

func (*FailureDetails) GetFailedDmDependency

func (x *FailureDetails) GetFailedDmDependency() []*DMLink

func (*FailureDetails) GetText

func (x *FailureDetails) GetText() string

func (*FailureDetails) GetType

func (x *FailureDetails) GetType() FailureDetails_Type

func (*FailureDetails) ProtoMessage

func (*FailureDetails) ProtoMessage()

func (*FailureDetails) ProtoReflect

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

func (*FailureDetails) Reset

func (x *FailureDetails) Reset()

func (*FailureDetails) String

func (x *FailureDetails) String() string

type FailureDetails_Type

type FailureDetails_Type int32

Type is the type of failure.

const (
	// The failure is a general failure.
	FailureDetails_GENERAL FailureDetails_Type = 0
	// An unhandled exception occurred during execution.
	FailureDetails_EXCEPTION FailureDetails_Type = 1
	// The failure is related to a failed infrastructure component, not an error
	// with the Step itself.
	FailureDetails_INFRA FailureDetails_Type = 2
	// The failure is due to a failed Dungeon Master dependency. This should be
	// used if a Step's external depdendency fails and the Step cannot recover
	// or proceed without it.
	FailureDetails_DM_DEPENDENCY_FAILED FailureDetails_Type = 3
	// The step was cancelled.
	FailureDetails_CANCELLED FailureDetails_Type = 4
	// The failure was due to an resource exhausion. The step was scheduled
	// but never ran, and never will run.
	FailureDetails_EXPIRED FailureDetails_Type = 5
)

func (FailureDetails_Type) Descriptor

func (FailureDetails_Type) Descriptor() protoreflect.EnumDescriptor

func (FailureDetails_Type) Enum

func (x FailureDetails_Type) Enum() *FailureDetails_Type

func (FailureDetails_Type) EnumDescriptor

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

Deprecated: Use FailureDetails_Type.Descriptor instead.

func (FailureDetails_Type) Number

func (x FailureDetails_Type) Number() protoreflect.EnumNumber

func (FailureDetails_Type) String

func (x FailureDetails_Type) String() string

func (FailureDetails_Type) Type

func (FailureDetails_Type) Type() protoreflect.EnumType

type IsolateObject

type IsolateObject struct {

	// The Isolate server. If empty, this is the default Isolate server specified
	// by the project's LUCI config.
	Server string `protobuf:"bytes,1,opt,name=server,proto3" json:"server,omitempty"`
	// The isolate object hash.
	Hash string `protobuf:"bytes,2,opt,name=hash,proto3" json:"hash,omitempty"`
	// contains filtered or unexported fields
}

IsolateObject is an Isolate service object specification.

func (*IsolateObject) Descriptor

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

Deprecated: Use IsolateObject.ProtoReflect.Descriptor instead.

func (*IsolateObject) GetHash

func (x *IsolateObject) GetHash() string

func (*IsolateObject) GetServer

func (x *IsolateObject) GetServer() string

func (*IsolateObject) ProtoMessage

func (*IsolateObject) ProtoMessage()

func (*IsolateObject) ProtoReflect

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

func (*IsolateObject) Reset

func (x *IsolateObject) Reset()

func (*IsolateObject) String

func (x *IsolateObject) String() string

type LogdogStream

type LogdogStream struct {

	// The stream's server. If omitted, the server is the same server that this
	// annotation stream is homed on.
	Server string `protobuf:"bytes,1,opt,name=server,proto3" json:"server,omitempty"`
	// The log Prefix. If empty, the prefix is the same prefix as this annotation
	// stream.
	Prefix string `protobuf:"bytes,2,opt,name=prefix,proto3" json:"prefix,omitempty"`
	// The log name.
	Name string `protobuf:"bytes,3,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

LogdogStream is a LogDog stream link.

func (*LogdogStream) Descriptor

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

Deprecated: Use LogdogStream.ProtoReflect.Descriptor instead.

func (*LogdogStream) GetName

func (x *LogdogStream) GetName() string

func (*LogdogStream) GetPrefix

func (x *LogdogStream) GetPrefix() string

func (*LogdogStream) GetServer

func (x *LogdogStream) GetServer() string

func (*LogdogStream) ProtoMessage

func (*LogdogStream) ProtoMessage()

func (*LogdogStream) ProtoReflect

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

func (*LogdogStream) Reset

func (x *LogdogStream) Reset()

func (*LogdogStream) String

func (x *LogdogStream) String() string

type Status

type Status int32

Status is the expressed root step of this step or substep.

const (
	// The step is still running.
	Status_RUNNING Status = 0
	// The step has finished successfully.
	Status_SUCCESS Status = 1
	// The step has finished unsuccessfully.
	Status_FAILURE Status = 2
	// The step has been scheduled, but not yet started.
	Status_PENDING Status = 3
)

func (Status) Descriptor

func (Status) Descriptor() protoreflect.EnumDescriptor

func (Status) Enum

func (x Status) Enum() *Status

func (Status) EnumDescriptor

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

Deprecated: Use Status.Descriptor instead.

func (Status) Number

func (x Status) Number() protoreflect.EnumNumber

func (Status) String

func (x Status) String() string

func (Status) Type

func (Status) Type() protoreflect.EnumType

type Step

type Step struct {
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`

	Command *Step_Command `protobuf:"bytes,2,opt,name=command,proto3" json:"command,omitempty"`

	Status Status `protobuf:"varint,3,opt,name=status,proto3,enum=annotation.Status" json:"status,omitempty"`

	FailureDetails *FailureDetails `protobuf:"bytes,4,opt,name=failure_details,json=failureDetails,proto3" json:"failure_details,omitempty"`

	Substep []*Step_Substep `protobuf:"bytes,5,rep,name=substep,proto3" json:"substep,omitempty"`

	StdoutStream *LogdogStream `protobuf:"bytes,6,opt,name=stdout_stream,json=stdoutStream,proto3" json:"stdout_stream,omitempty"`

	StderrStream *LogdogStream `protobuf:"bytes,7,opt,name=stderr_stream,json=stderrStream,proto3" json:"stderr_stream,omitempty"`

	Started *timestamp.Timestamp `protobuf:"bytes,8,opt,name=started,proto3" json:"started,omitempty"`

	Ended *timestamp.Timestamp `protobuf:"bytes,9,opt,name=ended,proto3" json:"ended,omitempty"`

	Text []string `protobuf:"bytes,20,rep,name=text,proto3" json:"text,omitempty"`

	Progress *Step_Progress `protobuf:"bytes,21,opt,name=progress,proto3" json:"progress,omitempty"`

	Link *AnnotationLink `protobuf:"bytes,22,opt,name=link,proto3" json:"link,omitempty"`

	OtherLinks []*AnnotationLink `protobuf:"bytes,23,rep,name=other_links,json=otherLinks,proto3" json:"other_links,omitempty"`
	Property   []*Step_Property  `protobuf:"bytes,24,rep,name=property,proto3" json:"property,omitempty"`

	SourceManifests map[string]*srcman.ManifestLink "" /* 195 byte string literal not displayed */

}

Generic step or substep state.

func (*Step) Descriptor

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

Deprecated: Use Step.ProtoReflect.Descriptor instead.

func (*Step) GetCommand

func (x *Step) GetCommand() *Step_Command

func (*Step) GetEnded

func (x *Step) GetEnded() *timestamp.Timestamp

func (*Step) GetFailureDetails

func (x *Step) GetFailureDetails() *FailureDetails
func (x *Step) GetLink() *AnnotationLink

func (*Step) GetName

func (x *Step) GetName() string
func (x *Step) GetOtherLinks() []*AnnotationLink

func (*Step) GetProgress

func (x *Step) GetProgress() *Step_Progress

func (*Step) GetProperty

func (x *Step) GetProperty() []*Step_Property

func (*Step) GetSourceManifests

func (x *Step) GetSourceManifests() map[string]*srcman.ManifestLink

func (*Step) GetStarted

func (x *Step) GetStarted() *timestamp.Timestamp

func (*Step) GetStatus

func (x *Step) GetStatus() Status

func (*Step) GetStderrStream

func (x *Step) GetStderrStream() *LogdogStream

func (*Step) GetStdoutStream

func (x *Step) GetStdoutStream() *LogdogStream

func (*Step) GetSubstep

func (x *Step) GetSubstep() []*Step_Substep

func (*Step) GetText

func (x *Step) GetText() []string

func (*Step) ProtoMessage

func (*Step) ProtoMessage()

func (*Step) ProtoReflect

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

func (*Step) Reset

func (x *Step) Reset()

func (*Step) String

func (x *Step) String() string

type Step_Command

type Step_Command struct {
	CommandLine []string `protobuf:"bytes,1,rep,name=command_line,json=commandLine,proto3" json:"command_line,omitempty"`

	Cwd string `protobuf:"bytes,2,opt,name=cwd,proto3" json:"cwd,omitempty"`

	Environ map[string]string "" /* 155 byte string literal not displayed */

}

Command contains information about a command-line invocation.

func (*Step_Command) Descriptor

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

Deprecated: Use Step_Command.ProtoReflect.Descriptor instead.

func (*Step_Command) GetCommandLine

func (x *Step_Command) GetCommandLine() []string

func (*Step_Command) GetCwd

func (x *Step_Command) GetCwd() string

func (*Step_Command) GetEnviron

func (x *Step_Command) GetEnviron() map[string]string

func (*Step_Command) ProtoMessage

func (*Step_Command) ProtoMessage()

func (*Step_Command) ProtoReflect

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

func (*Step_Command) Reset

func (x *Step_Command) Reset()

func (*Step_Command) String

func (x *Step_Command) String() string

type Step_Progress

type Step_Progress struct {

	// The total number of progress units. If missing or zero, no progress is
	// expressed.
	Total int32 `protobuf:"varint,1,opt,name=total,proto3" json:"total,omitempty"`
	// The number of completed progress units. This must always be less than or
	// equal to `total`. If omitted, it is implied to be zero.
	Completed int32 `protobuf:"varint,2,opt,name=completed,proto3" json:"completed,omitempty"`
	// contains filtered or unexported fields
}

Progress expresses a Component's overall progress. It does this using arbitrary "progress units", which are discrete units of work measured by the Component that are either completed or not completed.

A simple construction for "percentage complete" is to set `total` to 100 and `completed` to the percentage value.

func (*Step_Progress) Descriptor

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

Deprecated: Use Step_Progress.ProtoReflect.Descriptor instead.

func (*Step_Progress) GetCompleted

func (x *Step_Progress) GetCompleted() int32

func (*Step_Progress) GetTotal

func (x *Step_Progress) GetTotal() int32

func (*Step_Progress) ProtoMessage

func (*Step_Progress) ProtoMessage()

func (*Step_Progress) ProtoReflect

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

func (*Step_Progress) Reset

func (x *Step_Progress) Reset()

func (*Step_Progress) String

func (x *Step_Progress) String() string

type Step_Property

type Step_Property struct {

	// name is the property name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// value is the optional property value.
	Value string `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
	// contains filtered or unexported fields
}

Property is an arbitrary key/value (build) property.

func (*Step_Property) Descriptor

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

Deprecated: Use Step_Property.ProtoReflect.Descriptor instead.

func (*Step_Property) GetName

func (x *Step_Property) GetName() string

func (*Step_Property) GetValue

func (x *Step_Property) GetValue() string

func (*Step_Property) ProtoMessage

func (*Step_Property) ProtoMessage()

func (*Step_Property) ProtoReflect

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

func (*Step_Property) Reset

func (x *Step_Property) Reset()

func (*Step_Property) String

func (x *Step_Property) String() string

type Step_Substep

type Step_Substep struct {

	// The substep.
	//
	// Types that are assignable to Substep:
	//	*Step_Substep_Step
	//	*Step_Substep_AnnotationStream
	Substep isStep_Substep_Substep `protobuf_oneof:"substep"`
	// contains filtered or unexported fields
}

Sub-steps nested underneath of this step.

func (*Step_Substep) Descriptor

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

Deprecated: Use Step_Substep.ProtoReflect.Descriptor instead.

func (*Step_Substep) GetAnnotationStream

func (x *Step_Substep) GetAnnotationStream() *LogdogStream

func (*Step_Substep) GetStep

func (x *Step_Substep) GetStep() *Step

func (*Step_Substep) GetSubstep

func (m *Step_Substep) GetSubstep() isStep_Substep_Substep

func (*Step_Substep) ProtoMessage

func (*Step_Substep) ProtoMessage()

func (*Step_Substep) ProtoReflect

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

func (*Step_Substep) Reset

func (x *Step_Substep) Reset()

func (*Step_Substep) String

func (x *Step_Substep) String() string

type Step_Substep_AnnotationStream

type Step_Substep_AnnotationStream struct {
	// The substep is a separate LogDog annotation stream.
	AnnotationStream *LogdogStream `protobuf:"bytes,2,opt,name=annotation_stream,json=annotationStream,proto3,oneof"`
}

type Step_Substep_Step

type Step_Substep_Step struct {
	// The substep is an inline Step.
	Step *Step `protobuf:"bytes,1,opt,name=step,proto3,oneof"`
}

Package Files

Documentation was rendered with GOOS=linux and GOARCH=amd64.

Jump to identifier

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to identifier