Marc Cataford
4343402a04
* chore: add bootstrap script to facilitate startup * docs: mention bootstrap in README
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
# works-on-my-machine (womm)
|
|
|
|
> ✨ A full-nonsense pet test runner ✨
|
|
|
|
## So, what is this?
|
|
|
|
Software in the NodeJS ecosystem tends to depend _a lot_ on external dependencies. What would a test runner without any
|
|
look like? This is the question that started all of this.
|
|
|
|
`womm` is a pet test runner that follows the general direction of `jest` and `playwright` with a few additional
|
|
constraints:
|
|
|
|
- It must not have any production dependencies (some development dependencies are permissible, like `typescript` and
|
|
`rome`, but keeping it to a minimum);
|
|
- It must be compatible with the general API exposed by Jest and the like, for familiarity;
|
|
- It must use itself for testing.
|
|
|
|
### Hot takes baked in
|
|
|
|
`womm` is an opinionated implementation of Typescript/Javascript testing libraries we've all come to get used to. You
|
|
can peek at the opinions baked into this [here](./DESIGN_DECISIONS.md).
|
|
|
|
## Development
|
|
|
|
This uses [Corepack](https://github.com/nodejs/corepack), which comes bundled with `node>=16` to manage which Yarn version to use.
|
|
|
|
To get started, just `corepack enable` before using `yarn` commands. You can also jump in by running `.
|
|
script/bootstrap`, which will select the right version of Node, enable Corepack and install devDependencies.
|