Python tracker setup - chuwy/snowplow-ci GitHub Wiki

HOME > SNOWPLOW SETUP GUIDE > Step 2: setup a Tracker > Python tracker

• 1. Overview
• 2. Integration options
  • 2.1 Tracker compatibility
  • 2.2 Dependencies
• 3. Setup
  • 3.1 PyPI
  • 3.2 pip
  • 3.3 easy_install

The Snowplow Python Tracker lets you add analytics to your Python python-based applications.

The tracker should be relatively straightforward to setup if you are familiar with Python development.

Ready? Let's get started.

Back to top

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] django 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

Back to top

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. There are only two external dependencies currently:

• PyContracts pycontracts - Python package that allows one to declare constraints on function parameters and return values.
• Requests requests - HTTP library

These dependencies can be installed from the package manager of the host system or through PyPi.

Back to top

The Snowplow Python Tracker is published to PyPI 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.

To install the Snowplow Python Tracker locally, assuming you already have Pip installed:

$ pip install snowplow-tracker --upgrade

To add the Snowplow Tracker as a dependency to your own Python app, edit your requirements.txt and add:

snowplow-tracker ~> 0.6.0.post1

If you are still using easy_install:

$ easy_install -U snowplow-tracker

Done? Now read the Python Tracker API to start tracking events.