dash

Documentation

Overview

Package dash reads build.golang.org's dashboards.

Index

• type Board
  • func Read(limit time.Time) ([]*Board, error)
  • func Update(old []*Board, limit time.Time) ([]*Board, error)
• type Line

Types

type Board

type Board struct {
	Repo      string   // repo being displayed: "go", "arch", and so on
	Branch    string   // branch in repo
	Builders  []string // builder columns
	Revisions []*Line  // commit lines, newest to oldest
}

A Board is a single dashboard.

func Read

func Read(limit time.Time) ([]*Board, error)

Read reads and returns all the dashboards on build.golang.org (for the main repo, the main repo release branches, and subrepos), including all results up to the given time limit. It guarantees that all the returned boards will have the same b.Builders slices, so that any line.Results[i] even for different boards refers to a consistent builder for a given i.

func Update

func Update(old []*Board, limit time.Time) ([]*Board, error)

Update is like Read but takes a starting set of boards from a previous call to Read or Update and avoids redownloading information from those boards. It does not modify the boards passed in as input.

type Line

type Line struct {
	Repo       string    // same as b.Repo
	Branch     string    // same as b.Branch
	Revision   string    // revision of Repo
	GoRevision string    // for Repo != "go", revision of go repo being used
	GoBranch   string    // for Repo != "go", branch of go repo being used
	Date       time.Time // date of commit
	Author     string    // author of commit
	Desc       string    // commit description

	// // Results[i] reports b.Builders[i]'s result:
	// "" (not run), "ok" (passed), or the URL of the failure log
	// ("https://build.golang.org/log/...")
	Results []string
}

A Line is a single commit line on a Board b.