Skip to content

Commit

Permalink
📝 document requirements and how to run the tests.
Browse files Browse the repository at this point in the history
  • Loading branch information
filmaj committed Aug 29, 2018
1 parent 6ed1010 commit 4b43747
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,27 @@

SirMordred is the tool used to coordinate the execution of the GrimoireLab platform, via a configuration file. Below you can find details about the different sections composing the configuration file.

## Requirements

One good way of having an immediate sense of requirements is to look through our [`.travis.yml`](.travis.yml) file to see what our CI does to validate SirMordred.

1. Ensure you have all the [supporting systems](https://chaoss.github.io/grimoirelab-tutorial/before-you-start/supporting-systems.html) SirMordred needs. In particular, make sure [ElasticSearch is installed and running](https://chaoss.github.io/grimoirelab-tutorial/before-you-start/supporting-systems.html#installing-elasticsearch). (psst: [you can do this via a docker image faster](https://chaoss.github.io/grimoirelab-tutorial/before-you-start/supporting-systems.html#installing-elasticsearch-and-kibana-from-a-docker-container))
2. Prepare and activate a `python3` virtualenv by following our [tutorial instructions](https://chaoss.github.io/grimoirelab-tutorial/before-you-start/installing-grimoirelab.html#preparing-a-virtualenv).
3. Install dependencies by following the steps in our [`.travis.yml file`](.travis.yml). At the time of this writing, those are:
```sh
pip install pandas==0.18.1
pip install httpretty==0.8.6
pip install -r "requirements.txt"
pip install flake8
pip install coveralls
```
## Testing

```sh
flake8 .
cd tests && ./runtests.py
```

## General Sections

### [es_collection]
Expand Down Expand Up @@ -114,3 +135,4 @@ A complete list of studies parameters is available at:
* **study-param-1**: ..
* **study-param-2**: ..
* **study-param-n**: ..

0 comments on commit 4b43747

Please sign in to comment.