config: go.chromium.org/chromiumos/config/go/api/test/metadata/v1 Index | Files

package metadata

import "go.chromium.org/chromiumos/config/go/api/test/metadata/v1"

Index

Package Files

metadata.pb.go

type Attribute Uses

type Attribute struct {
    // Opaque name for this attribute.
    //
    // Value MUST be valid resource names per https://aip.dev/122.
    //
    // MUST NOT be interpreted by Test Lab Environments.
    Name                 string   `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
    XXX_NoUnkeyedLiteral struct{} `json:"-"`
    XXX_unrecognized     []byte   `json:"-"`
    XXX_sizecache        int32    `json:"-"`
}

Attributes used to include tests in test plans.

func (*Attribute) Descriptor Uses

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

func (*Attribute) GetName Uses

func (m *Attribute) GetName() string

func (*Attribute) ProtoMessage Uses

func (*Attribute) ProtoMessage()

func (*Attribute) Reset Uses

func (m *Attribute) Reset()

func (*Attribute) String Uses

func (m *Attribute) String() string

func (*Attribute) XXX_DiscardUnknown Uses

func (m *Attribute) XXX_DiscardUnknown()

func (*Attribute) XXX_Marshal Uses

func (m *Attribute) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Attribute) XXX_Merge Uses

func (m *Attribute) XXX_Merge(src proto.Message)

func (*Attribute) XXX_Size Uses

func (m *Attribute) XXX_Size() int

func (*Attribute) XXX_Unmarshal Uses

func (m *Attribute) XXX_Unmarshal(b []byte) error

type BuildArtifact Uses

type BuildArtifact struct {
    // All build artifacts are assumed to be archived in some common directory
    // root. `relative_path` is the relative path inside the root archive
    // directory.
    //
    // Infrastructure Test Lab Environment: Chrome OS Continuous Integration
    // builders archive build artifacts to a path on Google Storage. The Test
    // Platform requests include a reference to the root archival path.
    // e.g.,
    // * The builder archives all build artifacts to
    //   gs://chromeos-image-archive/link-release/R64-0.0.0.0/
    // * Test Platform request includes this archival path.
    // * `relative_path` is set to tast/mighty.bin
    // * Then, the full path to the artifact is
    //   gs://chromeos-image-archive/link-release/R64-0.0.0.0/tast/mighty.bin
    //
    // Developer Test Lab Environment: For developer flow outside of the
    // infrastructure, it is assumed that the build artifacts are available at a
    // local path with the same directory layout as the Google Storage archival.
    // e.g.,
    // * Local build copies all artifacts to /tmp/cbuildbot/archive/
    // * Local tooling includes a reference to this path.
    // * `relative_path` is set to tauto/ssp.bin
    // * Then, the full path to the artifact is
    //   /tmp/cbuildbot/archive/tauto/ssp.bin
    RelativePath         string   `protobuf:"bytes,1,opt,name=relative_path,json=relativePath,proto3" json:"relative_path,omitempty"`
    XXX_NoUnkeyedLiteral struct{} `json:"-"`
    XXX_unrecognized     []byte   `json:"-"`
    XXX_sizecache        int32    `json:"-"`
}

A Chrome OS build artifact required for test execution.

func (*BuildArtifact) Descriptor Uses

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

func (*BuildArtifact) GetRelativePath Uses

func (m *BuildArtifact) GetRelativePath() string

func (*BuildArtifact) ProtoMessage Uses

func (*BuildArtifact) ProtoMessage()

func (*BuildArtifact) Reset Uses

func (m *BuildArtifact) Reset()

func (*BuildArtifact) String Uses

func (m *BuildArtifact) String() string

func (*BuildArtifact) XXX_DiscardUnknown Uses

func (m *BuildArtifact) XXX_DiscardUnknown()

func (*BuildArtifact) XXX_Marshal Uses

func (m *BuildArtifact) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*BuildArtifact) XXX_Merge Uses

func (m *BuildArtifact) XXX_Merge(src proto.Message)

func (*BuildArtifact) XXX_Size Uses

func (m *BuildArtifact) XXX_Size() int

func (*BuildArtifact) XXX_Unmarshal Uses

func (m *BuildArtifact) XXX_Unmarshal(b []byte) error

type Contact Uses

type Contact struct {
    // Types that are valid to be assigned to Type:
    //	*Contact_Email
    //	*Contact_MdbGroup
    Type                 isContact_Type `protobuf_oneof:"type"`
    XXX_NoUnkeyedLiteral struct{}       `json:"-"`
    XXX_unrecognized     []byte         `json:"-"`
    XXX_sizecache        int32          `json:"-"`
}

Contact information of individuals or teams.

func (*Contact) Descriptor Uses

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

func (*Contact) GetEmail Uses

func (m *Contact) GetEmail() string

func (*Contact) GetMdbGroup Uses

func (m *Contact) GetMdbGroup() string

func (*Contact) GetType Uses

func (m *Contact) GetType() isContact_Type

func (*Contact) ProtoMessage Uses

func (*Contact) ProtoMessage()

func (*Contact) Reset Uses

func (m *Contact) Reset()

func (*Contact) String Uses

func (m *Contact) String() string

func (*Contact) XXX_DiscardUnknown Uses

func (m *Contact) XXX_DiscardUnknown()

func (*Contact) XXX_Marshal Uses

func (m *Contact) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Contact) XXX_Merge Uses

func (m *Contact) XXX_Merge(src proto.Message)

func (*Contact) XXX_OneofWrappers Uses

func (*Contact) XXX_OneofWrappers() []interface{}

XXX_OneofWrappers is for the internal use of the proto package.

func (*Contact) XXX_Size Uses

func (m *Contact) XXX_Size() int

func (*Contact) XXX_Unmarshal Uses

func (m *Contact) XXX_Unmarshal(b []byte) error

type Contact_Email Uses

type Contact_Email struct {
    Email string `protobuf:"bytes,1,opt,name=email,proto3,oneof"`
}

type Contact_MdbGroup Uses

type Contact_MdbGroup struct {
    MdbGroup string `protobuf:"bytes,2,opt,name=mdb_group,json=mdbGroup,proto3,oneof"`
}

type DUTCondition Uses

type DUTCondition struct {
    Expression           string   `protobuf:"bytes,1,opt,name=expression,proto3" json:"expression,omitempty"`
    XXX_NoUnkeyedLiteral struct{} `json:"-"`
    XXX_unrecognized     []byte   `json:"-"`
    XXX_sizecache        int32    `json:"-"`
}

Deprecated. Use DutConstraint instead. This message will be deleted once all clients have migrated.

func (*DUTCondition) Descriptor Uses

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

func (*DUTCondition) GetExpression Uses

func (m *DUTCondition) GetExpression() string

func (*DUTCondition) ProtoMessage Uses

func (*DUTCondition) ProtoMessage()

func (*DUTCondition) Reset Uses

func (m *DUTCondition) Reset()

func (*DUTCondition) String Uses

func (m *DUTCondition) String() string

func (*DUTCondition) XXX_DiscardUnknown Uses

func (m *DUTCondition) XXX_DiscardUnknown()

func (*DUTCondition) XXX_Marshal Uses

func (m *DUTCondition) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTCondition) XXX_Merge Uses

func (m *DUTCondition) XXX_Merge(src proto.Message)

func (*DUTCondition) XXX_Size Uses

func (m *DUTCondition) XXX_Size() int

func (*DUTCondition) XXX_Unmarshal Uses

func (m *DUTCondition) XXX_Unmarshal(b []byte) error

type DUTCondition_Scope Uses

type DUTCondition_Scope struct {
    Setup                *v1.DeviceUnderTest   `protobuf:"bytes,1,opt,name=setup,proto3" json:"setup,omitempty"`
    HardwareTopology     *api.HardwareTopology `protobuf:"bytes,2,opt,name=hardware_topology,json=hardwareTopology,proto3" json:"hardware_topology,omitempty"`
    HardwareFeatures     *api.HardwareFeatures `protobuf:"bytes,3,opt,name=hardware_features,json=hardwareFeatures,proto3" json:"hardware_features,omitempty"`
    XXX_NoUnkeyedLiteral struct{}              `json:"-"`
    XXX_unrecognized     []byte                `json:"-"`
    XXX_sizecache        int32                 `json:"-"`
}

func (*DUTCondition_Scope) Descriptor Uses

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

func (*DUTCondition_Scope) GetHardwareFeatures Uses

func (m *DUTCondition_Scope) GetHardwareFeatures() *api.HardwareFeatures

func (*DUTCondition_Scope) GetHardwareTopology Uses

func (m *DUTCondition_Scope) GetHardwareTopology() *api.HardwareTopology

func (*DUTCondition_Scope) GetSetup Uses

func (m *DUTCondition_Scope) GetSetup() *v1.DeviceUnderTest

func (*DUTCondition_Scope) ProtoMessage Uses

func (*DUTCondition_Scope) ProtoMessage()

func (*DUTCondition_Scope) Reset Uses

func (m *DUTCondition_Scope) Reset()

func (*DUTCondition_Scope) String Uses

func (m *DUTCondition_Scope) String() string

func (*DUTCondition_Scope) XXX_DiscardUnknown Uses

func (m *DUTCondition_Scope) XXX_DiscardUnknown()

func (*DUTCondition_Scope) XXX_Marshal Uses

func (m *DUTCondition_Scope) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTCondition_Scope) XXX_Merge Uses

func (m *DUTCondition_Scope) XXX_Merge(src proto.Message)

func (*DUTCondition_Scope) XXX_Size Uses

func (m *DUTCondition_Scope) XXX_Size() int

func (*DUTCondition_Scope) XXX_Unmarshal Uses

func (m *DUTCondition_Scope) XXX_Unmarshal(b []byte) error

type DUTConfigConstraint Uses

type DUTConfigConstraint struct {
    // A Common Expression Language (CEL) expression to specify constraints on a
    // Device Under Test's Chrome OS configuration payload. `expression` MUST
    // evaluate to a boolean value in the evaluation context described below.
    //
    // Test Lab Environments may optionally support scheduling test requests on
    // Devices Under Test that satisfy some constraints on their Chrome OS
    // configuration.
    // When supported, the Test Lab Environment MUST effectively evaluate
    // `expression` with the following declarations in scope for each available
    // Device Under Test and ensure that the test is scheduled on a Device Under
    // Test for which `expression` evaluates to true.
    //
    // - Constant: `dut` of type DUTConfigConstraint.DUT defined below, set to the
    //   Chrome OS configuration payload of a particular Device Under Test.
    // - Types: Protobuf messages from `chromiumos.config.api.*`
    //   - Additionally available with the short-hand `api.*`
    //
    // ## Examples
    //
    // Typical examples of expressions are:
    //
    // - Must run on a device with a given screen size:
    //     dut.hardware_features.screen.milliinch.value == 14000
    // - Must run on a device with LTE support:
    //     dut.hardware_features.lte == api.HardwareFeatures.Present.PRESENT
    //     - or equivalently,
    //       (dut.hardware_features.lte ==
    //        chromiumos.config.api.HardwareFeatures.Present.PRESENT)
    // - Must not run on a device with a specific form factor:
    //     (dut.hardware_features.form_factor.form_factor !=
    //      api.HardwareFeatures.FormFactor.CLAMSHELL)
    //
    // ## CEL support
    //
    // The full CEL spec can be found at https://github.com/google/cel-spec.
    //
    // Current support for `expression` evaluation is very restricted due to
    // limitations in the scheduling infrastructure used by Test Platform.
    //
    // As this API matures, features will be added to the scheduling
    // infrastructure of Test Platform and restrictions here will be lifted based
    // on requirements collected from test authors. See milestones in
    // go/cros-f20-plan for expected feature iterations. Test Lab Environments
    // SHOULD validate the expression and reject use of unsupported features.
    //
    // TODO(crbug.com/1051689) Add reference to the metadata validator package.
    //
    // ### Syntax
    //
    // See full syntax definition at
    // https://github.com/google/cel-spec/blob/master/doc/langdef.md#syntax
    //
    // CEL standard syntax allows expressions that evaluate to errors (e.g.,
    // syntax allows negation of lists, which has no semantics in CEL).
    // Thus, this spec does not attempt to restrict the syntax, but specifies what
    // operations are unsupported to aid metadata producers. Ultimately, the
    // reference metadata validator is the authority on what expressions are
    // allowed.
    //
    // Unsupported standard CEL semantics:
    //   - Binary arithmetic operations
    //     e.g.: +, *, /, % ...
    //   - Relational Operators beyond (in)equality are not supported.
    //     e.g.: (>, <, >=, <= ...)
    //   - Logical OR in expressions is not supported.
    //     e.g.: (a || b), !(a && b) ...
    //
    // ### Macros
    //
    // See full macro definition at
    // https://github.com/google/cel-spec/blob/master/doc/langdef.md#macros
    //
    // Supported macros: has(), e.all()
    // Unsupported macros: e.exists(), e.exists_one(), e.map(), e.filter()
    //
    // ### Standard functions
    //
    // See full list of standard definitions at
    // https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions
    //
    // Most standard functions are not supported.
    //
    // - Supported operators: !_, -_, _!=_, _&&_, _=_, _[_]
    //   - All other operators are not supported.
    // - All other standard functions are not supported. In particular:
    //   - size() is not supported.
    //   - string functions like endsWith() and contains() are not supported.
    //   - type conversions like int() and string() are not supported.
    //   - reflection with type(), null_type() and dyn() is not supported.
    Expression           string   `protobuf:"bytes,1,opt,name=expression,proto3" json:"expression,omitempty"`
    XXX_NoUnkeyedLiteral struct{} `json:"-"`
    XXX_unrecognized     []byte   `json:"-"`
    XXX_sizecache        int32    `json:"-"`
}

Conditions to be met for the Chrome OS configuration of each Device Under Test targeted by a test.

func (*DUTConfigConstraint) Descriptor Uses

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

func (*DUTConfigConstraint) GetExpression Uses

func (m *DUTConfigConstraint) GetExpression() string

func (*DUTConfigConstraint) ProtoMessage Uses

func (*DUTConfigConstraint) ProtoMessage()

func (*DUTConfigConstraint) Reset Uses

func (m *DUTConfigConstraint) Reset()

func (*DUTConfigConstraint) String Uses

func (m *DUTConfigConstraint) String() string

func (*DUTConfigConstraint) XXX_DiscardUnknown Uses

func (m *DUTConfigConstraint) XXX_DiscardUnknown()

func (*DUTConfigConstraint) XXX_Marshal Uses

func (m *DUTConfigConstraint) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTConfigConstraint) XXX_Merge Uses

func (m *DUTConfigConstraint) XXX_Merge(src proto.Message)

func (*DUTConfigConstraint) XXX_Size Uses

func (m *DUTConfigConstraint) XXX_Size() int

func (*DUTConfigConstraint) XXX_Unmarshal Uses

func (m *DUTConfigConstraint) XXX_Unmarshal(b []byte) error

type DUTConfigConstraint_DUT Uses

type DUTConfigConstraint_DUT struct {
    HardwareFeatures     *api.HardwareFeatures `protobuf:"bytes,1,opt,name=hardware_features,json=hardwareFeatures,proto3" json:"hardware_features,omitempty"`
    XXX_NoUnkeyedLiteral struct{}              `json:"-"`
    XXX_unrecognized     []byte                `json:"-"`
    XXX_sizecache        int32                 `json:"-"`
}

The evaluation context for `expression` MUST include the Chrome OS configuration payload for a particular Device Under Test as a typed constant of the following type.

func (*DUTConfigConstraint_DUT) Descriptor Uses

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

func (*DUTConfigConstraint_DUT) GetHardwareFeatures Uses

func (m *DUTConfigConstraint_DUT) GetHardwareFeatures() *api.HardwareFeatures

func (*DUTConfigConstraint_DUT) ProtoMessage Uses

func (*DUTConfigConstraint_DUT) ProtoMessage()

func (*DUTConfigConstraint_DUT) Reset Uses

func (m *DUTConfigConstraint_DUT) Reset()

func (*DUTConfigConstraint_DUT) String Uses

func (m *DUTConfigConstraint_DUT) String() string

func (*DUTConfigConstraint_DUT) XXX_DiscardUnknown Uses

func (m *DUTConfigConstraint_DUT) XXX_DiscardUnknown()

func (*DUTConfigConstraint_DUT) XXX_Marshal Uses

func (m *DUTConfigConstraint_DUT) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTConfigConstraint_DUT) XXX_Merge Uses

func (m *DUTConfigConstraint_DUT) XXX_Merge(src proto.Message)

func (*DUTConfigConstraint_DUT) XXX_Size Uses

func (m *DUTConfigConstraint_DUT) XXX_Size() int

func (*DUTConfigConstraint_DUT) XXX_Unmarshal Uses

func (m *DUTConfigConstraint_DUT) XXX_Unmarshal(b []byte) error

type DUTConstraint Uses

type DUTConstraint struct {
    // Conditions on the Chrome OS configuration payload.
    Config *DUTConfigConstraint `protobuf:"bytes,1,opt,name=config,proto3" json:"config,omitempty"`
    // Conditions on device setup.
    Setup                *DUTSetupConstraint `protobuf:"bytes,2,opt,name=setup,proto3" json:"setup,omitempty"`
    XXX_NoUnkeyedLiteral struct{}            `json:"-"`
    XXX_unrecognized     []byte              `json:"-"`
    XXX_sizecache        int32               `json:"-"`
}

Conditions to be met for each Device Under Test targeted by a test.

func (*DUTConstraint) Descriptor Uses

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

func (*DUTConstraint) GetConfig Uses

func (m *DUTConstraint) GetConfig() *DUTConfigConstraint

func (*DUTConstraint) GetSetup Uses

func (m *DUTConstraint) GetSetup() *DUTSetupConstraint

func (*DUTConstraint) ProtoMessage Uses

func (*DUTConstraint) ProtoMessage()

func (*DUTConstraint) Reset Uses

func (m *DUTConstraint) Reset()

func (*DUTConstraint) String Uses

func (m *DUTConstraint) String() string

func (*DUTConstraint) XXX_DiscardUnknown Uses

func (m *DUTConstraint) XXX_DiscardUnknown()

func (*DUTConstraint) XXX_Marshal Uses

func (m *DUTConstraint) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTConstraint) XXX_Merge Uses

func (m *DUTConstraint) XXX_Merge(src proto.Message)

func (*DUTConstraint) XXX_Size Uses

func (m *DUTConstraint) XXX_Size() int

func (*DUTConstraint) XXX_Unmarshal Uses

func (m *DUTConstraint) XXX_Unmarshal(b []byte) error

type DUTSetupConstraint Uses

type DUTSetupConstraint struct {
    // A Common Expression Language (CEL) expression to specify constraints on a
    // Device Under Test setup. `expression` MUST evaluate to a boolean value in
    // the evaluation context described below.
    //
    // Test Lab Environments may optionally support scheduling test requests on
    // Devices Under Test that satisfy some constraints on how they are setup.
    // When supported, the Test Lab Environment MUST effectively evaluate
    // `expression` with the following declarations in scope for each available
    // Device Under Test and ensure that the test is scheduled on a Device Under
    // Test for which `expression` evaluates to true.
    //
    // - Constant: `dut` of type DUTSetupConstraint.DUT defined below, set to the
    //   setup configuration payload of a particular Device Under Test.
    // - Type: Protobuf messages `chromiumos.config.api.test.dut.v1.*`, e.g.
    //   `chromiumos.config.api.test.dut.v1.DeviceUnderTest`
    //   - Additionally available with short-hands `DeviceUnderTest` etc.
    //
    // ## Examples
    //
    // Typical examples of expressions are:
    //
    // - Must run on a DUT with servo present:
    //     dut.setup.peripheral.servo.present
    // - Must run on a DUT which is in a camera box with a front facing camera:
    //     dut.setup.peripheral.camerabox.facing == Camerabox.Facing.FRONT
    //   - Or, equivalently:
    //       (dut.setup.peripheral.camerabox.facing ==
    //        chromiumos.config.api.test.dut.v1.Camerabox.Facing.FRONT)
    //
    // ## CEL support
    //
    // The full CEL spec can be found at https://github.com/google/cel-spec.
    //
    // Current support for `expression` evaluation is very restricted due to
    // limitations in the scheduling infrastructure used by Test Platform.
    //
    // As this API matures, features will be added to the scheduling
    // infrastructure of Test Platform and restrictions here will be lifted based
    // on requirements collected from test authors. See milestones in
    // go/cros-f20-plan for expected feature iterations. Test Lab Environments
    // SHOULD validate the expression and reject use of unsupported features.
    //
    // TODO(crbug.com/1051689) Add reference to the metadata validator package.
    //
    // ### Syntax
    //
    // See full syntax definition at
    // https://github.com/google/cel-spec/blob/master/doc/langdef.md#syntax
    //
    // CEL standard syntax allows expressions that evaluate to errors (e.g.,
    // syntax allows negation of lists, which has no semantics in CEL).
    // Thus, this spec does not attempt to restrict the syntax, but specifies what
    // operations are unsupported to aid metadata producers. Ultimately, the
    // reference metadata validator is the authority on what expressions are
    // allowed.
    //
    // Unsupported standard CEL semantics:
    //   - Binary arithmetic operations
    //     e.g.: +, *, /, % ...
    //   - Relational Operators beyond (in)equality are not supported.
    //     e.g.: (>, <, >=, <= ...)
    //   - Logical OR in expressions is not supported.
    //     e.g.: (a || b), !(a && b) ...
    //
    // ### Macros
    //
    // See full macro definition at
    // https://github.com/google/cel-spec/blob/master/doc/langdef.md#macros
    //
    // Supported macros: has(), e.all()
    // Unsupported macros: e.exists(), e.exists_one(), e.map(), e.filter()
    //
    // ### Standard functions
    //
    // See full list of standard definitions at
    // https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions
    //
    // Most standard functions are not supported.
    //
    // - Supported operators: !_, -_, _!=_, _&&_, _=_, _[_]
    //   - All other operators are not supported.
    // - All other standard functions are not supported. In particular:
    //   - size() is not supported.
    //   - string functions like endsWith() and contains() are not supported.
    //   - type conversions like int() and string() are not supported.
    //   - reflection with type(), null_type() and dyn() is not supported.
    Expression           string   `protobuf:"bytes,1,opt,name=expression,proto3" json:"expression,omitempty"`
    XXX_NoUnkeyedLiteral struct{} `json:"-"`
    XXX_unrecognized     []byte   `json:"-"`
    XXX_sizecache        int32    `json:"-"`
}

Conditions to be met for the setup of each Device Under Test targeted by a test.

func (*DUTSetupConstraint) Descriptor Uses

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

func (*DUTSetupConstraint) GetExpression Uses

func (m *DUTSetupConstraint) GetExpression() string

func (*DUTSetupConstraint) ProtoMessage Uses

func (*DUTSetupConstraint) ProtoMessage()

func (*DUTSetupConstraint) Reset Uses

func (m *DUTSetupConstraint) Reset()

func (*DUTSetupConstraint) String Uses

func (m *DUTSetupConstraint) String() string

func (*DUTSetupConstraint) XXX_DiscardUnknown Uses

func (m *DUTSetupConstraint) XXX_DiscardUnknown()

func (*DUTSetupConstraint) XXX_Marshal Uses

func (m *DUTSetupConstraint) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTSetupConstraint) XXX_Merge Uses

func (m *DUTSetupConstraint) XXX_Merge(src proto.Message)

func (*DUTSetupConstraint) XXX_Size Uses

func (m *DUTSetupConstraint) XXX_Size() int

func (*DUTSetupConstraint) XXX_Unmarshal Uses

func (m *DUTSetupConstraint) XXX_Unmarshal(b []byte) error

type DUTSetupConstraint_DUT Uses

type DUTSetupConstraint_DUT struct {
    // Peripherals information about the lab deployment of the device
    Setup                *v1.DeviceUnderTest `protobuf:"bytes,1,opt,name=setup,proto3" json:"setup,omitempty"`
    XXX_NoUnkeyedLiteral struct{}            `json:"-"`
    XXX_unrecognized     []byte              `json:"-"`
    XXX_sizecache        int32               `json:"-"`
}

The evaluation context for `expression` MUST include the dut setup configuration payload for a particular Device Under Test as a typed constant of the following type.

func (*DUTSetupConstraint_DUT) Descriptor Uses

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

func (*DUTSetupConstraint_DUT) GetSetup Uses

func (m *DUTSetupConstraint_DUT) GetSetup() *v1.DeviceUnderTest

func (*DUTSetupConstraint_DUT) ProtoMessage Uses

func (*DUTSetupConstraint_DUT) ProtoMessage()

func (*DUTSetupConstraint_DUT) Reset Uses

func (m *DUTSetupConstraint_DUT) Reset()

func (*DUTSetupConstraint_DUT) String Uses

func (m *DUTSetupConstraint_DUT) String() string

func (*DUTSetupConstraint_DUT) XXX_DiscardUnknown Uses

func (m *DUTSetupConstraint_DUT) XXX_DiscardUnknown()

func (*DUTSetupConstraint_DUT) XXX_Marshal Uses

func (m *DUTSetupConstraint_DUT) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*DUTSetupConstraint_DUT) XXX_Merge Uses

func (m *DUTSetupConstraint_DUT) XXX_Merge(src proto.Message)

func (*DUTSetupConstraint_DUT) XXX_Size Uses

func (m *DUTSetupConstraint_DUT) XXX_Size() int

func (*DUTSetupConstraint_DUT) XXX_Unmarshal Uses

func (m *DUTSetupConstraint_DUT) XXX_Unmarshal(b []byte) error

type Informational Uses

type Informational struct {
    // Contacts for ownership / flakiness notification etc.
    Authors []*Contact `protobuf:"bytes,1,rep,name=authors,proto3" json:"authors,omitempty"`
    // Machine readable test-specific information.
    //
    // Remote Test Drivers SHOULD include detailed information to aid analytics.
    // For example, test authors may minimize code duplication by writing
    // paramterized tests. Thus, multiple test metadata may refer to the
    // same test implementation with different arguments. It is useful to include
    // this information as details. An example for Tauto:
    //   {
    //      "test_project": "chromiumos/third_party/autotest",
    //      "control_file": "site_tests/dummy_Pass/control.stress",
    //      "args": {
    //        "run_count": 35
    //      }
    //   }
    //
    // This field MUST NOT be interpreted by the Test Lab Environments, but Remote
    // Test Drivers can enrich analytics by using uniform stable schema for
    // details across all their tests.
    Details              *_struct.Struct `protobuf:"bytes,2,opt,name=details,proto3" json:"details,omitempty"`
    XXX_NoUnkeyedLiteral struct{}        `json:"-"`
    XXX_unrecognized     []byte          `json:"-"`
    XXX_sizecache        int32           `json:"-"`
}

Contains metadata about the test that doesn't affect scheduling or execution.

func (*Informational) Descriptor Uses

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

func (*Informational) GetAuthors Uses

func (m *Informational) GetAuthors() []*Contact

func (*Informational) GetDetails Uses

func (m *Informational) GetDetails() *_struct.Struct

func (*Informational) ProtoMessage Uses

func (*Informational) ProtoMessage()

func (*Informational) Reset Uses

func (m *Informational) Reset()

func (*Informational) String Uses

func (m *Informational) String() string

func (*Informational) XXX_DiscardUnknown Uses

func (m *Informational) XXX_DiscardUnknown()

func (*Informational) XXX_Marshal Uses

func (m *Informational) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Informational) XXX_Merge Uses

func (m *Informational) XXX_Merge(src proto.Message)

func (*Informational) XXX_Size Uses

func (m *Informational) XXX_Size() int

func (*Informational) XXX_Unmarshal Uses

func (m *Informational) XXX_Unmarshal(b []byte) error

type RemoteTestDriver Uses

type RemoteTestDriver struct {
    // Globally unique name for a Remote Test Driver package.
    //
    //
    // MUST be a valid resource per https://aip.dev/122.
    //
    // Pattern: remoteTestDrivers/{remoteTestDriver}
    //
    // The two most commonly used Remote Test Drivers are named
    // - remoteTestDrivers/tauto
    // - remoteTestDrivers/tast
    // and contain the common public tests written in the Tauto and Tast framework
    // respectively.
    Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
    // A container image containing all the required dependencies and other build
    // artifacts required for test invocations.
    //
    // Test Lab Environments SHOULD fail with an error indicating that the request
    // was invalid if the image fails to be found for a test invocation.
    Image *BuildArtifact `protobuf:"bytes,2,opt,name=image,proto3" json:"image,omitempty"`
    // Command to invoke the Remote Test Driver inside `image`.
    //
    // Remote Test Servers MUST run `command` as
    //   $ ${command} -input_json ${input_json}
    // where ${command} and ${input_json} are absolute paths inside the container.
    //
    // Remote Test Servers MUST populate `input_json` with a JSON encoded
    // test.invocation.Request message.
    Command string `protobuf:"bytes,3,opt,name=command,proto3" json:"command,omitempty"`
    // Metadata for the smallest schedulable test units.
    Tests                []*Test  `protobuf:"bytes,4,rep,name=tests,proto3" json:"tests,omitempty"`
    XXX_NoUnkeyedLiteral struct{} `json:"-"`
    XXX_unrecognized     []byte   `json:"-"`
    XXX_sizecache        int32    `json:"-"`
}

go/cros-rtd-spec describes the Remote Test Driver bootstrapping flow inside the Remote Test Server. Remote Test Driver configures the bootstrapping flow for a test invocation.

func (*RemoteTestDriver) Descriptor Uses

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

func (*RemoteTestDriver) GetCommand Uses

func (m *RemoteTestDriver) GetCommand() string

func (*RemoteTestDriver) GetImage Uses

func (m *RemoteTestDriver) GetImage() *BuildArtifact

func (*RemoteTestDriver) GetName Uses

func (m *RemoteTestDriver) GetName() string

func (*RemoteTestDriver) GetTests Uses

func (m *RemoteTestDriver) GetTests() []*Test

func (*RemoteTestDriver) ProtoMessage Uses

func (*RemoteTestDriver) ProtoMessage()

func (*RemoteTestDriver) Reset Uses

func (m *RemoteTestDriver) Reset()

func (*RemoteTestDriver) String Uses

func (m *RemoteTestDriver) String() string

func (*RemoteTestDriver) XXX_DiscardUnknown Uses

func (m *RemoteTestDriver) XXX_DiscardUnknown()

func (*RemoteTestDriver) XXX_Marshal Uses

func (m *RemoteTestDriver) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*RemoteTestDriver) XXX_Merge Uses

func (m *RemoteTestDriver) XXX_Merge(src proto.Message)

func (*RemoteTestDriver) XXX_Size Uses

func (m *RemoteTestDriver) XXX_Size() int

func (*RemoteTestDriver) XXX_Unmarshal Uses

func (m *RemoteTestDriver) XXX_Unmarshal(b []byte) error

type Specification Uses

type Specification struct {
    // A set of Remote Test Driver packages.
    //
    // In practice, a complete specification of all known Remote Test Drivers may
    // consist of multiple Specification instances. In that case the test names
    // MUST be unique across different Specification instances.
    //
    // Unlike tests, a RemoteTestDriver (identified by its name) may be specified
    // multiple times, in a single Specification or across different Specification
    // instances. In that case, all fields except the list of tests MUST be
    // identical across these RemoteTestDriver instances. The list of tests across
    // these instances will be concatenated together.
    RemoteTestDrivers    []*RemoteTestDriver `protobuf:"bytes,1,rep,name=remote_test_drivers,json=remoteTestDrivers,proto3" json:"remote_test_drivers,omitempty"`
    XXX_NoUnkeyedLiteral struct{}            `json:"-"`
    XXX_unrecognized     []byte              `json:"-"`
    XXX_sizecache        int32               `json:"-"`
}

The test metadata specification.

Test metadata MUST be generated for each Remote Test Driver as one of the test artifacts generated from Chrome OS build system.

func (*Specification) Descriptor Uses

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

func (*Specification) GetRemoteTestDrivers Uses

func (m *Specification) GetRemoteTestDrivers() []*RemoteTestDriver

func (*Specification) ProtoMessage Uses

func (*Specification) ProtoMessage()

func (*Specification) Reset Uses

func (m *Specification) Reset()

func (*Specification) String Uses

func (m *Specification) String() string

func (*Specification) XXX_DiscardUnknown Uses

func (m *Specification) XXX_DiscardUnknown()

func (*Specification) XXX_Marshal Uses

func (m *Specification) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Specification) XXX_Merge Uses

func (m *Specification) XXX_Merge(src proto.Message)

func (*Specification) XXX_Size Uses

func (m *Specification) XXX_Size() int

func (*Specification) XXX_Unmarshal Uses

func (m *Specification) XXX_Unmarshal(b []byte) error

type Test Uses

type Test struct {
    // Globally unique name for this test.
    //
    // MUST be a valid resource per https://aip.dev/122.
    //
    // Pattern: remoteTestDrivers/{remoteTestDriver}/tests/{test}
    //   where {remoteTestDriver} is the Remote Test Driver package that
    //   contains this test.
    Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
    // Attributes are used to include tests in test plans.
    //
    // See Also:
    //   Test plans: test/plan/plan.proto
    Attributes []*Attribute `protobuf:"bytes,2,rep,name=attributes,proto3" json:"attributes,omitempty"`
    // Required conditions to be met for the Devices Under Test targeted by this
    // test.
    //
    // Constraint enforcement is an optional feature for test scheduling, i.e.,
    // some Test Lab Environments may ignore conditions entirely.
    //
    // If the test execution is sharded over multiple devices, each must satisfy
    // these conditions.
    DutConstraint *DUTConstraint `protobuf:"bytes,6,opt,name=dut_constraint,json=dutConstraint,proto3" json:"dut_constraint,omitempty"`
    // Metadata about the test that doesn't affect scheduling.
    Informational *Informational `protobuf:"bytes,4,opt,name=informational,proto3" json:"informational,omitempty"`
    // Will be deleted (& reserved) once all clients have migrated.
    DutCondition         *DUTCondition `protobuf:"bytes,5,opt,name=dut_condition,json=dutCondition,proto3" json:"dut_condition,omitempty"` // Deprecated: Do not use.
    XXX_NoUnkeyedLiteral struct{}      `json:"-"`
    XXX_unrecognized     []byte        `json:"-"`
    XXX_sizecache        int32         `json:"-"`
}

Related Test objects may be marked as such via the Informational field. See the documentation of test.metadata.v1.Informational for details.

A single test platform request or Remote Test Driver invocation may contain multiple instances of multiple Tests, but each instance of a Test MUST correspond to exactly one reported result.

See Also:

Test Platform request: TODO(pprabhu)
Remote Test Driver invocation request: test/rtd/invocation.proto
Remote Test Driver progress API: test/rtd/progress.proto

func (*Test) Descriptor Uses

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

func (*Test) GetAttributes Uses

func (m *Test) GetAttributes() []*Attribute

func (*Test) GetDutCondition Uses

func (m *Test) GetDutCondition() *DUTCondition

Deprecated: Do not use.

func (*Test) GetDutConstraint Uses

func (m *Test) GetDutConstraint() *DUTConstraint

func (*Test) GetInformational Uses

func (m *Test) GetInformational() *Informational

func (*Test) GetName Uses

func (m *Test) GetName() string

func (*Test) ProtoMessage Uses

func (*Test) ProtoMessage()

func (*Test) Reset Uses

func (m *Test) Reset()

func (*Test) String Uses

func (m *Test) String() string

func (*Test) XXX_DiscardUnknown Uses

func (m *Test) XXX_DiscardUnknown()

func (*Test) XXX_Marshal Uses

func (m *Test) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Test) XXX_Merge Uses

func (m *Test) XXX_Merge(src proto.Message)

func (*Test) XXX_Size Uses

func (m *Test) XXX_Size() int

func (*Test) XXX_Unmarshal Uses

func (m *Test) XXX_Unmarshal(b []byte) error

Package metadata imports 6 packages (graph). Updated 2020-05-30. Refresh now. Tools for package owners.