Documentation
¶
Overview ¶
Package modfile provides functionality for reading and parsing the CUE module file, cue.mod/module.cue.
WARNING: THIS PACKAGE IS EXPERIMENTAL. ITS API MAY CHANGE AT ANY TIME.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ErrNoLanguageVersion = fmt.Errorf("no language version declared in module.cue")
ErrNoLanguageVersion is returned by Parse and ParseNonStrict when a cue.mod/module.cue file lacks the `language.version` field.
Functions ¶
func EarliestClosedSchemaVersion ¶ added in v0.9.0
func EarliestClosedSchemaVersion() string
EarliestClosedSchemaVersion returns the earliest module.cue schema version that excludes unknown fields. Any version declared in a module.cue file should be at least this, because that's when we added the language.version field itself.
Types ¶
type Dep ¶
type Dep = modfiledata.Dep
type File ¶
type File = modfiledata.File
File represents the contents of a cue.mod/module.cue file.
func FixLegacy ¶ added in v0.9.0
FixLegacy converts a legacy module.cue file as parsed by ParseLegacy into a format suitable for parsing with Parse. It adds a language.version field and moves all unrecognized fields into custom.legacy.
If there is no module field or it is empty, it is set to "test.example".
If the file already parses OK with ParseNonStrict, it returns the result of that.
func Parse ¶
Parse verifies that the module file has correct syntax and follows the schema following the required language.version field. The file name is used for error messages. All dependencies must be specified correctly: with major versions in the module paths and canonical dependency versions.
func ParseLegacy ¶
ParseLegacy parses the legacy version of the module file that only supports the single field "module" and ignores all other fields.
func ParseNonStrict ¶
ParseNonStrict is like Parse but allows some laxity in the parsing:
- if a module path lacks a version, it's taken from the version.
- if a non-canonical version is used, it will be canonicalized.
The file name is used for error messages.
type Language ¶
type Language = modfiledata.Language
type Source ¶ added in v0.9.0
type Source = modfiledata.Source
Source represents how to transform from a module's source to its actual contents.
Source Files