Skip to content

giftig/s3-browser

Repository files navigation

S3 Browser

Latest tag Build status MIT License

A small, interactive tool to browse s3 like a regular directory structure

Written in python.

Features

  • Tab completion
  • 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)
  • Maintains command history
  • 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

Usage example

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.