💁 Adjust ospec bin def, add to README

Getting set up with ospec is deceptively simple, and adding just a bit
more documentation should help new users from falling into the trap of
overthinking the test config.  (I know that I ended up down a very
strange rabbit hole when pulling ospec into a project).

This also adjusts the bin definition in the package file so that we can
hopefully just use the `ospec` command instead of a folder ref.
This commit is contained in:
Douglas Brown 2016-10-14 13:27:44 -04:00
parent 664888d151
commit d02a238bf0
2 changed files with 40 additions and 2 deletions

View file

@ -4,7 +4,7 @@
Noiseless testing framework
Version: 1.1
Version: 1.1
License: MIT
## About
@ -259,6 +259,42 @@ _o("a test", function() {
_o.run()
```
### Running the test suite from the command-line
ospec will automatically evaluate all `*.js` files in any folder named `/tests`.
`o.run()` is automatically called by the cli - no need to call it in your test code.
#### Create an npm script in your package:
```
"scripts": {
...
"test": "ospec",
...
}
```
```
$ npm test
```
#### (Optionally) Install Globally
```
$ npm i -g ospec
$ ospec
```
#### (Optionally) Evaluate ES6+ code:
One way to accomplish this would be to include the 'babel-cli' module (`npm i babel-cli`)
(This would pre-suppose that you're already using babel in your project and thus have it configured to your liking).
```
$ babel-node ospec
```
---
## API