python-dependency-linter 0.1.0__tar.gz → 0.2.0__tar.gz

python_dependency_linter-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,62 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please fill out the sections below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Create a config file with ...
+        2. Run `pdl check`
+        3. See error ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: config
+    attributes:
+      label: Configuration
+      description: Your `.python-dependency-linter.yaml` (remove sensitive info).
+      render: yaml
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Please provide the following info.
+      value: |
+        - OS:
+        - Python version:
+        - python-dependency-linter version:
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error output / logs
+      description: Paste any relevant CLI output.
+      render: shell

python_dependency_linter-0.2.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question / Discussion
+    url: https://github.com/heumsi/python-layer-dependency-linter/discussions
+    about: Ask questions or start a discussion here.

python_dependency_linter-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,37 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe your idea below.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve? What's missing?
+      placeholder: "e.g., I want to allow wildcard patterns in third_party rules, but currently ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: How do you think this should work?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Any other approaches you've thought about.
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Any other context, examples, or config snippets.

python_dependency_linter-0.2.0/.github/pull_request_template.md

@@ -0,0 +1,13 @@
+## What does this PR do?
+
+<!-- A brief description of the change. -->
+
+## Related issue
+
+<!-- Link to the issue this PR addresses, e.g., Closes #123 -->
+
+## Checklist
+
+- [ ] Tests added / updated
+- [ ] `pdl check` runs without errors on the example config
+- [ ] Documentation updated (if applicable)

{python_dependency_linter-0.1.0 → python_dependency_linter-0.2.0}/.github/workflows/ci.yaml

@@ -3,14 +3,18 @@ name: CI
 on:
   pull_request:
     branches: [main]
+    paths:
+      - "python_dependency_linter/**"
+      - "tests/**"
+      - "pyproject.toml"
 
 jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v4
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.13"
       - run: uv pip install --system -e ".[dev]"
@@ -23,9 +27,9 @@ jobs:
       matrix:
         python-version: ["3.10", "3.11", "3.12", "3.13"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v4
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - run: uv pip install --system -e ".[dev]"

{python_dependency_linter-0.1.0 → python_dependency_linter-0.2.0}/.github/workflows/publish.yaml

@@ -11,13 +11,13 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Generate full changelog
         uses: orhun/git-cliff-action@v4
         with:
-          config: cliff.toml
+          config: pyproject.toml
           args: --verbose
         env:
           OUTPUT: CHANGELOG.md
@@ -33,7 +33,7 @@ jobs:
         id: release_notes
         uses: orhun/git-cliff-action@v4
         with:
-          config: cliff.toml
+          config: pyproject.toml
           args: --verbose --latest --strip header
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -50,7 +50,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v5
         with:
           python-version: "3.13"

python_dependency_linter-0.2.0/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-03-30

{python_dependency_linter-0.1.0 → python_dependency_linter-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-dependency-linter
-Version: 0.1.0
+Version: 0.2.0
 Summary: A dependency linter for Python projects
 License-Expression: MIT
 License-File: LICENSE
@@ -27,6 +27,14 @@ Description-Content-Type: text/markdown
 
 A dependency linter for Python projects. Define rules for which modules can depend on what, and catch violations.
 
+## What It Does
+
+- Define dependency rules between modules using a simple YAML or TOML config
+- Detect imports that violate your rules with a single CLI command
+- Integrate into CI or pre-commit to keep your architecture consistent
+
+For Python developers who care about module boundaries and dependency direction — whether you're applying Layered, Hexagonal, Clean Architecture, or your own conventions.
+
 ## Installation
 
 ```bash
@@ -80,6 +88,64 @@ contexts/boards/domain/models.py:9
 Found 2 violation(s).
 ```
 
+## Examples
+
+### Layered Architecture
+
+Enforce dependency direction: `presentation → application → domain`, where `domain` has no outward dependencies.
+
+```yaml
+rules:
+  - name: domain-isolation
+    modules: my_app.domain
+    allow:
+      standard_library: ["*"]
+      third_party: []
+      local: [my_app.domain]
+
+  - name: application-layer
+    modules: my_app.application
+    allow:
+      standard_library: ["*"]
+      third_party: [pydantic]
+      local:
+        - my_app.application
+        - my_app.domain
+
+  - name: presentation-layer
+    modules: my_app.presentation
+    allow:
+      standard_library: ["*"]
+      third_party: [fastapi, pydantic]
+      local:
+        - my_app.presentation
+        - my_app.application
+        - my_app.domain
+```
+
+### Hexagonal Architecture
+
+Isolate domain from infrastructure. Ports (interfaces) live in domain, adapters depend on domain but not vice versa.
+
+```yaml
+rules:
+  - name: domain-no-infra
+    modules: contexts.*.domain
+    allow:
+      standard_library: [dataclasses, typing, abc]
+      third_party: []
+      local: [contexts.*.domain]
+
+  - name: adapters-depend-on-domain
+    modules: contexts.*.adapters
+    allow:
+      standard_library: ["*"]
+      third_party: ["*"]
+      local:
+        - contexts.*.adapters
+        - contexts.*.domain
+```
+
 ## Configuration
 
 ### Rule Structure
@@ -117,7 +183,17 @@ Dependencies are classified into three categories (per PEP 8):
 - **`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
+- If `allow` exists but a category is omitted, that category allows all. For example:
+
+```yaml
+rules:
+  - name: domain-isolation
+    modules: contexts.*.domain
+    allow:
+      third_party: [pydantic]
+      local: [contexts.*.domain]
+      # standard_library is omitted → all standard library imports are allowed
+```
 
 Use `"*"` to allow all within a category:
 
@@ -134,6 +210,23 @@ allow:
 modules: contexts.*.domain  # matches contexts.boards.domain, contexts.auth.domain, ...
 ```
 
+`**` matches one or more levels in dotted module paths:
+
+```yaml
+modules: contexts.**.domain  # matches contexts.boards.domain, contexts.boards.sub.domain, ...
+```
+
+### Submodule Matching
+
+When a pattern is used in `allow` or `deny`, it also matches submodules of the matched module. For example:
+
+```yaml
+allow:
+  local: [contexts.*.domain]
+```
+
+This allows imports of `contexts.boards.domain` as well as its submodules like `contexts.boards.domain.models` or `contexts.boards.domain.entities.metric`.
+
 ### Rule Merging
 
 When multiple rules match a module, they are merged. Specific rules override wildcard rules per field:
@@ -164,6 +257,22 @@ modules = "contexts.*.domain"
 standard_library = ["dataclasses", "typing"]
 third_party = ["pydantic"]
 local = ["contexts.*.domain"]
+
+[[tool.python-dependency-linter.rules]]
+name = "application-dependency"
+modules = "contexts.*.application"
+
+[tool.python-dependency-linter.rules.allow]
+standard_library = ["*"]
+third_party = ["pydantic"]
+local = ["contexts.*.application", "contexts.*.domain"]
+
+[[tool.python-dependency-linter.rules]]
+name = "no-boto-in-domain"
+modules = "contexts.*.domain"
+
+[tool.python-dependency-linter.rules.deny]
+third_party = ["boto3"]
 ```
 
 ## CLI
@@ -195,6 +304,16 @@ Add to `.pre-commit-config.yaml`:
     - id: python-dependency-linter
 ```
 
+To pass custom options (e.g., a different config file or project root):
+
+```yaml
+- repo: https://github.com/heumsi/python-dependency-linter
+  rev: v0.1.0
+  hooks:
+    - id: python-dependency-linter
+      args: [--config, custom-config.yaml, --project-root, src]
+```
+
 ## License
 
 MIT

{python_dependency_linter-0.1.0 → python_dependency_linter-0.2.0}/README.md

@@ -2,6 +2,14 @@
 
 A dependency linter for Python projects. Define rules for which modules can depend on what, and catch violations.
 
+## What It Does
+
+- Define dependency rules between modules using a simple YAML or TOML config
+- Detect imports that violate your rules with a single CLI command
+- Integrate into CI or pre-commit to keep your architecture consistent
+
+For Python developers who care about module boundaries and dependency direction — whether you're applying Layered, Hexagonal, Clean Architecture, or your own conventions.
+
 ## Installation
 
 ```bash
@@ -55,6 +63,64 @@ contexts/boards/domain/models.py:9
 Found 2 violation(s).
 ```
 
+## Examples
+
+### Layered Architecture
+
+Enforce dependency direction: `presentation → application → domain`, where `domain` has no outward dependencies.
+
+```yaml
+rules:
+  - name: domain-isolation
+    modules: my_app.domain
+    allow:
+      standard_library: ["*"]
+      third_party: []
+      local: [my_app.domain]
+
+  - name: application-layer
+    modules: my_app.application
+    allow:
+      standard_library: ["*"]
+      third_party: [pydantic]
+      local:
+        - my_app.application
+        - my_app.domain
+
+  - name: presentation-layer
+    modules: my_app.presentation
+    allow:
+      standard_library: ["*"]
+      third_party: [fastapi, pydantic]
+      local:
+        - my_app.presentation
+        - my_app.application
+        - my_app.domain
+```
+
+### Hexagonal Architecture
+
+Isolate domain from infrastructure. Ports (interfaces) live in domain, adapters depend on domain but not vice versa.
+
+```yaml
+rules:
+  - name: domain-no-infra
+    modules: contexts.*.domain
+    allow:
+      standard_library: [dataclasses, typing, abc]
+      third_party: []
+      local: [contexts.*.domain]
+
+  - name: adapters-depend-on-domain
+    modules: contexts.*.adapters
+    allow:
+      standard_library: ["*"]
+      third_party: ["*"]
+      local:
+        - contexts.*.adapters
+        - contexts.*.domain
+```
+
 ## Configuration
 
 ### Rule Structure
@@ -92,7 +158,17 @@ Dependencies are classified into three categories (per PEP 8):
 - **`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
+- If `allow` exists but a category is omitted, that category allows all. For example:
+
+```yaml
+rules:
+  - name: domain-isolation
+    modules: contexts.*.domain
+    allow:
+      third_party: [pydantic]
+      local: [contexts.*.domain]
+      # standard_library is omitted → all standard library imports are allowed
+```
 
 Use `"*"` to allow all within a category:
 
@@ -109,6 +185,23 @@ allow:
 modules: contexts.*.domain  # matches contexts.boards.domain, contexts.auth.domain, ...
 ```
 
+`**` matches one or more levels in dotted module paths:
+
+```yaml
+modules: contexts.**.domain  # matches contexts.boards.domain, contexts.boards.sub.domain, ...
+```
+
+### Submodule Matching
+
+When a pattern is used in `allow` or `deny`, it also matches submodules of the matched module. For example:
+
+```yaml
+allow:
+  local: [contexts.*.domain]
+```
+
+This allows imports of `contexts.boards.domain` as well as its submodules like `contexts.boards.domain.models` or `contexts.boards.domain.entities.metric`.
+
 ### Rule Merging
 
 When multiple rules match a module, they are merged. Specific rules override wildcard rules per field:
@@ -139,6 +232,22 @@ modules = "contexts.*.domain"
 standard_library = ["dataclasses", "typing"]
 third_party = ["pydantic"]
 local = ["contexts.*.domain"]
+
+[[tool.python-dependency-linter.rules]]
+name = "application-dependency"
+modules = "contexts.*.application"
+
+[tool.python-dependency-linter.rules.allow]
+standard_library = ["*"]
+third_party = ["pydantic"]
+local = ["contexts.*.application", "contexts.*.domain"]
+
+[[tool.python-dependency-linter.rules]]
+name = "no-boto-in-domain"
+modules = "contexts.*.domain"
+
+[tool.python-dependency-linter.rules.deny]
+third_party = ["boto3"]
 ```
 
 ## CLI
@@ -170,6 +279,16 @@ Add to `.pre-commit-config.yaml`:
     - id: python-dependency-linter
 ```
 
+To pass custom options (e.g., a different config file or project root):
+
+```yaml
+- repo: https://github.com/heumsi/python-dependency-linter
+  rev: v0.1.0
+  hooks:
+    - id: python-dependency-linter
+      args: [--config, custom-config.yaml, --project-root, src]
+```
+
 ## License
 
 MIT

python_dependency_linter-0.2.0/pyproject.toml

@@ -0,0 +1,95 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "python-dependency-linter"
+dynamic = ["version"]
+description = "A dependency linter for Python projects"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "click>=8.0",
+    "tomli>=2.0; python_version < '3.11'",
+]
+
+[project.scripts]
+pdl = "python_dependency_linter.cli:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "ruff>=0.4",
+    "pre-commit>=3.0",
+]
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.ruff]
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["python_dependency_linter"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.git-cliff.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
+
+[tool.git-cliff.git]
+conventional_commits = true
+filter_unconventional = true
+commit_preprocessors = [
+  { pattern = ' *(:\w+:|[\p{Emoji_Presentation}\p{Extended_Pictographic}]\u{FE0F}?\u{200D}?) *', replace = "" },
+]
+commit_parsers = [
+  { message = "^.*Update CHANGELOG", skip = true },
+  { 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].*"

{python_dependency_linter-0.1.0 → python_dependency_linter-0.2.0}/python_dependency_linter/matcher.py

@@ -6,17 +6,29 @@ from python_dependency_linter.config import AllowDeny, Rule
 def matches_pattern(pattern: str, module: str) -> bool:
     pattern_parts = pattern.split(".")
     module_parts = module.split(".")
+    return _match(pattern_parts, module_parts)
 
-    if len(pattern_parts) != len(module_parts):
+
+def _match(pattern_parts: list[str], module_parts: list[str]) -> bool:
+    if not pattern_parts and not module_parts:
+        return True
+    if not pattern_parts:
+        return False
+
+    if pattern_parts[0] == "**":
+        # "**" matches one or more parts
+        for i in range(1, len(module_parts) + 1):
+            if _match(pattern_parts[1:], module_parts[i:]):
+                return True
+        return False
+
+    if not module_parts:
         return False
 
-    for p, m in zip(pattern_parts, module_parts):
-        if p == "*":
-            continue
-        if p != m:
-            return False
+    if pattern_parts[0] == "*" or pattern_parts[0] == module_parts[0]:
+        return _match(pattern_parts[1:], module_parts[1:])
 
-    return True
+    return False
 
 
 def find_matching_rules(module: str, rules: list[Rule]) -> list[Rule]:

{python_dependency_linter-0.1.0 → python_dependency_linter-0.2.0}/tests/test_matcher.py

@@ -17,6 +17,38 @@ def test_matches_pattern_wildcard():
     assert matches_pattern("contexts.*.domain", "contexts.boards.application") is False
 
 
+def test_matches_pattern_double_star():
+    # matches one level
+    assert matches_pattern("contexts.**.domain", "contexts.analytics.domain") is True
+    # matches multiple levels
+    assert (
+        matches_pattern("contexts.**.domain", "contexts.analytics.sub.domain") is True
+    )
+    # does not match zero levels (** requires one or more)
+    assert matches_pattern("contexts.**.domain", "contexts.domain") is False
+    # does not match wrong suffix
+    assert (
+        matches_pattern("contexts.**.domain", "contexts.analytics.application") is False
+    )
+
+
+def test_matches_pattern_double_star_at_end():
+    assert (
+        matches_pattern("contexts.**.domain.**", "contexts.a.domain.entities") is True
+    )
+    assert (
+        matches_pattern("contexts.**.domain.**", "contexts.a.domain.entities.metric")
+        is True
+    )
+    assert matches_pattern("contexts.**.domain.**", "contexts.a.domain") is False
+
+
+def test_matches_pattern_double_star_alone():
+    # ** alone matches any module with one or more parts
+    assert matches_pattern("**", "anything") is True
+    assert matches_pattern("**", "a.b.c") is True
+
+
 def test_matches_pattern_wildcard_in_allow():
     assert matches_pattern("contexts.*.domain", "contexts.boards.domain") is True