S3 Browser
A small, interactive tool to browse s3 like a regular directory structure
Written in python.
Features
- Autocompletion and command history, powered by prompt toolkit
- Familiar interface for unix users (
cd,ls,file,pwd, etc.) - Bookmarking (
bookmark add,bookmark ls...) - Inspect key metadata (
file) or contents (cat) - Download or upload individual keys to/from local files (
putorget) - Lazy-loading and caching of paths (no scanning entire buckets on start up)
Installation
pip install s3_browser
And then run with s3-browser.
Example usage
Development
You'll need uv and ruff to work with this project.
Running tests
This project uses make for ease of use. You can run tests by simply running:
make test
Use make to run the full build, including tests with pytest and formatting and
linting with ruff.
Testing against minio
You can test against minio by running make bootstrap to start
a minio container and create a test bucket. You can then connect to it with:
export AWS_ACCESS_KEY_ID=minio
export AWS_SECRET_ACCESS_KEY=minio123
uv run s3-browser --endpoint http://localhost:19000
Releasing
Bump the version in pyproject.toml and push the corresponding tag, then release via github.
This will run the publish workflow.
1 maintainer
Metadata
1 maintainer
Release files for s3_browser 0.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| s3_browser-0.5.2.tar.gz | 19.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| s3_browser-0.5.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 39.6 kB
Release files / s3_browser-0.5.2.tar.gz
| Download URL | s3_browser-0.5.2.tar.gz |
|---|---|
| Size | 19.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f037b1bef5ff3e458a87ffec0d1687bfccc7f5754fea5bd26396e7a969f52893
|
|
BLAKE2b-256 checksum How to use checksums |
d4468c1e2c55cfb07cd4720c5f1ae063867b8d1b24ef833c165f0eb95f0cbd55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.6.14
|
Release files / s3_browser-0.5.2-py3-none-any.whl
| Download URL | s3_browser-0.5.2-py3-none-any.whl |
|---|---|
| Size | 20.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6b967991c0ed801cfc3a63fa1f0abd989c0869de78d6de627d9fe826415689ad
|
|
BLAKE2b-256 checksum How to use checksums |
43e50ac6ee1e5724f1b27bc0020d0fd2f0063b58eae9fc0a5aa415c339d8b157
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.6.14
|
