eruspy 0.1.6

File and directory transfer over HTTP — Rust speed, Python convenience

eruspy-python

Python bindings for eruspy — file and directory transfer over HTTP, built with PyO3 and maturin.

Installation

pip install eruspy

Quick Start

Client

import eruspy

c = eruspy.EruspyClient("http://localhost:3000/transfer")

# Upload / download a file
c.upload("./file.txt", "file.txt")
c.download("file.txt", "./received.txt")

# Upload / download a directory
c.upload_dir("./my_folder", "my_folder")
c.download_dir("my_folder", "./restored")

# List a directory ("" = storage root)
entries = c.list("")
for e in entries:
    kind = "DIR" if e.is_dir else "FILE"
    print(f"[{kind}] {e.name}  ({e.size} bytes)")

Server

run_server spawns a background Rust thread and returns immediately. The server keeps the process alive until it exits.

import eruspy, time

eruspy.run_server("./storage", True, "0.0.0.0:3000")
#                  root dir    ^     ^
#                  allow_list ─┘     └─ bind address

print("Server running. Press Ctrl+C to stop.")
try:
    while True:
        time.sleep(1)
except KeyboardInterrupt:
    pass

API Reference

EruspyClient(base_url)

Method	Description
upload(local, remote)	Upload a file. Parent dir must exist on server.
download(remote, local)	Download a file.
upload_dir(local, remote)	Upload a directory (zipped). Parent dir must exist on server.
download_dir(remote, local)	Download a directory (unzipped locally).
list(remote_path)	List a directory. Returns list[FileEntry].

FileEntry

Attribute	Type	Description
name	str	File or directory name
is_dir	bool	True if directory
size	int	Size in bytes (0 for directories)

run_server(storage, allow_list, host)

Starts the server in a background Rust thread. Returns immediately.

Parameter	Type	Description
storage	str	Root directory for stored files (auto-created)
allow_list	bool	Allow clients to call the /list endpoint
host	str	Bind address, e.g. "0.0.0.0:3000"

Building from Source

cd eruspy-python
python3 -m venv .venv
source .venv/bin/activate
pip install maturin
maturin develop          # dev install into current venv
maturin build --release  # produce a .whl for distribution

License

MIT OR Apache-2.0