Contributing

Running Tests

Thanks for your interest in contributing to aiomonitor, there are multiple ways and places you can contribute.

Fist of all just clone repository:

$ git clone git@github.com:aio-libs/aiomonitor.git

Create virtualenv with python3.5 (older version are not supported). For example using virtualenvwrapper commands could look like:

$ cd aiomonitor
$ mkvirtualenv --python=`which python3.5` aiomonitor

After that please install libraries required for development:

$ pip install -r requirements-dev.txt
$ pip install -e .

Congratulations, you are ready to run the test suite:

$ make cov

To run individual use following command:

$ py.test -sv tests/test_monitor.py -k test_name

Reporting an Issue

If you have found issue with aiomonitor please do not hesitate to file an issue on the GitHub project. When filing your issue please make sure you can express the issue with a reproducible test case.

When reporting an issue we also need as much information about your environment that you can include. We never know what information will be pertinent when trying narrow down the issue. Please include at least the following information:

  • Version of aiomonitor and python.
  • Version uvloop if installed.
  • Platform you’re running on (OS X, Linux).