algokit-utils 3.0.3b1__py3-none-any.whl → 4.0.0b1__py3-none-any.whl

algokit_utils/accounts/account_manager.py

@@ -1,14 +1,14 @@
 import os
 from collections.abc import Callable
 from dataclasses import dataclass
-from typing import Any
+from typing import Any, overload
 
 import algosdk
 from algosdk import mnemonic
 from algosdk.atomic_transaction_composer import TransactionSigner
 from algosdk.mnemonic import to_private_key
 from algosdk.transaction import SuggestedParams
-from typing_extensions import Self
+from typing_extensions import Self, deprecated
 
 from algokit_utils.accounts.kmd_account_manager import KmdAccountManager
 from algokit_utils.clients.client_manager import ClientManager
@@ -215,6 +215,7 @@ class AccountManager:
         )
         return self
 
+    @overload
     def set_signer_from_account(self, account: TransactionSignerAccountProtocol) -> Self:
         """
         Tracks the given account for later signing.
@@ -227,11 +228,80 @@ class AccountManager:
 
         :example:
             >>> account_manager = AccountManager(client_manager)
-            >>> account_manager.set_signer_from_account(SigningAccount(private_key=algosdk.account.generate_account()[0]))
+            >>> account_manager.set_signer_from_account(
+            ...     SigningAccount(private_key=algosdk.account.generate_account()[0])
+            ... )
             >>> account_manager.set_signer_from_account(LogicSigAccount(AlgosdkLogicSigAccount(program, args)))
             >>> account_manager.set_signer_from_account(MultiSigAccount(multisig_params, [account1, account2]))
-        """  # noqa: E501
-        self._accounts[account.address] = account
+        """
+
+    @overload
+    @deprecated("Use set_signer_from_account(account) instead of set_signer_from_account(signer)")
+    def set_signer_from_account(self, signer: TransactionSignerAccountProtocol) -> Self:
+        """
+        Tracks the given account for later signing.
+
+        Note: If you are generating accounts via the various methods on `AccountManager`
+        (like `random`, `from_mnemonic`, `logic_sig`, etc.) then they automatically get tracked.
+
+        :param signer: The account to register (deprecated, use account parameter instead)
+        :returns: The `AccountManager` instance for method chaining
+
+        :example:
+            >>> account_manager = AccountManager(client_manager)
+            >>> account_manager.set_signer_from_account(
+            ...     SigningAccount(private_key=algosdk.account.generate_account()[0])
+            ... )
+            >>> account_manager.set_signer_from_account(LogicSigAccount(AlgosdkLogicSigAccount(program, args)))
+            >>> account_manager.set_signer_from_account(MultiSigAccount(multisig_params, [account1, account2]))
+        """
+
+    def set_signer_from_account(
+        self,
+        *args: TransactionSignerAccountProtocol,
+        **kwargs: TransactionSignerAccountProtocol,
+    ) -> Self:
+        """
+        Tracks the given account for later signing.
+
+        Note: If you are generating accounts via the various methods on `AccountManager`
+        (like `random`, `from_mnemonic`, `logic_sig`, etc.) then they automatically get tracked.
+
+        The method accepts either a positional argument or a keyword argument named 'account' or 'signer'.
+        The 'signer' parameter is deprecated and will show a warning when used.
+
+        :param *args: Variable positional arguments. The first argument should be a TransactionSignerAccountProtocol.
+        :param **kwargs: Variable keyword arguments. Can include 'account' or 'signer' (deprecated) as
+            TransactionSignerAccountProtocol.
+        :returns: The `AccountManager` instance for method chaining
+        :raises ValueError: If no account or signer argument is provided
+
+        :example:
+            >>> account_manager = AccountManager(client_manager)
+            >>> # Using positional argument
+            >>> account_manager.set_signer_from_account(
+            ...     SigningAccount(private_key=algosdk.account.generate_account()[0])
+            ... )
+            >>> # Using keyword argument 'account'
+            >>> account_manager.set_signer_from_account(
+            ...     account=LogicSigAccount(AlgosdkLogicSigAccount(program, args))
+            ... )
+            >>> # Using deprecated keyword argument 'signer'
+            >>> account_manager.set_signer_from_account(
+            ...     signer=MultiSigAccount(multisig_params, [account1, account2])
+            ... )
+        """
+        # Extract the account from either positional args or keyword args
+        if args:
+            account_obj = args[0]
+        elif "account" in kwargs:
+            account_obj = kwargs["account"]
+        elif "signer" in kwargs:
+            account_obj = kwargs["signer"]
+        else:
+            raise ValueError("Missing required argument: either 'account' or 'signer'")
+
+        self._accounts[account_obj.address] = account_obj
         return self
 
     def get_signer(self, sender: str | TransactionSignerAccountProtocol) -> TransactionSigner:

algokit_utils/clients/dispenser_api_client.py

@@ -144,8 +144,8 @@ class TestNetDispenserApiClient:
     @overload
     def fund(self, address: str, amount: int) -> DispenserFundResponse: ...
 
-    @deprecated("Asset ID parameter is deprecated. Can now use `fund(address, amount)` instead.")
     @overload
+    @deprecated("Asset ID parameter is deprecated. Can now use `fund(address, amount)` instead.")
     def fund(self, address: str, amount: int, asset_id: int | None = None) -> DispenserFundResponse: ...
 
     def fund(self, address: str, amount: int, asset_id: int | None = None) -> DispenserFundResponse:  # noqa: ARG002

algokit_utils/config.py

@@ -59,7 +59,7 @@ class UpdatableConfig:
         self._trace_all: bool = False
         self._trace_buffer_size_mb: int | float = 256  # megabytes
         self._max_search_depth: int = 10
-        self._populate_app_call_resources: bool = False
+        self._populate_app_call_resources: bool = True
         self._configure_project_root()
 
     def _configure_project_root(self) -> None:
@@ -123,7 +123,7 @@ class UpdatableConfig:
         trace_all: bool = False,
         trace_buffer_size_mb: float = 256,
         max_search_depth: int = 10,
-        populate_app_call_resources: bool = False,
+        populate_app_call_resources: bool = True,
         logger: logging.Logger | None = None,
     ) -> None:
         """
@@ -134,7 +134,7 @@ class UpdatableConfig:
         :param trace_all: Whether to trace all operations. Defaults to False.
         :param trace_buffer_size_mb: The trace buffer size in megabytes. Defaults to 256.
         :param max_search_depth: The maximum depth to search for a specific file. Defaults to 10.
-        :param populate_app_call_resources: Whether to populate app call resources. Defaults to False.
+        :param populate_app_call_resources: Whether to populate app call resources. Defaults to True.
         :param logger: A custom logger to use. Defaults to AlgoKitLogger instance.
         """
         if logger is not None:

algokit_utils/transactions/transaction_composer.py

@@ -831,7 +831,11 @@ def prepare_group_for_sending(  # noqa: C901, PLR0912, PLR0915
     """
     # Get execution info via simulation
     execution_info = _get_group_execution_info(
-        atc, algod, populate_app_call_resources, cover_app_call_inner_transaction_fees, additional_atc_context
+        atc,
+        algod,
+        populate_app_call_resources if populate_app_call_resources is not None else config.populate_app_call_resource,
+        cover_app_call_inner_transaction_fees,
+        additional_atc_context,
     )
     max_fees = additional_atc_context.max_fees if additional_atc_context else None
 
@@ -1971,8 +1975,7 @@ class TransactionComposer:
         pattern = r"^[a-zA-Z0-9][a-zA-Z0-9_/@.-]{4,31}$"
         if not re.match(pattern, note["dapp_name"]):
             raise ValueError(
-                "dapp_name must be 5-32 chars, start with alphanumeric, "
-                "and contain only alphanumeric, _, /, @, ., or -"
+                "dapp_name must be 5-32 chars, start with alphanumeric, and contain only alphanumeric, _, /, @, ., or -"
             )
 
         data = note["data"]

{algokit_utils-3.0.3b1.dist-info → algokit_utils-4.0.0b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: algokit-utils
-Version: 3.0.3b1
+Version: 4.0.0b1
 Summary: Utilities for Algorand development for use by AlgoKit
 License: MIT
 Author: Algorand Foundation

{algokit_utils-3.0.3b1.dist-info → algokit_utils-4.0.0b1.dist-info}/RECORD

@@ -14,7 +14,7 @@ algokit_utils/_legacy_v2/models.py,sha256=hH7aO50E4po4EgxXI9zdX5HTthn1HLfSLvkuPf
 algokit_utils/_legacy_v2/network_clients.py,sha256=z_zm1da9CVBG2TOAnXeYkHBh6a8HtXsSdNrlEizc8J0,5928
 algokit_utils/account.py,sha256=gyGrBSoafUh8WV677IzYGkYoxtzzElsgxGMp4SgA4pk,410
 algokit_utils/accounts/__init__.py,sha256=_LyY0se6TaQOes7vAcmbpt6pmG4VKlzfTt37-IjwimA,138
-algokit_utils/accounts/account_manager.py,sha256=LEqAp4AAssUugWG4PkOHw9oVmhIK-iZMGYcR7_q6zT0,38997
+algokit_utils/accounts/account_manager.py,sha256=l0rvCbkvOfALAXZlaookZkhqDCeePtdXIohkEyhHTNM,42282
 algokit_utils/accounts/kmd_account_manager.py,sha256=qPlklyoIk0B6B78GZX-VKwSgmfZBKgp5U2k51fg1YXg,6459
 algokit_utils/algorand.py,sha256=OvYMolOGK-tupKLDohtP_P59jlELIWW2hRqf1CYfrns,13732
 algokit_utils/application_client.py,sha256=5UIxXIBjukjRyjZPCeXmaNlAftbb3TziV7EfBolW79k,337
@@ -39,9 +39,9 @@ algokit_utils/beta/client_manager.py,sha256=xDFvsMSha0Ki42BGvKvfScQWT_W9y4GeP_RW
 algokit_utils/beta/composer.py,sha256=xDFvsMSha0Ki42BGvKvfScQWT_W9y4GeP_RWXjc3vnE,213
 algokit_utils/clients/__init__.py,sha256=qUuKBvfLnw4z6ZU9x7mc-mLjfnnXC9UcvtoeU33ZLJ8,136
 algokit_utils/clients/client_manager.py,sha256=eTkgaDVRl-auRnd_t3tQQzdrpLky6I1rQLR_1ZUXmrw,28615
-algokit_utils/clients/dispenser_api_client.py,sha256=TL4BZqRS81y55NVi_1Fczqkw8EmRcRavHTHkaSLw-t4,7336
+algokit_utils/clients/dispenser_api_client.py,sha256=3TgbnQsDmC9zSfDIykwNKDadbXLhQKZxUSbPwTDJISY,7336
 algokit_utils/common.py,sha256=5wl83vWw91RYdEC4hTTufqaptKiFtgjKLIyONDmRSH0,300
-algokit_utils/config.py,sha256=SFqfR_JKlx-pCOps1xF646oZqtIcRS2AtasiYne63E4,6051
+algokit_utils/config.py,sha256=CvDH5B8uPWnm6wCHHlMsl-0lONzq26vPLvwmnbw7c-k,6048
 algokit_utils/deploy.py,sha256=UUtSDI6JcBUuto62FuirhUlDcjZwQyLkiERgDMx8P7A,330
 algokit_utils/dispenser_api.py,sha256=-EO4Dq3q_v4kSMey43kXJfoX8uCBPJpjEMTlLI7xn_I,324
 algokit_utils/errors/__init__.py,sha256=CmuiLVjzMAOYxPaIIwmYCNArsso_RtS2ssFoNdp5CMs,61
@@ -61,10 +61,10 @@ algokit_utils/protocols/account.py,sha256=CowaVY7ErBP84TWBHNvBjkZy18whPb8HIlMZtJ
 algokit_utils/protocols/typed_clients.py,sha256=UrQrHbN2SvS8pEFJ8JQodvouoWeBrQOQGZGyBQx1KLM,3322
 algokit_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 algokit_utils/transactions/__init__.py,sha256=7fYF3m6DyOGzbV36MT5svo0wSkj9AIz496kWgIWSAlk,225
-algokit_utils/transactions/transaction_composer.py,sha256=x_pCYWaOQvigzTWPN9KwnmUZGC_MvgxYsCtY0HXqJPw,104042
+algokit_utils/transactions/transaction_composer.py,sha256=66_vY6DNs4gDhLRAamtzzo7oeLM8nxS9QKwZY_tidYc,104138
 algokit_utils/transactions/transaction_creator.py,sha256=cuP6Xm-fhGoCc2FNSbLiEg3iQRwW38rfdTzsqPyEcpM,29053
 algokit_utils/transactions/transaction_sender.py,sha256=foK_2S-gUl9D7xkWG3lD526qIKz5mVibHNKVREQCgoA,50079
-algokit_utils-3.0.3b1.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-3.0.3b1.dist-info/METADATA,sha256=c58s4IG_nnES-xqFkIJk6EMTcvq9FpRiTEmIxDqumYw,2420
-algokit_utils-3.0.3b1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-algokit_utils-3.0.3b1.dist-info/RECORD,,
+algokit_utils-4.0.0b1.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-4.0.0b1.dist-info/METADATA,sha256=-CeJCqIsrFuSwcVFmddL10YlmK4oIVK6Vm-gNl4gxEQ,2420
+algokit_utils-4.0.0b1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+algokit_utils-4.0.0b1.dist-info/RECORD,,