ml-lints 0.12.1__tar.gz

ml_lints-0.12.1/.githooks/pre-commit

@@ -0,0 +1,9 @@
+#!/bin/sh
+# Git pre-commit hook — runs the full justfile precommit suite before each commit.
+#
+# This file is version-controlled in .githooks/. To activate it on a fresh clone:
+#
+#   git config core.hooksPath .githooks
+#
+# Or run: just setup-git-hooks
+just precommit

ml_lints-0.12.1/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+# The justfile is the single source of truth for all check commands.
+# This workflow calls justfile recipes directly — the same commands
+# that pre-commit hooks invoke locally. To add or change a check,
+# edit the justfile recipe and update the steps here to match.
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+
+      - name: Install just
+        uses: taiki-e/install-action@v2
+        with:
+          tool: just
+
+      - name: Install dependencies
+        run: uv sync
+
+      # Pre-commit logic is defined in the justfile `precommit` target — do not add steps here.
+      - name: Validate project
+        run: just precommit

ml_lints-0.12.1/.github/workflows/release-please.yml

@@ -0,0 +1,101 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      pr: ${{ steps.release.outputs.pr }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v5
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  ci:
+    runs-on: ubuntu-latest
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+
+      - name: Install just
+        uses: taiki-e/install-action@v2
+        with:
+          tool: just
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Validate project
+        run: just precommit
+
+  update-lockfile:
+    runs-on: ubuntu-latest
+    needs: release-please
+    if: ${{ needs.release-please.outputs.pr }}
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: release-please--branches--main
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+
+      - name: Update lock file
+        run: uv lock
+
+      - name: Commit updated lock file
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add uv.lock
+          git diff --staged --quiet || git commit -m "chore: update uv.lock for version bump"
+          git push
+
+  publish-release:
+    needs: [release-please, ci]
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish GitHub release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release edit "${{ needs.release-please.outputs.tag_name }}" --draft=false
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ml_lints-0.12.1/.gitignore

@@ -0,0 +1,13 @@
+.venv/
+__pycache__/
+*.pyc
+.ruff_cache/
+.pytest_cache/
+dist/
+*.egg-info/
+
+# Coverage
+.coverage
+htmlcov/
+coverage.xml
+*.lcov

ml_lints-0.12.1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.12.1"
+}

ml_lints-0.12.1/CHANGELOG.md

@@ -0,0 +1,272 @@
+# Changelog
+
+## [0.12.1](https://github.com/lawther/python-lint-hooks/compare/v0.12.0...v0.12.1) (2026-07-26)
+
+
+### Bug Fixes
+
+* **ci:** correct PyPI GitHub Action repository path ([a101777](https://github.com/lawther/python-lint-hooks/commit/a101777e8f51d7b698ad15936171fa36caab1281))
+
+## [0.12.0](https://github.com/lawther/python-lint-hooks/compare/v0.11.0...v0.12.0) (2026-07-26)
+
+
+### Features
+
+* rename project to ml-lints and module to ml_lints ([4e2e1aa](https://github.com/lawther/python-lint-hooks/commit/4e2e1aa89e5b2bfe244838ae43383412bbb0aa9c))
+* **rules:** add ML600 to ban [@patch](https://github.com/patch)(new=Mock(...)) decorators ([765b94d](https://github.com/lawther/python-lint-hooks/commit/765b94de03aff2d0530e640dfb902f018487e5e8))
+
+
+### Bug Fixes
+
+* **cli:** load pyproject.toml per target project root when linting external directories ([81f45f9](https://github.com/lawther/python-lint-hooks/commit/81f45f91fa87a206d45c9ebba8c936b3ecb5dab4)), closes [#32](https://github.com/lawther/python-lint-hooks/issues/32)
+* **cli:** resolve path objects in _collect_out_of_root_files consistently ([516e1dd](https://github.com/lawther/python-lint-hooks/commit/516e1dd631b7c5ea4f08397ce4ec5d46bd6db67d))
+* **cli:** stop --select/--ignore/--exclude from swallowing paths ([6f367e3](https://github.com/lawther/python-lint-hooks/commit/6f367e3c8dae80e63e2190ac58db8cd197f16f0a))
+* resolve project root and gitignore per target path ([cbb8c0d](https://github.com/lawther/python-lint-hooks/commit/cbb8c0d63ee5eb80199c55a29fe8b3a779848549)), closes [#30](https://github.com/lawther/python-lint-hooks/issues/30)
+
+
+### Documentation
+
+* add missing rule-category rows to CONTRIBUTING_RULES.md ([f4fc7ae](https://github.com/lawther/python-lint-hooks/commit/f4fc7ae89570ef4f810db82ac8307f6f907308a2))
+
+## [0.11.0](https://github.com/lawther/python-lint-hooks/compare/v0.10.1...v0.11.0) (2026-06-08)
+
+
+### Features
+
+* **rules:** add ML110 to detect variable-length tuple parameter annotations ([863896f](https://github.com/lawther/python-lint-hooks/commit/863896fd8a87a45033856412c96ce81cdcd16425))
+* **rules:** add ML202 to detect __dict__/vars() spread into constructors ([348ef41](https://github.com/lawther/python-lint-hooks/commit/348ef418039a73da70c28bc1e326de7eedf03a61))
+
+
+### Bug Fixes
+
+* make register decorator generic to preserve subclass types ([3032f66](https://github.com/lawther/python-lint-hooks/commit/3032f661524db2a08622b64d7968ea4c14c399cb))
+
+## [0.10.1](https://github.com/lawther/python-lint-hooks/compare/v0.10.0...v0.10.1) (2026-06-03)
+
+
+### Bug Fixes
+
+* remove American-to-British spelling mappings for practice variants ([804caf1](https://github.com/lawther/python-lint-hooks/commit/804caf10aa6b772ed3c87f6aa542c40563e28448))
+* remove incorrect spelling mapping for ankle ([483a58b](https://github.com/lawther/python-lint-hooks/commit/483a58b3bac71b9f862e25669a203311553ff648))
+
+## [0.10.0](https://github.com/lawther/python-lint-hooks/compare/v0.9.0...v0.10.0) (2026-06-03)
+
+
+### Features
+
+* **ml500:** exempt override methods from Australian English check ([eb4a7b3](https://github.com/lawther/python-lint-hooks/commit/eb4a7b39f69bad45f248bd70cedc96abb594dfa7))
+
+
+### Bug Fixes
+
+* **ml500:** resolve base-class chains longer than two levels ([5a67b40](https://github.com/lawther/python-lint-hooks/commit/5a67b40eac20115fc741df445829336e3ff42634))
+
+
+### Documentation
+
+* remove bad merge from README ([b8f1cb1](https://github.com/lawther/python-lint-hooks/commit/b8f1cb18b1857908a71e6a7d00ce0ebd5b7ef92d))
+* update ML500 rule documentation and test examples to exclude overridden methods ([57ed9e0](https://github.com/lawther/python-lint-hooks/commit/57ed9e026aa9ca28a332f4f9b344208a27af9a39))
+
+## [0.9.0](https://github.com/lawther/python-lint-hooks/compare/v0.8.0...v0.9.0) (2026-05-29)
+
+
+### Features
+
+* **rules:** add ML501 to detect hacky pluralisation in strings ([ace61d7](https://github.com/lawther/python-lint-hooks/commit/ace61d756c79274e6661d3b618ce9b2b07a97c48))
+
+
+### Documentation
+
+* **rules:** improve ML300 rationale to explain Python's scoping illusion ([4d85cea](https://github.com/lawther/python-lint-hooks/commit/4d85ceac35717a88f6ea43e7e3e7dfb364ebed45))
+
+## [0.8.0](https://github.com/lawther/python-lint-hooks/compare/v0.7.7...v0.8.0) (2026-05-15)
+
+
+### Features
+
+* **rules:** add ML108 and ML109 for redundant NewType casts ([ecfffd9](https://github.com/lawther/python-lint-hooks/commit/ecfffd9bd59091367d80113fc30564b454c74b01))
+* **rules:** catch redundant NewType casts on for-loop and comprehension targets ([6ac09b6](https://github.com/lawther/python-lint-hooks/commit/6ac09b69229f3431df207df17692c8f247333555))
+
+
+### Bug Fixes
+
+* **rules:** make ML108 and ML109 messages name a concrete fix ([6ab3aee](https://github.com/lawther/python-lint-hooks/commit/6ab3aee797a6d1465cc924017bcf69b4798e461b))
+
+## [0.7.7](https://github.com/lawther/python-lint-hooks/compare/v0.7.6...v0.7.7) (2026-05-15)
+
+
+### Bug Fixes
+
+* **rules:** exempt to_dict and as_dict from ML102 ([5eb8939](https://github.com/lawther/python-lint-hooks/commit/5eb8939543f41078c5c9d56e1c731a5174776605))
+* **rules:** exempt URLs and dotted names from ML500 spelling checks ([d12f659](https://github.com/lawther/python-lint-hooks/commit/d12f659f68698ce1f27f9f07cc737d5b88051e87))
+
+## [0.7.6](https://github.com/lawther/python-lint-hooks/compare/v0.7.5...v0.7.6) (2026-05-15)
+
+
+### Bug Fixes
+
+* **rules:** allow noqa on closing docstring line to suppress ML500 ([f91548a](https://github.com/lawther/python-lint-hooks/commit/f91548acacbaa9e0dd348ec6255baa53f546160e))
+* **rules:** exempt imported names from ML500 spelling checks ([48945fa](https://github.com/lawther/python-lint-hooks/commit/48945fa6cb60026370ceaf7d180f32db6d343db4))
+
+
+### Documentation
+
+* **rules:** document ML500 automatic exemptions in README ([6ff1a3a](https://github.com/lawther/python-lint-hooks/commit/6ff1a3a22131d2164dbcd944a07bcbaa6b27d7f1))
+
+## [0.7.5](https://github.com/lawther/python-lint-hooks/compare/v0.7.4...v0.7.5) (2026-05-15)
+
+
+### Documentation
+
+* **cli:** clarify override behavior of exclude, select, and ignore flags ([801ad84](https://github.com/lawther/python-lint-hooks/commit/801ad84ce4fdc3767661571be933382d96ee0c88))
+
+## [0.7.4](https://github.com/lawther/python-lint-hooks/compare/v0.7.3...v0.7.4) (2026-05-10)
+
+
+### Bug Fixes
+
+* **rules:** add 'initializer' to ML500 spelling map ([dfdf10a](https://github.com/lawther/python-lint-hooks/commit/dfdf10a98e56f2f79ba26105745f259403e5e573))
+
+## [0.7.3](https://github.com/lawther/python-lint-hooks/compare/v0.7.2...v0.7.3) (2026-05-10)
+
+
+### Bug Fixes
+
+* **rules:** implement case-preserving and aggregated suggestions for ML500 ([c0a96b1](https://github.com/lawther/python-lint-hooks/commit/c0a96b17f0c1cad3474c42c35edbf68fb706e9d5))
+
+
+### Documentation
+
+* remove mention of inner class exemptions from README ([9d566d6](https://github.com/lawther/python-lint-hooks/commit/9d566d670818aa9fc550a46d2e005bfe8aa04969))
+
+## [0.7.2](https://github.com/lawther/python-lint-hooks/compare/v0.7.1...v0.7.2) (2026-05-10)
+
+
+### Bug Fixes
+
+* **rules:** flag American English in docstrings (ML500) ([5f083f5](https://github.com/lawther/python-lint-hooks/commit/5f083f5ba2e8241d71434591832a06e31df4d57d))
+
+## [0.7.1](https://github.com/lawther/python-lint-hooks/compare/v0.7.0...v0.7.1) (2026-05-10)
+
+
+### Bug Fixes
+
+* removed erroneous words ([352f682](https://github.com/lawther/python-lint-hooks/commit/352f682996a0454cd2fbd048dc42c8ebcd93ed56))
+
+## [0.7.0](https://github.com/lawther/python-lint-hooks/compare/v0.6.1...v0.7.0) (2026-05-10)
+
+
+### Features
+
+* **rules:** add ML106 and ML107 to detect forbidden Mapping types ([8db371c](https://github.com/lawther/python-lint-hooks/commit/8db371c91460ea58084d43233ca60754788c33ac))
+* **rules:** add ML500 to enforce Australian English spelling ([8041781](https://github.com/lawther/python-lint-hooks/commit/80417816f564cbbc44636a1cd1c5f89e1ef62c1a))
+
+
+### Bug Fixes
+
+* **cli:** implement Ruff-style path exclusion logic ([d0686f3](https://github.com/lawther/python-lint-hooks/commit/d0686f3a4c106ad3accf632e574ef72b44535249)), closes [#15](https://github.com/lawther/python-lint-hooks/issues/15)
+
+
+### Documentation
+
+* implement rationale and examples for all lint rules ([7aa5d7e](https://github.com/lawther/python-lint-hooks/commit/7aa5d7e9c91288c15a8e4570bc2b9f17875218c3))
+* update legacy rule references in README ([4af4329](https://github.com/lawther/python-lint-hooks/commit/4af43290f1af49baf89fd336ca88f458e752dabd))
+
+## [0.6.1](https://github.com/lawther/python-lint-hooks/compare/v0.6.0...v0.6.1) (2026-05-08)
+
+
+### Bug Fixes
+
+* exclude ClassVar fields from ML201 all-forbidden-types check ([42cf5b1](https://github.com/lawther/python-lint-hooks/commit/42cf5b1f474488af94f7a23bee7db6559b36ab97))
+* recognise [@alias](https://github.com/alias).dataclass regardless of module alias name ([d51ae7e](https://github.com/lawther/python-lint-hooks/commit/d51ae7e67b83d24d7e9473b70524027ac302b96e))
+* recognise t.NewType regardless of typing module alias name ([0f26908](https://github.com/lawther/python-lint-hooks/commit/0f26908bf9201b62101741b47d261438ac6bf800))
+
+## [0.6.0](https://github.com/lawther/python-lint-hooks/compare/v0.5.0...v0.6.0) (2026-05-08)
+
+
+### Features
+
+* add per-file branch coverage breakdown to just test output ([417afcb](https://github.com/lawther/python-lint-hooks/commit/417afcb6cf887829873298e98616219c86a9c55e))
+* introduce RuleCode StrEnum for type-safe rule codes ([f72ecd6](https://github.com/lawther/python-lint-hooks/commit/f72ecd64c007a41086815a189c985b99b9acc2ef))
+
+
+### Bug Fixes
+
+* handle ast.Starred in _get_names so starred unpack variables are tainted ([46be6e0](https://github.com/lawther/python-lint-hooks/commit/46be6e0115087cad9626c41c50eefa626e77aef9))
+* isolate comprehension variable taint with per-comprehension scope ([a0731f7](https://github.com/lawther/python-lint-hooks/commit/a0731f75d6846ce2cfcebd2eb7f68c77014cee3a))
+* unconditionally update loop-variable taint in enter_For ([e49073d](https://github.com/lawther/python-lint-hooks/commit/e49073dfeda9ad114ce2ad128600868d28970b52))
+* use gen.iter as source_node in comprehension taint propagation ([54750ac](https://github.com/lawther/python-lint-hooks/commit/54750ac60d46f24636baa107f88658c8572d5579))
+
+## [0.5.0](https://github.com/lawther/python-lint-hooks/compare/v0.4.0...v0.5.0) (2026-05-08)
+
+
+### Features
+
+* add docs-rules, check-rules-docs, and new-rule justfile recipes ([e5ac3f5](https://github.com/lawther/python-lint-hooks/commit/e5ac3f5657548104bc7d97690e7d6e30617a8ff5))
+* add ML400 rule to detect unvalidated external data usage ([8bd289b](https://github.com/lawther/python-lint-hooks/commit/8bd289b8e530642cae8161dadfce69cfe02af8cb))
+
+
+### Bug Fixes
+
+* disallow bare # noqa suppressions to prevent over-suppression ([9e6e668](https://github.com/lawther/python-lint-hooks/commit/9e6e6689b9f0befc8c1c38a4eca9c5ca2c3268cc))
+* include ml400_untrusted_data.py omitted from previous staging ([53f31a6](https://github.com/lawther/python-lint-hooks/commit/53f31a63fcfcb688d6ae6b5d1c1da6524f0132ff))
+* suppress ML400 on tomllib.load in cli (pre-validation navigation) ([4b65652](https://github.com/lawther/python-lint-hooks/commit/4b6565272ce57b1d044c719c2082fe580b3b7fd0))
+
+
+### Documentation
+
+* add CONTRIBUTING_RULES.md and link from GEMINI.md ([485b189](https://github.com/lawther/python-lint-hooks/commit/485b189259fedc2379739011be4fd9017c0e4059))
+* update justfile integration example in README ([e6d12ef](https://github.com/lawther/python-lint-hooks/commit/e6d12efcceb5b7a3c927514bedcc061bd07234d0))
+
+## [0.4.0](https://github.com/lawther/python-lint-hooks/compare/v0.3.0...v0.4.0) (2026-05-06)
+
+
+### Features
+
+* add ML105 to catch NewType bypasses of return type rules ([0321c6d](https://github.com/lawther/python-lint-hooks/commit/0321c6db90c8b67f28296bd43028ad84fc7ccd65))
+* add ML201 to catch classes wrapping only forbidden types ([4e9886d](https://github.com/lawther/python-lint-hooks/commit/4e9886de156bb132d4bd6002f9662e4f76a9300e))
+
+## [0.3.0](https://github.com/lawther/python-lint-hooks/compare/v0.2.0...v0.3.0) (2026-05-06)
+
+
+### Features
+
+* add pytest-randomly to development dependencies ([14cd9f8](https://github.com/lawther/python-lint-hooks/commit/14cd9f800263df0d6979556e370dd5db4e4dbd68))
+* add Ruff-like --select and --ignore CLI filtering ([71e76aa](https://github.com/lawther/python-lint-hooks/commit/71e76aa158e53d6aa764bb3aca92437a6622c2b7))
+* enforce frozen=True for dataclasses (ML005) ([5b46303](https://github.com/lawther/python-lint-hooks/commit/5b46303192d9830e837b6a3480ff2a60a842dfd3))
+* expanded return type enforcement and thematic renumbering ([ed4a0f4](https://github.com/lawther/python-lint-hooks/commit/ed4a0f4403e1db7f2b71137ca626fb4784ce72f5)), closes [#5](https://github.com/lawther/python-lint-hooks/issues/5)
+
+
+### Documentation
+
+* document --select, --ignore and prefix matching behavior ([988de6a](https://github.com/lawther/python-lint-hooks/commit/988de6a6428da1ce20b08c6d1684c753244f64f5))
+* update README with ML005 and new CLI options ([49400bf](https://github.com/lawther/python-lint-hooks/commit/49400bfee22fc5dae417e14246085a6a2a6b2494))
+
+## [0.2.0](https://github.com/lawther/python-lint-hooks/compare/v0.1.0...v0.2.0) (2026-05-06)
+
+
+### Features
+
+* add Ruff-like exclusion options to CLI ([8a137ff](https://github.com/lawther/python-lint-hooks/commit/8a137ffba6278a62f62999863a9efd4c46d6ba18))
+
+
+### Documentation
+
+* add GEMINI.md coding conventions and link in CLAUDE.md ([407948d](https://github.com/lawther/python-lint-hooks/commit/407948d51f03a7f5e6ae4e7d8276df053e31aeb8))
+
+## 0.1.0 (2026-05-06)
+
+
+### Features
+
+* initial implementation of ML001 (bare dict/tuple returns) and ML002 (class inside function) ([d2756d7](https://github.com/lawther/python-lint-hooks/commit/d2756d74c603058852c30b11c35bf2e5295dad41))
+
+
+### Bug Fixes
+
+* commit ruff auto-fixes missed by precommit staging; rename noqa section comment ([b2a0fc3](https://github.com/lawther/python-lint-hooks/commit/b2a0fc3550624600ecb4e96e46a1ad47bf967bad))
+
+
+### Documentation
+
+* add README covering installation, rules, configuration and integration ([eee9cf1](https://github.com/lawther/python-lint-hooks/commit/eee9cf1777510086c34478adb8e938edf0494d1b))

ml_lints-0.12.1/CLAUDE.md

@@ -0,0 +1 @@
+@GEMINI.md