smelt-cli 0.2.0__tar.gz → 0.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- smelt_cli-0.3.0/.editorconfig +15 -0
- smelt_cli-0.3.0/.gitattributes +5 -0
- smelt_cli-0.3.0/.github/dependabot.yml +11 -0
- smelt_cli-0.3.0/.github/pull_request_template.md +22 -0
- smelt_cli-0.3.0/.github/workflows/ci.yml +83 -0
- smelt_cli-0.3.0/.github/workflows/release.yml +128 -0
- smelt_cli-0.3.0/.gitignore +35 -0
- smelt_cli-0.3.0/.pre-commit-config.yml +66 -0
- smelt_cli-0.3.0/.pre-commit-hooks.yaml +16 -0
- smelt_cli-0.3.0/.python-version +1 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/CHANGELOG.md +100 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/CONTRIBUTING.md +15 -10
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/Cargo.lock +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/Cargo.toml +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/PKG-INFO +13 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/README.md +12 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/README.md +1 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/adoption.md +7 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/cli.md +17 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/configuration.md +7 -3
- smelt_cli-0.3.0/docs/facade-export-evaluation.json +52 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/integrations.md +28 -17
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/README.md +2 -0
- smelt_cli-0.3.0/docs/rules/SMT109.md +40 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT311.md +2 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT313.md +2 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT316.md +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT318.md +1 -1
- smelt_cli-0.3.0/docs/rules/SMT320.md +43 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT424.md +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT425.md +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT426.md +2 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT429.md +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT430.md +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/structure.md +91 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/testing.md +22 -4
- smelt_cli-0.3.0/docs/upgrading.md +161 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/pyproject.toml +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/cache.py +6 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/contracts.py +39 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/definition_blocks.py +111 -24
- smelt_cli-0.3.0/smelt/analysis/facade_usage.py +295 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/files.py +6 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/members.py +43 -4
- smelt_cli-0.3.0/smelt/analysis/module_symbols.py +247 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/ordering.py +30 -5
- smelt_cli-0.3.0/smelt/analysis/test_helpers.py +136 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_outcomes.py +14 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_subprocesses.py +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_syntax.py +94 -13
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_timing.py +22 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/app.py +4 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/commands/check.py +11 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/models.py +12 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/debt.py +1 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/groups.py +24 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/render/machine.py +39 -5
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/render/text.py +96 -7
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/suppressions.py +55 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/briefing.py +4 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/coverage.py +1 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/inference.py +5 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/result_cache.py +7 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/activation.py +7 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/catalog.json +32 -0
- smelt_cli-0.3.0/smelt/rules/dependencies/facades.py +136 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/fanout.py +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/registry.py +2 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/enum_values.py +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/headers.py +2 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/import_style.py +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/members.py +3 -2
- smelt_cli-0.3.0/smelt/rules/structure/module_symbols.py +50 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/ordering.py +7 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/outcomes.py +2 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/public_attributes.py +2 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/public_functions.py +14 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/timing.py +12 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt.schema.json +200 -60
- smelt_cli-0.3.0/tests/analysis/test_module_symbols.py +133 -0
- smelt_cli-0.3.0/tests/analysis/test_test_helpers.py +370 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/cli/test_app.py +43 -6
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/cli/test_session.py +1 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/render/test_machine.py +35 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/render/test_text.py +70 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_cache.py +41 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_changes.py +35 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_check.py +122 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_inference.py +20 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_native_git.py +1 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_ordering_fixes.py +22 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_staged.py +35 -0
- smelt_cli-0.3.0/tests/rules/dependencies/test_facades.py +397 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_fanout.py +45 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_members.py +17 -0
- smelt_cli-0.3.0/tests/rules/structure/test_module_symbols.py +134 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_ordering.py +113 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/test_activation.py +2 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_location.py +22 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_public_attributes.py +29 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_public_functions.py +4 -2
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_timing.py +36 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/test_docs.py +38 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/uv.lock +1 -1
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/agent-workflow.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/architecture.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/incremental-followup-2026-10-31.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/native-checks-2026-10-31.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/native-git-retained-state-2026-10-31.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/precommit-performance-2026-10-30.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/review-feedback-2026-10-31.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/staged-checks-2026-10-30.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/benchmarks/staged-policy-cache-2026-10-31.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/proposals/config-structure.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/review.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rule-selection.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT101.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT102.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT103.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT104.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT105.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT106.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT107.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT108.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT301.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT302.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT305.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT306.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT307.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT308.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT309.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT310.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT312.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT314.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT315.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT317.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT319.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT401.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT420.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT421.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT422.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT423.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT427.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT428.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT901.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT902.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/rules/SMT903.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/test-quality-evaluation.json +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/docs/vision.md +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/native/git.rs +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/native/main.rs +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/native/worker.rs +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/scripts/benchmark_checks.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/scripts/benchmark_hooks.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/scripts/benchmark_session.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/scripts/evaluate.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/scripts/generate.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/scripts/smoke_distribution.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/__main__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/annotations.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/context.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/coverage.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/enum_values.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/errors.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/exports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/function_usage.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/graphs.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/identity.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/import_cache.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/imports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/literals.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/member_state.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/ordering_rewrite.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/package_exports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/parsing.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/python_version.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/retained.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/syntax.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_awaits.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_cases.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/test_deadlines.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/type_dispatch.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/analysis/workspace.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/commands/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/commands/adopt.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/commands/discover.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/commands/info.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/session.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/session_slots.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/cli/support.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/discovery.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/errors.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/loader.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/patterns.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/schema.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/source.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/config/validation.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/dedupe.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/render/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/report.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/diagnostics/violation.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/docs.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/cache.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/changes.py +4 -4
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/check.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/evaluation.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/file_checks.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/git_source.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/mirror_inference.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/native_git.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/ordering_fixes.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/paths.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/rule_settings.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/schema.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/staged.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/engine/workspace.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/model/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/model/architecture.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/py.typed +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/base.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/common.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/composition_root.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/cycles.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/features.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/interfaces.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/layers.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/dependencies/third_party.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/member_names.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/meta.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/assignments.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/contracts.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/coverage.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/layout.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/naming.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/package_imports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/structure/type_dispatch.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/awaits.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/cases.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/location.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/mocking.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt/rules/testing/private_access.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/smelt.yml +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_annotations.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_context.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_contracts.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_enum_values.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_exports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_identity.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_ordering.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_ordering_rewrite.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_parsing.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_python_version.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_retained.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_test_awaits.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_test_cases.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_test_deadlines.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_test_outcomes.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_test_syntax.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_test_timing.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_type_dispatch.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/analysis/test_workspace.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/cli/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/cli/test_session_slots.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/config/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/config/test_loader.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/config/test_validation.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/render/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/render/conftest.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/test_groups.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/diagnostics/test_suppressions.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_briefing.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_coverage.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_evaluation.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_file_checks.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_mirror_inference.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_paths.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_rule_settings.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/engine/test_schema.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/smelt.yaml +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/bootstrap.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/billing/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/billing/application/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/billing/application/invoices.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/billing/domain/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/billing/domain/money.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/api/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/api/routes.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/application/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/application/ports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/application/session.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/domain/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/domain/session.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/infra/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/features/voice/infra/sql.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/main.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/shared/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/fixtures/gateway/src/gateway/shared/clock.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/helpers.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/model/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/model/test_architecture.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_composition_root.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_cycles.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_features.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_interfaces.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_layers.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/dependencies/test_third_party.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_assignments.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_contracts.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_coverage.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_enum_values.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_headers.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_import_style.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_layout.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_naming.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_package_imports.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/structure/test_type_dispatch.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/test_registry.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/__init__.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_awaits.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_cases.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_mocking.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_outcomes.py +0 -0
- {smelt_cli-0.2.0 → smelt_cli-0.3.0}/tests/rules/testing/test_private_access.py +0 -0
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
root = true
|
|
2
|
+
|
|
3
|
+
[*]
|
|
4
|
+
charset = utf-8
|
|
5
|
+
end_of_line = lf
|
|
6
|
+
insert_final_newline = true
|
|
7
|
+
trim_trailing_whitespace = true
|
|
8
|
+
indent_style = space
|
|
9
|
+
indent_size = 4
|
|
10
|
+
|
|
11
|
+
[*.{yml,yaml,json,toml}]
|
|
12
|
+
indent_size = 2
|
|
13
|
+
|
|
14
|
+
[*.md]
|
|
15
|
+
trim_trailing_whitespace = false
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
## Problem and resulting behavior
|
|
2
|
+
|
|
3
|
+
<!-- Minimal trigger, old/new result and a valid neighboring example. Link the issue. -->
|
|
4
|
+
|
|
5
|
+
## Policy and compatibility
|
|
6
|
+
|
|
7
|
+
<!-- Existing rule fix or new rule? Code/name, default/opt-in behavior, config changes,
|
|
8
|
+
false-positive boundaries, Python/layout assumptions. State "unchanged" if appropriate. -->
|
|
9
|
+
|
|
10
|
+
## Validation
|
|
11
|
+
|
|
12
|
+
<!-- Focused regression and commands/results. For real-project evaluation, record the
|
|
13
|
+
policy used and whether files changed. Note any checks you could not run. -->
|
|
14
|
+
|
|
15
|
+
## Catalog integration (when adding or changing a rule)
|
|
16
|
+
|
|
17
|
+
- [ ] Unique stable code/name; explicit registration and complete RuleDoc
|
|
18
|
+
- [ ] Regression and valid counterexample; portable fixtures
|
|
19
|
+
- [ ] Configuration/schema and agent context updated where applicable
|
|
20
|
+
- [ ] Generated files refreshed; catalog tests and architecture check pass
|
|
21
|
+
|
|
22
|
+
<!-- See CONTRIBUTING.md. Remove this checklist for changes unrelated to rules. -->
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
name: CI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
|
|
8
|
+
concurrency:
|
|
9
|
+
group: ${{ github.workflow }}-${{ github.ref }}
|
|
10
|
+
cancel-in-progress: true
|
|
11
|
+
|
|
12
|
+
jobs:
|
|
13
|
+
lint:
|
|
14
|
+
runs-on: ubuntu-latest
|
|
15
|
+
steps:
|
|
16
|
+
- uses: actions/checkout@v7
|
|
17
|
+
- uses: dtolnay/rust-toolchain@stable
|
|
18
|
+
with:
|
|
19
|
+
components: rustfmt, clippy
|
|
20
|
+
- uses: astral-sh/setup-uv@v7
|
|
21
|
+
with:
|
|
22
|
+
enable-cache: true
|
|
23
|
+
- uses: actions/cache@v6
|
|
24
|
+
with:
|
|
25
|
+
path: ~/.cache/prek
|
|
26
|
+
key: ${{ runner.os }}-prek-${{ hashFiles('.pre-commit-config.yml', 'uv.lock') }}
|
|
27
|
+
- run: uv sync --locked
|
|
28
|
+
- run: uv run prek run --all-files --show-diff-on-failure
|
|
29
|
+
|
|
30
|
+
test:
|
|
31
|
+
name: Test (Python ${{ matrix.python-version }}, ${{ matrix.os }})
|
|
32
|
+
runs-on: ${{ matrix.os }}
|
|
33
|
+
strategy:
|
|
34
|
+
fail-fast: false
|
|
35
|
+
matrix:
|
|
36
|
+
os: [ubuntu-latest, windows-latest, macos-latest]
|
|
37
|
+
python-version: ["3.12", "3.13", "3.14"]
|
|
38
|
+
env:
|
|
39
|
+
UV_PYTHON: ${{ matrix.python-version }}
|
|
40
|
+
steps:
|
|
41
|
+
- uses: actions/checkout@v7
|
|
42
|
+
- uses: dtolnay/rust-toolchain@stable
|
|
43
|
+
- uses: astral-sh/setup-uv@v7
|
|
44
|
+
with:
|
|
45
|
+
enable-cache: true
|
|
46
|
+
python-version: ${{ matrix.python-version }}
|
|
47
|
+
- run: uv sync --locked
|
|
48
|
+
- run: uv run pytest --cov --cov-report=term-missing
|
|
49
|
+
|
|
50
|
+
smelt:
|
|
51
|
+
runs-on: ubuntu-latest
|
|
52
|
+
steps:
|
|
53
|
+
- uses: actions/checkout@v7
|
|
54
|
+
- uses: dtolnay/rust-toolchain@stable
|
|
55
|
+
- uses: astral-sh/setup-uv@v7
|
|
56
|
+
with:
|
|
57
|
+
enable-cache: true
|
|
58
|
+
- uses: actions/cache@v6
|
|
59
|
+
with:
|
|
60
|
+
path: .smelt_cache
|
|
61
|
+
key: ${{ runner.os }}-smelt-v2-${{ hashFiles('uv.lock') }}-${{ github.sha }}
|
|
62
|
+
restore-keys: |
|
|
63
|
+
${{ runner.os }}-smelt-v2-${{ hashFiles('uv.lock') }}-
|
|
64
|
+
- run: uv sync --locked
|
|
65
|
+
- run: uv run smelt check --strict-coverage --fail-on warning --format github
|
|
66
|
+
|
|
67
|
+
package:
|
|
68
|
+
name: Package (${{ matrix.os }})
|
|
69
|
+
runs-on: ${{ matrix.os }}
|
|
70
|
+
strategy:
|
|
71
|
+
fail-fast: false
|
|
72
|
+
matrix:
|
|
73
|
+
os: [ubuntu-latest, windows-latest, macos-latest]
|
|
74
|
+
steps:
|
|
75
|
+
- uses: actions/checkout@v7
|
|
76
|
+
- uses: dtolnay/rust-toolchain@stable
|
|
77
|
+
- uses: astral-sh/setup-uv@v7
|
|
78
|
+
with:
|
|
79
|
+
python-version: "3.12"
|
|
80
|
+
- run: uv build
|
|
81
|
+
- name: Install and smoke-test the built wheel outside the checkout
|
|
82
|
+
run: |
|
|
83
|
+
uv run --no-project --python 3.12 python scripts/smoke_distribution.py dist
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
name: Publish to PyPI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
tags: ["v*"]
|
|
6
|
+
workflow_dispatch:
|
|
7
|
+
|
|
8
|
+
permissions: {}
|
|
9
|
+
|
|
10
|
+
concurrency:
|
|
11
|
+
group: pypi-${{ github.ref }}
|
|
12
|
+
cancel-in-progress: false
|
|
13
|
+
|
|
14
|
+
jobs:
|
|
15
|
+
build:
|
|
16
|
+
name: Validate and build distributions
|
|
17
|
+
if: github.ref_type == 'tag' && startsWith(github.ref_name, 'v')
|
|
18
|
+
runs-on: ubuntu-latest
|
|
19
|
+
permissions:
|
|
20
|
+
contents: read
|
|
21
|
+
env:
|
|
22
|
+
UV_PYTHON: "3.12"
|
|
23
|
+
steps:
|
|
24
|
+
- uses: actions/checkout@v7
|
|
25
|
+
with:
|
|
26
|
+
fetch-depth: 0
|
|
27
|
+
persist-credentials: false
|
|
28
|
+
- uses: dtolnay/rust-toolchain@stable
|
|
29
|
+
with:
|
|
30
|
+
components: rustfmt, clippy
|
|
31
|
+
- uses: astral-sh/setup-uv@v7
|
|
32
|
+
with:
|
|
33
|
+
python-version: "3.12"
|
|
34
|
+
enable-cache: false
|
|
35
|
+
- name: Require a release commit from main
|
|
36
|
+
run: git merge-base --is-ancestor HEAD origin/main
|
|
37
|
+
- run: uv sync --locked
|
|
38
|
+
- name: Require the tag to match the package version
|
|
39
|
+
run: |
|
|
40
|
+
uv run --frozen python - <<'PY'
|
|
41
|
+
import os
|
|
42
|
+
import tomllib
|
|
43
|
+
from pathlib import Path
|
|
44
|
+
|
|
45
|
+
project = tomllib.loads(Path("pyproject.toml").read_text())["project"]
|
|
46
|
+
cargo = tomllib.loads(Path("Cargo.toml").read_text())["package"]
|
|
47
|
+
if project["version"] != cargo["version"]:
|
|
48
|
+
raise SystemExit("Python and native package versions differ")
|
|
49
|
+
expected_tag = f"v{project['version']}"
|
|
50
|
+
actual_tag = os.environ["GITHUB_REF_NAME"]
|
|
51
|
+
if actual_tag != expected_tag:
|
|
52
|
+
raise SystemExit(f"Expected tag {expected_tag!r}, got {actual_tag!r}")
|
|
53
|
+
PY
|
|
54
|
+
- run: uv run --frozen prek run --all-files --show-diff-on-failure
|
|
55
|
+
- run: uv run --frozen pytest
|
|
56
|
+
- run: uv run --frozen smelt check --strict-coverage --fail-on warning
|
|
57
|
+
- run: uv build --no-sources --sdist
|
|
58
|
+
- name: Install and smoke-test the source distribution
|
|
59
|
+
run: uv run --frozen python scripts/smoke_distribution.py dist
|
|
60
|
+
- uses: actions/upload-artifact@v7
|
|
61
|
+
with:
|
|
62
|
+
name: python-distributions-source
|
|
63
|
+
path: dist/
|
|
64
|
+
if-no-files-found: error
|
|
65
|
+
|
|
66
|
+
wheels:
|
|
67
|
+
name: Wheel (${{ matrix.target }})
|
|
68
|
+
needs: build
|
|
69
|
+
runs-on: ${{ matrix.os }}
|
|
70
|
+
permissions:
|
|
71
|
+
contents: read
|
|
72
|
+
strategy:
|
|
73
|
+
fail-fast: false
|
|
74
|
+
matrix:
|
|
75
|
+
include:
|
|
76
|
+
- os: ubuntu-latest
|
|
77
|
+
target: x86_64-unknown-linux-gnu
|
|
78
|
+
smoke: true
|
|
79
|
+
- os: ubuntu-latest
|
|
80
|
+
target: aarch64-unknown-linux-gnu
|
|
81
|
+
- os: windows-latest
|
|
82
|
+
target: x86_64-pc-windows-msvc
|
|
83
|
+
smoke: true
|
|
84
|
+
- os: macos-latest
|
|
85
|
+
target: aarch64-apple-darwin
|
|
86
|
+
smoke: true
|
|
87
|
+
- os: macos-latest
|
|
88
|
+
target: x86_64-apple-darwin
|
|
89
|
+
steps:
|
|
90
|
+
- uses: actions/checkout@v7
|
|
91
|
+
with:
|
|
92
|
+
persist-credentials: false
|
|
93
|
+
- uses: PyO3/maturin-action@v1
|
|
94
|
+
with:
|
|
95
|
+
command: build
|
|
96
|
+
target: ${{ matrix.target }}
|
|
97
|
+
manylinux: '2_28'
|
|
98
|
+
args: --release --locked --out dist --compatibility pypi
|
|
99
|
+
- uses: astral-sh/setup-uv@v7
|
|
100
|
+
if: matrix.smoke
|
|
101
|
+
with:
|
|
102
|
+
python-version: "3.12"
|
|
103
|
+
- name: Install and smoke-test the release wheel outside the checkout
|
|
104
|
+
if: matrix.smoke
|
|
105
|
+
run: uv run --no-project --python 3.12 python scripts/smoke_distribution.py dist
|
|
106
|
+
- uses: actions/upload-artifact@v7
|
|
107
|
+
with:
|
|
108
|
+
name: python-distributions-${{ matrix.target }}
|
|
109
|
+
path: dist/*.whl
|
|
110
|
+
if-no-files-found: error
|
|
111
|
+
|
|
112
|
+
publish:
|
|
113
|
+
name: Publish distributions to PyPI
|
|
114
|
+
needs: [build, wheels]
|
|
115
|
+
runs-on: ubuntu-latest
|
|
116
|
+
environment:
|
|
117
|
+
name: pypi
|
|
118
|
+
url: https://pypi.org/project/smelt-cli/
|
|
119
|
+
permissions:
|
|
120
|
+
id-token: write
|
|
121
|
+
steps:
|
|
122
|
+
- uses: actions/download-artifact@v8
|
|
123
|
+
with:
|
|
124
|
+
pattern: python-distributions-*
|
|
125
|
+
merge-multiple: true
|
|
126
|
+
path: dist/
|
|
127
|
+
- name: Publish with PyPI Trusted Publishing
|
|
128
|
+
uses: pypa/gh-action-pypi-publish@release/v1
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Byte-compiled / cache
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
|
|
5
|
+
# Virtual environments
|
|
6
|
+
.venv/
|
|
7
|
+
|
|
8
|
+
# Build artifacts
|
|
9
|
+
build/
|
|
10
|
+
dist/
|
|
11
|
+
target/
|
|
12
|
+
*.egg-info/
|
|
13
|
+
|
|
14
|
+
# Tooling caches
|
|
15
|
+
.mypy_cache/
|
|
16
|
+
.ruff_cache/
|
|
17
|
+
.pytest_cache/
|
|
18
|
+
.smelt_cache/
|
|
19
|
+
|
|
20
|
+
# Coverage
|
|
21
|
+
.coverage
|
|
22
|
+
.coverage.*
|
|
23
|
+
htmlcov/
|
|
24
|
+
coverage.xml
|
|
25
|
+
|
|
26
|
+
# Environment / secrets
|
|
27
|
+
.env
|
|
28
|
+
.env.*
|
|
29
|
+
!.env.example
|
|
30
|
+
|
|
31
|
+
# Editors / OS
|
|
32
|
+
.idea/
|
|
33
|
+
.vscode/
|
|
34
|
+
.DS_Store
|
|
35
|
+
Thumbs.db
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
default_install_hook_types: [pre-commit, commit-msg]
|
|
2
|
+
default_stages: [pre-commit]
|
|
3
|
+
|
|
4
|
+
repos:
|
|
5
|
+
- repo: https://github.com/pre-commit/pre-commit-hooks
|
|
6
|
+
rev: v6.0.0
|
|
7
|
+
hooks:
|
|
8
|
+
- id: trailing-whitespace
|
|
9
|
+
- id: end-of-file-fixer
|
|
10
|
+
- id: mixed-line-ending
|
|
11
|
+
args: [--fix=lf]
|
|
12
|
+
- id: check-yaml
|
|
13
|
+
- id: check-toml
|
|
14
|
+
- id: check-json
|
|
15
|
+
- id: check-added-large-files
|
|
16
|
+
- id: check-merge-conflict
|
|
17
|
+
- id: check-case-conflict
|
|
18
|
+
- id: debug-statements
|
|
19
|
+
- id: detect-private-key
|
|
20
|
+
|
|
21
|
+
- repo: https://github.com/astral-sh/uv-pre-commit
|
|
22
|
+
rev: 0.12.15
|
|
23
|
+
hooks:
|
|
24
|
+
- id: uv-lock
|
|
25
|
+
|
|
26
|
+
- repo: https://github.com/astral-sh/ruff-pre-commit
|
|
27
|
+
rev: v0.16.8
|
|
28
|
+
hooks:
|
|
29
|
+
- id: ruff-check
|
|
30
|
+
args: [--fix]
|
|
31
|
+
- id: ruff-format
|
|
32
|
+
|
|
33
|
+
- repo: local
|
|
34
|
+
hooks:
|
|
35
|
+
- id: cargo-fmt
|
|
36
|
+
name: cargo fmt
|
|
37
|
+
entry: cargo fmt --all -- --check
|
|
38
|
+
language: system
|
|
39
|
+
files: '(^Cargo\.(toml|lock)$|\.rs$)'
|
|
40
|
+
pass_filenames: false
|
|
41
|
+
- id: cargo-clippy
|
|
42
|
+
name: cargo clippy
|
|
43
|
+
entry: cargo clippy --locked --all-targets -- -D warnings
|
|
44
|
+
language: system
|
|
45
|
+
files: '(^Cargo\.(toml|lock)$|\.rs$)'
|
|
46
|
+
pass_filenames: false
|
|
47
|
+
- id: mypy
|
|
48
|
+
name: mypy
|
|
49
|
+
entry: uv run --frozen mypy
|
|
50
|
+
language: system
|
|
51
|
+
types: [python]
|
|
52
|
+
pass_filenames: false
|
|
53
|
+
require_serial: true
|
|
54
|
+
- id: smelt
|
|
55
|
+
name: smelt
|
|
56
|
+
entry: uv run --frozen smelt check --staged --fail-on warning
|
|
57
|
+
language: system
|
|
58
|
+
always_run: true
|
|
59
|
+
pass_filenames: false
|
|
60
|
+
require_serial: true
|
|
61
|
+
|
|
62
|
+
- repo: https://github.com/compilerla/conventional-pre-commit
|
|
63
|
+
rev: v4.4.0
|
|
64
|
+
hooks:
|
|
65
|
+
- id: conventional-pre-commit
|
|
66
|
+
stages: [commit-msg]
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
- id: smelt
|
|
2
|
+
name: smelt
|
|
3
|
+
description: Check Python architecture boundaries against smelt.yaml.
|
|
4
|
+
entry: smelt check
|
|
5
|
+
language: python
|
|
6
|
+
pass_filenames: false
|
|
7
|
+
files: '(\.py|smelt\.ya?ml)$'
|
|
8
|
+
require_serial: true
|
|
9
|
+
- id: smelt-staged
|
|
10
|
+
name: smelt (new staged findings)
|
|
11
|
+
description: Review new architecture and maintainability findings in the Git index.
|
|
12
|
+
entry: smelt check --staged --fail-on warning
|
|
13
|
+
language: python
|
|
14
|
+
pass_filenames: false
|
|
15
|
+
always_run: true
|
|
16
|
+
require_serial: true
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
3.14
|
|
@@ -7,6 +7,104 @@ current configuration and complete rule contracts, see the [README](README.md),
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.3.0] - 2026-11-01
|
|
11
|
+
|
|
12
|
+
### Upgrade first
|
|
13
|
+
|
|
14
|
+
**JSON consumers need an update.** Check and error documents now use schema 2.
|
|
15
|
+
Request `--show-coverage` for full coverage details and resolve
|
|
16
|
+
`expected.usage_scope_index` through the report's `usage_scopes` array. This is
|
|
17
|
+
a report-format change; YAML stays `version: 1`, and default rules, exit codes,
|
|
18
|
+
SMT codes and debt identities stay unchanged. See the
|
|
19
|
+
[upgrade checklist and compatible parser example](docs/upgrading.md).
|
|
20
|
+
|
|
21
|
+
Update tool, dependency, hook and CI pins together to `0.3.0` (Git tag `v0.3.0`),
|
|
22
|
+
then refresh `.smelt.schema.json`. Upgrading from 0.1.x also requires the
|
|
23
|
+
[configuration migration](docs/configuration.md#breaking-change-migration).
|
|
24
|
+
|
|
25
|
+
### New capabilities
|
|
26
|
+
|
|
27
|
+
| Capability | Enable / use | Details |
|
|
28
|
+
| --- | --- | --- |
|
|
29
|
+
| Review widely imported names missing from a package facade | Set a contract's `export_at` threshold; opt-in, hint severity | [SMT109](docs/rules/SMT109.md) |
|
|
30
|
+
| Review internal public constants and PEP 695 aliases | `rules: {internal-public-module-symbol: warning}`; opt-in | [SMT320](docs/rules/SMT320.md) |
|
|
31
|
+
| Get one-line findings with repair advice | `smelt check --format concise` | [CLI and reports](docs/cli.md) |
|
|
32
|
+
| Migrate existing installations and report consumers | Follow the release-specific checklist | [Upgrading](docs/upgrading.md) |
|
|
33
|
+
|
|
34
|
+
### Ordering and module visibility
|
|
35
|
+
|
|
36
|
+
- SMT313 now recognizes unions of unshadowed builtin types and `None` in eager
|
|
37
|
+
function annotations for declared Python 3.10+ targets, so a helper annotated
|
|
38
|
+
`str | bytes` no longer silently blocks public-first ordering on Python 3.12/3.13.
|
|
39
|
+
Imported/user-defined operands, shadowed names, explicit namespace mutations and unions in defaults remain
|
|
40
|
+
execution barriers. Inspect barriers with `check --format json --show-coverage`.
|
|
41
|
+
- New opt-in [SMT320](docs/rules/SMT320.md) `internal-public-module-symbol`
|
|
42
|
+
reviews single, unconditional uppercase module assignments and PEP 695 type
|
|
43
|
+
aliases with no observed external use or public-signature evidence. Enable it
|
|
44
|
+
with `rules: {internal-public-module-symbol: warning}` or `--select SMT320`.
|
|
45
|
+
Exports, imports/re-exports, test accesses, escaped modules and public annotation
|
|
46
|
+
dependencies preserve names. Dynamic namespaces and uncertain bindings are
|
|
47
|
+
skipped; external consumers remain unassessed. No automatic renaming.
|
|
48
|
+
- SMT311/SMT313 explanations clarify that Python 3.12/3.13 projects can retain
|
|
49
|
+
an annotations future import for forward references in their chosen public-first
|
|
50
|
+
order. Eager dependencies still take priority when the import is absent. `Self`
|
|
51
|
+
requires a subclass-preserving return contract; no automatic replacement of a
|
|
52
|
+
matching class-name annotation is suggested. See [definition ordering](docs/structure.md#definition-order-with-execution-dependencies).
|
|
53
|
+
|
|
54
|
+
### Test evidence and package contracts
|
|
55
|
+
|
|
56
|
+
- Opt-in SMT424/SMT425/SMT426 outcome and deadline reviews follow one direct call
|
|
57
|
+
to an unambiguous, undecorated, non-generator helper in the same file, including local async
|
|
58
|
+
helpers executed with `await` or `asyncio.run`. Assertions retain empty-loop
|
|
59
|
+
review, and hidden unbounded operations report their helper and call site.
|
|
60
|
+
Caller async deadlines guard async waits, never synchronous subprocesses.
|
|
61
|
+
Uncalled definitions, unexecuted coroutines, callbacks, imported helper bodies
|
|
62
|
+
and further helper calls remain outside inference; configured assertion helpers
|
|
63
|
+
continue to work. No analyzed code is executed.
|
|
64
|
+
- Overlapping test roots consistently assign a test to the most specific declared
|
|
65
|
+
root, independent of configuration order. Mirror checks retain separate
|
|
66
|
+
workspace-member roots.
|
|
67
|
+
- Package contracts can set `export_at` for SMT109 `facade-export-gap`: one
|
|
68
|
+
advisory finding per widely imported implementation name missing from its
|
|
69
|
+
facade, with definition location, importer lists, other re-exports and a bounded
|
|
70
|
+
cycle check. Tests count only with `count_tests: true`; type-checking-only
|
|
71
|
+
imports and uncertain exports are skipped. No automatic API or import changes.
|
|
72
|
+
See [facade reviews](docs/structure.md#suggestions-to-bundle-implementation-imports).
|
|
73
|
+
- Overlapping SMT108/SMT109 thresholds now choose the most specific pattern per
|
|
74
|
+
concrete package, removing duplicate hints and allowing exact overrides of
|
|
75
|
+
wildcard contracts. Equally specific conflicting settings are config errors.
|
|
76
|
+
|
|
77
|
+
### Reports, suppressions and fixes
|
|
78
|
+
|
|
79
|
+
- **JSON report schema 2:** `check --format json` emits a small coverage summary
|
|
80
|
+
by default; `--show-coverage` restores full policy details and the per-file
|
|
81
|
+
inventory. Repeated visibility boundaries move to report-level `usage_scopes`,
|
|
82
|
+
referenced by each finding's `expected.usage_scope_index`. Scope, comparison,
|
|
83
|
+
warnings and exit thresholds remain available. See [report compatibility](docs/cli.md).
|
|
84
|
+
- `check --format concise` prints one line per finding with repair advice.
|
|
85
|
+
Text omits empty details, prints visibility limits once, and groups related
|
|
86
|
+
late-import SMT313 findings with their affected lines. JSON keeps individual
|
|
87
|
+
findings plus an `ordering` group; debt fingerprints are retained.
|
|
88
|
+
- Inline suppressions follow logical continuation lines, including interior
|
|
89
|
+
comments in multiline assertions, formatted calls and signatures. Interior
|
|
90
|
+
import-name exceptions stay local and never cover neighboring names, the next
|
|
91
|
+
statement or a function body. Unused-suppression checks remain active. See
|
|
92
|
+
[suppression scope](docs/adoption.md).
|
|
93
|
+
- Visibility rules preserve public members of classes exported through static
|
|
94
|
+
package facades or `__all__`, including aliases and re-export chains; cache
|
|
95
|
+
invalidation tracks export changes. SMT429 distinguishes functions referenced
|
|
96
|
+
only by tests from helpers also used inside their module, without claiming
|
|
97
|
+
unassessed external consumers do not exist.
|
|
98
|
+
- Cache directories ignore their own contents. Init reports the number of tests
|
|
99
|
+
matching a mirror pattern, and ordinary text checks omit the policy coverage
|
|
100
|
+
banner without architecture (strict coverage still applies). Hook documentation
|
|
101
|
+
uses a pinned wheel installation and explains source-build requirements.
|
|
102
|
+
SMT311/SMT318 explanations clarify decorated annotations and Literal-typed
|
|
103
|
+
boundaries; SMT426's subprocess example explicitly sets `check=False`.
|
|
104
|
+
- Release checks enforce matching Python/native/lockfile versions, dated release
|
|
105
|
+
notes and current installation pins. Publication also waits for installation
|
|
106
|
+
smoke tests of the exact Linux x86_64, Windows x86_64 and macOS aarch64 wheels.
|
|
107
|
+
|
|
10
108
|
## [0.2.0] - 2026-10-31
|
|
11
109
|
|
|
12
110
|
- Visibility reviews (SMT316/SMT317/SMT429/SMT430) explicitly limit their claims to
|
|
@@ -326,7 +424,8 @@ smelt explain SMT313 --format json
|
|
|
326
424
|
- Import fanout, match suggestions and missing-assertion checks are review aids;
|
|
327
425
|
their default severities differ. Configure policy and severity deliberately.
|
|
328
426
|
|
|
329
|
-
[Unreleased]: https://github.com/mathisarends/smelt/compare/v0.
|
|
427
|
+
[Unreleased]: https://github.com/mathisarends/smelt/compare/v0.3.0...HEAD
|
|
428
|
+
[0.3.0]: https://github.com/mathisarends/smelt/compare/v0.2.0...v0.3.0
|
|
330
429
|
[0.2.0]: https://github.com/mathisarends/smelt/compare/v0.1.6...v0.2.0
|
|
331
430
|
[0.1.6]: https://github.com/mathisarends/smelt/compare/v0.1.5...v0.1.6
|
|
332
431
|
[0.1.5]: https://github.com/mathisarends/smelt/compare/v0.1.4...v0.1.5
|
|
@@ -256,18 +256,21 @@ environment name must match the workflow exactly.
|
|
|
256
256
|
|
|
257
257
|
### Release procedure
|
|
258
258
|
|
|
259
|
-
1.
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
259
|
+
1. Review changes since the last tag. Update the [upgrade guide](docs/upgrading.md),
|
|
260
|
+
README feature summary and pinned hook/CI examples in
|
|
261
|
+
[integrations](docs/integrations.md), including any report-format migration.
|
|
262
|
+
Move `Unreleased` entries to a dated version section and update the changelog's
|
|
263
|
+
comparison links. Bump matching versions in `pyproject.toml` and `Cargo.toml`,
|
|
264
|
+
run `uv lock` and `cargo check` to refresh both lockfiles, and merge the release
|
|
265
|
+
preparation into `main` after CI passes. Each release needs a new PyPI version.
|
|
263
266
|
2. From an up-to-date, clean `main` checkout, create and push the corresponding tag.
|
|
264
|
-
For example, after merging version `0.
|
|
267
|
+
For example, after merging version `0.3.0`:
|
|
265
268
|
|
|
266
269
|
```bash
|
|
267
270
|
git switch main
|
|
268
271
|
git pull --ff-only
|
|
269
|
-
git tag v0.
|
|
270
|
-
git push origin v0.
|
|
272
|
+
git tag v0.3.0
|
|
273
|
+
git push origin v0.3.0
|
|
271
274
|
```
|
|
272
275
|
|
|
273
276
|
3. Follow the `Publish to PyPI` run in
|
|
@@ -276,14 +279,16 @@ environment name must match the workflow exactly.
|
|
|
276
279
|
to equal `v` followed by the package version. It runs prek, pytest and
|
|
277
280
|
Smelt, validates a source distribution outside the checkout, then builds native
|
|
278
281
|
Linux x86_64/aarch64, Windows x86_64 and macOS x86_64/aarch64 wheels. CI also
|
|
279
|
-
installs and exercises native wheels on Linux, Windows and macOS.
|
|
280
|
-
|
|
282
|
+
installs and exercises native wheels on Linux, Windows and macOS. The release
|
|
283
|
+
workflow also smoke-tests its exact Linux x86_64, Windows x86_64 and macOS
|
|
284
|
+
aarch64 wheels before uploading them for publication; the other targets are
|
|
285
|
+
cross-compiled. A separate job downloads the validated release artifacts and publishes them
|
|
281
286
|
with OIDC and the publishing action's default attestations enabled.
|
|
282
287
|
|
|
283
288
|
Maintainers and coding agents with permission to push release tags can use this
|
|
284
289
|
procedure without local PyPI credentials. Ordinary branch pushes and pull requests
|
|
285
290
|
do not publish. Manual workflow runs must select an existing `v`-prefixed tag
|
|
286
|
-
(`gh workflow run release.yml --ref v0.
|
|
291
|
+
(`gh workflow run release.yml --ref v0.3.0`); branch runs skip publishing.
|
|
287
292
|
|
|
288
293
|
If the upload fails because account configuration is missing, finish that setup
|
|
289
294
|
and rerun the failed publishing job so it reuses the validated build artifacts.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: smelt-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.3.0
|
|
4
4
|
Requires-Dist: grimp>=3.17
|
|
5
5
|
Requires-Dist: packaging>=24.2
|
|
6
6
|
Requires-Dist: pydantic>=2.13.5
|
|
@@ -38,6 +38,18 @@ The [rule catalog](docs/rules/README.md) lists each check, its activation and
|
|
|
38
38
|
default severity. Most rules are opt-in; a declared architecture, package or
|
|
39
39
|
test policy activates the corresponding checks. See [rule activation](docs/rule-selection.md).
|
|
40
40
|
|
|
41
|
+
## What's new in 0.3.0
|
|
42
|
+
|
|
43
|
+
- Review missing package exports with opt-in **SMT109**, and internal constants
|
|
44
|
+
and type aliases with opt-in **SMT320**.
|
|
45
|
+
- Use `--format concise` for short feedback. JSON reports now use **schema 2**;
|
|
46
|
+
integrations must resolve shared usage scopes and request full coverage explicitly.
|
|
47
|
+
- Get more precise definition ordering, public-API preservation, multiline
|
|
48
|
+
suppressions and outcome/deadline checks through directly executed test helpers.
|
|
49
|
+
|
|
50
|
+
See the [upgrade guide](docs/upgrading.md) for required steps, copyable examples
|
|
51
|
+
and changes in findings, or the [changelog](CHANGELOG.md#030---2026-11-01) for details.
|
|
52
|
+
|
|
41
53
|
## Quick start
|
|
42
54
|
|
|
43
55
|
Smelt requires Python 3.12 or newer. Install the `smelt-cli` package (the
|
|
@@ -23,6 +23,18 @@ The [rule catalog](docs/rules/README.md) lists each check, its activation and
|
|
|
23
23
|
default severity. Most rules are opt-in; a declared architecture, package or
|
|
24
24
|
test policy activates the corresponding checks. See [rule activation](docs/rule-selection.md).
|
|
25
25
|
|
|
26
|
+
## What's new in 0.3.0
|
|
27
|
+
|
|
28
|
+
- Review missing package exports with opt-in **SMT109**, and internal constants
|
|
29
|
+
and type aliases with opt-in **SMT320**.
|
|
30
|
+
- Use `--format concise` for short feedback. JSON reports now use **schema 2**;
|
|
31
|
+
integrations must resolve shared usage scopes and request full coverage explicitly.
|
|
32
|
+
- Get more precise definition ordering, public-API preservation, multiline
|
|
33
|
+
suppressions and outcome/deadline checks through directly executed test helpers.
|
|
34
|
+
|
|
35
|
+
See the [upgrade guide](docs/upgrading.md) for required steps, copyable examples
|
|
36
|
+
and changes in findings, or the [changelog](CHANGELOG.md#030---2026-11-01) for details.
|
|
37
|
+
|
|
26
38
|
## Quick start
|
|
27
39
|
|
|
28
40
|
Smelt requires Python 3.12 or newer. Install the `smelt-cli` package (the
|
|
@@ -5,6 +5,7 @@ guide for the decision or task at hand:
|
|
|
5
5
|
|
|
6
6
|
| If you want to... | Read |
|
|
7
7
|
| --- | --- |
|
|
8
|
+
| See new features and migrate from an earlier release | [Upgrading Smelt](upgrading.md) and the [changelog](../CHANGELOG.md) |
|
|
8
9
|
| Describe boundaries, features, layers or strict policy coverage | [Architecture as code](architecture.md) |
|
|
9
10
|
| Define package interfaces and source conventions | [Package contracts and source conventions](structure.md) |
|
|
10
11
|
| Configure test layout and quality checks | [Test policies](testing.md) |
|
|
@@ -35,6 +35,13 @@ Silence a single finding inline, always with a reason:
|
|
|
35
35
|
from gateway.infra.sql import Repo # smelt: ignore[SMT101] -- migration tracked in #123
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
+
Comments within a logical statement cover that statement,
|
|
39
|
+
including its continuation lines, so formatting a long call or signature does
|
|
40
|
+
not invalidate the exception. The scope ends before the next statement; a
|
|
41
|
+
comment on a function signature does not cover its body. Comments beside an
|
|
42
|
+
individual name inside a multiline import stay local to that name's line, so
|
|
43
|
+
neighboring private imports still receive review.
|
|
44
|
+
|
|
38
45
|
Every rule has a page under [docs/rules](rules/). `smelt init` writes a local
|
|
39
46
|
editor schema with completion, validation and bad/good hover examples derived
|
|
40
47
|
from that same catalog. See [editor setup](configuration.md#editor-completion-hover-and-validation).
|