Skip to main content

slopcheck

Slop Score Python 3.11+

Fast CLI linter that detects AI-generated code slop and calculates a Slop Score (deep AST analysis for Python + polyglot scanner for JS/TS, Rust, C/C++, C#, Go, Java).

Install

pip install sloplinter

Or run ephemerally with uvx:

uvx sloplinter .

Usage

Run a scan against the current repository or a specific directory:

slopcheck .

Enforce quality gates in CI (exit code 1 if score exceeds threshold):

slopcheck . --max-score 20

Generate a Markdown badge for your repository README.md:

slopcheck . --badge

Score thresholds:

  • 0-10%: CLEAN
  • 11-35%: SUSPICIOUS
  • 36-65%: VIBE-CODED
  • 66-100%: PURE SLOP

Rules

Rule Weight Languages What it catches
silent-except 15 Python Catch handler containing only pass, ..., or lone print
silent-catch 15 JS/TS, C++, C#, Java Empty or suppressed catch blocks
ai-cliche 12 All supported Markers like TODO: implement, placeholder, in a real-world, for brevity
emoji-slop 10 All supported Decorative emojis in comments and log/print statements
deep-nesting 10 Python Control structure nesting depth >= 4 (ignoring elif)
debug-print 8 All supported Print calls with debug prefixes (debug, here, test, asdf, etc.)
wildcard-import 8 Python from ... import * imports
bloat-docstring 8 Python Docstrings larger than the actual function body
useless-wrapper 7 Python Thin wrappers forwarding exact arguments without modification
captain-comment 6 All supported Standalone comment echoing identifiers on the line directly below
redundant-boolean 6 Python Comparisons with True/False or if/else returning boolean literals

License

MIT

Metadata

Release files for sloplinter 0.1.0

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

Source distribution (sdist)

Source distribution for sloplinter 0.1.0
File Size Uploaded Provenance Actions
sloplinter-0.1.0.tar.gz 13.5 kB Without provenance Details for sloplinter-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sloplinter 0.1.0
File Interpreter ABI Platform Actions
sloplinter-0.1.0-py3-none-any.whl Python 3 none any Details for sloplinter-0.1.0-py3-none-any.whl

Total release size: 25.2 kB

Release files / sloplinter-0.1.0.tar.gz

Download URL sloplinter-0.1.0.tar.gz
Size 13.5 kB
Tags Source
SHA-256 checksum
How to use checksums
015e49a44a8f720faf12ebb5da54531ef083b91b056794cc58cdf60d60dbf084
BLAKE2b-256 checksum
How to use checksums
421b9d76ebadf7d28514e10b262dc83d1d259182cab405fc440f951093c9be3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / sloplinter-0.1.0-py3-none-any.whl

Download URL sloplinter-0.1.0-py3-none-any.whl
Size 11.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f1f1ee12d06453d35468e293aa8ec4a437fe272faab87d5d73db4c2ee541046d
BLAKE2b-256 checksum
How to use checksums
9bc3eac13d2415fbf6d930b2fb33bc4c8e5c92fdcd5e02e1795d8ae0aa3cb74c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Security for sloplinter 0.1.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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