config

type Config struct {
	// ConfigSet is the config set name (e.g. "projects/<id>") this config
	// belongs to.
	// May be the empty string if this is unknown.
	ConfigSet string `json:"configSet,omitempty"`

	// Path is the filename relative to the root of the config set,
	// without leading slash, e.g. "luci-cron.cfg".
	// May be the empty string if this is unknown.
	Path string

	// Error is not nil if there where troubles fetching this config. Used only
	// by functions that operate with multiple configs at once, such as
	// GetProjectConfigs and GetRefConfigs.
	Error error `json:"error,omitempty"`

	// Content is the actual body of the config file.
	Content string `json:"content,omitempty"`

	// ContentHash can be used to quickly check that content didn't change.
	ContentHash string `json:"contentHash,omitempty"`

	// Revision is git SHA1 of a repository the config was fetched from.
	Revision string `json:"revision,omitempty"`
}

type Interface interface {
	// GetConfig returns a config at a path in a config set or ErrNoConfig
	// if missing. If hashOnly is true, returned Config struct has Content set
	// to "" (and the call is faster).
	GetConfig(ctx context.Context, configSet, path string, hashOnly bool) (*Config, error)

	// GetConfigByHash returns the contents of a config, as identified by its
	// content hash, or ErrNoConfig if missing.
	GetConfigByHash(ctx context.Context, contentHash string) (string, error)

	// GetConfigSetLocation returns the URL location of a config set.
	GetConfigSetLocation(ctx context.Context, configSet string) (*url.URL, error)

	// GetProjectConfigs returns all the configs at the given path in all
	// projects that have such config. If hashesOnly is true, returned Config
	// structs have Content set to "" (and the call is faster).
	GetProjectConfigs(ctx context.Context, path string, hashesOnly bool) ([]Config, error)

	// GetProjects returns all the registered projects in the configuration
	// service.
	GetProjects(ctx context.Context) ([]Project, error)

	// GetRefConfigs returns the config at the given path in all refs of all
	// projects that have such config. If hashesOnly is true, returned Config
	// structs have Content set to "" (and the call is faster).
	GetRefConfigs(ctx context.Context, path string, hashesOnly bool) ([]Config, error)

	// GetRefs returns the list of refs for a project.
	GetRefs(ctx context.Context, projectID string) ([]string, error)
}

type Project struct {
	// ID is unique project identifier.
	ID string

	// Name is a short friendly display name of the project.
	Name string

	// RepoType specifies in what kind of storage projects configs are stored.
	RepoType RepoType

	// RepoUrl is the location of this project code repository. May be nil if
	// unknown or cannot be parsed.
	RepoURL *url.URL
}

type RepoType string