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.0b2

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

Total release size: 15.2 MB

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

Download URL sprawl_guard-0.6.0b2-py3-none-win_amd64.whl
Size 3.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
4901e35a4bcbaf9138585f8961ad23bd0c323704480824331042947908dc9be3
BLAKE2b-256 checksum
How to use checksums
0012f042b5ee06abcad2b1f65c0cede06a61c210730870030073b811d6ee11cd
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.0b2-py3-none-musllinux_1_2_x86_64.whl

Download URL sprawl_guard-0.6.0b2-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
5561146667a20b3207c8f646831ee273d05fb2e33fe425f2df3f3a4b31aeb2af
BLAKE2b-256 checksum
How to use checksums
ed48fea10a260e2d54d2eec281827dd364062a5571b1ac639a89abb6daea7a7a
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.0b2-py3-none-manylinux_2_35_x86_64.whl

Download URL sprawl_guard-0.6.0b2-py3-none-manylinux_2_35_x86_64.whl
Size 2.5 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
c4c21d7f8c40a10013b80de13df01e573bbeabea473f99381ec48f2d6ea840c4
BLAKE2b-256 checksum
How to use checksums
244be0b5e6cd15ec4603067af91349afc79fcb77baf503118768f298367b94d9
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.0b2-py3-none-manylinux_2_35_aarch64.whl

Download URL sprawl_guard-0.6.0b2-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
18c85350c893b9cfec5a6b7ba59dd5830d1c39bc508588acdf8d176bfdbd269d
BLAKE2b-256 checksum
How to use checksums
890a5ad3a72d3d214587de5001fbc909ca912434b8c475c5882475dd0b718ced
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.0b2-py3-none-macosx_11_0_arm64.whl

Download URL sprawl_guard-0.6.0b2-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
18cf8c9a9105029375bbd459c2d9304ecb938c5b862f1bd9eae9cba8b46c0209
BLAKE2b-256 checksum
How to use checksums
2642d14d164ce3efb13b8d2271d9833c80c79f99a3f07c8b91a6c5726d289b57
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.0b2-py3-none-macosx_10_12_x86_64.whl

Download URL sprawl_guard-0.6.0b2-py3-none-macosx_10_12_x86_64.whl
Size 2.4 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
ae9e47840cdf2b8cc5eb9023ac2c41faf745cf2241a5f3510412261572e9a818
BLAKE2b-256 checksum
How to use checksums
61a71f545ff12d5d9fa8bb9986b82d214ac35f7a1755e1448cac77a9cb38ecb8
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.0b2

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.0b2-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