config

README

opencontrol.yaml README

opencontrol.yaml is a configuration file that describes the makeup of a system. It describes the components it directly uses as well as any dependent systems / components.

In order to support backwards comparability, we version the configuration file with a field named: schema_version.

The version is expressed in a string format using semantic versioning.

Adding a new schema version.

When adding a new schema version. (in this example we will add v2.0.0

• Create a new numbered version folder under the versions folder.

  • e.g. mkdir versions/2.0.0/.
  • Make the package name for the go files schema.
  • Ensure there is a function that implements this prototype: func (s *Schema) Parse(data []byte) error

• In parse.go

  • Create a new Schema Version variable for clean code sake.
    • e.g. SchemaV2_0_0 = semver.Version{2, 0, 0, nil, nil}
  • In the switch case, add a new case for 2.0.0 that calls ParseV2_0_0

  	case SchemaV2_0_0.Equals(v):
  		schema, parseError = parser.ParseV2_0_0(data)
  

• Add a new ParseV2_0_0 function to the parser/parser.go file.

  • It should satisfy the func (p Parser) ParseVX_Y_Z(data []byte) (common.BaseSchema, error) { prototype.
  • Alias the import so that you can easily refer to the particular version.

  import (
    v1_0_0 "github.com/opencontrol/compliance-masonry/yaml/versions/1.0.0"
    v2_0_0 "github.com/opencontrol/compliance-masonry/yaml/versions/2.0.0"
  )
  

  • Now it should call the parse function that your schema version has.

  config := v2_0_0.Schema{}
  config.Parse(data)
  

Documentation

Index

• Constants
• Variables
• func Parse(parser common.SchemaParser, data []byte) (common.BaseSchema, error)

Constants

const (
	// ErrMalformedBaseYamlPrefix is just the prefix to the error message for when the program is unable to parse
	// data into the base yaml struct.
	ErrMalformedBaseYamlPrefix = "Unable to parse yaml data"
)

Variables

var (
	// ErrNoDataToParse represents the case that there is no data to be found to be parsed (either nil or empty).
	ErrNoDataToParse = errors.New("No data to parse")
	// ErrUnknownSchemaVersion is thrown when the schema version is unknown to the parser.
	ErrUnknownSchemaVersion = errors.New("Unknown schema version")
	// ErrCantParseSemver is thrown when the semantic versioning can not be parsed.
	ErrCantParseSemver = errors.New("Can't parse semantic versioning of schema_version")
)

var (
	// SchemaV1_0_0 is the semantic versioning representation in object form for version 1.0.0
	SchemaV1_0_0 = semver.Version{1, 0, 0, nil, nil}
)

Functions

func Parse

func Parse(parser common.SchemaParser, data []byte) (common.BaseSchema, error)

Parse will try to parse the data and determine which specific version of schema to further parse.