Metadata-Version: 2.4
Name: forkfetch
Version: 0.1.0
Summary: Smart GitHub repository discovery CLI
Author: davinci
License-Expression: MIT
Project-URL: Homepage, https://github.com/Damascus-dev/forkfetch
Project-URL: Repository, https://github.com/Damascus-dev/forkfetch
Project-URL: Issues, https://github.com/Damascus-dev/forkfetch/issues
Keywords: cli,github,search,repositories,developer-tools
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: rich<14.0.0,>=13.7.0
Requires-Dist: typer<1.0.0,>=0.12.0
Provides-Extra: dev
Requires-Dist: build>=1.2.1; extra == "dev"
Requires-Dist: twine>=5.1.1; extra == "dev"
Dynamic: license-file

# Fetcher

Minimal GitHub repository search CLI.

## Install

### PyPI

After the package is published, users on Windows, macOS, and Linux will be able to install it from any folder with:

```bash
pip install forkfetch
```

That installs the `ffetch` command globally for the current Python environment, so it can be run from any drive or working directory.

### Windows

Install from the project folder:

```bat
install_ffetch.cmd
```

That script runs a user install and checks whether the Python Scripts directory is on `PATH`.
After a successful install, `ffetch` can be run from any drive or folder.

If you prefer the manual command:

```bat
py -m pip install --user .
```

If `ffetch` is still not recognized after install, reopen the terminal. If that still fails, add the Python user Scripts directory shown by `install_ffetch.cmd` to your Windows `PATH`.

### macOS / Linux

```bash
python3 -m pip install --user .
```

If `ffetch` is not found afterward, make sure your user script directory is on `PATH`. A common fix is:

```bash
python3 -m site --user-base
```

Then add the corresponding `bin` directory to your shell profile.

## Use

```bash
ffetch
ffetch search "jwt auth node"
ffetch top
ffetch refresh
ffetch clone owner/repo
ffetch config
python -m fetcher --help
```

## Token

Config file:

`~/.fetcher/config.json`

```json
{
  "github_token": "YOUR_TOKEN"
}
```

## Publish

Build distributions locally:

```bash
python3 -m pip install -U build
python3 -m build
```

Upload manually:

```bash
python3 -m pip install -U twine
python3 -m twine upload dist/*
```

GitHub Actions can also publish automatically on tagged releases once PyPI trusted publishing is configured.
