rabbitinspect 0.2.0__tar.gz

rabbitinspect-0.2.0/.github/dependabot.yml

@@ -0,0 +1,45 @@
+version: 2
+updates:
+  # Python runtime + dev dependencies pinned in pyproject.toml.
+  # Dependabot picks up the [project.optional-dependencies] groups
+  # automatically; PRs are grouped per-week to keep noise low.
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+    groups:
+      python-deps:
+        patterns:
+          - "*"
+
+  # GitHub Actions versions (uses: actions/checkout@vN, etc.). Pin
+  # bumps land alongside ecosystem-wide security advisories.
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 3
+    labels:
+      - "dependencies"
+      - "ci"
+
+  # Rust crates (PyO3 hot path). Cargo.lock is tracked so security
+  # advisories on transitive deps surface as PRs.
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "rust"
+    groups:
+      rust-deps:
+        patterns:
+          - "*"

rabbitinspect-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,88 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+  PYTHON_VERSION: "3.14"
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install uv
+        run: pip install uv
+      - name: Install linters
+        run: uv pip install ruff ty tomli --system
+      - name: Run ruff
+        run: ruff check python/ tests/ --ignore=E501
+      - name: Run ty
+        run: ty check python/rabbitinspect/ --python-version 3.14
+
+  rust:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+      - uses: Swatinem/rust-cache@v2
+      - name: Build
+        run: cargo build --release
+      - name: Test
+        run: cargo test
+
+  build-wheel:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+      - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install uv
+        run: pip install uv
+      - name: Build wheel
+        run: |
+          uv pip install maturin --system
+          maturin build --release --out dist
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheel
+          path: dist/*.whl
+
+  test-linux:
+    needs: build-wheel
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        run: pip install uv
+      - uses: actions/cache@v5
+        with:
+          path: .venv
+          key: venv-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('pyproject.toml', 'uv.lock') }}
+          restore-keys: venv-${{ runner.os }}-${{ matrix.python-version }}-
+      - name: Install dependencies
+        run: uv sync --frozen
+      - uses: actions/download-artifact@v8
+        with:
+          name: wheel
+          path: dist/
+      - name: Install wheel
+        run: uv pip install dist/*.whl --reinstall
+      - name: Run tests
+        run: uv run pytest tests/ -v

rabbitinspect-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,87 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  wheels:
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: ubuntu-24.04-arm
+            target: aarch64
+          - os: macos-latest
+            target: x86_64
+          - os: macos-latest
+            target: aarch64
+          - os: windows-latest
+            target: x86_64
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+
+      - name: Build Wheels
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist --interpreter python3.10 python3.11 python3.12 python3.13
+          sccache: 'true'
+          manylinux: manylinux_2_28
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: dist/*.whl
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: sdist
+          args: --out dist
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-sdist
+          path: dist/*.tar.gz
+
+  publish:
+    needs: [wheels, sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/rabbitinspect
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true
+
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          files: dist/*
+          generate_release_notes: true

rabbitinspect-0.2.0/.gitignore

@@ -0,0 +1,25 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Rust build artifacts
+target/
+
+# Compiled Python extensions (generated by maturin)
+*.so
+*.pyd
+*.dylib
+
+# uv lockfile (optional)
+# uv.lock
+
+# IDE
+.vscode/
+.idea/

rabbitinspect-0.2.0/.python-version

@@ -0,0 +1 @@
+3.14

rabbitinspect-0.2.0/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.0] - 2026-05-31
+
+### Added
+
+#### Infrastructure
+- `--select` / `--ignore` CLI flags for filtering checks
+- `--format json` output option
+- `# noqa: RABNNN` inline comment suppression
+- `[tool.rabbitinspect]` configuration via `pyproject.toml`
+- `tomli` fallback for Python 3.10 compatibility
+- GitHub Actions CI with lint (ruff + ty), Rust build, wheel build, and multi-Python testing (3.10–3.14)
+- GitHub Actions publish workflow with cibuildwheel for Linux (x86_64 + aarch64), macOS (x86_64 + arm64), and Windows
+- Type stub (`_core.pyi`) for the compiled Rust extension
+- Dev dependencies: `ruff`, `ty`, `tomli`
+
+#### Rust refactoring
+- `iter_fn_args()` helper eliminates repeated `posonlyargs.iter().chain(args.args.iter()).chain(kwonlyargs.iter())` pattern across 7 checkers
+- `count_fn_args()` helper for counting function parameters
+- Overlapping fix detection — `apply_fixes` skips fixes that overlap with already-applied regions
+
+#### New checks (46 total)
+
+| Code | Rule | Fix |
+|------|------|-----|
+| RAB046 | `sorted(x)[0]` → `min(x)` | ✅ |
+| RAB047 | `sorted(x)[-1]` → `max(x)` | ✅ |
+| RAB048 | `not x is None` → `x is not None` | ✅ |
+| RAB049 | `x = x + 1` → `x += 1` | ✅ |
+| RAB050 | `for i in range(len(seq))` — iterate directly | ❌ |
+| RAB051 | `d.setdefault(k, []).append(v)` → `defaultdict` | ❌ |
+| RAB052 | `type(x) == A or type(x) == B` → `isinstance(x, (A, B))` | ✅ |
+| RAB053 | `x is True` / `x is False` → `x` / `not x` | ✅ |
+| RAB054 | `if not x: x = y` → `x = x or y` | ✅ |
+| RAB055 | Unused loop variable → `_` | ✅ |
+| RAB056 | Nested `with` statements | ❌ |
+| RAB057 | `s.startswith('a') or s.startswith('b')` → `s.startswith(('a', 'b'))` | ✅ |
+| RAB058 | `return True if cond else False` → `return cond` | ✅ |
+| RAB059 | `while True:` without `break` → infinite loop | ❌ |
+| RAB060 | `sorted(x).sort()` → `x.sort()` | ✅ |
+| RAB061 | `from module import *` — wildcard import | ❌ |
+| RAB062 | Redundant `pass` after docstring | ✅ |
+| RAB063 | `x is 5` / `x is "str"` → `x == 5` / `x == "str"` | ✅ |
+| RAB064 | `__init__` returning non-None value | ✅ |
+| RAB065 | `if True:` / `if False:` dead code | ❌ |
+| RAB066 | Function definition inside a loop | ❌ |
+| RAB067 | Variable/function shadows built-in name | ✅ |
+| RAB068 | `raise Exc()` without `from` inside `except` | ❌ |
+| RAB069 | `dict()` / `list()` / `tuple()` → `{}` / `[]` / `()` | ✅ |
+| RAB070 | `x == ""` / `x == []` / `x == {}` → `not x` / `x` | ✅ |
+| RAB071 | List comp inside `str.join()` → generator | ✅ |
+| RAB072 | Except handler only re-raises | ❌ |
+| RAB073 | Old-style `%` string formatting | ❌ |
+| RAB074 | `os.path.*` → `pathlib.Path` | ❌ |
+| RAB075 | `isinstance(x, (A,))` → `isinstance(x, A)` | ✅ |
+| RAB076 | `str()` on value already a string | ✅ |
+| RAB078 | `except Exception: pass` — silent swallow | ❌ |
+| RAB079 | `__del__` method defined | ❌ |
+| RAB080 | `list(d.keys())` / `list(d.values())` → `list(d)` | ✅ |
+| RAB083 | Nested ternary expression | ❌ |
+| RAB085 | `reversed(sorted(x))` → `sorted(x, reverse=True)` | ✅ |
+| RAB087 | `{k: v for k, v in zip(...)}` → `dict(zip(...))` | ✅ |
+| RAB088 | `while len(x) > 0` → `while x` | ✅ |
+| RAB089 | `copy.copy(x)` → `x.copy()` | ✅ |
+
+- Initial release with 43 checks (RAB001–RAB045, RAB101–RAB102)
+- Rust+PyO3 analysis engine
+- CLI with ruff-style output and `--fix` flag
+- Auto-fix support for 22 checks
+- Comprehensive test suite (255 tests)
+- Native generics (RAB039) and union syntax (RAB044) checks
+- Cognitive and cyclomatic complexity analysis
+
+### Fixed
+
+#### Bugs
+- **RAB001**: `x += 1` no longer incorrectly reports `x` as unused (augmented assignment target is now also recorded as used)
+- **RAB040**: `@dataclass(frozen=True)` now correctly produces `@dataclass(frozen=True, slots=True)`, preserving existing keyword arguments
+- **RAB060**: `sorted(x, reverse=True).sort()` is now skipped (incorrect semantics)
+- **RAB067**: Function definition fix no longer destroys the function body (only the name is replaced)
+- **RAB068**: Uses a counter stack instead of a boolean for `enter_except`/`exit_except`, correctly handling nested except handlers; resets on function scope boundaries
+- **B5**: `apply_fixes` now handles overlapping fix ranges by skipping fixes that overlap with already-applied regions (e.g., RAB052 + RAB006 on `type(x) == int or type(x) == str`)
+- **B7**: `contains_name_ref` and `stmt_contains_name_ref` now handle `Await`, `Yield`, `YieldFrom`, `Match`, `ClassDef`, `AsyncFor`, `Import`, `ImportFrom`, `TypeAlias` — eliminating false positives in RAB055
+- **B10**: `tomllib` import has a `try/except` fallback to `tomli` for Python 3.10
+
+#### Code quality
+- ComplexityChecker, FunctionLengthChecker, TooManyParamsChecker, CognitiveComplexityChecker now report the actual function position instead of `(0, 0)`
+- RAB055 now handles `AsyncFor` loops in addition to `For`
+- Fixture files have `# ruff: noqa` headers to avoid false positives in linting
+- Duplicate `bad_range_len` function in test fixtures renamed
+
+### Documentation
+- Complete README rewrite with all 89 checks, CLI flags, `# noqa`, `pyproject.toml` config, and expanded performance rationale table
+- CHANGELOG added