Metadata-Version: 2.1
Name: pgcs
Version: 0.1.1
Summary: Pgcs is an intuitive TUI tool designed to simplify your interaction with Google Cloud Storage. Stay in your coding zone by navigating directories, searching files (with case-insensitive support), and previewing files all from your terminal. Easily save paths to clipboard or download files with straightforward keyboard shortcuts. Experience a seamless Cloud Storage interaction right from your terminal; no more swapping to a browser. Stimulate your productivity with Pgcs.
Home-page: https://github.com/Asugawara/pgcs
License: MIT
Keywords: GoogleCloudStorage,gcsfs
Author: Asugawara
Author-email: asgasw@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Dist: gcsfs (>=2023.12.2.post1,<2024.0.0)
Requires-Dist: prompt-toolkit (>=3.0.43,<4.0.0)
Requires-Dist: pydantic (>=2.5.3,<3.0.0)
Requires-Dist: pygments (>=2.17.2,<3.0.0)
Requires-Dist: pyperclip (>=1.8.2,<2.0.0)
Project-URL: Repository, https://github.com/Asugawara/pgcs
Description-Content-Type: text/markdown

![image](https://github.com/Asugawara/pgcs/actions/workflows/run_test.yml/badge.svg)
![PyPI](https://img.shields.io/pypi/v/pgcs?color=green)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pgcs)
![GitHub](https://img.shields.io/github/license/Asugawara/pgcs)


# Pgcs

**Pgcs** is an intuitive TUI tool designed to simplify your interaction with Google Cloud Storage. Stay in your coding zone by navigating directories, searching files (with case-insensitive support), and previewing files all from your terminal. Easily save paths to clipboard or download files with straightforward keyboard shortcuts. Experience a seamless Cloud Storage interaction right from your terminal; no more swapping to a browser.

# Features
- Navigate through directories with left and right arrows
- Peco-like search UI
- Case-insensitive search
- Preview of the file is available
- Press 'ctrl-p' to save the path to clipboard
- Press 'ctrl-d' to download


# Installation

```bash
$ pip install pgcs
```

# Usage
> [!IMPORTANT]
> Both `gcloud auth login` and `gcloud auth application-default login` are required.

command | description
-- | --
`pg` or `pg traverse` | navigate through Google Cloud Storage directories
`pg pref --init` | initialize or reset preferences file
`pg pref <key> <value>` | set preference with key to value

> [!Note]
> If you want to use clipboard functionality on Linux without a GUI, you need to execute the following. Below is an example.
```bash
$ sudo apt-get install xvfb
$ sudo apt-get install xclip
$ Xvfb :99 -screen 0 1280x720x16 &
$ export DISPLAY=:99
```

# Versioning
This repo uses [Semantic Versioning](https://semver.org/).

# License
**pgcs** is released under the MIT License. See [LICENSE](/LICENSE) for additional details.

