btr 0.2.1

CLI to standardize build, test, and run commands across projects
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# Command Features

## Supported Commands

The CLI should support project-defined commands beyond `build`, `test`, and `run`.

Recommended built-in command names:

- `build`
- `test`
- `run`
- `fmt`
- `clean`
- `ci`
- any custom command via `btr exec <name>`

## Typical Usage

```bash
btr build
btr test
btr run
btr fmt
btr clean
btr ci
btr exec lint
```

## Suggested Semantics

- `btr fmt` should format the project using the project-defined formatter.
- `btr clean` should remove generated build artifacts.
- `btr ci` should run the project's CI workflow.

## Example Node Config

```toml
[commands]
build = { program = "npm", args = ["run", "build"] }
test = { program = "npm", args = ["test"] }
run = { program = "npm", args = ["start"] }
fmt = { program = "npm", args = ["run", "format"] }
clean = { program = "npm", args = ["run", "clean"] }
ci = { program = "npm", args = ["run", "ci"] }
```

## Recommendation

Keep these as thin aliases over project-configured commands so the CLI stays language-agnostic.