Metadata-Version: 2.4
Name: trqsh
Version: 0.1.1
Summary: Expose localhost to the internet — fast QUIC tunnels with a desktop app. Installs the trqsh CLI binary for your platform.
Project-URL: Homepage, https://trqsh.uz
Project-URL: Documentation, https://trqsh.uz/docs
Project-URL: Source, https://github.com/trqsh/trqsh
Project-URL: Issues, https://github.com/trqsh/trqsh/issues
Author-email: trqsh <ops@trqsh.uz>
License-Expression: Apache-2.0
Keywords: http3,localhost,ngrok-alternative,quic,trqsh,tunnel,webhook
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: Proxy Servers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# trqsh (PyPI)

Install the [trqsh](https://trqsh.uz) CLI with pip. This package fetches the
signed, prebuilt binary for your platform from the GitHub release on first run.

```bash
pip install trqsh
# or, isolated:
pipx install trqsh

trqsh http 3000        # expose localhost:3000 over a public HTTPS URL
```

## How it works

The console script `trqsh` calls `trqsh.ensure_binary()`, which detects your OS
(`darwin`/`linux`/`windows`) and CPU (`amd64`/`arm64`), downloads
`trqsh_<version>_<os>_<arch>.<ext>` from
`https://github.com/trqsh/trqsh/releases`, verifies its SHA-256 against
`checksums.txt`, caches the binary under `~/.cache/trqsh/<version>/`, and execs
it. Pure standard library — no runtime dependencies.

## Environment overrides

| Variable | Purpose |
|---|---|
| `TRQSH_VERSION` | Pin a specific release (defaults to the package version). |
| `TRQSH_REPO` | Alternate `owner/repo` for the release download. |
| `TRQSH_DOWNLOAD_BASE` | Full base URL of a mirror serving the release assets (for air-gapped/internal mirrors). |
| `TRQSH_SKIP_CHECKSUM=1` | Skip SHA-256 verification (not recommended). |

Licensed Apache-2.0.
