algokit-utils 3.0.3b1__py3-none-any.whl → 3.0.3b2__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-3.0.3b1.dist-info → algokit_utils-3.0.3b2.dist-info}/METADATA

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

{algokit_utils-3.0.3b1.dist-info → algokit_utils-3.0.3b2.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,7 +39,7 @@ 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/deploy.py,sha256=UUtSDI6JcBUuto62FuirhUlDcjZwQyLkiERgDMx8P7A,330
@@ -64,7 +64,7 @@ algokit_utils/transactions/__init__.py,sha256=7fYF3m6DyOGzbV36MT5svo0wSkj9AIz496
 algokit_utils/transactions/transaction_composer.py,sha256=x_pCYWaOQvigzTWPN9KwnmUZGC_MvgxYsCtY0HXqJPw,104042
 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-3.0.3b2.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-3.0.3b2.dist-info/METADATA,sha256=YwXDja0I788_p-R2VWyYzOSSHDDvl0VRjIxAdy6-vo4,2420
+algokit_utils-3.0.3b2.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+algokit_utils-3.0.3b2.dist-info/RECORD,,