refactor: standardize on absolute imports repo-wide (leanEthereum#823)

Convert all intra-package relative imports to absolute and enforce the
convention so it cannot regress.

Motivation: ruff's import combining works on the literal module-path
string, so a relative and an absolute import of the same module (e.g.
`from .containers import Interval` next to
`from lean_spec.spec.forks.lstar.containers import ...`) were never
merged. The package mixed both styles, which defeated auto-combining and
produced duplicate import blocks.

Absolute imports are the more standardized choice: PEP 8 recommends them,
Google's style guide bans relative imports outright, and the CPython
standard library uses absolute throughout.

Changes:
- Enable flake8-tidy-imports `ban-relative-imports = "all"` and add `TID`
  to ruff's select/fixable lists, so relative imports are now a lint error.
- Convert ~660 relative imports across 132 files to absolute via ruff's
  TID252 autofix, then re-sort with isort.
- Fix two namespace-package roots the autofix mis-resolved (`tests/` has
  no `__init__.py` chain): `helpers.*` and `gossipsub.*` now use their
  full `tests.lean_spec.*` paths.

`just check` passes (ruff, ruff format, ty, codespell, mdformat).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: tcoratger

packages/testing/src/consensus_testing/__init__.py

@@ -2,9 +2,9 @@
 
 from typing import Type
 
-from . import forks
-from .genesis import build_anchor, generate_pre_state
-from .test_fixtures import (
+from consensus_testing import forks
+from consensus_testing.genesis import build_anchor, generate_pre_state
+from consensus_testing.test_fixtures import (
     ApiEndpointTest,
     BaseConsensusFixture,
     DropComponentMessageBinding,
@@ -28,7 +28,7 @@
     VerifySignaturesTest,
     VerifySingleMessageProofsTest,
 )
-from .test_types import (
+from consensus_testing.test_types import (
     AggregatedAttestationCheck,
     AggregatedAttestationSpec,
     AttestationCheck,

packages/testing/src/consensus_testing/forks/__init__.py

@@ -4,8 +4,8 @@
 
 from framework.forks import BaseFork, BaseForkMeta, ForkRegistry
 
-from . import forks as _forks_module
-from .forks import Lstar
+from consensus_testing.forks import forks as _forks_module
+from consensus_testing.forks.forks import Lstar
 
 Fork = Type[BaseFork]
 

packages/testing/src/consensus_testing/genesis.py

@@ -1,5 +1,6 @@
 """Consensus layer pre-state generation."""
 
+from consensus_testing.keys import XmssKeyManager
 from lean_spec.spec.crypto.merkleization import hash_tree_root
 from lean_spec.spec.forks import Slot, ValidatorIndex
 from lean_spec.spec.forks.lstar.containers import (
@@ -13,8 +14,6 @@
 from lean_spec.spec.forks.lstar.spec import LstarSpec
 from lean_spec.spec.ssz import Bytes52, Uint64
 
-from .keys import XmssKeyManager
-
 _DEFAULT_GENESIS_TIME = Uint64(0)
 
 

packages/testing/src/consensus_testing/test_fixtures/__init__.py

@@ -1,26 +1,26 @@
 """Consensus test fixture format definitions (Pydantic models)."""
 
-from .api_endpoint import ApiEndpointTest
-from .base import BaseConsensusFixture
-from .fork_choice import ForkChoiceTest
-from .gossipsub_handler import GossipsubHandlerTest
-from .justifiability import JustifiabilityTest
-from .networking_codec import NetworkingCodecTest
-from .poseidon_permutation import PoseidonPermutationTest
-from .slot_clock import SlotClockTest
-from .ssz import SSZTest
-from .state_transition import StateTransitionTest
-from .sync import SyncTest
-from .verify_multi_message_proofs import (
+from consensus_testing.test_fixtures.api_endpoint import ApiEndpointTest
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
+from consensus_testing.test_fixtures.fork_choice import ForkChoiceTest
+from consensus_testing.test_fixtures.gossipsub_handler import GossipsubHandlerTest
+from consensus_testing.test_fixtures.justifiability import JustifiabilityTest
+from consensus_testing.test_fixtures.networking_codec import NetworkingCodecTest
+from consensus_testing.test_fixtures.poseidon_permutation import PoseidonPermutationTest
+from consensus_testing.test_fixtures.slot_clock import SlotClockTest
+from consensus_testing.test_fixtures.ssz import SSZTest
+from consensus_testing.test_fixtures.state_transition import StateTransitionTest
+from consensus_testing.test_fixtures.sync import SyncTest
+from consensus_testing.test_fixtures.verify_multi_message_proofs import (
     DropComponentMessageBinding,
     IncrementComponentSlot,
     RebindComponentToAlternateHeadRoot,
     SwapComponentMessageBindings,
     SwapComponentParticipantPublicKey,
     VerifyMultiMessageProofsTest,
 )
-from .verify_signatures import VerifySignaturesTest
-from .verify_single_message_proofs import (
+from consensus_testing.test_fixtures.verify_signatures import VerifySignaturesTest
+from consensus_testing.test_fixtures.verify_single_message_proofs import (
     IncrementEmittedSlot,
     RebindToAlternateHeadRoot,
     SwapParticipantPublicKey,

packages/testing/src/consensus_testing/test_fixtures/api_endpoint.py

@@ -3,16 +3,15 @@
 from collections.abc import Callable
 from typing import Any, ClassVar
 
+from consensus_testing.genesis import build_anchor, generate_pre_state
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
 from lean_spec.spec.crypto.merkleization import hash_tree_root
 from lean_spec.spec.forks import Slot, ValidatorIndex
 from lean_spec.spec.forks.lstar import Store
 from lean_spec.spec.forks.lstar.containers import AggregatedAttestations, Block, BlockBody, State
 from lean_spec.spec.forks.lstar.spec import LstarSpec
 from lean_spec.spec.ssz import Bytes32, Uint64
 
-from ..genesis import build_anchor, generate_pre_state
-from .base import BaseConsensusFixture
-
 EndpointHandler = Callable[[Store, "ApiEndpointTest"], dict[str, Any]]
 """Uniform signature for all endpoint response builders.
 

packages/testing/src/consensus_testing/test_fixtures/fork_choice.py

@@ -11,6 +11,15 @@
 
 from pydantic import Field, model_validator
 
+from consensus_testing.keys import XmssKeyManager
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
+from consensus_testing.test_types import (
+    AttestationStep,
+    BlockStep,
+    ForkChoiceStep,
+    GossipAggregatedAttestationStep,
+    TickStep,
+)
 from lean_spec.node.chain.clock import SlotClock
 from lean_spec.spec.crypto.merkleization import hash_tree_root
 from lean_spec.spec.forks import Interval, Slot, ValidatorIndex
@@ -23,18 +32,6 @@
 )
 from lean_spec.spec.forks.lstar.spec import LstarSpec
 
-from ..keys import (
-    XmssKeyManager,
-)
-from ..test_types import (
-    AttestationStep,
-    BlockStep,
-    ForkChoiceStep,
-    GossipAggregatedAttestationStep,
-    TickStep,
-)
-from .base import BaseConsensusFixture
-
 
 class ForkChoiceTest(BaseConsensusFixture):
     """

packages/testing/src/consensus_testing/test_fixtures/gossipsub_handler.py

@@ -13,6 +13,7 @@
 from typing import Any, ClassVar
 from unittest.mock import patch
 
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
 from lean_spec.node.networking import PeerId
 from lean_spec.node.networking.gossipsub.behavior import GossipsubBehavior, PeerState
 from lean_spec.node.networking.gossipsub.message import GossipsubMessage
@@ -29,8 +30,6 @@
 )
 from lean_spec.node.networking.gossipsub.types import MessageId, Timestamp, TopicId
 
-from .base import BaseConsensusFixture
-
 # Sentinel that satisfies `outbound_stream is not None` checks.
 # The patched _send_rpc never touches the stream, so any non-None value works.
 _FAKE_STREAM: Any = object()

packages/testing/src/consensus_testing/test_fixtures/justifiability.py

@@ -13,10 +13,9 @@
 
 from typing import Any, ClassVar
 
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
 from lean_spec.spec.forks import Slot
 
-from .base import BaseConsensusFixture
-
 
 class JustifiabilityTest(BaseConsensusFixture):
     """Fixture for 3SF-mini justifiability conformance.

packages/testing/src/consensus_testing/test_fixtures/networking_codec.py

@@ -2,6 +2,7 @@
 
 from typing import Any, ClassVar
 
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
 from lean_spec.node.networking.enr.enr import ENR
 from lean_spec.node.networking.gossipsub.message import GossipsubMessage
 from lean_spec.node.networking.gossipsub.rpc import (
@@ -27,8 +28,6 @@
 from lean_spec.node.snappy import compress, decompress, frame_compress, frame_decompress
 from lean_spec.spec.forks import SubnetId
 
-from .base import BaseConsensusFixture
-
 
 def _to_hex(data: bytes) -> str:
     """Format raw bytes as a 0x-prefixed hex string."""

packages/testing/src/consensus_testing/test_fixtures/poseidon_permutation.py

@@ -7,11 +7,10 @@
 
 from typing import Any, ClassVar
 
+from consensus_testing.test_fixtures.base import BaseConsensusFixture
 from lean_spec.spec.crypto.koalabear import Fp
 from lean_spec.spec.crypto.poseidon import PARAMS_16, PARAMS_24, Poseidon
 
-from .base import BaseConsensusFixture
-
 
 class PoseidonPermutationTest(BaseConsensusFixture):
     """Fixture for Poseidon permutation conformance.