var (
    // TODO(evanbrown): resource requirements should be
    // defined per-builder in dashboard/builders.go
    BuildletCPU    = api.MustParse("2")         // 2 Cores
    BuildletMemory = api.MustParse("2000000Ki") // 2,000,000Ki RAM
)

var ErrClosed = errors.New("buildlet: Client closed")

var ErrTimeout = errors.New("buildlet: timeout waiting for command to complete")

var GCEGate func()

var NoKeyPair = KeyPair{}

type Client struct {
    // contains filtered or unexported fields
}

type CoordinatorClient struct {
    // Auth specifies how to authenticate to the coordinator.
    Auth UserPass

    // Instance optionally specifies the build coordinator to connect
    // to. If zero, the production coordinator is used.
    Instance build.CoordinatorInstance
    // contains filtered or unexported fields
}

type DirEntry struct {
    // contains filtered or unexported fields
}

type ExecOpts struct {
    // Output is the output of stdout and stderr.
    // If nil, the output is discarded.
    Output io.Writer

    // Dir is the directory from which to execute the command.
    // It is optional. If not specified, it defaults to the directory of
    // the command, or the work directory if SystemLevel is set.
    Dir string

    // Args are the arguments to pass to the cmd given to Client.Exec.
    Args []string

    // ExtraEnv are KEY=VALUE pairs to append to the buildlet
    // process's environment.
    ExtraEnv []string

    // Path, if non-nil, specifies the PATH variable of the executed
    // process's environment. A non-nil empty list clears the path.
    // The following expansions apply:
    //   - the string "$PATH" expands to any existing PATH element(s)
    //   - the substring "$WORKDIR" expands to buildlet's temp workdir
    // After expansions, the list is joined with an OS-specific list
    // separator and supplied to the executed process as its PATH
    // environment variable.
    Path []string

    // SystemLevel controls whether the command is run outside of
    // the buildlet's environment.
    SystemLevel bool

    // Debug, if true, instructs to the buildlet to print extra debug
    // info to the output before the command begins executing.
    Debug bool

    // OnStartExec is an optional hook that runs after the 200 OK
    // response from the buildlet, but before the output begins
    // writing to Output.
    OnStartExec func()

    // Timeout is an optional duration before ErrTimeout is returned.
    Timeout time.Duration
}

type KeyPair struct {
    CertPEM string
    KeyPEM  string
}

type ListDirOpts struct {
    // Recursive controls whether the directory is listed
    // recursively.
    Recursive bool

    // Skip are the directories to skip, relative to the directory
    // passed to ListDir. Each item should contain only forward
    // slashes and not start or end in slashes.
    Skip []string

    // Digest controls whether the SHA-1 digests of regular files
    // are returned.
    Digest bool
}

type PodOpts struct {
    // ProjectID is the GCE project ID. Required.
    ProjectID string

    // ImageRegistry specifies the Docker registry Kubernetes
    // will use to create the pod. Required.
    ImageRegistry string

    // TLS optionally specifies the TLS keypair to use.
    // If zero, http without auth is used.
    TLS KeyPair

    // Description optionally describes the pod.
    Description string

    // Labels optionally specify key=value strings that Kubernetes
    // can use to filter and group pods.
    Labels map[string]string

    // DeleteIn optionally specifies a duration at which
    // to delete the pod.
    DeleteIn time.Duration

    // OnPodCreating optionally specifies a hook to run synchronously
    // after the pod create request has been made, but before the create
    // has suceeded.
    OnPodCreating func()

    // OnPodCreated optionally specifies a hook to run synchronously
    // after the pod create request succeeds.
    OnPodCreated func()

    // OnGotPodInfo optionally specifies a hook to run synchronously
    // after the pod Get call.
    OnGotPodInfo func()
}

type RemoteBuildlet struct {
    Type    string // "openbsd-386"
    Name    string // "buildlet-adg-openbsd-386-2"
    Created time.Time
    Expires time.Time
}

type Status struct {
    Version int // buildlet version, coordinator rejects any value less than 1.
}

type UserPass struct {
    Username string // "user-$USER"
    Password string // buildlet key
}

type VM struct {
    // Name is the name of the GCE VM instance.
    // For example, it's of the form "mote-bradfitz-plan9-386-foo",
    // and not "plan9-386-foo".
    Name   string
    IPPort string
    TLS    KeyPair
    Type   string
}

type VMOpts struct {
    // Zone is the GCE zone to create the VM in. Required.
    Zone string

    // ProjectID is the GCE project ID. Required.
    ProjectID string

    // TLS optionally specifies the TLS keypair to use.
    // If zero, http without auth is used.
    TLS KeyPair

    // Optional description of the VM.
    Description string

    // Optional metadata to put on the instance.
    Meta map[string]string

    // to delete the VM.
    DeleteIn time.Duration

    // OnInstanceRequested optionally specifies a hook to run synchronously
    // after the computeService.Instances.Insert call, but before
    // waiting for its operation to proceed.
    OnInstanceRequested func()

    // OnInstanceCreated optionally specifies a hook to run synchronously
    // after the instance operation succeeds.
    OnInstanceCreated func()

    // OnInstanceCreated optionally specifies a hook to run synchronously
    // after the computeService.Instances.Get call.
    OnGotInstanceInfo func()

    // FallbackToFullPrice optionally specifies a hook to return a new
    // GCE instance name if the first one failed to launch
    // as preemptible. (If you use the same name, GCE complains about
    // resources already existing, even if it failed to be created)
    FallbackToFullPrice func() (newInstname string)
}