aptabase 0.0.1

Python SDK for Aptabase analytics

Aptabase Python SDK

Python SDK for Aptabase - privacy-first analytics for mobile, desktop and web applications.

Features

• 🚀 Fully async - Built with httpx and asyncio
• 🔒 Privacy-first - No personal data collection
• 🏃 Modern Python - Requires Python 3.11+
• 📦 Type-safe - Full typing support
• 🔄 Auto-batching - Efficient event batching and flushing
• ⚡ Lightweight - Minimal dependencies

Installation

uv add aptabase
# or
pip install aptabase

Quick Start

import asyncio
from aptabase import Aptabase

async def main():
    async with Aptabase("A-EU-1234567890") as client:
        # Track a simple event
        await client.track("app_started")

        # Track an event with properties
        await client.track("user_action", {
            "action": "button_click",
            "button_id": "login",
            "screen": "home"
        })

        # Events are automatically flushed, but you can force it
        await client.flush()

asyncio.run(main())

Configuration

client = Aptabase(
    app_key="A-EU-1234567890",          # Your Aptabase app key
    app_version="1.2.3",                # Your app version
    is_debug=False,                     # Enable debug mode
    max_batch_size=25,                  # Max events per batch (max 25)
    flush_interval=10.0,                # Auto-flush interval in seconds
    timeout=30.0                        # HTTP timeout in seconds
)

App Key Format

Your app key determines the server region:

• A-EU-* - European servers
• A-US-* - US servers

Get your app key from the Aptabase dashboard.

Event Tracking

Simple Events

await client.track("page_view")

Events with Properties

await client.track("purchase", {
    "product_id": "abc123",
    "price": 29.99,
    "currency": "USD"
})

Session Management

# Set a custom session ID
client.set_session_id("my-custom-session-id")

# Track events with specific session
await client.track("login", session_id="user-session-123")

Context Manager vs Manual Lifecycle

Recommended: Context Manager

async with Aptabase("A-EU-1234567890") as client:
    await client.track("event")
    # Automatically handles start/stop and flushing

Manual Lifecycle

client = Aptabase("A-EU-1234567890")
await client.start()
try:
    await client.track("event")
finally:
    await client.stop()  # Ensures all events are flushed

Error Handling

from aptabase import Aptabase, AptabaseError, NetworkError

try:
    async with Aptabase("A-EU-1234567890") as client:
        await client.track("event")
except NetworkError as e:
    print(f"Network error: {e}, status: {e.status_code}")
except AptabaseError as e:
    print(f"Aptabase error: {e}")

Development

Install development dependencies:

uv sync --dev

Run tests:

uv run pytest

Code formatting:

uv run black .
uv run ruff check .

Type checking:

uv run mypy .

License

MIT License - see LICENSE file for details.