tusk-drift-python-sdk 0.1.8

Python SDK for Tusk Drift instrumentation and replay

The Python Tusk Drift SDK enables fast and deterministic API testing by capturing and replaying API calls made to/from your service. Automatically record real-world API calls, then replay them as tests using the Tusk CLI to find regressions. During replay, all outbound requests are intercepted with recorded data to ensure consistent behavior without side-effects.

Try it on a demo repo →

Documentation

For comprehensive guides and API reference, visit our full documentation.

SDK Guides

• Initialization Guide - Set up the SDK in your Python application
• Environment Variables - Environment variables reference
• Quick Start Guide - Record and replay your first trace

Requirements

• Python 3.12+

Tusk Drift currently supports the following packages and versions:

• Flask: flask>=2.0.0
• FastAPI: fastapi>=0.68.0
• Django: django>=3.2.0
• Requests: requests (all versions)
• HTTPX: httpx (all versions)
• psycopg: psycopg>=3.0.0, psycopg2>=2.8.0
• Redis: redis (all versions)

If you're using packages or versions not listed above, please create an issue with the package + version you'd like an instrumentation for.

Installation

Step 1: Install the CLI

First, install and configure the Tusk Drift CLI by following our CLI installation guide. The CLI helps set up your Tusk configuration file and replays tests.

The wizard will eventually direct you back here when it's time to set up the SDK.

Step 2: Install the SDK

After completing the CLI wizard, install the SDK:

pip install tusk-drift-python-sdk

With Framework Support

# With Flask support
pip install tusk-drift-python-sdk[flask]

# With FastAPI support
pip install tusk-drift-python-sdk[fastapi]

# With Django support
pip install tusk-drift-python-sdk[django]

Step 3: Initialize the SDK for your service

Refer to our initialization guide to set up the SDK for your service.

Step 4: Run Your First Test

Follow along our quick start guide to record and replay your first test!

Troubleshooting

Having issues?

• Check our initialization guide for common setup issues
• Create an issue or reach us at [e-mail].

Community

Join our open source community on Slack.

Contributing

We appreciate feedback and contributions. See CONTRIBUTING.md.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.