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

Total release size: 15.3 MB

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

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

Download URL sprawl_guard-0.6.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
c404ca205675abc818dc672d32cec908f1a250e26cecad62cc8f7ac2a23c4048
BLAKE2b-256 checksum
How to use checksums
5cfa50fb544cbb2521f61b3ed006bb15e70a658de5c5925a098650e33e3f1375
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.0-py3-none-manylinux_2_35_x86_64.whl

Download URL sprawl_guard-0.6.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
a11a561b2ed168fe5ce2119f588383696cf13ff52ad573cac3ad5f84d5bf917d
BLAKE2b-256 checksum
How to use checksums
3419cf3d47dc8d952485ae4333e1356323111c1ed17f3f8ced095197fb6af4a2
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.0-py3-none-manylinux_2_35_aarch64.whl

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

Download URL sprawl_guard-0.6.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
2dad514fbd3f2447ac304208a46a33c657bd80631b41ae081762d7967e910482
BLAKE2b-256 checksum
How to use checksums
24bcbf3d8f9208162038e4a4c245a3f10f0247caca8e3b3ad07980b4e91a6e14
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.0-py3-none-macosx_10_12_x86_64.whl

Download URL sprawl_guard-0.6.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
1d50163804f15d9f2127e98b537890afddbf35491c93ca4a866af13945f8e82d
BLAKE2b-256 checksum
How to use checksums
5024bd400c66a57e371237ba7fd11fdfd43dfb7c4633ca8817a06cc0e8dadce6
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.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.6.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 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