Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

sprawl-guard

sprawl-guard checks that source files stay short and directories stay small. It records existing violations in a ratchet file so they can shrink but not grow.

Every language bundled with Tokei is enabled by default. Sprawl Guard counts the lines in each file and the source files directly inside each directory.

Install

Add the CLI to a uv project. pip install sprawl-guard and uvx sprawl-guard work too:

uv add --dev sprawl-guard

Quick start

From the repository root:

uv run sprawl-guard init --write
uv run sprawl-guard check

init --write creates sprawl-guard.toml. Run init without --write to preview it first. A passing check prints:

Configuration: sprawl-guard.toml

No sprawl-guard violations found.
Checked 2 source files in 2 directories across 2 languages.

If an existing repository exceeds the limits you want, keep the limits and record the current violations in the ratchet file.

Documentation

Metadata

Release files for sprawl-guard 0.6.0b3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for sprawl-guard 0.6.0b3
File Actions
sprawl_guard-0.6.0b3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for sprawl_guard-0.6.0b3-py3-none-win_amd64.whl
sprawl_guard-0.6.0b3-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for sprawl_guard-0.6.0b3-py3-none-musllinux_1_2_x86_64.whl
sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_x86_64.whl Python 3 none Linux glibc 2.35+ x86-64 Details for sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_x86_64.whl
sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_aarch64.whl Python 3 none Linux glibc 2.35+ ARM64 Details for sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_aarch64.whl
sprawl_guard-0.6.0b3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for sprawl_guard-0.6.0b3-py3-none-macosx_11_0_arm64.whl
sprawl_guard-0.6.0b3-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for sprawl_guard-0.6.0b3-py3-none-macosx_10_12_x86_64.whl

Total release size: 15.3 MB

Release files / sprawl_guard-0.6.0b3-py3-none-win_amd64.whl

Download URL sprawl_guard-0.6.0b3-py3-none-win_amd64.whl
Size 3.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
f18c27a6375124e926fd37c95691cf7dcfdf1d5ff897ddf828fbb7cdae87be01
BLAKE2b-256 checksum
How to use checksums
9e851ff4d97db2b0a9941de62e8eade01f5723841f3f82da200b50a31d8f87d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / sprawl_guard-0.6.0b3-py3-none-musllinux_1_2_x86_64.whl

Download URL sprawl_guard-0.6.0b3-py3-none-musllinux_1_2_x86_64.whl
Size 2.7 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
1014e717e82419033a1e80b58fcf7b6302cef451269044739c0c152783e97da2
BLAKE2b-256 checksum
How to use checksums
3f6b8d4b6c5852d56191bf333dfa80b806a9dd4b6a996343fdb5e39814eeb8fe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_x86_64.whl

Download URL sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_x86_64.whl
Size 2.6 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
c46a68ec6dc0f2b4207b20aabea9735a4faa00fbc2a077b1818ce8fbb361778b
BLAKE2b-256 checksum
How to use checksums
e0f7736ca756026ae6cab60f7c6d17349c3f3773ff77fc53711ba7637bb8ea8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_aarch64.whl

Download URL sprawl_guard-0.6.0b3-py3-none-manylinux_2_35_aarch64.whl
Size 2.3 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c6bbb2c5b2491927da0a6f569c54ded2fa267485946a764efceba31587debab4
BLAKE2b-256 checksum
How to use checksums
ae1cbca2fef573b53782f3800bacccac42a6aacc37d74dd89d7169ca81099fdc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / sprawl_guard-0.6.0b3-py3-none-macosx_11_0_arm64.whl

Download URL sprawl_guard-0.6.0b3-py3-none-macosx_11_0_arm64.whl
Size 2.2 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
af2384815412edf4aea6aff5ecd82667d92b2946d259f85f36490aaf7a385e09
BLAKE2b-256 checksum
How to use checksums
89b95408ca0b0c9d2f1300ee280b333916a3305a80ae5e41fdf1a7eef8e83c57
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / sprawl_guard-0.6.0b3-py3-none-macosx_10_12_x86_64.whl

Download URL sprawl_guard-0.6.0b3-py3-none-macosx_10_12_x86_64.whl
Size 2.5 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
3d23f4d547f3d15fb534bcc921eff8250470d8b87004e41a05c9eb24c03ee4fd
BLAKE2b-256 checksum
How to use checksums
e28dfd40ef5bcfbec9c087e80d8b9a666db083780702a41f134f811a861086e6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for sprawl-guard 0.6.0b3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for sprawl_guard-0.6.0b3-py3-none-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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