s3dol
s3 (through boto3) with a simple (dict-like or list-like) interface
To install: pip install s3dol
Heads-up: v1 is coming — run s3dol.diagnose() now
A major, behaviour-clarifying v1 is in progress
(design: misc/docs/architecture.md and the ADRs in
misc/docs/decisions/). Today's S3Store will keep
working through a compatibility shim, but a few v0 behaviours were bugs
(e.g. an explicit endpoint_url= being silently dropped whenever
AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY are exported) and v1 fixes them —
which can move where your data goes.
Before upgrading to v1, run the diagnosis with the same arguments you pass
S3Store today, in the environment you deploy in:
import s3dol
s3dol.diagnose(bucket_name="my-bucket", endpoint_url="...", path="...")
It prints what resolves (endpoint, region, signing, credential source — never a secret), where each value came from, and a v0-vs-v1 divergence table telling you whether the upgrade changes anything for your call. It never raises; a failing resolution is part of the report.
Set up credentials
Recommended prerequisite to make getting started easier but not required.
Option 1: Environment Variables
export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_DEFAULT_REGION=us-west-2
Option 2: Configure Default Profile in Credentials File
Add credentails in ~/.aws/credentials
[default]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Option 3: Configure Default Profile with AWS CLI
brew instal awscli
Set credentails with CLI
aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]:
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file s3dol-0.1.14.tar.gz.
File metadata
- Download URL: s3dol-0.1.14.tar.gz
- Upload date:
- Size: 133.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ecee4767148523a679736aa37b3e901a19ad4d3128d29e7c83b0fa372b7930e
|
|
| MD5 |
54d5b8d728cdac61f8663535025cdcf8
|
|
| BLAKE2b-256 |
a157643f2c68b97990fe6513c933b73f3b4b18d574d539f58963dce885482453
|
File details
Details for the file s3dol-0.1.14-py3-none-any.whl.
File metadata
- Download URL: s3dol-0.1.14-py3-none-any.whl
- Upload date:
- Size: 57.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
268c31716bee08281868c40e3d320fa274cd38280fdf1374d07d1df387b63892
|
|
| MD5 |
8973c2355cff71fe1bce0c792b166588
|
|
| BLAKE2b-256 |
aa487d2424b3288d41ff45789fd69e2be3aac4fdfb88e544120342e640fc469b
|
