iRuneCore Python 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 -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

Plan	Lifetime	Price
`base`	10 minutes	Free
`plus`	30 minutes	Free
`pro`	1 hour	Free

API methods

Method	Description
`info()`	Server name, limits, plans, capacity
`capacity()`	Used / total / available bytes
`plans()`	List expiry plans
`upload(path, plan=…)`	Upload a file
`get(id)`	File metadata
`download(id, dest)`	Save bytes to disk
`delete(id)`	Delete early

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}