type Context struct {
	// Path to the avo version under test.
	AvoDirectory string

	// Path to the checked out third-party repository.
	RepositoryDirectory string
}

type GithubRepository struct {
	Owner string `json:"owner"`
	Name  string `json:"name"`
}

type Metadata struct {
	// Repository description.
	Description string `json:"description,omitempty"`

	// Homepage URL. Not the same as the Github page.
	Homepage string `json:"homepage,omitempty"`

	// Number of Github stars.
	Stars int `json:"stars,omitempty"`
}

type Package struct {
	// Repository the package belongs to. At the moment, all packages are
	// available on github.
	Repository GithubRepository `json:"repository"`

	// Repository metadata.
	Metadata Metadata `json:"metadata"`

	// Default git branch. This is used when testing against the latest version.
	DefaultBranch string `json:"default_branch,omitempty"`

	// Version as a git sha, tag or branch.
	Version string `json:"version"`

	// Sub-package within the repository under test. All file path references
	// will be relative to this directory. If empty the root of the repository
	// is used.
	SubPackage string `json:"pkg,omitempty"`

	// Path to the module file for the avo generator package. This is necessary
	// so the integration test can insert replace directives to point at the avo
	// version under test.
	Module string `json:"module"`

	// Setup steps. These run prior to the insertion of avo replace directives,
	// therefore should be used if it's necessary to initialize new go modules
	// within the repository.
	Setup []*Step `json:"setup,omitempty"`

	// Steps to run the avo code generator.
	Generate []*Step `json:"generate"` // generate commands to run

	// Test steps. If empty, defaults to "go test ./...".
	Test []*Step `json:"test,omitempty"`

	// If the package test has a known problem, record it by setting this to a
	// non-zero avo issue number.  If set, the package will be skipped in
	// testing.
	KnownIssue int `json:"known_issue,omitempty"`
}

type Packages []*Package

type Step struct {
	Name             string   `json:"name,omitempty"`
	WorkingDirectory string   `json:"dir,omitempty"`
	Commands         []string `json:"commands"`
}