perforce-agentic-gateway 2026.1__py3-none-win_amd64.whl

pag/__main__.py

@@ -0,0 +1,47 @@
+"""Entry point for ``python -m pag`` and the ``pag`` console script.
+
+On Unix (``sys.platform != "win32"``), uses ``os.execvp`` to replace
+the Python process with the Go binary entirely — no Python process
+remains resident after the exec.
+
+On Windows, ``os.execvp`` is not available in a usable form; instead,
+``subprocess.run()`` launches the binary as a child process. The Python
+wrapper stays resident for the lifetime of PAG. ``KeyboardInterrupt``
+exits with code 2; the child's exit code is forwarded via
+``sys.exit``.
+
+Both platforms forward ``sys.argv[1:]`` and inherit stdin/stdout/stderr
+from the parent process.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+
+def main() -> None:
+    """Locate the ``pag`` binary and transfer control to it."""
+    from pag._find_pag import find_pag
+
+    binary = find_pag()
+
+    if sys.platform != "win32":
+        # Unix: exec replaces this process — no return.
+        os.execvp(binary, [binary, *sys.argv[1:]])  # noqa: S606
+    else:
+        # Windows: run as a child process and forward exit code.
+        import subprocess
+
+        try:
+            completed = subprocess.run(
+                [binary, *sys.argv[1:]],
+                check=False,
+            )
+        except KeyboardInterrupt:
+            sys.exit(2)
+        sys.exit(completed.returncode)
+
+
+if __name__ == "__main__":
+    main()

pag/_find_pag.py

@@ -0,0 +1,94 @@
+"""Locate the ``pag`` binary installed alongside this Python package.
+
+Search order (mirrors ruff's ``_find_ruff.py``):
+
+1. The current environment's scripts directory
+   (``sysconfig.get_path("scripts")``).
+2. The base prefix scripts directory (handles venvs that share a base
+   install).
+3. Paths relative to the package root — handles ``pip install --prefix``
+   and ``pip install --target`` layouts where the scripts directory is a
+   sibling of the package directory rather than the environment root.
+4. The user scheme scripts directory (``pip install --user``).
+
+Returns the absolute path to the binary as a string, or raises
+``FileNotFoundError`` with a helpful message if no candidate is found.
+"""
+
+from __future__ import annotations
+
+import os
+import sysconfig
+from pathlib import Path
+
+# Python 3.8 / 3.9 do not support ``sysconfig.get_path`` with the
+# ``vars`` parameter for the ``platbase`` variable in all schemes.
+# We guard the user-scheme lookup to avoid AttributeError on older
+# Pythons where the ``posix_user`` scheme key set differs.
+_HAVE_USER_SCHEME = hasattr(sysconfig, "get_default_scheme")
+
+_BINARY_NAME = "pag.exe" if os.name == "nt" else "pag"
+
+
+def _script_dir(scheme: str) -> Path | None:
+    """Return the scripts directory for *scheme*, or ``None`` on error."""
+    try:
+        path = sysconfig.get_path("scripts", scheme)
+    except (KeyError, TypeError):
+        return None
+    if path is None:
+        return None
+    return Path(path)
+
+
+def find_pag() -> str:
+    """Return the absolute path to the ``pag`` binary.
+
+    Raises ``FileNotFoundError`` if no candidate is executable.
+    """
+    candidates: list[Path] = []
+
+    # 1. Current environment scripts directory.
+    scripts = sysconfig.get_path("scripts")
+    if scripts:
+        candidates.append(Path(scripts) / _BINARY_NAME)
+
+    # 2. Base prefix scripts directory (relevant inside a venv whose
+    #    base installation has the binary).
+    base_scripts = _script_dir("posix_prefix" if os.name != "nt" else "nt")
+    if base_scripts:
+        candidates.append(base_scripts / _BINARY_NAME)
+
+    # 3. Relative to the package root — handles ``--prefix`` and
+    #    ``--target`` installs where scripts land next to the package.
+    #    This file lives at <pkg_root>/pag/_find_pag.py, so the package
+    #    root is two levels up.
+    pkg_root = Path(__file__).parent.parent.resolve()
+    # Typical --target layout: <target>/pag/_find_pag.py → binary at
+    # <target>/../bin/pag or <target>/../Scripts/pag.exe (Windows).
+    bin_subdir = "Scripts" if os.name == "nt" else "bin"
+    candidates.append(pkg_root.parent / bin_subdir / _BINARY_NAME)
+    # Also check a ``bin``/``Scripts`` sibling of the package root itself.
+    candidates.append(pkg_root / bin_subdir / _BINARY_NAME)
+
+    # 4. User scheme scripts directory (``pip install --user``).
+    if _HAVE_USER_SCHEME:
+        user_scheme = "nt_user" if os.name == "nt" else "posix_user"
+        user_scripts = _script_dir(user_scheme)
+        if user_scripts:
+            candidates.append(user_scripts / _BINARY_NAME)
+
+    for candidate in candidates:
+        if candidate.is_file():
+            return str(candidate)
+
+    searched = "\n  ".join(str(c) for c in candidates)
+    raise FileNotFoundError(
+        f"could not find the '{_BINARY_NAME}' binary.\n"
+        f"Searched:\n  {searched}\n\n"
+        "If you installed pag from a wheel, the binary should be in your\n"
+        "environment's scripts directory. Try re-installing with:\n"
+        "  pip install --force-reinstall pag\n"
+        "or:\n"
+        "  uv pip install --reinstall pag"
+    )

perforce_agentic_gateway-2026.1.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: perforce-agentic-gateway
+Version: 2026.1
+Summary: Perforce Agentic Gateway — MCP gateway for AI clients
+Requires-Python: >=3.8
+License-Expression: LicenseRef-Proprietary

perforce_agentic_gateway-2026.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+perforce_agentic_gateway-2026.1.data/scripts/pag.exe,sha256=UkrgStwmRmixMhRXcAZRfwR019L1SA90kv-DUixB1bM,44729344
+pag/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pag/__main__.py,sha256=hjKeEOsy75aAT-S6nTG0t2Wtlor_Vp1cusZdSTivbss,1368
+pag/_find_pag.py,sha256=NCijU9rvFw8N5HlruhPK22vXuacm3Gzd7OhVRzzBn3U,3621
+perforce_agentic_gateway-2026.1.dist-info/METADATA,sha256=uM0RLYFrNE7GRbKv9H_Tp_guGIPY0xBLLz4pCqVLKuU,200
+perforce_agentic_gateway-2026.1.dist-info/WHEEL,sha256=8J5De_l23DYBg1F8WpxUs9kfXkLKwOuMY7-443IsXZ0,94
+perforce_agentic_gateway-2026.1.dist-info/entry_points.txt,sha256=iHalm8e5w3hDikY8JGHkogqnhbZutr1JVlO1JWkZDGw,63
+perforce_agentic_gateway-2026.1.dist-info/RECORD,,

perforce_agentic_gateway-2026.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: pag-build-wheels
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64

perforce_agentic_gateway-2026.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+perforce-agentic-gateway = pag.__main__:main