python-dependency-linter 0.1.0__tar.gz

python_dependency_linter-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

python_dependency_linter-0.1.0/.github/workflows/ci.yaml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: uv pip install --system -e ".[dev]"
+      - run: ruff check .
+      - run: ruff format --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv pip install --system -e ".[dev]"
+      - run: pytest -v

python_dependency_linter-0.1.0/.github/workflows/publish.yaml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  changelog:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Generate full changelog
+        uses: orhun/git-cliff-action@v4
+        with:
+          config: cliff.toml
+          args: --verbose
+        env:
+          OUTPUT: CHANGELOG.md
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Commit CHANGELOG.md
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add CHANGELOG.md
+          git commit -m "📝 docs: Update CHANGELOG for ${{ github.ref_name }}" || true
+          git push origin HEAD:main
+      - name: Generate release notes
+        id: release_notes
+        uses: orhun/git-cliff-action@v4
+        with:
+          config: cliff.toml
+          args: --verbose --latest --strip header
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body: ${{ steps.release_notes.outputs.content }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    needs: changelog
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

python_dependency_linter-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+.ruff_cache/

python_dependency_linter-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.8
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

python_dependency_linter-0.1.0/.pre-commit-hooks.yaml

@@ -0,0 +1,6 @@
+- id: python-dependency-linter
+  name: Python Dependency Linter
+  entry: pdl check
+  language: python
+  types: [python]
+  pass_filenames: false

python_dependency_linter-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 heumsi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_dependency_linter-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: python-dependency-linter
+Version: 0.1.0
+Summary: A dependency linter for Python projects
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: pre-commit>=3.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# python-dependency-linter
+
+A dependency linter for Python projects. Define rules for which modules can depend on what, and catch violations.
+
+## Installation
+
+```bash
+pip install python-dependency-linter
+```
+
+Or with uv:
+
+```bash
+uv add python-dependency-linter
+```
+
+## Quick Start
+
+Create `.python-dependency-linter.yaml` in your project root:
+
+```yaml
+rules:
+  - name: domain-isolation
+    modules: contexts.*.domain
+    allow:
+      standard_library: [dataclasses, typing]
+      third_party: [pydantic]
+      local: [contexts.*.domain]
+
+  - name: application-dependency
+    modules: contexts.*.application
+    allow:
+      standard_library: ["*"]
+      third_party: [pydantic]
+      local:
+        - contexts.*.application
+        - contexts.*.domain
+```
+
+Run:
+
+```bash
+pdl check
+```
+
+Output:
+
+```
+contexts/boards/domain/models.py:6
+    [domain-isolation] contexts.boards.domain.models → contexts.boards.application.service (local)
+
+contexts/boards/domain/models.py:9
+    [domain-isolation] contexts.boards.domain.models → sqlalchemy (third_party)
+
+Found 2 violation(s).
+```
+
+## Configuration
+
+### Rule Structure
+
+Each rule has:
+
+- `name` — Rule identifier, shown in violation output
+- `modules` — Module pattern to apply the rule to (supports `*` wildcard)
+- `allow` — Whitelist: only listed dependencies are allowed
+- `deny` — Blacklist: listed dependencies are denied
+
+```yaml
+rules:
+  - name: rule-name
+    modules: my_package.*.domain
+    allow:
+      standard_library: [dataclasses]
+      third_party: [pydantic]
+      local: [my_package.*.domain]
+    deny:
+      third_party: [boto3]
+```
+
+### Import Categories
+
+Dependencies are classified into three categories (per PEP 8):
+
+- `standard_library` — Python built-in modules (`os`, `sys`, `typing`, ...)
+- `third_party` — Installed packages (`pydantic`, `sqlalchemy`, ...)
+- `local` — Modules in your project
+
+### Behavior
+
+- **No rule** — Everything is allowed
+- **`allow` only** — Whitelist mode. Only listed dependencies are allowed
+- **`deny` only** — Blacklist mode. Listed dependencies are denied, rest allowed
+- **`allow` + `deny`** — Allow first, then deny removes exceptions
+- If `allow` exists but a category is omitted, that category allows all
+
+Use `"*"` to allow all within a category:
+
+```yaml
+allow:
+  standard_library: ["*"]  # allow all standard library imports
+```
+
+### Wildcard
+
+`*` matches a single level in dotted module paths:
+
+```yaml
+modules: contexts.*.domain  # matches contexts.boards.domain, contexts.auth.domain, ...
+```
+
+### Rule Merging
+
+When multiple rules match a module, they are merged. Specific rules override wildcard rules per field:
+
+```yaml
+rules:
+  - name: base
+    modules: contexts.*.domain
+    allow:
+      third_party: [pydantic]
+
+  - name: boards-extra
+    modules: contexts.boards.domain
+    allow:
+      third_party: [attrs]  # merged: [pydantic, attrs]
+```
+
+### pyproject.toml
+
+You can also configure in `pyproject.toml`:
+
+```toml
+[[tool.python-dependency-linter.rules]]
+name = "domain-isolation"
+modules = "contexts.*.domain"
+
+[tool.python-dependency-linter.rules.allow]
+standard_library = ["dataclasses", "typing"]
+third_party = ["pydantic"]
+local = ["contexts.*.domain"]
+```
+
+## CLI
+
+```bash
+# Check with default config (.python-dependency-linter.yaml)
+pdl check
+
+# Specify config file
+pdl check --config path/to/config.yaml
+
+# Specify project root
+pdl check --project-root path/to/project
+```
+
+Exit codes:
+
+- `0` — No violations
+- `1` — Violations found
+
+## Pre-commit
+
+Add to `.pre-commit-config.yaml`:
+
+```yaml
+- repo: https://github.com/heumsi/python-dependency-linter
+  rev: v0.1.0
+  hooks:
+    - id: python-dependency-linter
+```
+
+## License
+
+MIT

python_dependency_linter-0.1.0/README.md

@@ -0,0 +1,175 @@
+# python-dependency-linter
+
+A dependency linter for Python projects. Define rules for which modules can depend on what, and catch violations.
+
+## Installation
+
+```bash
+pip install python-dependency-linter
+```
+
+Or with uv:
+
+```bash
+uv add python-dependency-linter
+```
+
+## Quick Start
+
+Create `.python-dependency-linter.yaml` in your project root:
+
+```yaml
+rules:
+  - name: domain-isolation
+    modules: contexts.*.domain
+    allow:
+      standard_library: [dataclasses, typing]
+      third_party: [pydantic]
+      local: [contexts.*.domain]
+
+  - name: application-dependency
+    modules: contexts.*.application
+    allow:
+      standard_library: ["*"]
+      third_party: [pydantic]
+      local:
+        - contexts.*.application
+        - contexts.*.domain
+```
+
+Run:
+
+```bash
+pdl check
+```
+
+Output:
+
+```
+contexts/boards/domain/models.py:6
+    [domain-isolation] contexts.boards.domain.models → contexts.boards.application.service (local)
+
+contexts/boards/domain/models.py:9
+    [domain-isolation] contexts.boards.domain.models → sqlalchemy (third_party)
+
+Found 2 violation(s).
+```
+
+## Configuration
+
+### Rule Structure
+
+Each rule has:
+
+- `name` — Rule identifier, shown in violation output
+- `modules` — Module pattern to apply the rule to (supports `*` wildcard)
+- `allow` — Whitelist: only listed dependencies are allowed
+- `deny` — Blacklist: listed dependencies are denied
+
+```yaml
+rules:
+  - name: rule-name
+    modules: my_package.*.domain
+    allow:
+      standard_library: [dataclasses]
+      third_party: [pydantic]
+      local: [my_package.*.domain]
+    deny:
+      third_party: [boto3]
+```
+
+### Import Categories
+
+Dependencies are classified into three categories (per PEP 8):
+
+- `standard_library` — Python built-in modules (`os`, `sys`, `typing`, ...)
+- `third_party` — Installed packages (`pydantic`, `sqlalchemy`, ...)
+- `local` — Modules in your project
+
+### Behavior
+
+- **No rule** — Everything is allowed
+- **`allow` only** — Whitelist mode. Only listed dependencies are allowed
+- **`deny` only** — Blacklist mode. Listed dependencies are denied, rest allowed
+- **`allow` + `deny`** — Allow first, then deny removes exceptions
+- If `allow` exists but a category is omitted, that category allows all
+
+Use `"*"` to allow all within a category:
+
+```yaml
+allow:
+  standard_library: ["*"]  # allow all standard library imports
+```
+
+### Wildcard
+
+`*` matches a single level in dotted module paths:
+
+```yaml
+modules: contexts.*.domain  # matches contexts.boards.domain, contexts.auth.domain, ...
+```
+
+### Rule Merging
+
+When multiple rules match a module, they are merged. Specific rules override wildcard rules per field:
+
+```yaml
+rules:
+  - name: base
+    modules: contexts.*.domain
+    allow:
+      third_party: [pydantic]
+
+  - name: boards-extra
+    modules: contexts.boards.domain
+    allow:
+      third_party: [attrs]  # merged: [pydantic, attrs]
+```
+
+### pyproject.toml
+
+You can also configure in `pyproject.toml`:
+
+```toml
+[[tool.python-dependency-linter.rules]]
+name = "domain-isolation"
+modules = "contexts.*.domain"
+
+[tool.python-dependency-linter.rules.allow]
+standard_library = ["dataclasses", "typing"]
+third_party = ["pydantic"]
+local = ["contexts.*.domain"]
+```
+
+## CLI
+
+```bash
+# Check with default config (.python-dependency-linter.yaml)
+pdl check
+
+# Specify config file
+pdl check --config path/to/config.yaml
+
+# Specify project root
+pdl check --project-root path/to/project
+```
+
+Exit codes:
+
+- `0` — No violations
+- `1` — Violations found
+
+## Pre-commit
+
+Add to `.pre-commit-config.yaml`:
+
+```yaml
+- repo: https://github.com/heumsi/python-dependency-linter
+  rev: v0.1.0
+  hooks:
+    - id: python-dependency-linter
+```
+
+## License
+
+MIT

python_dependency_linter-0.1.0/cliff.toml

@@ -0,0 +1,38 @@
+[changelog]
+header = """# Changelog\n
+All notable changes to this project will be documented in this file.\n
+"""
+body = """
+{%- macro remote_url() -%}
+  https://github.com/heumsi/python-dependency-linter
+{%- endmacro -%}
+
+{% if version -%}
+## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else -%}
+## [Unreleased]
+{% endif -%}
+
+{% for group, commits in commits | group_by(attribute="group") %}
+### {{ group | upper_first }}
+{% for commit in commits %}
+- {{ commit.message | split(pat=":") | last | trim }}\
+{% endfor %}
+{% endfor %}
+"""
+trim = true
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+commit_parsers = [
+  { message = "^.*feat", group = "Features" },
+  { message = "^.*fix", group = "Bug Fixes" },
+  { message = "^.*refactor", group = "Refactor" },
+  { message = "^.*perf", group = "Performance" },
+  { message = "^.*doc", group = "Documentation" },
+  { message = "^.*test", group = "Testing" },
+  { message = "^.*chore", group = "Miscellaneous" },
+  { message = "^.*ci", group = "CI/CD" },
+]
+tag_pattern = "v[0-9].*"