nexium-storage

Official Python SDK for NEXIUM Storage — upload, serve and manage files via a simple API.

Install

pip install nexium-storage

# For file upload support:
pip install "nexium-storage[requests]"

Quick start

import os
from nexium_storage import NexiumStorage

storage = NexiumStorage(api_key=os.getenv("NEXIUM_API_KEY"))

# Upload
with open("photo.jpg", "rb") as f:
    file = storage.upload(bucket_id, f, "photo.jpg", "image/jpeg")
print(file.url)

# List
result = storage.list(bucket_id, search="photo")
for f in result.files:
    print(f.filename, f.size_bytes)

# Download URL
url = storage.download(file.id)

# Rename
storage.rename(file.id, "new-name.jpg")

# Delete
storage.delete(file.id)

Webhook verification

from nexium_storage import NexiumStorage, NexiumError

# Flask example
@app.route("/webhook", methods=["POST"])
def webhook():
    try:
        payload = NexiumStorage.verify_webhook(
            request.get_data(),
            request.headers.get("X-Nexium-Signature"),
            os.getenv("NEXIUM_WEBHOOK_SECRET"),
        )
        print(payload["event"], payload["data"])
        return "", 200
    except NexiumError:
        return "", 401

License

MIT