elaunira-r2index 0.1.0

Python library for uploading files to R2 and registering them with the r2index API

elaunira-r2index

Python library for uploading files to Cloudflare R2 and registering them with the r2index API.

Installation

pip install elaunira-r2index

Usage

Sync Client

from elaunira.r2index import R2IndexClient, R2Config

client = R2IndexClient(
    api_url="https://r2index.example.com",
    api_token="your-bearer-token",
    r2_config=R2Config(
        access_key_id="your-r2-access-key-id",
        secret_access_key="your-r2-secret-access-key",
        endpoint_url="https://your-account-id.r2.cloudflarestorage.com",
        bucket="your-bucket-name",
    ),
)

# Upload and register a file
record = client.upload_and_register(
    file_path="./myfile.zip",
    category="software",
    entity="myapp",
    remote_path="/releases",
    remote_filename="myapp-1.0.0.zip",
    remote_version="1.0.0",
    tags=["release", "stable"],
)

Async Client

from elaunira.r2index import AsyncR2IndexClient, R2Config

async with AsyncR2IndexClient(
    api_url="https://r2index.example.com",
    api_token="your-bearer-token",
    r2_config=R2Config(
        access_key_id="your-r2-access-key-id",
        secret_access_key="your-r2-secret-access-key",
        endpoint_url="https://your-account-id.r2.cloudflarestorage.com",
        bucket="your-bucket-name",
    ),
) as client:
    record = await client.upload_and_register(
        file_path="./myfile.zip",
        category="software",
        entity="myapp",
        remote_path="/releases",
        remote_filename="myapp-1.0.0.zip",
        remote_version="1.0.0",
        tags=["release", "stable"],
    )

License

MIT