Skip to main content

theblob

An S3-compatible object store written in Python. It starts as one command on one machine, and is designed to grow into a redundant cluster.

This is an experiment. Phase 1 (one server, one disk) is under construction.

Quick start

uv sync
uv run theblob serve --data-dir ./data

The first start creates an access key and prints it once. Use it with any S3 client:

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="http://127.0.0.1:9000",
    aws_access_key_id="...",
    aws_secret_access_key="...",
    region_name="us-east-1",
)
s3.create_bucket(Bucket="my-bucket")
s3.put_object(Bucket="my-bucket", Key="hello.txt", Body=b"hello")

Other commands: theblob key create|list|delete and theblob fsck. Run theblob serve --help for the server options, including TLS and virtual-hosted addressing.

Development

make test      # the whole test pyramid
make lint      # ruff, ty, pyrefly, mypy

Tests are in tests/: a_unit for pure logic, b_integration for real SQLite and files, c_e2e for real S3 clients (boto3, AWS CLI, rclone, s5cmd) against a real server over HTTP and HTTPS. The rclone and s5cmd tests are skipped if those tools are not installed.

Metadata

Release files for theblob 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for theblob 0.1.0
File Size Uploaded Provenance Actions
theblob-0.1.0.tar.gz 36.7 kB Without provenance Details for theblob-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for theblob 0.1.0
File Interpreter ABI Platform Actions
theblob-0.1.0-py3-none-any.whl Python 3 none any Details for theblob-0.1.0-py3-none-any.whl

Total release size: 81.5 kB

Release files / theblob-0.1.0.tar.gz

Download URL theblob-0.1.0.tar.gz
Size 36.7 kB
Tags Source
SHA-256 checksum
How to use checksums
b060b1766fc661afa3d6c29135fea8a7fc32924cfca091cbbf30253c6ce01531
BLAKE2b-256 checksum
How to use checksums
25b9b766d69868217f6c02a460650f59750339363efac56508d81cc44515fadb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / theblob-0.1.0-py3-none-any.whl

Download URL theblob-0.1.0-py3-none-any.whl
Size 44.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c6d634185ab052a18879b01940490e9567d0f1fca07d39dd82d21b790052efcb
BLAKE2b-256 checksum
How to use checksums
550de5f49c25b427c85644a7ec596b3ccb77434f923f5e1ef8b216d9aac73f44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for theblob 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page