results

Documentation

Index

• func Average(slice []time.Duration) time.Duration
• func Deviation(slice []time.Duration) time.Duration
• func Duration(runs []Run) time.Duration
• func Durations(runs []Run) []time.Duration
• func Loads(runs []Run) []float64
• func Mean(slice []time.Duration) time.Duration
• func Total(runs []Run) time.Duration
• type DB
  • func Latest() (*DB, error)
  • func (db *DB) MaxJobs() int
  • func (db *DB) MaxLoad() int
  • func (db *DB) Runs() []Run
• type Run
  • func FinalVerdicts(runs []Run) []Run
  • func First(runs []Run) Run
  • func Last(runs []Run) Run
  • func Longest(runs []Run) Run
  • func Shortest(runs []Run) Run
  • func (r Run) Duration() time.Duration
  • func (r Run) ID() string
  • func (r Run) JobID() string
  • func (r Run) String() string
• type Session
• type Timestamp
  • func (t Timestamp) MarshalJSON() ([]byte, error)
  • func (t *Timestamp) UnmarshalJSON(s []byte) (err error)

Functions

func Average

func Average(slice []time.Duration) time.Duration

Average returns the average test duration (median)

func Deviation

func Deviation(slice []time.Duration) time.Duration

Deviation returns the standard deviation of duration

func Duration

func Duration(runs []Run) time.Duration

Duration returns the time spent between the first and the last test run.

func Durations

func Durations(runs []Run) []time.Duration

Duration returns a slice of test run durations

func Loads

func Loads(runs []Run) []float64

Loads returns a slice of test run durations

func Mean

func Mean(slice []time.Duration) time.Duration

Mean returns arithmetic mean

func Total

func Total(runs []Run) time.Duration

Total returns total time spent if all runs would have been executed sequentially.

Types

type DB

type DB struct {
	Version  string
	Sessions []Session
}

func Latest

func Latest() (*DB, error)

func (*DB) MaxJobs

func (db *DB) MaxJobs() int

func (*DB) MaxLoad

func (db *DB) MaxLoad() int

func (*DB) Runs

func (db *DB) Runs() []Run

Runs returns a slice with all runs from all sessions

type Run

type Run struct {
	Name     string `json:"name"`               // Full qualified test name
	Instance int    `json:"instance,omitempty"` // Test instance
	Verdict  string `json:"verdict,omitempty"`  // the test verdict (pass, fail, none, ...)
	Reason   string `json:"reason,omitempty"`   // Optional reason for verdicts

	Begin Timestamp `json:"begin"` // When the test was started
	End   Timestamp `json:"end"`   // When the test ended

	WorkingDir string  `json:"working_dir,omitempty"` // Working Directory of the test
	Load       float64 `json:"load,omitempty"`        // the system load when the test was started
	MaxMem     int     `json:"max_mem,omitempty"`     // the maximum memory used when the test ended

	RunnerID        string `json:"runner_id,omitempty"`
	ExpectedVerdict string `json:"expected_verdict,omitempty"`
}

A Run describes the execution of a single test case.

func FinalVerdicts

func FinalVerdicts(runs []Run) []Run

FinalVerdicts folds multiple runs instances into one with a final verdict.

* A test is considered "pass", if all runs had verdict "pass". * A test is considered "unstable", if only some runs had verdict "pass" * Runs with worse or equal verdict will overwrite previous runs.

func First

func First(runs []Run) Run

First returns the first test run

func Last

func Last(runs []Run) Run

Last returns the last test run

func Longest

func Longest(runs []Run) Run

Longest returns the longest test run

func Shortest

func Shortest(runs []Run) Run

Shortest returns the shortest test run

func (Run) Duration

func (r Run) Duration() time.Duration

Duration of an individual run

func (Run) ID

func (r Run) ID() string

A unique identifier of the run. Usually something like "testname-2"

func (Run) JobID

func (r Run) JobID() string

A unique identifier of the job.

func (Run) String

func (r Run) String() string

String returns a printable and simplified representation of Run

type Session

type Session struct {
	Id              string
	MaxJobs         int    `json:"max_jobs,omitempty"`
	MaxLoad         int    `json:"max_load,omitempty"`
	ExpectedVerdict string `json:"expected_verdict,omitempty"`
	Runs            []Run  `json:"runs,omitempty"`
}

type Timestamp

type Timestamp struct {
	time.Time
}

Timestamp is a Unix timestamp in milliseconds.

func (Timestamp) MarshalJSON

func (t Timestamp) MarshalJSON() ([]byte, error)

MarshalJSON is used to convert the timestamp to JSON

func (*Timestamp) UnmarshalJSON

func (t *Timestamp) UnmarshalJSON(s []byte) (err error)

UnmarshalJSON is used to convert the timestamp from JSON