pymycorr 0.2.0

Python client for fetching table data from the MyCorr API via Apache Arrow

pymycorr

Python client for fetching table data from the MyCorr API using Apache Arrow for efficient data transfer.

Note: The production API is coming soon. Set MYCORR_API_URL to your endpoint if you have early access.

Installation

pip install pymycorr

Configuration

Set your API token and (optionally) the API URL as environment variables:

export MYCORR_API_TOKEN="your-api-token"

Or create a .env file in your project root:

MYCORR_API_TOKEN=your-api-token

The client automatically loads from environment variables and .env files.

Quick Start

from pymycorr import MyCorr

# Initialize client (loads token from MYCORR_API_TOKEN env var or .env file)
client = MyCorr()

# Fetch as pandas DataFrame
df = client.get_table("table-id")

# Fetch a specific version
df = client.get_table("table-id", version=2)

# Fetch using version alias
df = client.get_table("table-id", version="stable")

# Get table metadata without fetching data
info = client.get_table_info("table-id")
print(info["schema"])

Progress Display

Progress is shown automatically in interactive environments (terminals and notebooks). You can control this behavior:

# Always show progress
client = MyCorr(progress=True)

# Never show progress
client = MyCorr(progress=False)

# Override per-request
df = client.get_table("table-id", progress=False)

API Reference

MyCorr

__init__(url=None, token=None, env_file=None, progress="auto")

Initialize the client.

• url: API base URL (optional). Falls back to MYCORR_API_URL env var, then default.
• token: Authentication token (Bearer token from MyCorr UI). Falls back to MYCORR_API_TOKEN env var or .env file.
• env_file: Path to custom .env file (optional).
• progress: Show download progress. True always shows, False never shows, "auto" (default) shows in interactive environments.

get_table(table_id, version=None, engine="pandas", progress=None)

Fetch table data as a DataFrame.

• table_id: Unique identifier for the table.
• version: Version number (int) or alias (str like "latest", "stable").
• engine: "pandas" (default) or "polars".
• progress: Override client's progress setting for this request.
• Returns: pandas or polars DataFrame.

get_table_info(table_id, version=None)

Get table schema and metadata.

• table_id: Unique identifier for the table.
• version: Version number (int) or alias (str).
• Returns: Dictionary with table metadata including schema.

Exceptions

• TableAPIError: Base exception for API errors.
• TableNotFoundError: Table not found (404).
• QuotaExceededError: Egress quota exceeded (429).
• TableConversionError: Failed to convert Arrow data to DataFrame.
• StreamingError: Error during data streaming or IPC parsing.

Development

See .env.example for environment variable configuration. For local development:

1. Copy .env.example to .env
2. Set MYCORR_API_URL to your local/dev base URL (no path segments)
3. SSL verification is automatically disabled for localhost and 127.0.0.1 URLs

License

MIT License - see LICENSE for details.