django-tracking-analyzer 0.1b4

Requirements

• Django 1.9 or later.

• Django Countries 3.4.1 or later.

• Django IPWare 1.1.5 or later.

• Django User Agents 0.3.0 or later.

• GeoIP2 2.3.0 or later.

• MaxMind GeoLite2 country datasets.

Installation

1. Install Django Tracking Analyzer from PyPI by using pip:

   pip install django-tracking-analyzer

2. Add 'tracking_analyzer' entry to Django INSTALLED_APPS setting.

3. Run the migrations to load the Tracker model in your database:

   python manage.py migrate tracking_analyzer

4. Install the MaxMind® GeoIP2 Country dataset. You can do this in two ways:

   4.1. By running the provided management command for this:

   python manage.py install_geoip_dataset

   4.2. Or manually, by following the instructions in GeoIP2 Django documentation.

After following those steps, you should be ready to go.

Contribution

All contributions or fixes are welcome. Just make sure to follow this rules:

• Always include some unit tests for the new code you write or the bugs you fix. Or, update the existent unit tests, if necessary.

• Stick to PEP-8 styling.

• Make your pull requests to development branch.

python setup.py test

python setup.py test --pytest-args "--cov-report xml --cov tracking_analyzer tests/ --verbose --junit-xml=junit.xml --color=yes"

python setup.py test --pytest-args "--cov-report xml --cov tracking_analyzer tests/ --verbose --junit-xml=junit.xml --color=yes --pylint --pylint-rcfile=pylint.rc --pep8"

Acknowledgements

Django Tracking Analyzer makes use of this technologies and apps, without which it wouldn’t be possible:

• Django Countries, by Chris Beaven.

• Django IPWare, by Val Neekman.

• Django User Agents, by Selwin Ong.

• Datamaps, by Marc DiMarco.

• TopoJSON, by Mike Bostock.

• D3 bar chart w/tooltips, original code by Justin Palmer.

• D3 area chart, by Mike Bostock.

• Of course, the D3.js library.

• And MaxMind, the company behind all the geographical datasets that made them publicly available.