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
50
51
52
53
54
55
56
57
58
59
60
61
|
This project uses (perhaps the development version of) [`b0`] for
development. Consult [b0 occasionally] for quick hints on how to
perform common development tasks.
[`b0`]: https://erratique.ch/software/b0
[b0 occasionally]: https://erratique.ch/software/b0/doc/occasionally.html
# Build system for distribution
The build system used for distribution is in the `Makefile`.
# Changing completion scripts
To test them you can:
source ./src/tool/zsh-completion.sh # zsh
source ./src/tool/bash-completion.sh # bash
. ./src/tool/pwsh-completion.ps1 # powershell
This replaces the generic completion function used by tool completion
scripts with the new definition. Trying to complete tools should now
use the new definitions. To test the file, directory and path
completions you can also use this test (invoke with `--help`)
b0 -- test_shell
If you change completion scripts in [`src/tool`](src/tool) you must invoke:
b0 -- update-cmdliner-data
so that the changes get incorporated into the `cmdliner` tool.
# Testing
Testing is done with `B0_testing` from `b0.std`. The catch is that
`B0_testing` depends on `cmdliner` so we need a build of `b0.std` with
our build of `cmdliner` to link against our test executables.
To do so we do a checkout of `b0`'s repo in `test/b0` (which is ignored
by `git`).
cd test
git clone https://erratique.ch/repos/b0.git
The [`B0.ml`](B0.ml) file of cmdliner includes `test/b0/B0.ml` and the
`default` pack of `B0.ml` is unlocked so that when a test executable
requires `b0.std` it is looked up and built againt the development
version of cmdliner. After that testing remains [as usual].
[as usual]: https://erratique.ch/software/b0/doc/occasionally.html#test
## Manual renderings
Various manual renderings are snapshot tested in the test executables,
mostly in plain text.
The `test_man` test can be invoked with `--test-help[=FMT]` to interactively
test the various `--help[=FMT]` invocations, including paging.
b0 -- test_man --test-help
|
