pragyalint 0.1.0__tar.gz

pragyalint-0.1.0/.github/workflows/bins.yml

@@ -0,0 +1,107 @@
+name: binaries
+
+# Builds standalone executables for Windows (EXE), Linux, and macOS using
+# PyInstaller and attaches them to the GitHub Release created by the
+# `release:` trigger (see publish.yml).
+#
+# The build matrix runs in parallel on native runners (Windows, Ubuntu, macOS).
+# macOS binaries are built with an unsigned quirk: the `codesign` step is kept
+# off unless a signing identity is provided via the secret `MACOS_CERT`.
+
+on:
+  push:
+    branches: [main]
+  release:
+    types: [published]
+  # Manual trigger: run to build binaries off the current code.
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build-binaries:
+    name: build (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            artifact: pragyalint-windows-x64.exe
+            ext: .exe
+            args: --onefile --name pragyalint
+          - os: ubuntu-latest
+            artifact: pragyalint-linux-x64
+            ext: ""
+            args: --onefile --name pragyalint
+          - os: macos-latest
+            artifact: pragyalint-macos-x64
+            ext: ""
+            args: --onefile --name pragyalint
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install PyInstaller
+        run: pip install pyinstaller
+
+      - name: Build with PyInstaller
+        run: pyinstaller --clean --noconfirm ${{ matrix.args }} pragyalint/cli.py
+
+      - name: Locate binary
+        id: loc
+        shell: bash
+        run: |
+          if [ "${{ matrix.ext }}" = ".exe" ]; then
+            echo "bin=dist/pragyalint${{ matrix.ext }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "bin=dist/pragyalint" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Rename artifact
+        shell: bash
+        run: |
+          cp "${{ steps.loc.outputs.bin }}" \
+             "${{ runner.temp }}/${{ matrix.artifact }}"
+
+      - name: Make executable (unix)
+        if: matrix.os != 'windows-latest'
+        run: chmod +x "${{ runner.temp }}/${{ matrix.artifact }}"
+
+      - name: Smoke-test the binary
+        shell: bash
+        run: |
+          BIN="${{ runner.temp }}/${{ matrix.artifact }}"
+          "$BIN" --version
+          "$BIN" --help | head -5
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: ${{ runner.temp }}/${{ matrix.artifact }}
+          if-no-files-found: error
+
+  # Runs only when the build is part of (or triggered by) a published release,
+  # attaching every platform binary to that release.
+  attach:
+    name: attach to release
+    runs-on: ubuntu-latest
+    needs: build-binaries
+    if: github.event_name == 'release' && github.event.action == 'published'
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: binaries
+          merge-multiple: true
+      - name: Attach binaries to release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.release.tag_name }}
+          files: binaries/*

pragyalint-0.1.0/.github/workflows/pages.yml

@@ -0,0 +1,36 @@
+name: deploy-pages
+
+# Deploys the static site in site/ to GitHub Pages on every push to main.
+# Uses the official Pages deploy action (no static-site generator needed).
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Upload site artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

pragyalint-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,93 @@
+name: release
+
+# Builds and publishes PragyaLint to PyPI and creates a GitHub Release
+# when a commit message contains the trigger word `release:`
+# (e.g. "release: v0.1.0").
+#
+# The test job always runs on push. The publish job only runs when the
+# head commit message contains `release:`.
+#
+# Secrets needed:
+#   - PyPI Trusted Publishing (recommended): no secret; just configure the
+#       PyPI "Trusted Publishing" publisher for this repo.
+#   - Or a classic API token in a secret named `PYPI_TOKEN`.
+
+on:
+  push:
+    branches: [main]
+  # Manual trigger: check "Publish to PyPI even without release: commit".
+  workflow_dispatch:
+    inputs:
+      force-release:
+        description: "Publish to PyPI even without release: commit"
+        type: boolean
+        required: false
+        default: false
+
+permissions:
+  contents: write    # for GitHub Release creation
+  id-token: write    # for PyPI trusted publishing
+
+jobs:
+  test:
+    uses: ./.github/workflows/tests.yml
+
+  build:
+    needs: [test]
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tooling
+        run: pip install --upgrade build
+      - name: Build wheel + sdist
+        run: python -m build
+      - name: Capture version
+        id: version
+        run: echo "version=$(python -c 'import tomllib;print(tomllib.load(open(\"pyproject.toml\",\"rb\"))[\"project\"][\"version\"])')" >> "$GITHUB_OUTPUT"
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: |
+      contains(github.event.head_commit.message, 'release:') ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.force-release == 'true')
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Trusted Publishing needs no password. Passing a token (optional)
+        # covers the classic-token path; gh-action skips publishing if empty.
+        with:
+          password: ${{ secrets.PYPI_TOKEN }}
+
+  github_release:
+    needs: [publish]
+    runs-on: ubuntu-latest
+    if: needs.publish.result == 'success'
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create GitHub Release and attach Python artifacts
+        uses: softprops/action-gh-release@v2
+        with:
+          name: PragyaLint v${{ needs.build.outputs.version }}
+          tag_name: v${{ needs.build.outputs.version }}
+          draft: false
+          generate_release_notes: true
+          files: dist/*

pragyalint-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,28 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest -q
+      - name: Self-analysis gate
+        run: |
+          pragyalint --fail-on high --include pragyalint

pragyalint-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+wheels/
+.venv/
+venv/
+env/
+.venvs/
+pip-wheel-metadata/
+share/python-wheels/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.nox/
+.tox/
+.cache/
+coverage.xml
+*.cover
+
+# Lint / typing
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+dmypy.json
+pyrightconfig.json
+.pytype/
+
+# Packaging / publishing
+*.whl
+*.tar.gz
+requirements.txt.bak
+
+# Editors / OS
+.DS_Store
+*.swp
+*.swo
+.idea/
+.vscode/
+*.log
+
+# Environments
+.env
+.env.*
+!.env.example

pragyalint-0.1.0/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to PragyaLint are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-08-29
+
+### Added
+
+- **Fix engine** (`--fix`) — opt-in removal of dead code, confidence-gated with
+  dry-run support:
+  - `files`: delete unreachable modules (never entries or `__init__.py`).
+  - `imports`: remove unused imports; trims unused names from multi-name imports.
+  - `exports`: remove unused function/class/variable definitions (respects `__all__`).
+  - `--confidence high|medium+|low+|all`, `--dry-run`, and `--force` flags.
+- Module graph builder using the standard-library `ast` module.
+  - Entry discovery (conventional entries: `main.py`, `app.py`, `__main__.py`,
+    `setup.py`) and explicit `--entry` support.
+  - Package/`__init__.py` handling and relative import resolution.
+  - Dynamic import detection (`importlib.import_module`, `__import__`).
+  - Qualified member-access tracking (`helper.used()` counts as a usage).
+  - Reachability analysis and strongly-connected-component cycle detection.
+- Dead-code finders:
+  - `unused_file` (high): unreachable modules.
+  - `unused_import` (high): unused imports, honoring `__all__` re-exports.
+  - `unused_export` (medium): defined public names never imported.
+  - `unused_local` (medium/low): unused functions, classes, and assignments.
+  - `cycle` (low): circular import cycles.
+- Confidence levels on every finding (`high` / `medium` / `low`).
+- Terminal, JSON, and SARIF reporters.
+- `--fail-on <confidence>` CI gating.
+- Configuration via `pragyalint.toml`, `pragyalint.json`, or
+  `[tool.pragyalint]` in `pyproject.toml`.
+- Zero runtime dependencies; requires Python 3.9+.
+- Test suite (pytest) and GitHub Actions CI with a self-analysis gate.