2023-11-22 21:43:20 +00:00
|
|
|
# spec
|
2023-11-22 21:39:27 +00:00
|
|
|
|
2023-11-22 21:43:20 +00:00
|
|
|
CLI utility for initializing projects in reproducible ways.
|
2023-11-22 21:39:27 +00:00
|
|
|
|
2023-11-22 21:55:55 +00:00
|
|
|
## Overview
|
2023-11-22 21:39:27 +00:00
|
|
|
|
|
|
|
|
Within the `specs` directory exists so-called *specs*. A spec is a directory
|
|
|
|
|
containing a `spec.json` file and a `run.sh` file. The former is configured like
|
|
|
|
|
so:
|
|
|
|
|
|
|
|
|
|
```spec.json
|
|
|
|
|
{
|
|
|
|
|
versions: [...],
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The keys of this top-level JSON object correspond to the parameters that are
|
2023-11-22 21:55:55 +00:00
|
|
|
prompted by the `spec init` curses interface. The value is used to determine
|
|
|
|
|
what kind of prompt `spec` provides for the given question. Possible value types
|
|
|
|
|
include:
|
2023-11-22 21:39:27 +00:00
|
|
|
|
|
|
|
|
* `[...]` (list)
|
|
|
|
|
* This indicates a select option prompt. The user chooses amongst the values
|
|
|
|
|
specified in the JSON list.
|
|
|
|
|
|
|
|
|
|
Once all prompts are evaluated, the keys of the object are converted into
|
|
|
|
|
uppercase environment variables and passed to the `run.sh` file relative to the
|
|
|
|
|
current directory.
|
