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 18, 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 18, 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.12-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.12-cp314-cp314-manylinux_2_34_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.14macOS 10.12+ x86-64

caddysnake-0.5.12-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.12-cp313-cp313-manylinux_2_34_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.13macOS 10.12+ x86-64

caddysnake-0.5.12-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.12-cp312-cp312-manylinux_2_34_aarch64.whl (15.9 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

caddysnake-0.5.12-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.12-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 eeafe9477b1b8ae0d907e585dd55b68b57c339a1574dea4e6a5734e82848fd2d
MD5 1e7c367ff10598c901e510a002e53102
BLAKE2b-256 5c13d0bfedce725ce28eeecba04d6f99ad9644cb1ba66ca6d3160643c7deeead

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp314-cp314-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 4bb787090b34bb2b9be24bab02f176b8a9a6b82ff8c355a61c3408dd75a07041
MD5 bc9c90a1626ac6d27cd2ba71f0a8e80f
BLAKE2b-256 a2171efe2b1303eb12c1c236b9e7b1302ac3ab43db891f92b88ff999b8878152

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2c4a74f6f8393b4662408922c7028279dd9eb71dd500971b3aa15610dd250000
MD5 4c64bc1dc09c2b13c8bdbfaf166e6fcb
BLAKE2b-256 38dc5db5ad52946dfa9c49bde1f9e4f8fed44472398454c65cdbd946861bf40a

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp314-cp314-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp314-cp314-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 043e328aa8965dba4fca334a5011819b7da70d3fcbd3a850cae3b8f4c028b9c5
MD5 8ccb450df5be43ea844a5ca3af1b3688
BLAKE2b-256 0611afce77d2304401240262b4f600be97ff4338e8a1f28cbdad179fd6ca53b7

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp313-cp313-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 d8e829772eb53bfe5c1e340359aad71140002bdf6299d4c6af88c68560eab632
MD5 4439eabe559f18e5743b93fc4146bc98
BLAKE2b-256 5df8d0418a9f301f708911fa37494b57ea279fe16be065ac6f3a6c342c7c91ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp313-cp313-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 c5b62cbd3dff31dee8d0e2f1192b735b71db3dd42656ada2281bb5e5440799c0
MD5 74fb8ea41ebd2f6333013524cf3c6d7f
BLAKE2b-256 f62627e7f6fe3070a59046b0e0071ebae2f309a75e0db0543fd4d4b4803924e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 447621a29062484384baed0fbe84b136b32ae337dc26935c0f8672f15c0addfb
MD5 473e39ebd4d4ac7d553b95dd1e36358c
BLAKE2b-256 cd09cec181d769bdac33cf1c0922226855cfd19414ca5f17732259f5c9c26e3c

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp313-cp313-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp313-cp313-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 116e6fa4520c882f29cd9697054e1f1578548561b8252a6ed4c7eac3d09e87bf
MD5 28737fde1ca302adaea33052614d0bc6
BLAKE2b-256 ec52fb3aa09480be9109adc57af4641da42bf9478b8b6513ba963131cf9ee1a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 24259e85492193104e4c2295d522e6198ba3baabae415fb660c396539de395db
MD5 f3e27cb43e14a43f613762a76563fa1d
BLAKE2b-256 55fba644b4c2921fba01f98f327e323b212d674f039b663d0093a7687db81ef4

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp312-cp312-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 928d9136370948c1d6001356801053d05e336a4fcabf4aeec3870f9c6fb35029
MD5 69c83b00d7f2ac3615e8dfb5ae32abf4
BLAKE2b-256 96051049aaacaa9c580af31575a71196654445abfb3d95b0ceea66612699ea44

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e9135e65c686157896752c647337e49569d4c50c59883e8feda7085ad6f95ecf
MD5 945a4f715649abe103dc91da8a4fb767
BLAKE2b-256 58f24ca459e3e88e4eb58211466768deadc9b95b4d03c8dc77d8e6a133633925

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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.12-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.12-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 39b0dd7a146da6b1ad064afb0b1634fe3b3b039fe93d41f516744328a98b58ce
MD5 1ca286a72ed35aa20270e44518ef35ff
BLAKE2b-256 94bac518113a66e1b1a7d5293041cb21f1437281f35ee3057c8bba2eb19d0c20

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.5.12-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

This release

0.5.12 This release

12 files

0.5.11

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