https://github.com/razeghi71/burf
TUI for google cloud storage (GCS)
https://github.com/razeghi71/burf
Last synced: 5 months ago
JSON representation
TUI for google cloud storage (GCS)
- Host: GitHub
- URL: https://github.com/razeghi71/burf
- Owner: razeghi71
- Created: 2023-07-17T23:31:14.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-03T19:13:04.000Z (almost 3 years ago)
- Last Synced: 2026-01-04T06:55:12.123Z (5 months ago)
- Language: Python
- Homepage:
- Size: 66.4 KB
- Stars: 18
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - burf - TUI for Google Cloud Storage (GCS). (<a name="file-handling"></a>File and file system handling)
- awesome-cli-apps - burf - TUI for Google Cloud Storage (GCS). (<a name="file-handling"></a>File and file system handling)
- awesome-tuis - burf
README
# 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 git@github.com: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 git@github.com:razeghi71/burf.git
cd burf
pip install .
## Usage
Run via uv from source:
uv run burf --help
CLI:
usage: burf [-h] [gcs_uri]
positional arguments:
gcs_uri gcs uri to browse: gs:////
options:
-h, --help show this help message and exit
### Authentication
This app relies on Google Application Default Credentials (ADC). A common setup is:
gcloud auth application-default login
To choose which GCP project is used for listing buckets, configure it outside the app, e.g.:
gcloud config set project YOUR_PROJECT_ID
export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
## License
burf is released under the [MIT License](LICENSE).