blob: 3c061cd88034db9a855226d7fab1551c4dc570d2 [file] [log] [blame]
// Copyright 2011 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
// Package types contains common types used by the Go continuous build
// system.
package types
import "time"
// BuildStatus is the data structure that's marshalled as JSON
// for the https://build.golang.org/?mode=json page.
type BuildStatus struct {
// Builders is a list of all known builders.
// The order that builders appear is the same order as the build results for a revision.
Builders []string `json:"builders"`
// Revisions are the revisions shown on the front page of build.golang.org,
// in the same order. It starts with the "go" repo, from recent to old, and then
// it has 1 each of the subrepos, with only their most recent commit.
Revisions []BuildRevision `json:"revisions"`
}
// BuildRevision is the status of a commit across all builders.
// It corresponds to a single row of https://build.golang.org/
type BuildRevision struct {
// Repo is "go" for the main repo, else "tools", "crypto", "net", etc.
// These are repos as listed at https://go.googlesource.com/
Repo string `json:"repo"`
// Revision is the full git hash of the repo.
Revision string `json:"revision"`
// ParentRevisions is the full git hashes of the parents of
// Revision.
ParentRevisions []string `json:"parentRevisions"`
// GoRevision is the full git hash of the "go" repo, if Repo is not "go" itself.
// Otherwise this is empty.
GoRevision string `json:"goRevision,omitempty"`
// Date is the commit date of this revision, formatted in RFC3339.
Date string `json:"date"`
// Branch is the branch of this commit, e.g. "master" or "dev.ssa".
Branch string `json:"branch"`
// Author is the author of this commit in standard git form
// "Name <email>".
Author string `json:"author"`
// Desc is the commit message of this commit. It may be
// truncated.
Desc string `json:"desc"`
// Results are the build results for each of the builders in
// the same length slice BuildStatus.Builders.
// Each string is either "" (if no data), "ok", or the URL to failure logs.
Results []string `json:"results"`
}
// SpanRecord is a datastore entity we write only at the end of a span
// (roughly a "step") of the build.
type SpanRecord struct {
BuildID string
IsTry bool // is trybot run
GoRev string
Rev string // same as GoRev for repo "go"
Repo string // "go", "net", etc.
Builder string // "linux-amd64-foo"
OS string // "linux"
Arch string // "amd64"
Event string
Error string // empty for no error
Detail string
StartTime time.Time
EndTime time.Time
Seconds float64
}
// BuildRecord is the datastore entity we write both at the beginning
// and end of a build. Some fields are not updated until the end.
type BuildRecord struct {
ID string
ProcessID string
StartTime time.Time
IsTry bool // is trybot run
GoRev string
Rev string // same as GoRev for repo "go"
Repo string // "go", "net", etc.
Builder string // "linux-amd64-foo"
OS string // "linux"
Arch string // "amd64"
EndTime time.Time
Seconds float64
Result string // empty string, "ok", "fail"
FailureURL string `datastore:",noindex"`
// TODO(bradfitz): log which reverse buildlet we got?
// Buildlet string
}