caddyserver 2.11.7__py3-none-win_arm64.whl

.data/scripts/caddy.exe

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: .data/scripts/caddy.exe
+size: 48903168 bytes
+sha256: 79c43d6e18b5762a3ccfefc60d8ad3bbcbe6438d175fa18a5d6aa560e36f7044

caddyserver/__init__.py

@@ -0,0 +1,9 @@
+"""caddyserver: official Caddy binaries distributed as Python wheels.
+
+The package version mirrors the bundled Caddy version.
+"""
+
+__version__ = "2.11.7"
+CADDY_VERSION = __version__
+
+from caddyserver.cli import get_caddy_executable, main  # noqa: E402,F401

caddyserver/cli.py

@@ -0,0 +1,63 @@
+"""Console entry point: locate the bundled Caddy binary and exec it.
+
+The binary ships inside the wheel under ``.data/scripts/`` and is installed
+by pip into the same directory as the interpreter's executable
+(venv/pipx ``bin/`` on POSIX, the Scripts-less venv root on Windows).
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import sysconfig
+from pathlib import Path
+
+_BIN = "caddy.exe" if os.name == "nt" else "caddy"
+
+
+class CaddyNotFound(Exception):
+    pass
+
+
+def get_caddy_executable() -> Path:
+    """Return the path to the bundled Caddy binary."""
+    candidates = []
+
+    # Primary: pip installs .data/scripts/ into the scheme scripts dir,
+    # which is exactly where the `caddy`/`caddyserver` console scripts live.
+    # (Do NOT resolve sys.executable: venvs symlink the interpreter to the
+    # base install, which would point at the wrong bin/.)
+    candidates.append(Path(sysconfig.get_path("scripts")) / _BIN)
+    candidates.append(Path(sys.executable).parent / _BIN)
+
+    # Fallbacks: relative to this package (uninstalled tree, exotic layouts).
+    # `pkg` is the caddyserver package dir; `pkg.parent` is site-packages.
+    pkg = Path(__file__).resolve().parent
+    sp = pkg.parent
+    candidates += [
+        sp / _BIN,
+        pkg / _BIN,
+        # uv (uvx / `uv tool install`) leaves the .data tree under
+        # site-packages instead of moving it to the scheme scripts dir.
+        sp / ".data" / "scripts" / _BIN,
+        sp / "data" / "scripts" / _BIN,
+        pkg.parent.parent / "bin" / _BIN,
+    ]
+
+    for c in candidates:
+        c = c.resolve() if c.exists() else c
+        if c.is_file():
+            return c
+
+    raise CaddyNotFound(
+        "Bundled Caddy binary not found. Looked for:\n  "
+        + "\n  ".join(str(c) for c in candidates)
+        + "\nWas this package installed from a platform wheel, not the source tree?"
+    )
+
+
+def main(argv: list[str] | None = None) -> int:
+    exe = get_caddy_executable()
+    args = sys.argv[1:] if argv is None else argv
+    os.execvp(str(exe), [str(exe), *args])
+    # Unreachable on success; execvp raises on failure.

caddyserver-2.11.7.dist-info/METADATA

@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: caddyserver
+Version: 2.11.7
+Summary: Caddy web server as platform-specific Python wheels - pip/pipx/uvx installable, offline, no first-run download
+Author: Sushant Gautam
+License: MIT
+Requires-Python: >=3.9
+Project-URL: Homepage, https://github.com/SushantGautam/caddyserve-wheel
+Project-URL: Repository, https://github.com/SushantGautam/caddyserve-wheel
+Project-URL: Issues, https://github.com/SushantGautam/caddyserve-wheel/issues
+Keywords: caddy,webserver,binary,distribution,http3,https
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Server
+Description-Content-Type: text/markdown
+
+# caddyserver
+
+The [Caddy](https://caddyserver.com/) web server as a Python wheel — install with
+`pip`/`uvx`, no mise, no Docker, no Homebrew, no first-run download.
+**Works offline after install.** `pip`/`uv` picks the right binary for your OS
+and architecture automatically (Windows, macOS, Linux; x86-64 and ARM64).
+
+> [!IMPORTANT]
+> **Community-maintained, not the Caddy project.** Official project:
+> https://caddyserver.com / https://github.com/caddyserver/caddy. The binaries
+> here are the official Caddy builds, repackaged as wheels.
+> **Handover:** happy to **hand over the `caddyserver` PyPI project to the
+> official Caddy team** if they want to maintain it — open an issue.
+
+## Quick run (no install)
+
+```console
+uvx caddyserver version
+uvx caddyserver file-server --listen :8080
+```
+
+`uvx caddyserver ...` runs Caddy directly — anything after `caddyserver` is
+passed straight to the Caddy CLI.
+
+## Install
+
+```console
+pip install caddyserver       # or: uv tool install caddyserver / pipx install caddyserver
+caddy version
+```
+
+## CLI usage
+
+The wheel puts the real `caddy` binary on your PATH, so the full official CLI
+works as-is:
+
+```console
+caddy version                        # show version
+caddy file-server --listen :8080     # serve the current directory
+caddy run --config Caddyfile         # start with your Caddyfile
+caddy validate --config Caddyfile    # check config syntax
+caddy adapt --config Caddyfile       # Caddyfile -> JSON
+caddy list modules                   # list compiled-in modules
+```
+
+Any `caddy` subcommand works — this is the unmodified official binary.
+A `caddyserver` console script does the same thing (Python launcher), useful
+when `bin/` is not on PATH: `uvx caddyserver version`.
+
+### Programmatic use
+
+```python
+from caddyserver import get_caddy_executable
+exe = get_caddy_executable()  # Path to the bundled caddy binary
+```
+
+The package **version mirrors the Caddy version**
+(e.g. `caddyserver==2.11.7` bundles Caddy v2.11.7).
+
+## Maintenance
+
+Committed to tracking the **latest Caddy release** — a bump is one line plus a
+tag, and the pipeline builds, verifies, and publishes automatically.
+**If I am slow to pick up a new Caddy release, [open an issue](https://github.com/SushantGautam/caddyserve-wheel/issues) —
+I will push a new version promptly.** PRs bumping `build/version.txt` welcome.
+
+## Verification
+
+Every GitHub Release lists the **wheel SHA-256** and the **upstream Caddy
+asset digest** for each file; the build fails hard if any downloaded asset
+doesn't match the [official checksums](https://github.com/caddyserver/caddy/releases).
+
+## Version bump (maintainers)
+
+```bash
+echo "2.12.0" > build/version.txt
+# also update pyproject.toml version + src/caddyserver/__init__.py __version__
+git commit -am "bump to 2.12.0"
+git tag v2.12.0 && git push --tags   # CI builds, verifies, publishes
+```
+

caddyserver-2.11.7.dist-info/RECORD

@@ -0,0 +1,7 @@
+.data/scripts/caddy.exe,ecQ9bhi1dio8z-_GDYrTu8vmQ40XX6GKXWqlYONvcEQ,48903168
+caddyserver-2.11.7.dist-info/METADATA,mjV9zsRFb4UrT1idTQyk2h-d0TiwpRycbhxsme5AfrU,3837
+caddyserver-2.11.7.dist-info/WHEEL,t56ug0Bd_2KR5AcVoqmhytWFeniCM_SbaaVZ3XbiRME,105
+caddyserver-2.11.7.dist-info/entry_points.txt,sKkS3zNsRtNNZkuohttW-ybaG7Tmstuh0aWa_wLgKv4,53
+caddyserver/__init__.py,_8dqN1ZYoC_AxxLBcP30jkmhKNGPHlVY1SSWomdV1Cs,257
+caddyserver/cli.py,L1QbAFz6lyEoq1LJqvdEJt0eElzjBH0qH19RsGvPGcU,2114
+caddyserver-2.11.7.dist-info/RECORD,,

caddyserver-2.11.7.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: caddyserver build/wheels.py
+Root-Is-Purelib: false
+Tag: py3-none-win_arm64

caddyserver-2.11.7.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+caddyserver = caddyserver.cli:main