Skip to main content

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.7.0

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.7.0
File Actions
sprawl_guard-0.7.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for sprawl_guard-0.7.0-py3-none-win_amd64.whl
sprawl_guard-0.7.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for sprawl_guard-0.7.0-py3-none-musllinux_1_2_x86_64.whl
sprawl_guard-0.7.0-py3-none-manylinux_2_35_x86_64.whl Python 3 none Linux glibc 2.35+ x86-64 Details for sprawl_guard-0.7.0-py3-none-manylinux_2_35_x86_64.whl
sprawl_guard-0.7.0-py3-none-manylinux_2_35_aarch64.whl Python 3 none Linux glibc 2.35+ ARM64 Details for sprawl_guard-0.7.0-py3-none-manylinux_2_35_aarch64.whl
sprawl_guard-0.7.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for sprawl_guard-0.7.0-py3-none-macosx_11_0_arm64.whl
sprawl_guard-0.7.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for sprawl_guard-0.7.0-py3-none-macosx_10_12_x86_64.whl

Total release size: 15.4 MB

Release files / sprawl_guard-0.7.0-py3-none-win_amd64.whl

Download URL sprawl_guard-0.7.0-py3-none-win_amd64.whl
Size 3.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
b961f74f8b94ce242f19f0986a4b7402cbdfb5975cd95bf23468e89122093362
BLAKE2b-256 checksum
How to use checksums
6e9b07266ea7fc1c983b7eca01aba934e6f11d82588903e275334b9fb664d611
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 20, 2026.

Transparency log

Release files / sprawl_guard-0.7.0-py3-none-musllinux_1_2_x86_64.whl

Download URL sprawl_guard-0.7.0-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
360c139250d3489f2d110b817b4794ad58d14a5463878891123242677c403464
BLAKE2b-256 checksum
How to use checksums
3f95633f12cabbe985c8a4d49ad01b4f8d28f2fcdf4f1e60656f8aa300899014
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 20, 2026.

Transparency log

Release files / sprawl_guard-0.7.0-py3-none-manylinux_2_35_x86_64.whl

Download URL sprawl_guard-0.7.0-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
8498bc26e848b7ace2d2dacde6d464670d3628d274d1ee1ec6f5b4fc6bf0f3d6
BLAKE2b-256 checksum
How to use checksums
936065b8aafd0b7fb9bb200d82759442b0de3257cb279542850aa19debba8047
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 20, 2026.

Transparency log

Release files / sprawl_guard-0.7.0-py3-none-manylinux_2_35_aarch64.whl

Download URL sprawl_guard-0.7.0-py3-none-manylinux_2_35_aarch64.whl
Size 2.4 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
ca50933e8921043b1d836a142c0148280b5ca7c62ad49dde84858704f68995ca
BLAKE2b-256 checksum
How to use checksums
ab962966ec5b1a0f80ae1907dbe438c0436e006c9251b3822135eaa503c7fb3d
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 20, 2026.

Transparency log

Release files / sprawl_guard-0.7.0-py3-none-macosx_11_0_arm64.whl

Download URL sprawl_guard-0.7.0-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
5ff55554de7d0ab33033810a47ab297b1a43ad92b3ef3f847f4069bd0315fa23
BLAKE2b-256 checksum
How to use checksums
08ad5ea9ccc138c9e46e682be9ffdb60fe6562b755bb53910bd314abf2465e89
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 20, 2026.

Transparency log

Release files / sprawl_guard-0.7.0-py3-none-macosx_10_12_x86_64.whl

Download URL sprawl_guard-0.7.0-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
2cb18c9dc6b57606567589d105e7f57590cc8b4aecf5c3ea47e47ec572900bd4
BLAKE2b-256 checksum
How to use checksums
98e7fdb9e124078cc3b0dba08a41a9edd310673368e55140ab36a08d3dea3a91
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 20, 2026.

Transparency log

Security for sprawl-guard 0.7.0

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.7.0-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 20, 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