Setup

caution

You are reading documentation for an outdated version. Here’s the latest one!

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:

1. Minimize external dependencies and third party libraries
2. 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.15.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	1.0.3
2.7	0.9.1