burf 1.2.3

A tool to surf buckets on gcs

burf

burf is a terminal user interface (TUI) for surfing Google Cloud Storage (GCS) buckets.

Installation

With uv (recommended)

Install from PyPI:

uv tool install burf

Or run from source:

git clone [e-mail]:razeghi71/burf.git
cd burf
uv sync

With pip

You can install it directly from PyPi:

pip install burf

or using source code:

git clone [e-mail]:razeghi71/burf.git
cd burf
pip install .

Usage

Run via uv from source:

uv run burf --help

CLI:

usage: burf [-h] [-p PROJECT] [gcs_uri]

positional arguments:
    gcs_uri               gcs uri to browse: gs://<bucket>/<subdir1>/<subdir2>

options:
    -h, --help            show this help message and exit
    -p PROJECT, --project PROJECT
                            gcp project to use

Authentication

This app relies on Google Application Default Credentials (ADC). A common setup is:

gcloud auth application-default login

License

burf is released under the MIT License.