A package path is a unique identifier for a package, for example github.comuserfoo.

Turn a package path (which always uses forward slashes) into a file path in the local file system (which might use different slashes).

The dependencies of a (revision of a) package is a mapping from package paths to minimum versions (and an optional hash pinning).

Convert a SemVer back to its textual representation.

An (Ideal) version number that conforms to Semantic Versioning. This is a prescriptive parser, meaning it follows the SemVer standard.

Legal semvers are of the form: MAJOR.MINOR.PATCH-PREREL+META

Example: 1.2.3-r1+commithash

Extra Rules:

1. Pre-release versions have lower precedence than normal versions.
2. Build metadata does not affect version precedence.
3. PREREL and META strings may only contain ASCII alphanumerics and hyphens.

For more information, see http://semver.org

A single unit of a Version. May be digits or a string of characters. Groups of these are called VChunks, and are the identifiers separated by periods in the source.

commitVersion timestamp commit constructs a commit version.

Versions of the form (0,0,0)-timestamp+hash are treated specially, as a reference to the commit identified uniquely with hash (typically the Git commit ID). This function detects such versions.

Unfortunately, Data.Versions has a buggy semver parser that collapses consecutive zeroes in the metadata field. So, we define our own parser here. It's a little simpler too, since we don't need full semver.

A structure corresponding to a futhark.pkg file, including comments. It is an invariant that duplicate required packages do not occcur (the parser will verify this).

Possibly given a package path, construct an otherwise-empty manifest file.

The required packages listed in a package manifest.

Where in the corresponding repository archive we can expect to find the package files.

Add new required package to the package manifest. If the package was already present, return the old version.

Remove a required package from the manifest. Returns Nothing if the package was not found in the manifest, and otherwise the new manifest and the Required that was present.

Prettyprint a package manifest such that it can be written to a futhark.pkg file.

A line comment.

Wraps a value with an annotation of preceding line comments. This is important to our goal of being able to programmatically modify the futhark.pkg file while keeping comments intact.

An entry in the required section of a futhark.pkg file.

The name of the file containing the futhark-pkg manifest.

Parse a text as a PkgManifest. The FilePath is used for any error messages.

Read contents of file and pass it to parsePkgManifest.

Pretty-print a ParseErrorBundle. All ParseErrors in the bundle will be pretty-printed in order together with the corresponding offending lines by doing a single efficient pass over the input stream. The rendered String always ends with a newline.

Since: megaparsec-7.0.0

A mapping from package paths to their chosen revisions. This is the result of the version solver.

Prettyprint a build list; one package per line and newline-terminated.