report

Documentation

Index

• func IsArtifactRequired(reps []Reporter, at ArtifactType) bool
• type Artifact
• type ArtifactType
• type Attempt
• type Reporter
• type TestResult

Functions

func IsArtifactRequired

func IsArtifactRequired(reps []Reporter, at ArtifactType) bool

IsArtifactRequired traverses the list of reporters and validates their requirements against the given artifact type. Returns true if at least one of the reporters has a matching requirement.

Types

type Artifact

type Artifact struct {
	FilePath  string       `json:"filePath,omitempty"`
	AssetType ArtifactType `json:"-"`
	Body      []byte       `json:"-"`

	// Error contains optional error information in case the artifact was not retrieved.
	Error error `json:"-"`
}

Artifact represents an artifact (aka asset) that was generated as part of a job.

type ArtifactType

type ArtifactType int

ArtifactType represents the type of assets (e.g. a junit report). Semantically similar to Content-Type.

const (
	// Unknown represents an asset with an unknown purpose that isn't further defined.
	Unknown ArtifactType = iota
	// JUnitArtifact represents the junit artifact type (https://llg.cubic.org/docs/junit/).
	JUnitArtifact
)

type Attempt

type Attempt struct {
	// ID is the unique identifier of the attempt. This is usually the job ID.
	// Can also be the runner ID (imagerunner) or whatever is used to identify
	// the attempt in the context of the job.
	ID        string        `json:"id"`
	Duration  time.Duration `json:"duration"`
	StartTime time.Time     `json:"startTime"`
	EndTime   time.Time     `json:"endTime"`
	Status    string        `json:"status"`

	// TestSuites contains the junit test suites that were generated as part of
	// the attempt.
	TestSuites junit.TestSuites `json:"-"`
}

Attempt represents a single attempt of a job.

type Reporter

type Reporter interface {
	// Add adds the TestResult to the reporter. TestResults added this way can then be rendered out by calling Render().
	Add(t TestResult)
	// Render renders the test results. The destination depends on the implementation.
	Render()
	// Reset resets the state of the reporter (e.g. remove any previously reported TestResults).
	Reset()
	// ArtifactRequirements returns a list of artifact types that this reporter requires to create a proper report.
	ArtifactRequirements() []ArtifactType
}

Reporter is the interface for rest result reporting.

type TestResult

type TestResult struct {
	Name          string        `json:"name"`
	Duration      time.Duration `json:"duration"`
	StartTime     time.Time     `json:"startTime"`
	EndTime       time.Time     `json:"endTime"`
	Status        string        `json:"status"`
	Browser       string        `json:"browser,omitempty"`
	Platform      string        `json:"platform"`
	DeviceName    string        `json:"deviceName,omitempty"`
	URL           string        `json:"url,omitempty"`
	Artifacts     []Artifact    `json:"artifacts,omitempty"`
	Origin        string        `json:"origin,omitempty"`
	BuildURL      string        `json:"buildURL,omitempty"`
	RunID         string        `json:"runID,omitempty"`
	RDC           bool          `json:"-"`
	TimedOut      bool          `json:"-"`
	PassThreshold bool          `json:"-"`
	Attempts      []Attempt     `json:"-"`
}

TestResult represents the test result.