job

Documentation

Index

• Constants
• Variables
• func Done(status string) bool
• type AppSettings
• type ArtifactDownloader
• type Instrumentation
• type Job
  • func (j Job) TotalStatus() string
• type Reader
• type Service
• type SmartRetry
• type StartOptions
• type Starter
• type Stopper
• type TunnelOptions
• type Writer

Constants

const (
	StateNew        = "new"
	StateQueued     = "queued"
	StateInProgress = "in progress"
	StateComplete   = "complete"
	StateError      = "error"
	StateUnknown    = "?"
)

The different states that a job can be in.

const (
	StatePassed = "passed"
	StateFailed = "failed"
)

The following states are only used by RDC.

Variables

var AllStates = []string{StatePassed, StateComplete, StateFailed, StateError, StateInProgress, StateQueued}

var DoneStates = []string{StateComplete, StateError, StatePassed, StateFailed}

DoneStates represents states that a job doesn't transition out of, i.e. once the job is in one of these states, it's done.

Functions

func Done

func Done(status string) bool

Done returns true if the job status is one of DoneStates. False otherwise.

Types

type AppSettings

type AppSettings struct {
	AudioCapture    bool            `json:"audio_capture,omitempty"`
	Instrumentation Instrumentation `json:"instrumentation,omitempty"`
}

AppSettings represents app settings for real device

type ArtifactDownloader

type ArtifactDownloader interface {
	// DownloadArtifact downloads artifacts and returns a list of what was downloaded.
	DownloadArtifact(jobID, suiteName string, realDevice bool) []string
}

ArtifactDownloader represents the interface for downloading artifacts.

type Instrumentation

type Instrumentation struct {
	NetworkCapture bool `json:"network_capture,omitempty"`
}

Instrumentation represents instrumentation settings for real device

type Job

type Job struct {
	ID                  string `json:"id"`
	Passed              bool   `json:"passed"`
	Status              string `json:"status"`
	Error               string `json:"error"`
	BrowserShortVersion string `json:"browser_short_version"`
	BaseConfig          struct {
		PlatformName    string `json:"platformName"`
		PlatformVersion string `json:"platformVersion"`
		DeviceName      string `json:"deviceName"`
	} `json:"base_config"`

	// IsRDC flags a job started as an RDC run.
	IsRDC bool `json:"-"`

	// TimedOut flags a job as an unfinished one.
	TimedOut bool `json:"-"`
}

Job represents test details and metadata of a test run (aka Job), that is usually associated with a particular test execution instance (e.g. VM).

func (Job) TotalStatus

func (j Job) TotalStatus() string

TotalStatus returns the total status of a job, combining the result of fields Status + Passed.

type Reader

type Reader interface {
	// ReadJob returns the job details.
	ReadJob(ctx context.Context, id string, realDevice bool) (Job, error)

	// PollJob polls job details at an interval, until timeout has been reached or until the job has ended, whether successfully or due to an error.
	PollJob(ctx context.Context, id string, interval, timeout time.Duration, realDevice bool) (Job, error)

	// GetJobAssetFileNames returns all assets files available.
	GetJobAssetFileNames(ctx context.Context, jobID string, realDevice bool) ([]string, error)

	// GetJobAssetFileContent returns the job asset file content.
	GetJobAssetFileContent(ctx context.Context, jobID, fileName string, realDevice bool) ([]byte, error)
}

Reader is the interface for retrieving jobs.

type Service

type Service interface {
	Starter
	Reader
	Writer
	Stopper
	ArtifactDownloader
}

Service represents the interface for Job interactions.

type SmartRetry

type SmartRetry struct {
	FailedOnly bool `json:"-"`
}

SmartRetry represents the retry strategy.

type StartOptions

type StartOptions struct {
	// DisplayName is used for local logging purposes only (e.g. console).
	DisplayName string `json:"-"`

	// PrevAttempts contains any previous attempts of the job.
	PrevAttempts []report.Attempt `json:"-"`

	// Timeout is used for local/per-suite timeout.
	Timeout time.Duration `json:"-"`

	User           string                 `json:"username"`
	AccessKey      string                 `json:"accessKey"`
	App            string                 `json:"app,omitempty"`
	Suite          string                 `json:"suite,omitempty"`
	OtherApps      []string               `json:"otherApps,omitempty"`
	Framework      string                 `json:"framework,omitempty"`
	ConfigFilePath string                 `json:"-"`
	CLIFlags       map[string]interface{} `json:"-"`

	// FrameworkVersion contains the targeted version of the framework
	// It should not be confused with automation tool (like jest/folio).
	// This is currently supported only for frameworks available on Sauce Cloud:
	// Currently supported: Cypress.
	FrameworkVersion string `json:"frameworkVersion,omitempty"`

	Attempt           int                    `json:"-"`
	CurrentPassCount  int                    `json:"-"`
	BrowserName       string                 `json:"browserName,omitempty"`
	BrowserVersion    string                 `json:"browserVersion,omitempty"`
	PlatformName      string                 `json:"platformName,omitempty"`
	PlatformVersion   string                 `json:"platformVersion,omitempty"`
	DeviceID          string                 `json:"deviceId,omitempty"`
	DeviceName        string                 `json:"deviceName,omitempty"`
	DeviceOrientation string                 `json:"deviceOrientation"`
	DevicePrivateOnly bool                   `json:"devicePrivateOnly,omitempty"`
	DeviceType        string                 `json:"deviceType,omitempty"`
	DeviceHasCarrier  bool                   `json:"deviceHasCarrier,omitempty"`
	RealDevice        bool                   `json:"realDevice,omitempty"`
	Name              string                 `json:"name,omitempty"`
	Build             string                 `json:"build,omitempty"`
	Tags              []string               `json:"tags,omitempty"`
	Tunnel            TunnelOptions          `json:"tunnel,omitempty"`
	ScreenResolution  string                 `json:"screenResolution,omitempty"`
	Retries           int                    `json:"-"`
	PassThreshold     int                    `json:"-"`
	SmartRetry        SmartRetry             `json:"-"`
	RunnerVersion     string                 `json:"runnerVersion,omitempty"`
	Experiments       map[string]string      `json:"experiments,omitempty"`
	TestOptions       map[string]interface{} `json:"testOptions,omitempty"`
	TestsToRun        []string               `json:"testsToRun,omitempty"`
	TestsToSkip       []string               `json:"testsToSkip,omitempty"`
	StartTime         time.Time              `json:"startTime,omitempty"`
	AppSettings       AppSettings            `json:"appSettings,omitempty"`
	RealDeviceKind    string                 `json:"realDeviceKind,omitempty"`
	TimeZone          string                 `json:"timeZone,omitempty"`
	Visibility        string                 `json:"public,omitempty"`
	Env               map[string]string      `json:"-"`
}

StartOptions represents the options for starting a job in the Sauce Labs cloud.

type Starter

type Starter interface {
	StartJob(ctx context.Context, opts StartOptions) (jobID string, isRDC bool, err error)
}

Starter is the interface for starting jobs.

type Stopper

type Stopper interface {
	StopJob(ctx context.Context, jobID string, realDevice bool) (Job, error)
}

Stopper is the interface for stopping jobs.

type TunnelOptions

type TunnelOptions struct {
	ID     string `json:"id"`
	Parent string `json:"parent,omitempty"`
}

TunnelOptions represents the options that configure the usage of a tunnel when running tests in the Sauce Labs cloud.

type Writer

type Writer interface {
	UploadAsset(jobID string, realDevice bool, fileName string, contentType string, content []byte) error
}

Writer is the interface for modifying jobs.