repointerface

type Constraint struct {
	RepoType string
	Ranges   []VersionRange
	Raw      string
}

type ConstraintString struct {
	RepoType string               `json:"repo_type"`
	Ranges   []VersionRangeString `json:"ranges"`
	Raw      string               `json:"raw"`
}

type EnvSpec interface {
	Encode() string
}

type Repo interface {
	// init repository parameters by deployment context
	Init(context *dcontext.DeployContext) (err error)
	// generate a Environemnt SpecSheet by repository parametes and the given name & specifier
	// Should Init() the Repo before calling this function
	GetEnvSpec() EnvSpec

	// Finding 0 version is not an error, should return []Version{} and nil
	// This function MUST NOT rely on deployment context
	GetVersions(name string) (versions []Version, err error)
	SelectVersion(versions []Version) (selected Version, err error)

	// Finding 0 environment is not an error, should return []string{} and nil
	// This function MUST NOT rely on deployment context
	GetEnvs(name string, version Version) (envs []string, err error)
	SelectEnv(envs []string, envSpec EnvSpec) (selected string, err error)
	FilterEnv(envs []string) (selected []string)

	// fabricate a prefab according to a SpecSheet, then save the prefab and blueprint to dstDir
	// and return the path to prefab and blueprint
	// This function MUST NOT rely on deployment context
	Fabricate(name string, version Version, envs []string, dstDir string) (prefabPaths []string, blueprintPaths []string, fileType string, err error)
}

type SpecSheet struct {
	Type      string
	Name      string
	Version   Version
	Env       string
	Specifier Constraint
	EnvSpec   EnvSpec
}

type SpecSheetString struct {
	Type      string
	Name      string
	Version   string
	Env       string
	Specifier string
	EnvSpec   string
}

type Version interface {
	Compare(Version) int
	String() string
}

type VersionRange struct {
	LowerBound     Version
	UpperBound     Version
	LowerInclusive bool
	UpperInclusive bool
}

type VersionRangeString struct {
	LowerBound     string `json:"lower_bound"`
	UpperBound     string `json:"upper_bound"`
	LowerInclusive bool   `json:"lower_inclusive"`
	UpperInclusive bool   `json:"upper_inclusive"`
}