minimal-snowplow-tracker is a Python library that provides a minimal event tracker for Snowplow analytics. It is a fork of the original `snowplow-python-tracker` (v0.8.0), stripped down to include only basic emitters and support for structured and unstructured event tracking. Last released in 2018 as version 0.0.2, it is primarily maintained as an internal dependency for projects like dbt-core for anonymous usage tracking, rather than an actively developed standalone library.
pip install minimal-snowplow-trackerVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to initialize the tracker and send a structured event and an unstructured event. It uses the `snowplow_tracker` import path, which is the internal module name for `minimal-snowplow-tracker`. You will need a running Snowplow Collector (e.g., Snowplow Mini) at `COLLECTOR_URL` to receive events.
For comprehensive and up-to-date Snowplow tracking features, use the actively maintained `snowplow-tracker` library (pypi.org/project/snowplow-tracker/). If `minimal-snowplow-tracker` is a dependency, consider whether the older, limited functionality is sufficient or if an alternative tracking approach is needed.
Avoid installing `minimal-snowplow-tracker` alongside the official `snowplow-tracker` in the same Python environment. If `minimal-snowplow-tracker` is a transitive dependency (e.g., via `dbt-core`), be aware of this potential conflict and manage your environment carefully, perhaps using virtual environments.
Migrate to the official and actively maintained `snowplow-tracker` library for Python. If adherence to Python 3.7 or earlier is required, ensure rigorous testing for compatibility.
If you intend to use a Snowplow Python tracker, consult the official documentation and GitHub for the actively maintained `snowplow-tracker` library to ensure correct implementation and access to supported features.
Install the package using pip: `pip install minimal-snowplow-tracker`
Try installing with a legacy builder: `pip install --no-use-pep517 minimal-snowplow-tracker`. If using Poetry, an older version (<=1.4.2) that allows specifying a legacy installer might be necessary.
Ensure you are using Python 3.6 or newer. If the error persists, check for specific dependency conflicts within your environment or consider isolating `minimal-snowplow-tracker` in a dedicated virtual environment with compatible Python and dependency versions.
Avoid installing both `minimal-snowplow-tracker` and `snowplow-tracker` in the same Python environment. If `dbt-core` is a dependency, note that newer `dbt-core` versions are migrating to the official `snowplow-tracker`.