document .urchin_dir
This commit is contained in:
parent
406d6f43f8
commit
5cbafb2a78
15
HISTORY
15
HISTORY
@ -12,18 +12,18 @@ test suite, as we need to know how far up to apply the setup
|
|||||||
and teardown files.
|
and teardown files.
|
||||||
|
|
||||||
The Urchin root directory is determined by moving higher in the directory
|
The Urchin root directory is determined by moving higher in the directory
|
||||||
tree in search of a file named `.urchin`.
|
tree in search of a file named `.urchin_root`.
|
||||||
The closest directory that contains such a file is considered the root.
|
The closest directory that contains such a file is considered the root.
|
||||||
In the following filesystem, for example, `/a/b/c` would be the root.
|
In the following filesystem, for example, `/a/b/c` would be the root.
|
||||||
|
|
||||||
mkdir -p /a/b/c/d
|
mkdir -p /a/b/c/d
|
||||||
touch /a/b/c/d/e
|
touch /a/b/c/d/e
|
||||||
chmod +x /a/b/c/d/e
|
chmod +x /a/b/c/d/e
|
||||||
touch /a/b/c/.urchin
|
touch /a/b/c/.urchin_root
|
||||||
urchin /a/b/c/d
|
urchin /a/b/c/d
|
||||||
|
|
||||||
There are two situations in which we would stop looking without having
|
There are two situations in which we would stop looking without having
|
||||||
found a `.urchin` file.
|
found a `.urchin_root` file.
|
||||||
|
|
||||||
1. The system root, `/`, because we can't go any higher
|
1. The system root, `/`, because we can't go any higher
|
||||||
2. A directory that starts with a dot, because an urchin call on a higher
|
2. A directory that starts with a dot, because an urchin call on a higher
|
||||||
@ -97,6 +97,13 @@ turned on.
|
|||||||
|
|
||||||
Parallel processing and shell cycling are both enabled by default.
|
Parallel processing and shell cycling are both enabled by default.
|
||||||
|
|
||||||
|
You may want make only some directories run in series, you can create
|
||||||
|
".urchin_dir" files in those directories.
|
||||||
|
If .urchin_dir contains the phrase "series", run that directory in series
|
||||||
|
rather than in parallel.
|
||||||
|
This is helpful when directories actually need to run in series
|
||||||
|
and also when running all your tests in parallel crashes your computer.
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
Long options are now available for all command line flags.
|
Long options are now available for all command line flags.
|
||||||
For example, the `-s` flag is now available as `--shell` as well.
|
For example, the `-s` flag is now available as `--shell` as well.
|
||||||
@ -229,7 +236,7 @@ other Urchin call), and the test suite is recursively descended. Setup and
|
|||||||
teardown files are sourced, and everything but the specified test file is
|
teardown files are sourced, and everything but the specified test file is
|
||||||
otherwise ignored.
|
otherwise ignored.
|
||||||
|
|
||||||
If you don't explicitly specify the Urchin root with a .urchin file, we
|
If you don't explicitly specify the Urchin root with a .urchin_root file, we
|
||||||
consider the test suite root directory to be the parent of the file that
|
consider the test suite root directory to be the parent of the file that
|
||||||
you ran Urchin on.
|
you ran Urchin on.
|
||||||
|
|
||||||
|
11
TODO
11
TODO
@ -46,17 +46,6 @@ List some shell linters somewhere.
|
|||||||
* checkbashisms
|
* checkbashisms
|
||||||
|
|
||||||
|
|
||||||
Set parallel and series
|
|
||||||
----------
|
|
||||||
I want to be able to make only some directories run in series.
|
|
||||||
This is helpful when directories actually need to run in series
|
|
||||||
and also when running all your tests in parallel crashes your computer.
|
|
||||||
|
|
||||||
* Rename .urchin to .urchin_root.
|
|
||||||
* Look for a .urchin_dir file.
|
|
||||||
* If .urchin_dir contains "series", run that directory in series rather
|
|
||||||
than in parallel.
|
|
||||||
|
|
||||||
Rename to something other than "test"?
|
Rename to something other than "test"?
|
||||||
----------
|
----------
|
||||||
Maybe wait until I have a use for this.
|
Maybe wait until I have a use for this.
|
||||||
|
Loading…
Reference in New Issue
Block a user