urchin/tests
Michael Klement 2847b020b4 Make sure that CDPATH isn't set, as it causes cd to behave unpredictably - notably, it can produce output, which breaks fullpath().
Also: Improved CLI help, updated URLs in read-me, cleaned up package.json:

I've tried to clarify the intent of `-x` in the CLI help, but I haven't touched the read-me in that respect.

I don't see any benefit to `-x`:

* Just using `#/bin/sh` as the shebang line in combination with `-s <shell>` gives you the same functionality,
* When it comes to invoking scripts from _within_ test scripts, nothing can do the work for you: you consciously have to mark the invocation with _something_ to indicate that it should be controlled from the outside; it won't get any easier than `$TEST_SHELL ...`
* Finally, using a shebang line such as `#!/usr/bin/env urchin -x` is problematic for two reasons:
  * Some platforms can handle only *1* argument in a shebang line.
  * In a _package-local_ installation, `#!/usr/bin/env` may not find the Urchin executable.

I'm also not sure how the following (from `readme.md`) fits in the picture:

> It might make sense if you do this.

    export TEST_SHELL=zsh && urchin -x
    export TEST_SHELL=bash && urchin -x

(As an aside: To achieve the same thing, you don't need `export`; `TEST_SHELL=zsh urchin -x`  and `TEST_SHELL=bash urchin -x`  is the better choice.)
How does this relate to use in a  _shebang line_?

`urchin_help()` now uses a here-doc: easier to maintain, and should work in all Bourne-like shells.

`readmeFilename` removed from `package.json`:

> "The readmeFilename does not need to ever be in your actual package.json file" - npm/npm#3573
2014-12-03 09:54:15 -05:00
..
- directories starting with a hypen... Ensure we can cd into directories starting with a hyphen. Fixes #3. 2013-07-26 12:51:01 +01:00
.example-test-suite check failureness 2012-10-11 00:17:44 -04:00
Command-line help contents Support for cross-shell testing added, via option -s <shell> and env. variable TEST_SHELL. 2014-10-17 17:16:12 -04:00
Counts should be kept of successes and failures. Test for singular. 2013-06-20 18:43:11 +01:00
Cross-shell test support Support for cross-shell testing added, via option -s <shell> and env. variable TEST_SHELL. 2014-10-17 17:16:12 -04:00
Setup and teardown rename tests 2012-10-11 15:32:07 -04:00
The setup script should not be sourced. rename tests 2012-10-11 15:32:07 -04:00
urchin exit code Document the non zero exit code case. 2014-03-17 14:00:30 +00:00
Urchin should do a sanity check so that directories like the user home are not specified as tests. Various bug fixes and cleanup. 2014-10-16 16:37:51 -04:00
Urchin should recognize that the filesystem is sane. Various bug fixes and cleanup. 2014-10-16 16:37:51 -04:00
.gitignore Various bug fixes and cleanup. 2014-10-16 16:37:51 -04:00
.print-arg-3 fix -sh 2014-11-05 17:46:19 +00:00
A nonempty CDPATH should not break urchin. Make sure that CDPATH isn't set, as it causes cd to behave unpredictably - notably, it can produce output, which breaks fullpath(). 2014-12-03 09:54:15 -05:00
Exit codes of zero should pass. rename tests 2012-10-11 15:32:07 -04:00
Failing tests should be marked in red. rename tests 2012-10-11 15:32:07 -04:00
Succeeding tests should be marked in green. rename tests 2012-10-11 15:32:07 -04:00
urchin -x should start the $TEST_SHELL. fix -sh 2014-11-05 17:46:19 +00:00