fileshare-sdk

Python client for iRuneCore — anonymous ephemeral file sharing.

• Default API: https://irunecore.com
• Plans: base (10 min, free) · plus (30 min, free) · pro (1 hr, free)
• Max file size: 50 MB (server-enforced)

Install

pip install fileshare-sdk
# or from a checkout:
pip install -e ./sdk

Quick start

from fileshare_sdk import FileShareClient

with FileShareClient() as client:  # https://irunecore.com
    info = client.info()
    print(info.name, info.max_file_size_bytes)
    for plan in info.plans:
        print(plan.name, plan.label, plan.price_display)

    shared = client.upload("notes.txt", plan="base")
    print(shared.share_url)
    print(shared.expires_at)

    client.download(shared.id, "notes-copy.txt")
    client.delete(shared.id)

Custom server

FileShareClient("http://localhost:8010")

Progress callback

def on_progress(loaded: int, total: int) -> None:
    print(f"{loaded}/{total}")

with FileShareClient() as client:
    client.upload("video.mp4", plan="pro", on_progress=on_progress)

Plans

API methods

Network failures raise FileShareTransportError; non-2xx API responses raise FileShareAPIError with status_code and detail attributes.

REST mapping

GET  /api/v1/info
GET  /api/v1/capacity
POST /api/v1/files                    multipart: file, plan
GET  /api/v1/files/{id}
GET  /api/v1/files/{id}/download
DELETE /api/v1/files/{id}