algokit-utils 3.0.0b11__py3-none-any.whl → 3.0.1b1__py3-none-any.whl

algokit_utils/_legacy_v2/_transfer.py

@@ -17,7 +17,6 @@ __all__ = ["TransferAssetParameters", "TransferParameters", "transfer", "transfe
 logger = logging.getLogger(__name__)
 
 
-@deprecated("Send transactions via `algorand.{send|create_transaction}.{txn_type}()` instead")
 @dataclasses.dataclass(kw_only=True)
 class TransferParametersBase:
     """Parameters for transferring µALGOs between accounts.

algokit_utils/accounts/account_manager.py

@@ -32,8 +32,6 @@ from algokit_utils.transactions.transaction_composer import (
 )
 from algokit_utils.transactions.transaction_sender import SendSingleTransactionResult
 
-logger = config.logger
-
 __all__ = [
     "AccountInformation",
     "AccountManager",
@@ -595,7 +593,7 @@ class AccountManager:
             self.rekeyed(sender=account, account=rekey_to)
 
         if not suppress_log:
-            logger.info(f"Rekeyed {sender_address} to {rekey_address} via transaction {result.tx_ids[-1]}")
+            config.logger.info(f"Rekeyed {sender_address} to {rekey_address} via transaction {result.tx_ids[-1]}")
 
         return result
 

algokit_utils/accounts/kmd_account_manager.py

@@ -11,8 +11,6 @@ from algokit_utils.transactions.transaction_composer import PaymentParams, Trans
 
 __all__ = ["KmdAccount", "KmdAccountManager"]
 
-logger = config.logger
-
 
 class KmdAccount(SigningAccount):
     """Account retrieved from KMD with signing capabilities, extending base Account.
@@ -121,7 +119,7 @@ class KmdAccountManager:
         account = self.get_wallet_account(name)
         assert account is not None
 
-        logger.info(
+        config.logger.info(
             f"LocalNet account '{name}' doesn't yet exist; created account {account.address} "
             f"with keys stored in KMD and funding with {fund_with} ALGO"
         )

algokit_utils/applications/app_deployer.py

@@ -47,8 +47,6 @@ __all__ = [
 
 APP_DEPLOY_NOTE_DAPP: str = "ALGOKIT_DEPLOYER"
 
-logger = config.logger
-
 
 @dataclasses.dataclass
 class AppDeploymentMetaData:
@@ -240,7 +238,7 @@ class AppDeployer:
         send_params = deployment.send_params or SendParams()
         suppress_log = send_params.get("suppress_log") or False
 
-        logger.info(
+        config.logger.info(
             f"Idempotently deploying app \"{deployment.metadata.name}\" from creator "
             f"{deployment.create_params.sender} using {len(deployment.create_params.approval_program)} bytes of "
             f"{'teal code' if isinstance(deployment.create_params.approval_program, str) else 'AVM bytecode'} and "
@@ -341,7 +339,7 @@ class AppDeployer:
         )
 
         if is_schema_break:
-            logger.warning(
+            config.logger.warning(
                 f"Detected a breaking app schema change in app {existing_app.app_id}:",
                 extra={
                     "from": {
@@ -363,6 +361,10 @@ class AppDeployer:
             )
 
         if is_update:
+            config.logger.info(
+                f"Detected a TEAL update in app {existing_app.app_id} for creator {deployment.create_params.sender}",
+                extra={"suppress_log": suppress_log},
+            )
             return self._handle_update(
                 deployment=deployment,
                 existing_app=existing_app,
@@ -370,7 +372,7 @@ class AppDeployer:
                 clear_program=clear_program,
             )
 
-        logger.debug("No detected changes in app, nothing to do.", extra={"suppress_log": suppress_log})
+        config.logger.debug("No detected changes in app, nothing to do.", extra={"suppress_log": suppress_log})
         return AppDeployResult(
             app=existing_app,
             operation_performed=OperationPerformed.Nothing,
@@ -422,7 +424,7 @@ class AppDeployer:
         )
 
         self._update_app_lookup(deployment.create_params.sender, app_metadata)
-        logger.debug(
+        config.logger.debug(
             f"Sent transaction ID {create_result.app_id} (AppCreate) from {deployment.create_params.sender}",
             extra={
                 "suppress_log": deployment.send_params.get("suppress_log") or False if deployment.send_params else False
@@ -500,7 +502,7 @@ class AppDeployer:
             deleted=False,
         )
         self._update_app_lookup(deployment.create_params.sender, app_metadata)
-        logger.debug(
+        config.logger.debug(
             f"Group transaction sent: Replaced app {existing_app.app_id} with new app {app_id} from "
             f"{deployment.create_params.sender} (Composer group count: {composer.count()})",
             extra={
@@ -559,7 +561,7 @@ class AppDeployer:
         )
 
         self._update_app_lookup(deployment.create_params.sender, app_metadata)
-        logger.debug(
+        config.logger.debug(
             f"Sent transaction ID {existing_app.app_id} (AppUpdate) from {deployment.create_params.sender}",
             extra={
                 "suppress_log": deployment.send_params.get("suppress_log") or False if deployment.send_params else False
@@ -579,24 +581,37 @@ class AppDeployer:
         approval_program: bytes,
         clear_program: bytes,
     ) -> AppDeployResult:
+        suppress_log = deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+
         if deployment.on_schema_break in (OnSchemaBreak.Fail, "fail") or deployment.on_schema_break is None:
             raise ValueError(
-                "Schema break detected and onSchemaBreak=OnSchemaBreak.Fail, stopping deployment. "
+                "Schema break detected and on_schema_break=OnSchemaBreak.Fail, stopping deployment. "
                 "If you want to try deleting and recreating the app then "
-                "re-run with onSchemaBreak=OnSchemaBreak.ReplaceApp"
+                "re-run with on_schema_break=OnSchemaBreak.ReplaceApp"
             )
 
         if deployment.on_schema_break in (OnSchemaBreak.AppendApp, "append"):
+            config.logger.info(
+                "on_schema_break=AppendApp, will attempt to create a new app", extra={"suppress_log": suppress_log}
+            )
             return self._create_app(deployment, approval_program, clear_program)
 
         if existing_app.deletable:
-            return self._replace_app(deployment, existing_app, approval_program, clear_program)
+            config.logger.info(
+                "App is deletable and on_schema_break=ReplaceApp, will attempt to create new app and delete old app",
+                extra={"suppress_log": suppress_log},
+            )
         else:
-            raise ValueError(
-                f"App is {'not' if not existing_app.deletable else ''} deletable and onSchemaBreak=ReplaceApp, "
-                "cannot delete and recreate app"
+            config.logger.info(
+                "App is not deletable but on_schema_break=ReplaceApp, will attempt to create a new app and "
+                "delete the old app, delete will most likely fail",
+                extra={
+                    "suppress_log": suppress_log,
+                },
             )
 
+        return self._replace_app(deployment, existing_app, approval_program, clear_program)
+
     def _handle_update(
         self,
         deployment: AppDeployParams,
@@ -604,33 +619,49 @@ class AppDeployer:
         approval_program: bytes,
         clear_program: bytes,
     ) -> AppDeployResult:
+        suppress_log = deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+
         if deployment.on_update in (OnUpdate.Fail, "fail") or deployment.on_update is None:
             raise ValueError(
-                "Update detected and onUpdate=Fail, stopping deployment. " "Try a different onUpdate value to not fail."
+                "Update detected and on_update=Fail, stopping deployment. "
+                "Try a different on_update value to not fail."
             )
 
         if deployment.on_update in (OnUpdate.AppendApp, "append"):
+            config.logger.info(
+                "on_update=AppendApp, will attempt to create a new app", extra={"suppress_log": suppress_log}
+            )
             return self._create_app(deployment, approval_program, clear_program)
 
         if deployment.on_update in (OnUpdate.UpdateApp, "update"):
             if existing_app.updatable:
-                return self._update_app(deployment, existing_app, approval_program, clear_program)
+                config.logger.info(
+                    "App is updatable and on_update=UpdateApp, updating app...",
+                    extra={"suppress_log": suppress_log},
+                )
             else:
-                raise ValueError(
-                    f"App is {'not' if not existing_app.updatable else ''} updatable and onUpdate=UpdateApp, "
-                    "cannot update app"
+                config.logger.warning(
+                    "App is not updatable but on_update=UpdateApp, will attempt to update app, "
+                    "update will most likely fail",
+                    extra={"suppress_log": suppress_log},
                 )
+            return self._update_app(deployment, existing_app, approval_program, clear_program)
 
         if deployment.on_update in (OnUpdate.ReplaceApp, "replace"):
             if existing_app.deletable:
-                return self._replace_app(deployment, existing_app, approval_program, clear_program)
+                config.logger.warning(
+                    "App is deletable and on_update=ReplaceApp, will attempt to create new app and delete old app",
+                    extra={"suppress_log": suppress_log},
+                )
             else:
-                raise ValueError(
-                    f"App is {'not' if not existing_app.deletable else ''} deletable and onUpdate=ReplaceApp, "
-                    "cannot delete and recreate app"
+                config.logger.warning(
+                    "App is not deletable but on_update=ReplaceApp, will attempt to create a new app and "
+                    "delete the old app, delete will most likely fail",
+                    extra={"suppress_log": suppress_log},
                 )
+            return self._replace_app(deployment, existing_app, approval_program, clear_program)
 
-        raise ValueError(f"Unsupported onUpdate value: {deployment.on_update}")
+        raise ValueError(f"Unsupported on_update value: {deployment.on_update}")
 
     def _update_app_lookup(self, sender: str, app_metadata: ApplicationMetaData) -> None:
         """Update the app lookup cache"""
@@ -715,7 +746,7 @@ class AppDeployer:
                         deleted=app.get("deleted", False),
                     )
             except Exception as e:
-                logger.warning(
+                config.logger.warning(
                     f"Error processing app {app_id} for creator {creator_address}: {e}",
                 )
                 continue

algokit_utils/clients/dispenser_api_client.py

@@ -22,9 +22,6 @@ __all__ = [
 ]
 
 
-logger = config.logger
-
-
 class DispenserApiConfig:
     BASE_URL = "https://api.dispenser.algorandfoundation.tools"
 
@@ -141,7 +138,7 @@ class TestNetDispenserApiClient:
 
         except Exception as err:
             error_message = "Error processing dispenser API request"
-            logger.debug(f"{error_message}: {err}", exc_info=True)
+            config.logger.debug(f"{error_message}: {err}", exc_info=True)
             raise err
 
     @overload
@@ -182,7 +179,7 @@ class TestNetDispenserApiClient:
             return DispenserFundResponse(tx_id=content["txID"], amount=content["amount"])
 
         except Exception as err:
-            logger.exception(f"Error funding account {address}: {err}")
+            config.logger.exception(f"Error funding account {address}: {err}")
             raise err
 
     def refund(self, refund_txn_id: str) -> None:
@@ -199,7 +196,7 @@ class TestNetDispenserApiClient:
             )
 
         except Exception as err:
-            logger.exception(f"Error issuing refund for txn_id {refund_txn_id}: {err}")
+            config.logger.exception(f"Error issuing refund for txn_id {refund_txn_id}: {err}")
             raise err
 
     def get_limit(
@@ -220,5 +217,5 @@ class TestNetDispenserApiClient:
 
             return DispenserLimitResponse(amount=content["amount"])
         except Exception as err:
-            logger.exception(f"Error setting limit for account {address}: {err}")
+            config.logger.exception(f"Error setting limit for account {address}: {err}")
             raise err

algokit_utils/transactions/transaction_composer.py

@@ -75,8 +75,6 @@ __all__ = [
 ]
 
 
-logger = config.logger
-
 MAX_TRANSACTION_GROUP_SIZE = 16
 MAX_APP_CALL_FOREIGN_REFERENCES = 8
 MAX_APP_CALL_ACCOUNT_REFERENCES = 4
@@ -1220,11 +1218,11 @@ def send_atomic_transaction_composer(  # noqa: C901, PLR0912
             )
 
             if not suppress_log:
-                logger.info(
+                config.logger.info(
                     f"Sending group of {len(transactions_to_send)} transactions ({group_id})",
                     extra={"suppress_log": suppress_log or False},
                 )
-                logger.debug(
+                config.logger.debug(
                     f"Transaction IDs ({group_id}): {[t.get_txid() for t in transactions_to_send]}",
                     extra={"suppress_log": suppress_log or False},
                 )
@@ -1244,12 +1242,12 @@ def send_atomic_transaction_composer(  # noqa: C901, PLR0912
         # Log results
         if not suppress_log:
             if len(transactions_to_send) > 1:
-                logger.info(
+                config.logger.info(
                     f"Group transaction ({group_id}) sent with {len(transactions_to_send)} transactions",
                     extra={"suppress_log": suppress_log or False},
                 )
             else:
-                logger.info(
+                config.logger.info(
                     f"Sent transaction ID {transactions_to_send[0].get_txid()}",
                     extra={"suppress_log": suppress_log or False},
                 )
@@ -1271,7 +1269,7 @@ def send_atomic_transaction_composer(  # noqa: C901, PLR0912
     except Exception as e:
         # Handle error with debug info if enabled
         if config.debug:
-            logger.error(
+            config.logger.error(
                 "Received error executing Atomic Transaction Composer and debug flag enabled; "
                 "attempting simulation to get more information ",
                 extra={"suppress_log": suppress_log or False},
@@ -1307,7 +1305,7 @@ def send_atomic_transaction_composer(  # noqa: C901, PLR0912
             error.traces = traces  # type: ignore[attr-defined]
             raise error from e
 
-        logger.error(
+        config.logger.error(
             "Received error executing Atomic Transaction Composer, for more information enable the debug flag",
             extra={"suppress_log": suppress_log or False},
             exc_info=e,

algokit_utils/transactions/transaction_sender.py

@@ -45,8 +45,6 @@ __all__ = [
     "SendSingleTransactionResult",
 ]
 
-logger = config.logger
-
 
 TxnParamsT = TypeVar("TxnParamsT", bound=TxnParams)
 
@@ -213,7 +211,7 @@ class AlgorandClientTransactionSender:
 
             if pre_log:
                 transaction = composer.build().transactions[-1].txn
-                logger.debug(pre_log(params, transaction))
+                config.logger.debug(pre_log(params, transaction))
 
             raw_result = composer.send(
                 send_params,
@@ -230,7 +228,7 @@ class AlgorandClientTransactionSender:
             )
 
             if post_log:
-                logger.debug(post_log(params, result))
+                config.logger.debug(post_log(params, result))
 
             return result
 
@@ -659,9 +657,9 @@ class AlgorandClientTransactionSender:
 
     def asset_opt_out(
         self,
-        *,
         params: AssetOptOutParams,
         send_params: SendParams | None = None,
+        *,
         ensure_zero_balance: bool = True,
     ) -> SendSingleTransactionResult:
         """Opt an account out of an Algorand Standard Asset.

{algokit_utils-3.0.0b11.dist-info → algokit_utils-3.0.1b1.dist-info}/METADATA

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

{algokit_utils-3.0.0b11.dist-info → algokit_utils-3.0.1b1.dist-info}/RECORD

@@ -2,7 +2,7 @@ algokit_utils/__init__.py,sha256=he0sKUGvOgN2ROlXJ_6GOBqElfoDy3c5_XgVA3BYACU,103
 algokit_utils/_debugging.py,sha256=nAiC10WXiZsvc0RPWOrMLpjJQZT_ItgcMl7D9Z4DfYc,11703
 algokit_utils/_legacy_v2/__init__.py,sha256=WcRE30axWjGnBB09bJCeTw9NT-2_jDN_CVJITFcIDc8,4689
 algokit_utils/_legacy_v2/_ensure_funded.py,sha256=_k3hc_xL-_KOEmvF3mofk-Z2D1n8dSo9Rz8OLqPnoNg,6912
-algokit_utils/_legacy_v2/_transfer.py,sha256=xe_o4sK2oRUlX0TxLSQ_ttJy_3KXfvEEWFKUl_sZNlk,6559
+algokit_utils/_legacy_v2/_transfer.py,sha256=nMHm3jXKJLLjOLqjMK_B3bFsslDCx45EPJ5yt7Ex-8k,6464
 algokit_utils/_legacy_v2/account.py,sha256=mv5GjHlIPKNr3dx1FI1aAYFiJqeVpCbf0mTUXeYu0UU,8314
 algokit_utils/_legacy_v2/application_client.py,sha256=Gb7WldXLi0V92YfeU19HP1rJ-L4Rmz2Lxm2q45tQJ2s,59610
 algokit_utils/_legacy_v2/application_specification.py,sha256=wp2Y9ou2_F-bSFbDnm6AEhFexybmD7-fAT0CuWtO26g,521
@@ -14,15 +14,15 @@ 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=j8gzQRrsCjjziHgYzN2msbF6xtFsFIxefSWq5s4vWtQ,39014
-algokit_utils/accounts/kmd_account_manager.py,sha256=0flsU5T11JciyL0YvOKDHPVSm-ghV0RjJAbtm8JwrhU,6476
+algokit_utils/accounts/account_manager.py,sha256=LEqAp4AAssUugWG4PkOHw9oVmhIK-iZMGYcR7_q6zT0,38997
+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
 algokit_utils/application_specification.py,sha256=wV0H088IudMqlxsW-gsZIfJyKA4e-zVwxJ-cR__ouBA,1379
 algokit_utils/applications/__init__.py,sha256=NGjhpBeExsQZOAYCT2QUFag1xuKoFiX-Ux5SR2GNzd8,452
 algokit_utils/applications/abi.py,sha256=OjTdn4szJPPeC8XmosdDYtkIIVgQSWAnqz2DHw5OH9g,10117
 algokit_utils/applications/app_client.py,sha256=wM3tH0-oW6uQG_W0RLiL3iULnvAPpNM-O9BiPw5wfiU,88470
-algokit_utils/applications/app_deployer.py,sha256=y0hl_m2pkKF_tGR2sjKL0sbIW3qyUe9ttzcGboGBSi4,28938
+algokit_utils/applications/app_deployer.py,sha256=kAypS20VM-yAwosCcYdMwTmXntGOt_6EN_i5nIYN5rw,30627
 algokit_utils/applications/app_factory.py,sha256=PPJnR-fs1hNkEMlIqwY7jx63hPnOkdyiIK6l4-A3d10,45383
 algokit_utils/applications/app_manager.py,sha256=wDrJW-YtArRldNk5Nh9Mf-DwEz9XTjKD1Q0z4O_WPTY,21904
 algokit_utils/applications/app_spec/__init__.py,sha256=HtjAhAqHNFml9WbRKGmhJnwyJeW8AztPRO_BriQ84vs,140
@@ -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=jpwAeoWWjbDdZWPs3UMoDBdPgxgQlk4D3htRJuPLnPw,7333
+algokit_utils/clients/dispenser_api_client.py,sha256=TL4BZqRS81y55NVi_1Fczqkw8EmRcRavHTHkaSLw-t4,7336
 algokit_utils/common.py,sha256=5wl83vWw91RYdEC4hTTufqaptKiFtgjKLIyONDmRSH0,300
 algokit_utils/config.py,sha256=SFqfR_JKlx-pCOps1xF646oZqtIcRS2AtasiYne63E4,6051
 algokit_utils/deploy.py,sha256=UUtSDI6JcBUuto62FuirhUlDcjZwQyLkiERgDMx8P7A,330
@@ -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=rbUKQCv8yzAGFm9Jegw3F0V9PbMaPOK-oQxHIm5jCZA,103692
+algokit_utils/transactions/transaction_composer.py,sha256=0o7rAAy-2L6tx4xWsb4EHk7bayME_02xHLmkeHfHQM8,103710
 algokit_utils/transactions/transaction_creator.py,sha256=cuP6Xm-fhGoCc2FNSbLiEg3iQRwW38rfdTzsqPyEcpM,29053
-algokit_utils/transactions/transaction_sender.py,sha256=FXwFLRPCBodfbXM6IpO9zFWU4xGQR1hEJe4sLBooe10,50089
-algokit_utils-3.0.0b11.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-3.0.0b11.dist-info/METADATA,sha256=grhHt90Tp6YujupdRsSBWiwe9z6REeqB93r882b7fkA,2421
-algokit_utils-3.0.0b11.dist-info/WHEEL,sha256=7dDg4QLnNKTvwIDR9Ac8jJaAmBC_owJrckbC0jjThyA,88
-algokit_utils-3.0.0b11.dist-info/RECORD,,
+algokit_utils/transactions/transaction_sender.py,sha256=foK_2S-gUl9D7xkWG3lD526qIKz5mVibHNKVREQCgoA,50079
+algokit_utils-3.0.1b1.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-3.0.1b1.dist-info/METADATA,sha256=MjxiL6BsXY_hb0VhVt9QPKbKOlhejwnXUocjQb7OR3w,2420
+algokit_utils-3.0.1b1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+algokit_utils-3.0.1b1.dist-info/RECORD,,

{algokit_utils-3.0.0b11.dist-info → algokit_utils-3.0.1b1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.0
+Generator: poetry-core 2.1.1
 Root-Is-Purelib: true
 Tag: py3-none-any