s3_browser 0.5.0

An interactive tool to browse s3 like a regular directory structure

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 (put or get)
• 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

Running tests

This project uses make for ease of use. You can install the project in development mode, and install the test requirements, using the install target:

make install

It's recommended to create and activate a virtual environment first. There are a number of ways to do that; I like virtualenvwrapper.

Use make to run the full build.

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

Create a source distribution with setup.py and upload it to pypi with twine:

make dist && make dist/release