sarj-python-lint 0.23.0__tar.gz → 0.25.0__tar.gz

{sarj_python_lint-0.23.0 → sarj_python_lint-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sarj-python-lint
-Version: 0.23.0
+Version: 0.25.0
 Summary: Custom Python lint rules — AST-based, pre-commit-friendly, hypermodern defaults
 Project-URL: Homepage, https://github.com/sarj-ai/standards/tree/main/packages/python
 Project-URL: Repository, https://github.com/sarj-ai/standards
@@ -28,7 +28,7 @@ uv tool install sarj-python-lint
 
 ```yaml
 - repo: https://github.com/sarj-ai/standards
-  rev: python-v0.2.0
+  rev: python-v0.24.0
   hooks:
     - id: sarj-no-sequential-await
     - id: sarj-inefficient-string-concat-in-loop
@@ -40,6 +40,7 @@ uv tool install sarj-python-lint
     - id: sarj-prefer-struct-over-namedtuple
     - id: sarj-no-comment-cruft
     - id: sarj-no-fstring-in-log
+    - id: sarj-prefer-non-nullable-collection      # SARJ074
 ```
 
 ### Test-quality rules (0.15.0)
@@ -146,6 +147,37 @@ decisions into one unreviewable one and pre-authorizes every mock added later.
 Scoped exemptions for mechanical codes (`E501`, `F401`, `UP035`) are never
 flagged — measured across five repos those are the entire population.
 
+
+### Mock-quality and real-dependency rules (0.24.0)
+
+The second test-quality wave. Where the 0.15.0 family asks "does this test assert
+anything?", this one asks "does it exercise anything real?" — it pushes suites off
+hand-rolled doubles and onto the real store, the real database and a maintained fake
+library. Measured against bulbul, noura-be, five other first-party repos and fourteen
+OSS corpora; two candidates were dropped outright when the corpus showed they only
+duplicated ruff.
+
+```yaml
+    - id: sarj-prefer-real-store-in-tests          # SARJ058
+    - id: sarj-prefer-library-fake                 # SARJ059
+    - id: sarj-tautological-mock-assertion         # SARJ060
+    - id: sarj-no-patching-system-under-test       # SARJ061
+    - id: sarj-over-mocked-test                    # SARJ062
+    - id: sarj-interaction-only-test               # SARJ063
+    - id: sarj-trivially-true-assertion            # SARJ064
+    - id: sarj-conditional-assertion-in-test       # SARJ065
+    - id: sarj-duplicate-test-body                 # SARJ066
+    - id: sarj-unused-mock-setup                   # SARJ067
+```
+
+### Expressiveness rules (0.24.0)
+
+```yaml
+    - id: sarj-prefer-fstring-over-concat          # SARJ068
+    - id: sarj-prefer-match-pattern-destructuring  # SARJ069
+    - id: sarj-prefer-or-pattern                   # SARJ070
+    - id: sarj-require-port-for-service            # SARJ071
+```
 ### Suppression ratchet (`sarj-ratchet`, 0.21.0)
 
 ```yaml
@@ -196,7 +228,7 @@ sarj-python-lint check --rule mock-without-spec --update-baseline test-quality-b
 sarj-python-lint check --rule mock-without-spec --baseline test-quality-baseline.json python/
 ```
 
-### Multi-tenant scoping (0.22.0)
+### Multi-tenant scoping (0.24.0)
 
 ```yaml
     - id: sarj-no-optional-tenant-predicate        # SARJ056

{sarj_python_lint-0.23.0 → sarj_python_lint-0.25.0}/README.md

@@ -10,7 +10,7 @@ uv tool install sarj-python-lint
 
 ```yaml
 - repo: https://github.com/sarj-ai/standards
-  rev: python-v0.2.0
+  rev: python-v0.24.0
   hooks:
     - id: sarj-no-sequential-await
     - id: sarj-inefficient-string-concat-in-loop
@@ -22,6 +22,7 @@ uv tool install sarj-python-lint
     - id: sarj-prefer-struct-over-namedtuple
     - id: sarj-no-comment-cruft
     - id: sarj-no-fstring-in-log
+    - id: sarj-prefer-non-nullable-collection      # SARJ074
 ```
 
 ### Test-quality rules (0.15.0)
@@ -128,6 +129,37 @@ decisions into one unreviewable one and pre-authorizes every mock added later.
 Scoped exemptions for mechanical codes (`E501`, `F401`, `UP035`) are never
 flagged — measured across five repos those are the entire population.
 
+
+### Mock-quality and real-dependency rules (0.24.0)
+
+The second test-quality wave. Where the 0.15.0 family asks "does this test assert
+anything?", this one asks "does it exercise anything real?" — it pushes suites off
+hand-rolled doubles and onto the real store, the real database and a maintained fake
+library. Measured against bulbul, noura-be, five other first-party repos and fourteen
+OSS corpora; two candidates were dropped outright when the corpus showed they only
+duplicated ruff.
+
+```yaml
+    - id: sarj-prefer-real-store-in-tests          # SARJ058
+    - id: sarj-prefer-library-fake                 # SARJ059
+    - id: sarj-tautological-mock-assertion         # SARJ060
+    - id: sarj-no-patching-system-under-test       # SARJ061
+    - id: sarj-over-mocked-test                    # SARJ062
+    - id: sarj-interaction-only-test               # SARJ063
+    - id: sarj-trivially-true-assertion            # SARJ064
+    - id: sarj-conditional-assertion-in-test       # SARJ065
+    - id: sarj-duplicate-test-body                 # SARJ066
+    - id: sarj-unused-mock-setup                   # SARJ067
+```
+
+### Expressiveness rules (0.24.0)
+
+```yaml
+    - id: sarj-prefer-fstring-over-concat          # SARJ068
+    - id: sarj-prefer-match-pattern-destructuring  # SARJ069
+    - id: sarj-prefer-or-pattern                   # SARJ070
+    - id: sarj-require-port-for-service            # SARJ071
+```
 ### Suppression ratchet (`sarj-ratchet`, 0.21.0)
 
 ```yaml
@@ -178,7 +210,7 @@ sarj-python-lint check --rule mock-without-spec --update-baseline test-quality-b
 sarj-python-lint check --rule mock-without-spec --baseline test-quality-baseline.json python/
 ```
 
-### Multi-tenant scoping (0.22.0)
+### Multi-tenant scoping (0.24.0)
 
 ```yaml
     - id: sarj-no-optional-tenant-predicate        # SARJ056

{sarj_python_lint-0.23.0 → sarj_python_lint-0.25.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sarj-python-lint"
-version = "0.23.0"
+version = "0.25.0"
 description = "Custom Python lint rules — AST-based, pre-commit-friendly, hypermodern defaults"
 readme = "README.md"
 authors = [{ name = "sarj-ai" }]

{sarj_python_lint-0.23.0 → sarj_python_lint-0.25.0}/src/sarj_python_lint/rules/_registry.py

@@ -2,10 +2,13 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from sarj_python_lint.rules.conditional_assertion_in_test import ConditionalAssertionInTest
+from sarj_python_lint.rules.duplicate_test_body import DuplicateTestBody
 from sarj_python_lint.rules.fixture_returns_bare_tuple import FixtureReturnsBareTuple
 from sarj_python_lint.rules.inefficient_string_concat_in_loop import (
     InefficientStringConcatInLoop,
 )
+from sarj_python_lint.rules.interaction_only_test import InteractionOnlyTest
 from sarj_python_lint.rules.kwarg_heavy_construction_in_test import KwargHeavyConstructionInTest
 from sarj_python_lint.rules.kwonly_same_type_params import KwonlySameTypeParams
 from sarj_python_lint.rules.mock_without_spec import MockWithoutSpec
@@ -29,6 +32,7 @@ from sarj_python_lint.rules.no_offset_pagination import NoOffsetPagination
 from sarj_python_lint.rules.no_optional_tenant_predicate import (
     NoOptionalTenantPredicate,
 )
+from sarj_python_lint.rules.no_patching_system_under_test import NoPatchingSystemUnderTest
 from sarj_python_lint.rules.no_query_with_many_joins import NoQueryWithManyJoins
 from sarj_python_lint.rules.no_raw_sql_in_tests import NoRawSqlInTests
 from sarj_python_lint.rules.no_repeated_string_literal import NoRepeatedStringLiteral
@@ -43,18 +47,27 @@ from sarj_python_lint.rules.no_tautological_expect import NoTautologicalExpect
 from sarj_python_lint.rules.no_unreachable_after_terminal import (
     NoUnreachableAfterTerminal,
 )
+from sarj_python_lint.rules.over_mocked_test import OverMockedTest
 from sarj_python_lint.rules.parametrize_case_needs_id import ParametrizeCaseNeedsId
 from sarj_python_lint.rules.prefer_class_row import PreferClassRow
 from sarj_python_lint.rules.prefer_constant_time_secret_compare import (
     PreferConstantTimeSecretCompare,
 )
+from sarj_python_lint.rules.prefer_fstring_over_concat import PreferFstringOverConcat
+from sarj_python_lint.rules.prefer_library_fake import PreferLibraryFake
 from sarj_python_lint.rules.prefer_match_assert_never import PreferMatchAssertNever
+from sarj_python_lint.rules.prefer_match_pattern_destructuring import PreferMatchPatternDestructuring
 from sarj_python_lint.rules.prefer_module_level_constant import (
     PreferModuleLevelConstant,
 )
 from sarj_python_lint.rules.prefer_namedtuple_over_tuple_return import (
     PreferNamedtupleOverTupleReturn,
 )
+from sarj_python_lint.rules.prefer_non_nullable_collection import (
+    PreferNonNullableCollection,
+)
+from sarj_python_lint.rules.prefer_or_pattern import PreferOrPattern
+from sarj_python_lint.rules.prefer_real_store_in_tests import PreferRealStoreInTests
 from sarj_python_lint.rules.prefer_str_enum import PreferStrEnum
 from sarj_python_lint.rules.prefer_struct_over_namedtuple import (
     PreferStructOverNamedtuple,
@@ -64,16 +77,20 @@ from sarj_python_lint.rules.prefer_timedelta_for_durations import (
 )
 from sarj_python_lint.rules.pydantic_at_boundaries import PydanticAtBoundaries
 from sarj_python_lint.rules.redundant_docstring import RedundantDocstring
+from sarj_python_lint.rules.require_port_for_service import RequirePortForService
 from sarj_python_lint.rules.single_public_export import SinglePublicExport
 from sarj_python_lint.rules.sleep_with_computed_arg_in_test import SleepWithComputedArgInTest
 from sarj_python_lint.rules.stepdown import Stepdown
 from sarj_python_lint.rules.store_insert_requires_on_conflict import (
     StoreInsertRequiresOnConflict,
 )
+from sarj_python_lint.rules.tautological_mock_assertion import TautologicalMockAssertion
 from sarj_python_lint.rules.test_loops_over_literal_cases import (
     TestLoopsOverLiteralCases,
 )
 from sarj_python_lint.rules.trailing_value_narration import TrailingValueNarration
+from sarj_python_lint.rules.trivially_true_assertion import TriviallyTrueAssertion
+from sarj_python_lint.rules.unused_mock_setup import UnusedMockSetup
 from sarj_python_lint.rules.xfail_requires_strict import XfailRequiresStrict
 from sarj_python_lint.rules.zero_assertion_test import ZeroAssertionTest
 
@@ -102,6 +119,13 @@ if TYPE_CHECKING:
 #   against every corpus; that, not the narrow variant, is the case to make.),
 #   SARJ037 no-trivial-single-use-helper (prototyped and dropped for FP rate;
 #   see the 0.13.1 inlining commit for the corpus analysis).
+#   SARJ072 unbound-mock-assertion and SARJ073 raises-needs-specific-error
+#   (built, corpus-measured and dropped before ever being registered, in the
+#   wave that added SARJ058-071). SARJ072 found 0 hits across 16,130 files in
+#   9 repos, including 0 against 8,322 real mock-assertion API uses; ruff B018
+#   covers its bare-statement shape. SARJ073 was a strict superset of ruff
+#   PT011, which this standard already enables — its one real gap,
+#   RuntimeError, is closed by `lint.flake8-pytest-style.raises-require-match-for`.
 REGISTRY: dict[str, type[Rule]] = {
     NoSequentialAwait.id: NoSequentialAwait,
     InefficientStringConcatInLoop.id: InefficientStringConcatInLoop,
@@ -151,6 +175,21 @@ REGISTRY: dict[str, type[Rule]] = {
     NoFileLevelEscapeHatchNoqa.id: NoFileLevelEscapeHatchNoqa,
     NoOptionalTenantPredicate.id: NoOptionalTenantPredicate,
     NoTautologicalExpect.id: NoTautologicalExpect,
+    PreferRealStoreInTests.id: PreferRealStoreInTests,
+    PreferLibraryFake.id: PreferLibraryFake,
+    TautologicalMockAssertion.id: TautologicalMockAssertion,
+    NoPatchingSystemUnderTest.id: NoPatchingSystemUnderTest,
+    OverMockedTest.id: OverMockedTest,
+    InteractionOnlyTest.id: InteractionOnlyTest,
+    TriviallyTrueAssertion.id: TriviallyTrueAssertion,
+    ConditionalAssertionInTest.id: ConditionalAssertionInTest,
+    DuplicateTestBody.id: DuplicateTestBody,
+    UnusedMockSetup.id: UnusedMockSetup,
+    PreferFstringOverConcat.id: PreferFstringOverConcat,
+    PreferMatchPatternDestructuring.id: PreferMatchPatternDestructuring,
+    PreferOrPattern.id: PreferOrPattern,
+    RequirePortForService.id: RequirePortForService,
+    PreferNonNullableCollection.id: PreferNonNullableCollection,
 }
 
 __all__ = ["REGISTRY"]