trqsh 0.1.1__py3-none-any.whl

trqsh/__init__.py

@@ -0,0 +1,8 @@
+"""trqsh — expose localhost to the internet.
+
+This PyPI package is a thin wrapper that fetches the prebuilt ``trqsh`` CLI
+binary for your platform (from the GitHub release) and execs it. The real
+program is the Go binary; see https://trqsh.uz.
+"""
+
+__version__ = "0.1.1"

trqsh/__main__.py

@@ -0,0 +1,22 @@
+"""Console entry point: exec the real trqsh binary with the caller's arguments."""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+
+from ._runtime import ensure_binary
+
+
+def main() -> None:
+    binary = str(ensure_binary())
+    args = [binary, *sys.argv[1:]]
+    if os.name == "nt":
+        # os.execv on Windows doesn't preserve the console cleanly; use subprocess.
+        sys.exit(subprocess.run(args).returncode)
+    os.execv(binary, args)
+
+
+if __name__ == "__main__":
+    main()

trqsh/_runtime.py

@@ -0,0 +1,132 @@
+"""Locate (or download) the prebuilt trqsh binary for the current platform.
+
+The archive names mirror the goreleaser template
+``trqsh_<version>_<os>_<arch>.<ext>`` (.zip on Windows, .tar.gz elsewhere),
+downloaded from the GitHub release and verified against ``checksums.txt``. Only
+the Python standard library is used.
+"""
+
+from __future__ import annotations
+
+import hashlib
+import os
+import platform
+import stat
+import sys
+import tarfile
+import tempfile
+import urllib.request
+import zipfile
+from pathlib import Path
+
+from . import __version__
+
+REPO = os.environ.get("TRQSH_REPO", "trqsh-uz/downloads")
+VERSION = os.environ.get("TRQSH_VERSION", __version__)
+
+
+def _target() -> tuple[str, str, str]:
+    goos = {"darwin": "darwin", "linux": "linux", "windows": "windows"}.get(
+        platform.system().lower()
+    )
+    goarch = {
+        "x86_64": "amd64",
+        "amd64": "amd64",
+        "arm64": "arm64",
+        "aarch64": "arm64",
+    }.get(platform.machine().lower())
+    if not goos or not goarch:
+        raise SystemExit(
+            f"trqsh: unsupported platform {platform.system()}/{platform.machine()}. "
+            f"Download manually from https://github.com/{REPO}/releases"
+        )
+    ext = "zip" if goos == "windows" else "tar.gz"
+    return goos, goarch, ext
+
+
+def _bin_name() -> str:
+    return "trqsh.exe" if platform.system() == "Windows" else "trqsh"
+
+
+def _cache_dir() -> Path:
+    base = os.environ.get("XDG_CACHE_HOME") or (Path.home() / ".cache")
+    d = Path(base) / "trqsh" / VERSION
+    d.mkdir(parents=True, exist_ok=True)
+    return d
+
+
+def bin_path() -> Path:
+    return _cache_dir() / _bin_name()
+
+
+def _download(url: str) -> bytes:
+    req = urllib.request.Request(url, headers={"User-Agent": "trqsh-pypi-installer"})
+    with urllib.request.urlopen(req) as resp:  # noqa: S310 (trusted GitHub host)
+        return resp.read()
+
+
+def _verify(data: bytes, archive: str, base: str) -> None:
+    if os.environ.get("TRQSH_SKIP_CHECKSUM") == "1":
+        return
+    try:
+        sums = _download(f"{base}/checksums.txt").decode()
+    except Exception as exc:  # noqa: BLE001
+        print(f"trqsh: warning — could not fetch checksums.txt ({exc}); skipping verify", file=sys.stderr)
+        return
+    want = None
+    for line in sums.splitlines():
+        parts = line.split()
+        if len(parts) == 2 and parts[1].lstrip("*") == archive:
+            want = parts[0].lower()
+            break
+    if not want:
+        print(f"trqsh: warning — {archive} absent from checksums.txt; skipping verify", file=sys.stderr)
+        return
+    got = hashlib.sha256(data).hexdigest()
+    if got != want:
+        raise SystemExit(f"trqsh: checksum mismatch for {archive}\n  expected {want}\n  got      {got}")
+
+
+def _extract(archive_path: Path, ext: str, dest: Path) -> None:
+    if ext == "zip":
+        with zipfile.ZipFile(archive_path) as zf:
+            zf.extractall(dest)
+    else:
+        with tarfile.open(archive_path) as tf:
+            try:
+                tf.extractall(dest, filter="data")  # py3.12+ safe extraction
+            except TypeError:
+                tf.extractall(dest)
+
+
+def ensure_binary() -> Path:
+    """Return the path to the trqsh binary, downloading it once if needed."""
+    target = bin_path()
+    if target.exists():
+        return target
+
+    goos, goarch, ext = _target()
+    archive = f"trqsh_{VERSION}_{goos}_{goarch}.{ext}"
+    # Overridable (TRQSH_DOWNLOAD_BASE) for mirrors, air-gapped installs, or tests.
+    base = os.environ.get("TRQSH_DOWNLOAD_BASE") or f"https://github.com/{REPO}/releases/download/v{VERSION}"
+
+    print(f"trqsh: downloading {archive} (v{VERSION})...", file=sys.stderr)
+    data = _download(f"{base}/{archive}")
+    _verify(data, archive, base)
+
+    tmp = Path(tempfile.mkdtemp())
+    archive_path = tmp / archive
+    archive_path.write_bytes(data)
+    _extract(archive_path, ext, _cache_dir())
+
+    if not target.exists():
+        for found in _cache_dir().rglob(target.name):
+            found.replace(target)
+            break
+    if not target.exists():
+        raise SystemExit("trqsh: binary not found after extraction")
+
+    if os.name != "nt":
+        target.chmod(target.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+    print("trqsh: installed ✓", file=sys.stderr)
+    return target

trqsh-0.1.1.dist-info/METADATA

@@ -0,0 +1,55 @@
+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.

trqsh-0.1.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+trqsh/__init__.py,sha256=0ndFNaVarZZrW22AVBXDa3YG7Tx1Aj16U54ya_iuifk,273
+trqsh/__main__.py,sha256=6NLkSrBSCZ29-5CwE1E3MDhPaoAYtSO9NxPkC838gMA,512
+trqsh/_runtime.py,sha256=XOhMlJfW5BLgFgfq1U4WLZl4cgVN-GSCvwFmle4-wFo,4304
+trqsh-0.1.1.dist-info/METADATA,sha256=TgvQ7mM3zwCI_-Qze__ZwTRcKCXGs0xPQRy6epv_I-o,2135
+trqsh-0.1.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+trqsh-0.1.1.dist-info/entry_points.txt,sha256=8Qs_xqNviQgcpJt29tpQYRJqM18qyw3nqSOd0IyeW4I,46
+trqsh-0.1.1.dist-info/RECORD,,

trqsh-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

trqsh-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+trqsh = trqsh.__main__:main