Getting Started


$ pip install malaffinity

Alternatively, download this repo and run:

$ python install

To use the development version (please don’t), run:

$ pip install --upgrade


  • BeautifulSoup4
  • lxml
  • Requests

These should be installed when you install this package, so no need to worry about them.

lxml is a bit wonky sometimes. If install fails:

$ pip install --upgrade pip
$ pip install --upgrade lxml

If all else fails and you’re on Windows, download the wheel yourself and:

$ pip install /path/to/wheel.whl


This section demonstrates how documentation can be built and tests run. These should not be used unless you’re contributing to the package.


To install the dependencies needed to build the docs, run:

$ pip install .[doc]

The docs can then be built by navigating to the docs directory, and running:

$ make html

The built docs will now be in ./_build/html. You can either run them by clicking and viewing them, or by running a server in that directory, which you can view in your browser.


Any warnings that show up when building will be interpreted as errors when the tests get run on Travis, which will cause the build to fail. You’ll want to make sure these are taken care of.

Test Suite

To install the dependencies needed for the test suite, run:

$ pip install .[test]

It is advised to run the test suite through coverage, so a coverage report can be generated as well. To do this, run:

$ coverage run --source malaffinity test

The tests should then run. You can view the coverage report by running:

$ coverage report

You should be aiming for 100% coverage in the tests.