Setup
Integration options
Tracker compatibility
As a programming language that lets you work more quickly and integrate your systems more effectively, Python is available in a huge number of different computing environments and platforms, from Civilization IV through Django framework to Ubuntu One.
To make the Snowplow Python Tracker work out-of-the-box with as many different Python programs as possible, we have tried to:
- Minimize external dependencies and third party libraries
- Provide setup instructions
Dependencies
To make the Snowplow Python Tracker work with as many different Python programs as possible, we have tried to keep external dependencies to a minimum. The main external dependencies currently are:
- Requests – HTTP library
- Python typing extensions – Backported type hints for Python
These dependencies can be installed from the package manager of the host system or through PyPi.
In addition, since version 0.9.0, extra functionality, like the redis and celery emitters, was separated and needs to be explicitly installed, so as to keep the core version as light as possible.
Setup
PyPI
The Snowplow Python Tracker is published to PyPI, the the official third-party software repository for the Python programming language.
This makes it easy to either install the tracker locally, or to add it as a dependency into your own Python app.
pip
To install the Snowplow Python Tracker locally, assuming you already have Pip installed:
$ pip install snowplow-tracker --upgrade
**New in v0.9.0 : To install the Snowplow Tracker with extras:
# Redis extra
$ pip install snowplow-tracker[redis]
# Celery extra
$ pip install snowplow-tracker[celery]
To add the Snowplow Tracker as a dependency to your own Python app, edit your requirements.txt and add:
snowplow-tracker==0.14.0
easy_install
If you are still using easy_install:
$ easy_install -U snowplow-tracker
Python version support
Please refer to the table below to identify the recommended tracker version for your Python version.
| Python Version | snowplow-tracker Version |
|---|---|
| >=3.5 | 0.14.0 |
| 2.7 | 0.9.1 |