Skip to content

Slopmeter v0.1.0

Choose a tag to compare

View all tags
@fdsprod fdsprod released this 18 Sep 22:18
· 169 commits to main since this release
v0.1.0
a61c528

First release of Slopmeter, a Python source-review tool for people and coding agents.
The command is slop; the package is slop-measure.

Included

  • Python directory scans, file rankings, directory trees, and callable explanations.
  • Twenty pattern rules, normalized clone detection, and gradual excess-complexity measurement.
  • Directory and Git revision comparisons, including the working tree, without executing target code.
  • Early language filtering with --lang py / --langs, plus Git ignore handling that skips ignored folders.
  • Calibrated file and project scores using py-2026.2. Erosion contributions reflect both reference percentile and raw severity.
  • Interpretation guidance on every successful report, with a full structured guide in JSON and expanded terminal guidance under --verbose.
  • Findings output that retains coverage, diagnostics, and excluded-directory context.
  • Automatic ASCII fallback for output streams that cannot encode display characters.

Install

Requires Python 3.12 or later. Python 3.12, 3.13, and 3.14 are tested.
In an activated virtual environment, install the release wheel directly:

python -m pip install https://github.com/fdsprod/slopmeter/releases/download/v0.1.0/slop_measure-0.1.0-py3-none-any.whl
slop score /path/to/project --lang py --top 10

For agents, use slop score /path/to/project --lang py --json.
For more detail in a terminal, add --verbose.
The source distribution is also attached. SHA256SUMS.txt contains checksums for both packages.

See the README for Windows PowerShell setup, configuration, and all commands.

Interpretation and limits

Only Python analysis is currently implemented. Scores identify review candidates;
they are not defect probabilities or proof of authorship. Flat predicates can
overstate refactoring need, while subtle algorithms can understate it. The
initial tuning uses nine local examples and a six-project historical reference
corpus; evaluation on other repositories remains useful.

The default py-2026.2 profile uses M4 version 2. Its scores are not directly
comparable with the historical py-2026.1 profile. Historical resources remain available.

Validation

  • 1,178 deterministic tests and 42 retained learning tests passed locally.
  • All four release archive and isolated wheel/source installation checks passed against the attached packages.
  • Local branch coverage: 96.81 percent.
  • Release commit CI passed static checks and all nine Windows, macOS, and Linux jobs on Python 3.12, 3.13, and 3.14.

Release source: a61c528afe7aa79dcfb3554d30124822bb15d7b3. Existing Git history is preserved.

Assets 5
Loading