https://github.com/atoum/docker
A docker image for atoum
https://github.com/atoum/docker
Last synced: 7 months ago
JSON representation
A docker image for atoum
- Host: GitHub
- URL: https://github.com/atoum/docker
- Owner: atoum
- Created: 2015-02-21T21:05:20.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2016-10-01T15:06:21.000Z (over 9 years ago)
- Last Synced: 2025-04-10T19:21:56.211Z (9 months ago)
- Language: Shell
- Homepage:
- Size: 22.5 KB
- Stars: 11
- Watchers: 9
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# atoum/atoum
## Install it
Pull the [docker](https://www.docker.com/) image:
```sh
$ docker pull atoum/atoum
```
There are several tags available. Depending on the atoum version you want to use, you should use:
* `atoum/atoum:latest` to get an image containing the last stable atoum release,
* `atoum/atoum:2.x` to get an image containing the last `2.x` atoum release,
* `atoum/atoum:1.x` to get an image containing the last `1.x` atoum release.
## Run it
Run the container:
```sh
$ docker run --rm -it -v $(pwd):/src atoum/atoum -d tests/units
```
The command explains as follow:
```sh
$ docker run --rm -it -v :/src atoum/atoum [atoum-arguments]
```
As you can see, you will have to provide a directory to link to the `/src` volume.
`atoum-arguments` are standard atoum CLI arguments which you can find by using `-h`.
## Utilities
The docker image ships with a handy command line utility you can access to with the `atoum` command
inside your containers. This command is automatically run as the entrypoint but if you are
extending this image or working in it, you will probably use the `atoum` CLI so here is
how it works:
* the `ext-install` command lets you install and configure atoum extensions:
```sh
$ atoum ext-install bdd
$ atoum ext-install json '~1.0'
```
* the `ext-update` command lets you update installed extensions:
```sh
$ atoum ext-update bdd
```
* the `update` command lets you keep atoum up-to-date:
```sh
$ atoum update
```
* the `update-all` command lets you update everything (atoum and all installed extensions):
```sh
$ atoum update-all
```
* the `say` command lets you make atoum talk:
```sh
$ atoum say 'Hello World!'
```
* every other things you pass to the `atoum` CLI will be forwarded to the original `atoum` binary. For example
the following command will run the tests in `tests/units` and enable the loop mode:
```sh
$ atoum -d tests/units --loop
```