caddysnake CLI

PyPI

The caddysnake package is available on PyPI and provides a CLI to serve Python WSGI/ASGI applications powered by Caddy.

Install

pip install caddysnake

Available for Python 3.12 through 3.14 on Linux and macOS (x86_64 and ARM64).

Usage

# Start a WSGI server
caddysnake --server-type wsgi --app main:app

# Start an ASGI server
caddysnake --server-type asgi --app main:app

CLI Options

Flag Short Description Default
--server-type -t Required. Type of Python app: wsgi or asgi —
--app -a Required. Python module and app variable (e.g. main:app) —
--domain -d Domain name for HTTPS with automatic certificates —
--listen -l Custom listen address :9080
--workers -w Number of worker processes (0 = CPU count) 0
--static-path Path to a static files directory —
--static-route Route prefix for static files /static
--debug Enable debug logging false
--access-logs Enable access logs false

How it works

This package is built with maturin and distributed as platform-specific wheel files. Each wheel bundles a pre-compiled Caddy binary with the caddy-snake plugin (caddysnake-cli). The Python CLI wrapper (caddysnake_cli.py) uses click to parse arguments and then executes the bundled Caddy binary with os.execv.

The package is built and published automatically on tagged releases by the python-build.yml GitHub Actions workflow.

Full Documentation

See https://caddy-snake.readthedocs.io for complete documentation, including:

Project links

Data verified by PyPI on Jul 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.6.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mliezun from gravatar.com mliezun

Credits

Author: Miguel Liezun

GitHub Statistics

Data verified by PyPI on Jul 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

caddysnake-0.5.11-cp314-cp314-manylinux_2_34_x86_64.whl (17.5 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ x86-64

caddysnake-0.5.11-cp314-cp314-manylinux_2_34_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ ARM64

caddysnake-0.5.11-cp314-cp314-macosx_11_0_arm64.whl (16.7 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

caddysnake-0.5.11-cp314-cp314-macosx_10_12_x86_64.whl (17.9 MB view details)

Uploaded CPython 3.14macOS 10.12+ x86-64

caddysnake-0.5.11-cp313-cp313-manylinux_2_34_x86_64.whl (17.5 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ x86-64

caddysnake-0.5.11-cp313-cp313-manylinux_2_34_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ ARM64

caddysnake-0.5.11-cp313-cp313-macosx_11_0_arm64.whl (16.7 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

caddysnake-0.5.11-cp313-cp313-macosx_10_12_x86_64.whl (17.9 MB view details)

Uploaded CPython 3.13macOS 10.12+ x86-64

caddysnake-0.5.11-cp312-cp312-manylinux_2_34_x86_64.whl (17.5 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ x86-64

caddysnake-0.5.11-cp312-cp312-manylinux_2_34_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ ARM64

caddysnake-0.5.11-cp312-cp312-macosx_11_0_arm64.whl (16.7 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

caddysnake-0.5.11-cp312-cp312-macosx_10_12_x86_64.whl (17.9 MB view details)

Uploaded CPython 3.12macOS 10.12+ x86-64

File details

Details for the file caddysnake-0.5.11-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 b34b9bac0d15ffc8dc162b6a6cbe0ea9784a1ee2e659b846b89d5988f16536d0
MD5 1b8b3a6a0561d5a0220c9e2326f46d3e
BLAKE2b-256 9505d3d77bb02d632f32066d3289fe3be6a94f6ed91a14b6c0f419f45ddf62ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp314-cp314-manylinux_2_34_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp314-cp314-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 86729cde0be73067a1b0527962bc5d951c3e6bff710cd47737ba6a2f57d7ff3a
MD5 4cd3c2ee00bd9a7815096d38dd51d46b
BLAKE2b-256 21c5d31c65c84d1ab803d6d5e3a7679976300cc16ba75ca625f4d090583d2128

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp314-cp314-manylinux_2_34_aarch64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e6e32b54cbda63ff835aed5c5b1cd0010054a152aa496750d4089fb9bac21007
MD5 1124645b75208e7eab16cbe6c6637e7b
BLAKE2b-256 f1c9d4440f10f221e29f0097be149412f25f10bcd49dd90aae8a6f1d0aecaca1

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp314-cp314-macosx_11_0_arm64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp314-cp314-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp314-cp314-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 aca7cd079d7127e03d9cf1cdd5bb566e235405ee81ec41ad799e739955189d12
MD5 9e34dc504b2789601038d398a3c160cf
BLAKE2b-256 f0a763d1d35b40155c3c9cc2e325c094df001b9f0f9fb5f9d7a76346bc406be6

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp314-cp314-macosx_10_12_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp313-cp313-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 e9e7ca3600e5ef5b7b13cb93e9f84b54e957bab79688b421ef70353053110839
MD5 01bd718859aea5e044b10a662eaef5bd
BLAKE2b-256 0990f1ea07414b83a3b0e64ce4287313972aeec284706ff8be9817c9c3172db2

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp313-cp313-manylinux_2_34_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp313-cp313-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 27a1b0c2286336ae320c6237ac76360756613ada863d349bcba27b3e87a168b7
MD5 d3a89ed0479d7fe7c80d75205b600f80
BLAKE2b-256 5acc67450f34251a21cad3520bb95a6b9a76028e13b07ef953896ed1d461d7db

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp313-cp313-manylinux_2_34_aarch64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8da2ab819ba0952717af496b30928269f6a9e1cee64fc019154c01757e3f6bf1
MD5 a9652a2dd1aaed5a79e88fc4de4736ad
BLAKE2b-256 f103af81e7c362153e0fa580d829972c0bb939a52adab65822a6a0b9eb356a3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp313-cp313-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp313-cp313-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 de4da1714879ee8fdc0a9d4e44901c90f9adc242f805bb764df506afb3d1786b
MD5 12264c8570f6b15422bfa8f64abeb4ed
BLAKE2b-256 aefc71612f9e86d5494bb8bde0d1af63ab0d5a1c6e19c05e670b23795ede6b4f

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp313-cp313-macosx_10_12_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 6929a0a36e842854b4ad24a3d9d329baaf5735459ae87fb80c8b5267ced797c9
MD5 ad3541ce8ab5868a45b2330ed9a6bdfb
BLAKE2b-256 759da6c4af9d98b34e6e7fd338a2ee7332a27fb9c0264e2e9eb73c9aed50c317

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp312-cp312-manylinux_2_34_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp312-cp312-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 7a34a29fce98b92063567d401980f7af3e17343635372facdbb149b31ddca22d
MD5 18546f027d8539e937d615e70e6d9a70
BLAKE2b-256 4e8ab3a9f4a4733f48b99dc9a9a8264a4bf252839408d93abbf8d45751a6954c

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp312-cp312-manylinux_2_34_aarch64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b5c0f63f58575a36050147e801062771253084772bc087a629ee18e665ee8c3b
MD5 91e2ce27e6490fdf9ad97fcba214d86e
BLAKE2b-256 bd9d613dd98ff6b3b90c9ad12ba4e5c6a1b3ffd9842847aaee4e3ffcf3ea9d79

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.5.11-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.11-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 6e0ca4e4bd6d47ef188135c526ea740603901bc4411a774693036fe8990dc9f1
MD5 06de5a46eb7dc90ce9901faccd48af37
BLAKE2b-256 0a936b029af25b350850bb61853ce0074cee3c4a841ff6d75618307682d98f9e

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.11-cp312-cp312-macosx_10_12_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.6.2

12 files

0.6.1

12 files

0.6.0

12 files

0.5.13

12 files

0.5.12

12 files

This release

0.5.11 This release

12 files

0.5.10

12 files

0.5.9

12 files

0.5.8

12 files

0.5.4

3 files

0.5.3

3 files

0.5.2

3 files

0.5.1

9 files

0.5.0

6 files

Pre-release

0.4.2a0

6 files

0.4.1

6 files

0.4.0

6 files

0.3.0

10 files

0.2.2

10 files

0.2.1

5 files

0.2.0

4 files

0.1.10

4 files

0.1.8

4 files

0.1.7

4 files

0.1.6

4 files

0.1.5

4 files

0.1.4

4 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page