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

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

Total release size: 14.7 MB

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

Download URL sprawl_guard-0.6.0b1-py3-none-win_amd64.whl
Size 2.9 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
4fd0070970155fa3d75aa4ac23154f2ac75ff736c91083323e62da7569f2b176
BLAKE2b-256 checksum
How to use checksums
a359289120841ec964b5b8f143af67141cf1ca0e7a4cbaa0f99c4201935d01c2
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.0b1-py3-none-musllinux_1_2_x86_64.whl

Download URL sprawl_guard-0.6.0b1-py3-none-musllinux_1_2_x86_64.whl
Size 2.6 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
066d4beab00a205135cbe9e60d435d84f5aa86723021b168c7947e3dccc5bf8c
BLAKE2b-256 checksum
How to use checksums
ffa6d551ba7718c3d03ac9d4aa9e0d6cbad3d610ecf7d48c2fd3345b85216d5c
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.0b1-py3-none-manylinux_2_35_x86_64.whl

Download URL sprawl_guard-0.6.0b1-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
f9e4bb984c2e79f955715d3ba416cb9050aa22cd68f7a8833999ad527d99fa15
BLAKE2b-256 checksum
How to use checksums
60d81087f01a20fcfcfaafaaccf38f07bfd69f85d2c8b482906bf65ae33b334a
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.0b1-py3-none-manylinux_2_35_aarch64.whl

Download URL sprawl_guard-0.6.0b1-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
b12abfb4821ea2cc66d4a86af9476a1801d7e62923f83931b63a94bf91fe946f
BLAKE2b-256 checksum
How to use checksums
f9ceb9a02c6d603dfdec92cfe5b15499bc04a704316e83633e1efa9bbc8fe4f7
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.0b1-py3-none-macosx_11_0_arm64.whl

Download URL sprawl_guard-0.6.0b1-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
45cca9e26a8815110e550e737b40eafa15d8670f39f3dd526c493f8a21564684
BLAKE2b-256 checksum
How to use checksums
b5097fd12b5c6e0fd0a101e44e32a40934fe69c205c5f8c4abb6b0893b2a643e
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.0b1-py3-none-macosx_10_12_x86_64.whl

Download URL sprawl_guard-0.6.0b1-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
ee760383b272372a691b32cdbfd6bc460528e6b0a79f6432f1dfde48338d822a
BLAKE2b-256 checksum
How to use checksums
f83af58af4ee53d22605d70c83c9da6fcce4f506e92a62aa260b00c33d725d42
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.0b1

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