algorand-python-testing 0.3.0b6__tar.gz → 0.3.0b7__tar.gz

{algorand_python_testing-0.3.0b6 → algorand_python_testing-0.3.0b7}/CHANGELOG.md

@@ -1,4 +1,6 @@
 # CHANGELOG
+## v0.3.0-beta.7 (2024-08-21)
+
 ## v0.3.0-beta.6 (2024-08-21)
 
 ### Documentation

{algorand_python_testing-0.3.0b6 → algorand_python_testing-0.3.0b7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: algorand-python-testing
-Version: 0.3.0b6
+Version: 0.3.0b7
 Summary: Algorand Python testing library
 Project-URL: Documentation, https://github.com/algorandfoundation/puya/tree/main/algopy_testing#README.md
 Project-URL: Issues, https://github.com/algorandfoundation/puya/issues

algorand_python_testing-0.3.0b7/docs/api.md

@@ -0,0 +1,31 @@
+# API Reference
+
+## Contexts
+
+```{autodoc2-summary}
+algopy_testing.AlgopyTestContext
+algopy_testing.LedgerContext
+algopy_testing.TransactionContext
+```
+
+## Value Generators
+
+```{autodoc2-summary}
+algopy_testing.AVMValueGenerator
+algopy_testing.ARC4ValueGenerator
+algopy_testing.TxnValueGenerator
+```
+
+## Inner transaction loaders
+
+```{autodoc2-summary}
+algopy_testing.ITxnGroupLoader
+algopy_testing.ITxnLoader
+```
+
+## Utils
+
+```{autodoc2-summary}
+algopy_testing.algopy_testing_context
+algopy_testing.arc4_prefix
+```

{algorand_python_testing-0.3.0b6 → algorand_python_testing-0.3.0b7}/docs/conf.py

@@ -61,7 +61,11 @@ myst_enable_extensions = ["colon_fence", "fieldlist"]
 autodoc2_packages = [
     {
         "path": "../src/algopy_testing",
-        "auto_mode": False,
+        "auto_mode": True,
+    },
+    {
+        "path": "../src/_algopy_testing",
+        "auto_mode": True,
     },
 ]
 autodoc2_render_plugin = "myst"

{algorand_python_testing-0.3.0b6 → algorand_python_testing-0.3.0b7}/docs/coverage.md

@@ -1,8 +1,6 @@
 # Coverage
 
-See which `algorand-python` stubs are implemented by the `algorand-python-testing` library. See the [Concepts](testing-guide/concepts.md#types-of-algopy-stub-implementations) section for more details on the implementation categories.
-
-Based on the definitions provided and the implementation details in the `src` directory, here is the classification for the abstractions outlined in the table under the `Name` column:
+See which `algorand-python` stubs are implemented by the `algorand-python-testing` library. See the [Concepts](testing-guide/concepts.md#types-of-algopy-stub-implementations) section for more details on the implementation categories. Refer to the [`algorand-python` stubs API](api.md) for the full list of the stubs for which the `algorand-python-testing` library provides implementations referenced in the table below.
 
 | Name                                        | Implementation type |
 | ------------------------------------------- | ------------------- |
@@ -159,4 +157,3 @@ Based on the definitions provided and the implementation details in the `src` di
 | algopy.op.EllipticCurve                     | Mockable            |
 | algopy.op.VrfVerify                         | Mockable            |
 | algopy.op.vrf_verify                        | Mockable            |
-

{algorand_python_testing-0.3.0b6 → algorand_python_testing-0.3.0b7}/examples/zk_whitelist/test_contract.py

@@ -3,8 +3,7 @@ from collections.abc import Generator
 
 import algopy
 import pytest
-from algopy_testing import AlgopyTestContext, algopy_testing_context
-from algopy_testing.utils import arc4_prefix
+from algopy_testing import AlgopyTestContext, algopy_testing_context, arc4_prefix
 
 from .contract import ZkWhitelistContract
 

{algorand_python_testing-0.3.0b6 → algorand_python_testing-0.3.0b7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "algorand-python-testing"
-version = "0.3.0-beta.6"
+version = "0.3.0-beta.7"
 description = 'Algorand Python testing library'
 readme = "README.md"
 requires-python = ">=3.12"

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/__init__.py

@@ -1,15 +1,15 @@
-from algopy_testing import arc4, gtxn, itxn
-from algopy_testing._context_helpers.context_storage import algopy_testing_context
-from algopy_testing._context_helpers.ledger_context import LedgerContext
-from algopy_testing._context_helpers.txn_context import TransactionContext
-from algopy_testing._itxn_loader import ITxnGroupLoader, ITxnLoader
-from algopy_testing._value_generators.arc4 import ARC4ValueGenerator
-from algopy_testing._value_generators.avm import AVMValueGenerator
-from algopy_testing._value_generators.txn import TxnValueGenerator
-from algopy_testing.context import AlgopyTestContext
-from algopy_testing.decorators.subroutine import subroutine
-from algopy_testing.enums import OnCompleteAction, TransactionType
-from algopy_testing.models import (
+from _algopy_testing import arc4, gtxn, itxn
+from _algopy_testing._context_helpers.context_storage import algopy_testing_context
+from _algopy_testing._context_helpers.ledger_context import LedgerContext
+from _algopy_testing._context_helpers.txn_context import TransactionContext
+from _algopy_testing._itxn_loader import ITxnGroupLoader, ITxnLoader
+from _algopy_testing._value_generators.arc4 import ARC4ValueGenerator
+from _algopy_testing._value_generators.avm import AVMValueGenerator
+from _algopy_testing._value_generators.txn import TxnValueGenerator
+from _algopy_testing.context import AlgopyTestContext
+from _algopy_testing.decorators.subroutine import subroutine
+from _algopy_testing.enums import OnCompleteAction, TransactionType
+from _algopy_testing.models import (
     Account,
     Application,
     ARC4Contract,
@@ -22,8 +22,8 @@ from algopy_testing.models import (
     uenumerate,
     urange,
 )
-from algopy_testing.primitives import BigUInt, Bytes, String, UInt64
-from algopy_testing.state import Box, BoxMap, BoxRef, GlobalState, LocalState
+from _algopy_testing.primitives import BigUInt, Bytes, String, UInt64
+from _algopy_testing.state import Box, BoxMap, BoxRef, GlobalState, LocalState
 
 # TODO: clean up and ensure only algopy_testing namespace specific user facing abstractions
 # are exposed Only keep the _value_generators, ledger_context, txn_context,
@@ -62,7 +62,6 @@ __all__ = [
     "gtxn",
     "itxn",
     "logicsig",
-    "op",
     "subroutine",
     "uenumerate",
     "urange",

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_compiled.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import dataclasses
 import typing
 
-from algopy_testing.utils import raise_mocked_function_error
+from _algopy_testing.utils import raise_mocked_function_error
 
 if typing.TYPE_CHECKING:
     from collections.abc import Mapping

algorand_python_testing-0.3.0b7/src/_algopy_testing/_context_helpers/__init__.py

@@ -0,0 +1,13 @@
+from _algopy_testing._context_helpers.context_storage import (
+    algopy_testing_context,
+    lazy_context,
+)
+from _algopy_testing._context_helpers.ledger_context import LedgerContext
+from _algopy_testing._context_helpers.txn_context import TransactionContext
+
+__all__ = [
+    "LedgerContext",
+    "TransactionContext",
+    "algopy_testing_context",
+    "lazy_context",
+]

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_context_helpers/context_storage.py

@@ -9,13 +9,13 @@ if typing.TYPE_CHECKING:
 
     import algopy
 
-    from algopy_testing._context_helpers.ledger_context import LedgerContext
-    from algopy_testing._context_helpers.txn_context import TransactionContext, TransactionGroup
-    from algopy_testing._value_generators import AlgopyValueGenerator
-    from algopy_testing.context import AlgopyTestContext
-    from algopy_testing.models.account import AccountContextData
-    from algopy_testing.models.application import ApplicationContextData
-    from algopy_testing.models.asset import AssetFields
+    from _algopy_testing._context_helpers.ledger_context import LedgerContext
+    from _algopy_testing._context_helpers.txn_context import TransactionContext, TransactionGroup
+    from _algopy_testing._value_generators import AlgopyValueGenerator
+    from _algopy_testing.context import AlgopyTestContext
+    from _algopy_testing.models.account import AccountContextData
+    from _algopy_testing.models.application import ApplicationContextData
+    from _algopy_testing.models.asset import AssetFields
 
 _var: ContextVar[AlgopyTestContext] = ContextVar("_var")
 
@@ -97,7 +97,12 @@ def algopy_testing_context(
     *,
     default_sender: str | None = None,
 ) -> Generator[AlgopyTestContext, None, None]:
-    from algopy_testing.context import AlgopyTestContext
+    """Context manager for the AlgopyTestContext.
+
+    Args:
+        default_sender: The default sender for the context.
+    """
+    from _algopy_testing.context import AlgopyTestContext
 
     token = _var.set(
         AlgopyTestContext(

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_context_helpers/ledger_context.py

@@ -3,25 +3,25 @@ from __future__ import annotations
 import typing
 from collections import defaultdict
 
-from algopy_testing.constants import MAX_BOX_SIZE
-from algopy_testing.models.account import Account
-from algopy_testing.primitives.uint64 import UInt64
-from algopy_testing.utils import as_bytes, assert_address_is_valid, get_default_global_fields
+from _algopy_testing.constants import MAX_BOX_SIZE
+from _algopy_testing.models.account import Account
+from _algopy_testing.primitives.uint64 import UInt64
+from _algopy_testing.utils import as_bytes, assert_address_is_valid, get_default_global_fields
 
 if typing.TYPE_CHECKING:
     import algopy
 
-    from algopy_testing.models.account import AccountFields
-    from algopy_testing.models.application import ApplicationContextData, ApplicationFields
-    from algopy_testing.models.asset import AssetFields
-    from algopy_testing.op.global_values import GlobalFields
+    from _algopy_testing.models.account import AccountFields
+    from _algopy_testing.models.application import ApplicationContextData, ApplicationFields
+    from _algopy_testing.models.asset import AssetFields
+    from _algopy_testing.op.global_values import GlobalFields
 
 
 class LedgerContext:
     """Context for managing the ledger state."""
 
     def __init__(self) -> None:
-        from algopy_testing.models.account import AccountContextData, get_empty_account
+        from _algopy_testing.models.account import AccountContextData, get_empty_account
 
         self.account_data = defaultdict[str, AccountContextData](get_empty_account)
         self.app_data: dict[int, ApplicationContextData] = {}
@@ -374,7 +374,7 @@ class LedgerContext:
         Raises:
             AttributeError: If invalid fields are provided.
         """
-        from algopy_testing.op.global_values import GlobalFields
+        from _algopy_testing.op.global_values import GlobalFields
 
         invalid_keys = global_fields.keys() - GlobalFields.__annotations__.keys()
 
@@ -436,8 +436,8 @@ def _get_app_id(app: algopy.UInt64 | algopy.Application | algopy.Contract | int)
     Raises:
         TypeError: If an invalid type is provided.
     """
-    from algopy_testing.models import Application, Contract
-    from algopy_testing.primitives import UInt64
+    from _algopy_testing.models import Application, Contract
+    from _algopy_testing.primitives import UInt64
 
     if isinstance(app, Contract):
         app_id = app.__app_id__

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_context_helpers/txn_context.py

@@ -5,30 +5,30 @@ import typing
 
 import algosdk
 
-from algopy_testing._itxn_loader import ITxnGroupLoader
-from algopy_testing.decorators.arc4 import (
+from _algopy_testing._itxn_loader import ITxnGroupLoader
+from _algopy_testing.decorators.arc4 import (
     check_routing_conditions,
     create_abimethod_txns,
     create_baremethod_txns,
     get_arc4_metadata,
     get_ordered_args,
 )
-from algopy_testing.enums import OnCompleteAction
+from _algopy_testing.enums import OnCompleteAction
 
 if typing.TYPE_CHECKING:
     from collections.abc import Callable, Iterator, Sequence
 
     import algopy
 
-    from algopy_testing._itxn_loader import InnerTransactionResultType
-    from algopy_testing.models.txn_fields import ActiveTransactionFields
+    from _algopy_testing._itxn_loader import InnerTransactionResultType
+    from _algopy_testing.models.txn_fields import ActiveTransactionFields
 
-from algopy_testing import gtxn
-from algopy_testing._itxn_loader import ITxnLoader
-from algopy_testing.gtxn import TransactionBase
-from algopy_testing.itxn import InnerTransaction, submit_txns
-from algopy_testing.models import Application
-from algopy_testing.primitives import UInt64
+from _algopy_testing import gtxn
+from _algopy_testing._itxn_loader import ITxnLoader
+from _algopy_testing.gtxn import TransactionBase
+from _algopy_testing.itxn import InnerTransaction, submit_txns
+from _algopy_testing.models import Application
+from _algopy_testing.primitives import UInt64
 
 TReturn = typing.TypeVar("TReturn")
 TParamSpec = typing.ParamSpec("TParamSpec")
@@ -56,6 +56,8 @@ class DeferredAppCall(typing.Generic[TReturn]):
 
 
 class TransactionContext:
+    """Context for managing transaction groups and active transactions."""
+
     def __init__(self) -> None:
         self._groups: list[TransactionGroup] = []
         self._active_group: TransactionGroup | None = None
@@ -91,7 +93,7 @@ class TransactionContext:
     ) -> DeferredAppCall[TReturn]:
         r"""Prepare an application call transaction group for a contract method without
         executing it."""
-        from algopy_testing.models import ARC4Contract
+        from _algopy_testing.models import ARC4Contract
 
         arc4_metadata = get_arc4_metadata(method)
         # unwrap instance method

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_itxn_loader.py

@@ -2,8 +2,8 @@ from __future__ import annotations
 
 import typing
 
-from algopy_testing import itxn
-from algopy_testing.enums import TransactionType
+from _algopy_testing import itxn
+from _algopy_testing.enums import TransactionType
 
 if typing.TYPE_CHECKING:
     from collections.abc import Sequence

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_value_generators/arc4.py

@@ -6,9 +6,9 @@ import typing
 
 import algosdk
 
-from algopy_testing import arc4
-from algopy_testing.constants import MAX_UINT8, MAX_UINT16, MAX_UINT32, MAX_UINT64, MAX_UINT512
-from algopy_testing.utils import generate_random_int
+from _algopy_testing import arc4
+from _algopy_testing.constants import MAX_UINT8, MAX_UINT16, MAX_UINT32, MAX_UINT64, MAX_UINT512
+from _algopy_testing.utils import generate_random_int
 
 if typing.TYPE_CHECKING:
     import algopy

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_value_generators/avm.py

@@ -7,18 +7,18 @@ from collections import ChainMap
 
 import algosdk
 
-import algopy_testing
-from algopy_testing._context_helpers import lazy_context
-from algopy_testing.constants import (
+import _algopy_testing
+from _algopy_testing._context_helpers import lazy_context
+from _algopy_testing.constants import (
     ALWAYS_APPROVE_TEAL_PROGRAM,
     MAX_BYTES_SIZE,
     MAX_UINT64,
     MAX_UINT512,
 )
-from algopy_testing.models.account import AccountFields
-from algopy_testing.models.application import ApplicationContextData, ApplicationFields
-from algopy_testing.models.asset import AssetFields
-from algopy_testing.utils import generate_random_int
+from _algopy_testing.models.account import AccountFields
+from _algopy_testing.models.application import ApplicationContextData, ApplicationFields
+from _algopy_testing.models.asset import AssetFields
+from _algopy_testing.utils import generate_random_int
 
 if typing.TYPE_CHECKING:
     import algopy
@@ -43,7 +43,7 @@ class AVMValueGenerator:
         if min_value < 0 or max_value < 0:
             raise ValueError("min_value and max_value must be greater than or equal to 0")
 
-        return algopy_testing.UInt64(generate_random_int(min_value, max_value))
+        return _algopy_testing.UInt64(generate_random_int(min_value, max_value))
 
     def biguint(self, min_value: int = 0) -> algopy.BigUInt:
         """Generate a random BigUInt value within a specified range.
@@ -55,7 +55,7 @@ class AVMValueGenerator:
         if min_value < 0:
             raise ValueError("min_value must be greater than or equal to 0")
 
-        return algopy_testing.BigUInt(generate_random_int(min_value, MAX_UINT512))
+        return _algopy_testing.BigUInt(generate_random_int(min_value, MAX_UINT512))
 
     def bytes(self, length: int | None = None) -> algopy.Bytes:
         """Generate a random byte sequence of a specified length.
@@ -64,7 +64,7 @@ class AVMValueGenerator:
         :returns: The randomly generated byte sequence.
         """
         length = length or MAX_BYTES_SIZE
-        return algopy_testing.Bytes(secrets.token_bytes(length))
+        return _algopy_testing.Bytes(secrets.token_bytes(length))
 
     def string(self, length: int = MAX_BYTES_SIZE) -> algopy.String:
         """Generate a random string of a specified length.
@@ -72,7 +72,7 @@ class AVMValueGenerator:
         :param length: int:  (Default value = MAX_BYTES_SIZE)
         :returns: The randomly generated string.
         """
-        return algopy_testing.String(
+        return _algopy_testing.String(
             "".join(secrets.choice(string.ascii_uppercase + string.digits) for _ in range(length))
         )
 
@@ -146,7 +146,6 @@ class AVMValueGenerator:
         **application_fields: typing.Unpack[ApplicationFields],
     ) -> algopy.Application:
         r"""Generate and add a new application with a unique ID."""
-        import algopy_testing
 
         new_app_id = id if id is not None else lazy_context.ledger.get_next_app_id()
 
@@ -159,20 +158,20 @@ class AVMValueGenerator:
             if key not in ApplicationFields.__annotations__:
                 raise AttributeError(f"Invalid field '{key}' for Application")
 
-        new_app = algopy_testing.Application(new_app_id)
+        new_app = _algopy_testing.Application(new_app_id)
 
         # Set sensible defaults
         app_fields: ApplicationFields = {
-            "approval_program": algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM),
-            "clear_state_program": algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM),
-            "global_num_uint": algopy_testing.UInt64(0),
-            "global_num_bytes": algopy_testing.UInt64(0),
-            "local_num_uint": algopy_testing.UInt64(0),
-            "local_num_bytes": algopy_testing.UInt64(0),
-            "extra_program_pages": algopy_testing.UInt64(0),
+            "approval_program": _algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM),
+            "clear_state_program": _algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM),
+            "global_num_uint": _algopy_testing.UInt64(0),
+            "global_num_bytes": _algopy_testing.UInt64(0),
+            "local_num_uint": _algopy_testing.UInt64(0),
+            "local_num_bytes": _algopy_testing.UInt64(0),
+            "extra_program_pages": _algopy_testing.UInt64(0),
             "creator": lazy_context.value.default_sender,
             "address": address
-            or algopy_testing.Account(algosdk.logic.get_application_address(new_app_id)),
+            or _algopy_testing.Account(algosdk.logic.get_application_address(new_app_id)),
         }
 
         # Merge provided fields with defaults, prioritizing provided fields

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/_value_generators/txn.py

@@ -2,15 +2,15 @@ from __future__ import annotations
 
 import typing
 
-from algopy_testing import gtxn
-from algopy_testing._context_helpers import lazy_context
-from algopy_testing.models.application import Application
-from algopy_testing.models.txn_fields import get_txn_defaults
+from _algopy_testing import gtxn
+from _algopy_testing._context_helpers import lazy_context
+from _algopy_testing.models.application import Application
+from _algopy_testing.models.txn_fields import get_txn_defaults
 
 if typing.TYPE_CHECKING:
     import algopy
 
-    from algopy_testing.models.txn_fields import (
+    from _algopy_testing.models.txn_fields import (
         ApplicationCallFields,
         AssetConfigFields,
         AssetFreezeFields,

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/arc4.py

@@ -8,22 +8,22 @@ import typing
 import algosdk
 from Cryptodome.Hash import SHA512
 
-from algopy_testing._mutable import (
+from _algopy_testing._mutable import (
     MutableBytes,
     add_mutable_callback,
     set_item_on_mutate,
 )
-from algopy_testing.constants import (
+from _algopy_testing.constants import (
     ARC4_RETURN_PREFIX,
     BITS_IN_BYTE,
     MAX_UINT64,
     UINT64_SIZE,
     UINT512_SIZE,
 )
-from algopy_testing.models.account import Account
-from algopy_testing.primitives import Bytes
-from algopy_testing.protocols import BytesBacked
-from algopy_testing.utils import (
+from _algopy_testing.models.account import Account
+from _algopy_testing.primitives import Bytes
+from _algopy_testing.protocols import BytesBacked
+from _algopy_testing.utils import (
     as_bytes,
     as_int,
     as_int16,
@@ -1150,7 +1150,6 @@ class ARC4Client:
 
 
 class _ABICall:
-
     def __init__(self, func_name: str) -> None:
         self.func_name = func_name
 
@@ -1175,7 +1174,7 @@ arc4_update = _ABICall("arc4_update")
 
 
 def emit(event: str | Struct, /, *args: object) -> None:
-    from algopy_testing.utilities.log import log
+    from _algopy_testing.utilities.log import log
 
     if isinstance(event, str):
         arc4_args = tuple(_cast_arg_as_arc4(arg) for arg in args)

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/context.py

@@ -4,8 +4,8 @@ import typing
 
 import algosdk
 
-from algopy_testing._context_helpers import LedgerContext, TransactionContext
-from algopy_testing._value_generators import AlgopyValueGenerator
+from _algopy_testing._context_helpers import LedgerContext, TransactionContext
+from _algopy_testing._value_generators import AlgopyValueGenerator
 
 if typing.TYPE_CHECKING:
     from collections.abc import Sequence

algorand_python_testing-0.3.0b7/src/_algopy_testing/decorators/__init__.py

@@ -0,0 +1,8 @@
+from _algopy_testing.decorators.arc4 import abimethod, baremethod
+from _algopy_testing.decorators.subroutine import subroutine
+
+__all__ = [
+    "abimethod",
+    "baremethod",
+    "subroutine",
+]

{algorand_python_testing-0.3.0b6/src/algopy_testing → algorand_python_testing-0.3.0b7/src/_algopy_testing}/decorators/arc4.py

@@ -8,11 +8,11 @@ import typing
 
 import algosdk
 
-import algopy_testing
-from algopy_testing._context_helpers import lazy_context
-from algopy_testing.constants import ALWAYS_APPROVE_TEAL_PROGRAM
-from algopy_testing.enums import OnCompleteAction
-from algopy_testing.primitives import BigUInt, Bytes, String, UInt64
+import _algopy_testing
+from _algopy_testing._context_helpers import lazy_context
+from _algopy_testing.constants import ALWAYS_APPROVE_TEAL_PROGRAM
+from _algopy_testing.enums import OnCompleteAction
+from _algopy_testing.primitives import BigUInt, Bytes, String, UInt64
 
 _P = typing.ParamSpec("_P")
 _R = typing.TypeVar("_R")
@@ -167,7 +167,7 @@ def abimethod(  # noqa: PLR0913
     @functools.wraps(fn)
     def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> _R:
         contract, *app_args = args
-        assert isinstance(contract, algopy_testing.ARC4Contract), "expected ARC4 contract"
+        assert isinstance(contract, _algopy_testing.ARC4Contract), "expected ARC4 contract"
         assert fn is not None, "expected function"
         app_id = contract.__app_id__
 
@@ -224,10 +224,10 @@ def create_abimethod_txns(
     # at some point could get the actual values by using puya to compile the contract
     # this should be opt-in behaviour, as that it would be too slow to always do
     txn_fields.setdefault(
-        "approval_program_pages", [algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
+        "approval_program_pages", [_algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
     )
     txn_fields.setdefault(
-        "clear_state_program_pages", [algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
+        "clear_state_program_pages", [_algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
     )
 
     app_txn = lazy_context.any.txn.application_call(**txn_fields)
@@ -241,10 +241,10 @@ def create_baremethod_txns(app_id: int) -> list[algopy.gtxn.TransactionBase]:
     txn_fields.setdefault("app_id", contract_app)
 
     txn_fields.setdefault(
-        "approval_program_pages", [algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
+        "approval_program_pages", [_algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
     )
     txn_fields.setdefault(
-        "clear_state_program_pages", [algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
+        "clear_state_program_pages", [_algopy_testing.Bytes(ALWAYS_APPROVE_TEAL_PROGRAM)]
     )
     txn_fields.setdefault("sender", lazy_context.value.default_sender)
     return [
@@ -269,26 +269,26 @@ def _extract_arrays_from_args(
     app: algopy.Application,
     sender: algopy.Account,
 ) -> _TxnArrays:
-    txns = list[algopy_testing.gtxn.TransactionBase]()
+    txns = list[_algopy_testing.gtxn.TransactionBase]()
     apps = [app]
-    assets = list[algopy_testing.Asset]()
+    assets = list[_algopy_testing.Asset]()
     accounts = [sender]
     app_args = [method_selector]
     for arg in args:
         match arg:
-            case algopy_testing.gtxn.TransactionBase() as txn:
+            case _algopy_testing.gtxn.TransactionBase() as txn:
                 txns.append(txn)
-            case algopy_testing.Account() as acc:
-                app_args.append(algopy_testing.arc4.UInt8(len(accounts)).bytes)
+            case _algopy_testing.Account() as acc:
+                app_args.append(_algopy_testing.arc4.UInt8(len(accounts)).bytes)
                 accounts.append(acc)
-            case algopy_testing.Asset() as asset:
-                app_args.append(algopy_testing.arc4.UInt8(len(assets)).bytes)
+            case _algopy_testing.Asset() as asset:
+                app_args.append(_algopy_testing.arc4.UInt8(len(assets)).bytes)
                 assets.append(asset)
-            case algopy_testing.Application() as arg_app:
-                app_args.append(algopy_testing.arc4.UInt8(len(apps)).bytes)
+            case _algopy_testing.Application() as arg_app:
+                app_args.append(_algopy_testing.arc4.UInt8(len(apps)).bytes)
                 apps.append(arg_app)
             case _ as maybe_native:
-                app_args.append(algopy_testing.arc4.native_value_to_arc4(maybe_native).bytes)
+                app_args.append(_algopy_testing.arc4.native_value_to_arc4(maybe_native).bytes)
     if len(app_args) > 16:
         # TODO:1.0 pack extra args into an ARC4 tuple
         raise NotImplementedError
@@ -313,9 +313,9 @@ def _generate_arc4_signature_from_fn(fn: typing.Callable[_P, _R], arc4_name: str
 
 
 def _type_to_arc4(annotation: types.GenericAlias | type | None) -> str:  # noqa: PLR0911, PLR0912
-    from algopy_testing.arc4 import _ABIEncoded
-    from algopy_testing.gtxn import Transaction, TransactionBase
-    from algopy_testing.models import Account, Application, Asset
+    from _algopy_testing.arc4 import _ABIEncoded
+    from _algopy_testing.gtxn import Transaction, TransactionBase
+    from _algopy_testing.models import Account, Application, Asset
 
     if annotation is None:
         return "void"
@@ -408,7 +408,7 @@ def baremethod(
     @functools.wraps(fn)
     def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> _R:
         contract, *app_args = args
-        assert isinstance(contract, algopy_testing.ARC4Contract), "expected ARC4 contract"
+        assert isinstance(contract, _algopy_testing.ARC4Contract), "expected ARC4 contract"
         assert fn is not None, "expected function"
 
         txns = create_baremethod_txns(contract.__app_id__)