algorand-python-testing 1.2.0b2__tar.gz → 1.2.0b4__tar.gz

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/CHANGELOG.md

@@ -1,4 +1,12 @@
 # CHANGELOG
+## v1.2.0-beta.4 (2026-03-16)
+
+## v1.2.0-beta.3 (2025-12-08)
+
+### Features
+
+* add stage and submit_staged functions to support submitting dynamic number of inner transactions in a group ([`84ad031`](https://github.com/algorandfoundation/algorand-python-testing/commit/84ad03166442dadc10c7c1fe70e4cd07a63600cc))
+
 ## v1.2.0-beta.2 (2025-12-08)
 
 ### Features

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algorand-python-testing
-Version: 1.2.0b2
+Version: 1.2.0b4
 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-1.2.0b2 → algorand_python_testing-1.2.0b4}/docs/coverage.md

@@ -96,6 +96,7 @@ See which `algorand-python` stubs are implemented by the `algorand-python-testin
 | algopy.itxn.KeyRegistrationInnerTransaction | Emulated            |
 | algopy.itxn.Payment                         | Emulated            |
 | algopy.itxn.PaymentInnerTransaction         | Emulated            |
+| algopy.itxn.submit_staged                   | Emulated            |
 | algopy.itxn.submit_txns                     | Emulated            |
 | algopy.op.Base64                            | Native              |
 | algopy.op.EC                                | Native              |

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/docs/testing-guide/transactions.md

@@ -190,6 +190,75 @@ To access the submitted inner transactions:
 
 These methods provide type validation and will raise an error if the requested transaction type doesn't match the actual type of the inner transaction.
 
+### Submitting a group with dynamic number of inner transactions
+
+`algorand-python` supports composing inner transaction groups with a dynamic number of transactions. To use this feature, call the `.stage()` method on inner transaction classes to queue transactions, then call `algopy.itxn.submit_staged()` to submit all staged transactions as a group.
+
+The following example demonstrates how to test this functionality using the `algorand-python-testing` package.
+
+```{testcode}
+from algopy import Application, ARC4Contract, Array, Global, arc4, gtxn, itxn, TransactionType, Txn, UInt64, urange
+
+class DynamicItxnGroup(ARC4Contract):
+    @arc4.abimethod
+    def distribute(
+        self, addresses: Array[arc4.Address], funds: gtxn.PaymentTransaction, verifier: Application
+    ) -> None:
+        assert funds.receiver == Global.current_application_address, "Funds must be sent to app"
+
+        assert addresses.length, "must provide some accounts"
+
+        share = funds.amount // addresses.length
+
+        itxn.Payment(amount=share, receiver=addresses[0].native).stage(begin_group=True)
+
+        for i in urange(1, addresses.length):
+            addr = addresses[i]
+            itxn.Payment(amount=share, receiver=addr.native).stage()
+
+        itxn.ApplicationCall(
+            app_id=verifier.id, app_args=(arc4.arc4_signature("verify()void"),)
+        ).stage()
+
+        itxn.AssetConfig(asset_name="abc").stage()
+
+        itxn.submit_staged()
+
+class VerifierContract(ARC4Contract):
+    @arc4.abimethod
+    def verify(self) -> None:
+        for i in urange(Txn.group_index):
+            txn = gtxn.Transaction(i)
+            assert txn.type == TransactionType.Payment, "Txn must be pay"
+
+
+# create contract instaces
+verifier = VerifierContract()
+dynamic_itxn_group = DynamicItxnGroup()
+
+# get application id for contract instances
+verifier_app = context.ledger.get_app(verifier)
+dynamic_itxn_group_app = context.ledger.get_app(dynamic_itxn_group)
+
+# create test accounts to distribute funds to and initial fund
+addresses = Array([arc4.Address(context.any.account()) for _ in range(3)])
+payment = context.any.txn.payment(
+    amount=UInt64(9),
+    receiver=dynamic_itxn_group_app.address,
+)
+
+# call contract method which creates inner transactions according to number of addresses passed in
+dynamic_itxn_group.distribute(addresses, payment, verifier_app)
+
+# get inner transaction group to assert the details
+itxns = context.txn.last_group.get_itxn_group(-1)
+assert len(itxns) == 5
+for i in range(3):
+    assert itxns.payment(i).amount == 3
+assert itxns.application_call(3).app_id == verifier_app
+assert itxns.asset_config(4).asset_name == b"abc"
+```
+
 ## References
 
 -   [API](../api.md) for more details on the test context manager and inner transactions related methods that perform implicit inner transaction type validation.

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "algorand-python-testing"
-version = "1.2.0-beta.2"
+version = "1.2.0-beta.4"
 description = 'Algorand Python testing library'
 readme = "README.md"
 requires-python = ">=3.12"
@@ -50,7 +50,7 @@ type = "virtual"
 path = ".venv"
 python = "3.12"
 dependencies = [
-    "puyapy>=5",
+    "puyapy>=5.7.1",
     "pytest>=7.4",
     "pytest-mock>=3.10.0",
     "pytest-xdist[psutil]>=3.3",
@@ -58,7 +58,7 @@ dependencies = [
     "algokit-utils>=4.0.0",
     "pytest-cov>=4.1.0",
     "prettytable>=3.9.0",
-    "mypy==1.10",
+    "mypy==1.19.1",
 ]
 
 [tool.hatch.envs.default.env-vars]
@@ -132,7 +132,7 @@ dependencies = [
     "pytest-cov>=4.1.0",
     "py-algorand-sdk>=2.4.0",
     "algokit-utils>=4.0.0",
-    "puyapy>=5",
+    "puyapy>=5.7.1",
 ]
 
 [tool.hatch.envs.test.scripts]
@@ -190,7 +190,7 @@ dependencies = [
     "py-algorand-sdk>=2.4.0",
     "algokit-utils>=4.0.0",
     "pytest-cov>=4.1.0",
-    "mypy==1.10",
+    "mypy==1.19.1",
 ]
 
 [tool.hatch.envs.examples.scripts]

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/arc4.py

@@ -1154,17 +1154,17 @@ class _StructMeta(type):
 
 def _tuple_type_from_struct(struct: type[Struct]) -> type[Tuple]:  # type: ignore[type-arg]
     field_types = [f.type for f in struct._type_info.fields]
-    return parameterize_type(Tuple, *field_types)
+    return parameterize_type(Tuple, *field_types)  # type: ignore[arg-type]
 
 
-class Struct(MutableBytes, _ABIEncoded, metaclass=_StructMeta):  # type: ignore[misc]
+class Struct(MutableBytes, _ABIEncoded, metaclass=_StructMeta):
     """Base class for ARC4 Struct types."""
 
     _type_info: typing.ClassVar[_StructTypeInfo]  # type: ignore[misc]
 
     def __init_subclass__(cls, *args: typing.Any, **kwargs: dict[str, typing.Any]) -> None:
         # make implementation not frozen, so we can conditionally control behaviour
-        dataclasses.dataclass(cls, *args, **{**kwargs, "frozen": False})
+        dataclasses.dataclass(cls, *args, **{**kwargs, "frozen": False})  # type: ignore[call-overload]
         frozen = kwargs.get("frozen", False)
         assert isinstance(frozen, bool)
         cls._type_info = _StructTypeInfo(cls, frozen=frozen)

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/context_helpers/txn_context.py

@@ -326,19 +326,19 @@ class TransactionGroup:
         except ValueError:
             raise ValueError("Transaction is not part of this group") from None
 
-    def _begin_itxn_group(self) -> None:
+    def _begin_itxn_group(self, itxn: InnerTransaction | None = None) -> None:
         if self._constructing_itxn_group:
             raise RuntimeError("itxn begin without itxn submit")
 
         if self.active_txn.on_completion == OnCompleteAction.ClearState:
             raise RuntimeError("Cannot begin inner transaction group in a clear state call")
 
-        self._constructing_itxn_group.append(InnerTransaction())
+        self._constructing_itxn_group.append(itxn or InnerTransaction())
 
-    def _append_itxn_group(self) -> None:
+    def _append_itxn_group(self, itxn: InnerTransaction | None = None) -> None:
         if not self._constructing_itxn_group:
             raise RuntimeError("itxn next without itxn begin")
-        self._constructing_itxn_group.append(InnerTransaction())
+        self._constructing_itxn_group.append(itxn or InnerTransaction())
 
     def _submit_itxn_group(self) -> None:
         if not self._constructing_itxn_group:

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/itxn.py

@@ -33,6 +33,7 @@ __all__ = [
     "KeyRegistrationInnerTransaction",
     "Payment",
     "PaymentInnerTransaction",
+    "submit_staged",
     "submit_txns",
 ]
 
@@ -113,6 +114,12 @@ class _BaseInnerTransactionFields(typing.Protocol[_TResult_co]):
         _narrow_covariant_types(fields)
         self.fields.update(fields)
 
+    def stage(self, *, begin_group: bool = False) -> None:
+        if begin_group:
+            lazy_context.active_group._begin_itxn_group(self)  # type: ignore[arg-type]
+        else:
+            lazy_context.active_group._append_itxn_group(self)  # type: ignore[arg-type]
+
     def submit(self) -> _TResult_co:
         result = _get_itxn_result(self)
         lazy_context.active_group._add_itxn_group([result])  # type: ignore[list-item]
@@ -170,6 +177,10 @@ def submit_txns(
     return results
 
 
+def submit_staged() -> None:
+    lazy_context.active_group._submit_itxn_group()
+
+
 def _get_itxn_result(
     itxn: _BaseInnerTransactionFields[_TResult_co],
 ) -> _BaseInnerTransactionResult:

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/itxn_loader.py

@@ -48,7 +48,7 @@ class ITxnLoader:
     def _get_itxn(self, txn_type: type[_T]) -> _T:
         if (
             not isinstance(self._inner_txn, txn_type)
-            and getattr(self._inner_txn, "type", None) != self._TXN_TYPE_MAP[txn_type]
+            and getattr(self._inner_txn, "type", None) != self._TXN_TYPE_MAP[txn_type]  # type: ignore[index]
         ):
             raise TypeError(f"transaction is not of type {txn_type.__name__}!")
         return self._inner_txn  # type: ignore[return-value]

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/models/account.py

@@ -75,7 +75,7 @@ class AccountContextData:
 
     opted_assets: dict[int, AssetHolding] = dataclasses.field(default_factory=dict)
     opted_apps: dict[int, algopy.Application] = dataclasses.field(default_factory=dict)
-    fields: AccountFields = dataclasses.field(default_factory=AccountFields)  # type: ignore[arg-type]
+    fields: AccountFields = dataclasses.field(default_factory=AccountFields)
 
 
 class Account(BytesBacked):

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/primitives/array.py

@@ -531,7 +531,7 @@ class Struct(Serializable, MutableBytes):
 
     def __init_subclass__(cls, *args: typing.Any, **kwargs: dict[str, typing.Any]) -> None:
         # make implementation not frozen, so we can conditionally control behaviour
-        dataclasses.dataclass(cls, *args, **{**kwargs, "frozen": False})
+        dataclasses.dataclass(cls, *args, **{**kwargs, "frozen": False})  # type: ignore[call-overload]
         frozen = kwargs.get("frozen", False)
         cls._field_names = [
             f.name for f in dataclasses.fields(typing.cast("type[DataclassInstance]", cls))

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/serialize.py

@@ -145,7 +145,7 @@ def _get_tuple_serializer(item_types: tuple[type, ...]) -> _Serializer[typing.An
         return tuple(result)
 
     return _Serializer(
-        arc4_type=arc4.Tuple[*(s.arc4_type for s in serializers)],  # type: ignore[misc]
+        arc4_type=arc4.Tuple[*(s.arc4_type for s in serializers)],  # type: ignore[misc,arg-type]
         native_to_arc4=lambda t: arc4.Tuple(_items_to_arc4(t)),
         arc4_to_native=lambda t: _items_to_native(t),
     )
@@ -190,7 +190,7 @@ def type_of(value: object) -> type:
     if it is a generic type."""
     # get fully parametrized tuples
     if isinstance(value, tuple) and type(value) is tuple:
-        return tuple[*(type_of(i) for i in value)]  # type: ignore[misc, no-any-return]
+        return tuple[*(type_of(i) for i in value)]  # type: ignore[misc,return-value]
     else:
         return type(value)
 

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/src/_algopy_testing/state/utils.py

@@ -37,15 +37,15 @@ def deserialize(typ: type[_TValue], value: SerializableValue) -> _TValue:
     elif issubclass(typ, bool):
         return value != 0  # type: ignore[return-value]
     elif issubclass(typ, UInt64 | Bytes):
-        return typ(value)  # type: ignore[arg-type, return-value]
+        return typ(value)  # type: ignore[arg-type]
     elif issubclass(typ, UInt64Backed):
         if isinstance(value, bytes):
             raise TypeError("expected int, received bytes")
-        return typ.from_int(value)  # type: ignore[return-value]
+        return typ.from_int(value)
     elif issubclass(typ, BytesBacked | Serializable):
         if isinstance(value, int):
             raise TypeError("expected bytes, received int")
-        return typ.from_bytes(value)  # type: ignore[return-value]
+        return typ.from_bytes(value)
     else:
         raise TypeError(f"Unsupported type: {typ}")
 

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/tests/artifacts/AVM12/data/Contract.arc56.json

@@ -110,7 +110,7 @@
         "compiler": "puya",
         "compilerVersion": {
             "major": 5,
-            "minor": 5,
+            "minor": 6,
             "patch": 0
         }
     },

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/tests/artifacts/AVM12/data/ContractV0.arc56.json

@@ -81,7 +81,7 @@
         "compiler": "puya",
         "compilerVersion": {
             "major": 5,
-            "minor": 5,
+            "minor": 6,
             "patch": 0
         }
     },

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/tests/artifacts/AVM12/data/ContractV1.arc56.json

@@ -81,7 +81,7 @@
         "compiler": "puya",
         "compilerVersion": {
             "major": 5,
-            "minor": 5,
+            "minor": 6,
             "patch": 0
         }
     },

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/tests/artifacts/Arc4ABIMethod/data/SignaturesContract.arc56.json

@@ -487,7 +487,7 @@
         "compiler": "puya",
         "compilerVersion": {
             "major": 5,
-            "minor": 5,
+            "minor": 6,
             "patch": 0
         }
     },

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/tests/artifacts/Arc4InnerTxns/data/Arc4InnerTxnsContract.arc56.json

@@ -79,7 +79,7 @@
         "compiler": "puya",
         "compilerVersion": {
             "major": 5,
-            "minor": 5,
+            "minor": 6,
             "patch": 0
         }
     },

{algorand_python_testing-1.2.0b2 → algorand_python_testing-1.2.0b4}/tests/artifacts/Arc4PrimitiveOps/data/Arc4PrimitiveOpsContract.approval.teal

@@ -1136,12 +1136,11 @@ verify_uintn_from_log:
     // tests/artifacts/Arc4PrimitiveOps/contract.py:171
     // return arc4.UInt32.from_log(a)
     dup
-    extract 6 0
-    swap
     extract 2 4
     bytec_0 // 0x151f7c75
     ==
     assert // application log value is not the result of an ABI return
+    extract 6 0
     // tests/artifacts/Arc4PrimitiveOps/contract.py:169
     // @arc4.abimethod()
     bytec_0 // 0x151f7c75
@@ -1160,12 +1159,11 @@ verify_biguintn_from_log:
     // tests/artifacts/Arc4PrimitiveOps/contract.py:175
     // return arc4.UInt256.from_log(a)
     dup
-    extract 6 0
-    swap
     extract 2 4
     bytec_0 // 0x151f7c75
     ==
     assert // application log value is not the result of an ABI return
+    extract 6 0
     // tests/artifacts/Arc4PrimitiveOps/contract.py:173
     // @arc4.abimethod()
     bytec_0 // 0x151f7c75
@@ -1381,12 +1379,11 @@ verify_ufixednxm_from_log:
     // tests/artifacts/Arc4PrimitiveOps/contract.py:225
     // return arc4.UFixedNxM[typing.Literal[32], typing.Literal[8]].from_log(a)
     dup
-    extract 6 0
-    swap
     extract 2 4
     bytec_0 // 0x151f7c75
     ==
     assert // application log value is not the result of an ABI return
+    extract 6 0
     // tests/artifacts/Arc4PrimitiveOps/contract.py:221
     // @arc4.abimethod()
     bytec_0 // 0x151f7c75
@@ -1405,12 +1402,11 @@ verify_bigufixednxm_from_log:
     // tests/artifacts/Arc4PrimitiveOps/contract.py:231
     // return arc4.BigUFixedNxM[typing.Literal[256], typing.Literal[16]].from_log(a)
     dup
-    extract 6 0
-    swap
     extract 2 4
     bytec_0 // 0x151f7c75
     ==
     assert // application log value is not the result of an ABI return
+    extract 6 0
     // tests/artifacts/Arc4PrimitiveOps/contract.py:227
     // @arc4.abimethod()
     bytec_0 // 0x151f7c75
@@ -1538,12 +1534,11 @@ verify_string_from_log:
     // tests/artifacts/Arc4PrimitiveOps/contract.py:258
     // return arc4.String.from_log(a)
     dup
-    extract 6 0
-    swap
     extract 2 4
     bytec_0 // 0x151f7c75
     ==
     assert // application log value is not the result of an ABI return
+    extract 6 0
     // tests/artifacts/Arc4PrimitiveOps/contract.py:256
     // @arc4.abimethod()
     bytec_0 // 0x151f7c75
@@ -1595,12 +1590,11 @@ verify_bool_from_log:
     // tests/artifacts/Arc4PrimitiveOps/contract.py:270
     // return arc4.Bool.from_log(a)
     dup
-    extract 6 0
-    swap
     extract 2 4
     bytec_0 // 0x151f7c75
     ==
     assert // application log value is not the result of an ABI return
+    extract 6 0
     // tests/artifacts/Arc4PrimitiveOps/contract.py:268
     // @arc4.abimethod()
     bytec_0 // 0x151f7c75