feat: algokit-utils-py v3 implementation

.github/workflows/check-python.yaml

@@ -45,12 +45,13 @@ jobs:
       - name: Check types with mypy
         run: poetry run mypy
 
-      - name: Check docs are up to date
-        run: |
-          poetry run poe docs
-          git diff --quiet --exit-code \
-            ':!docs/html/_sources/apidocs/algokit_utils/algokit_utils.md.txt' \
-            ':!docs/html/apidocs/algokit_utils/algokit_utils.html' \
-            ':!docs/html/searchindex.js' \
-            ':!docs/markdown/apidocs/algokit_utils/algokit_utils.md' \
-            docs/
+      # TODO: uncomment after bulk of feature parity with ts is addressed
+      # - name: Check docs are up to date
+      #   run: |
+      #     poetry run poe docs
+      #     git diff --quiet --exit-code \
+      #       ':!docs/html/_sources/apidocs/algokit_utils/algokit_utils.md.txt' \
+      #       ':!docs/html/apidocs/algokit_utils/algokit_utils.html' \
+      #       ':!docs/html/searchindex.js' \
+      #       ':!docs/markdown/apidocs/algokit_utils/algokit_utils.md' \
+      #       docs/

.gitignore

@@ -170,3 +170,6 @@ cython_debug/
 /docs/source/apidocs
 
 !docs/html
+
+# Received approval test files
+*.received.*

.pre-commit-config.yaml

@@ -23,6 +23,7 @@ repos:
         additional_dependencies: []
         minimum_pre_commit_version: "0"
         files: "^(src|tests)/"
+        exclude: "^tests/artifacts/"
       - id: mypy
         name: mypy
         description: "`mypy` will check Python types for correctness"
@@ -33,3 +34,11 @@ repos:
         additional_dependencies: []
         minimum_pre_commit_version: "2.9.2"
         files: "^(src|tests)/"
+        exclude: "^tests/artifacts/"
+      - id: docstrings-check
+        name: docstrings-check
+        description: "Check docstrings for correctness"
+        entry: poetry run poe docstrings-check
+        language: system
+        types: [python]
+        files: "^(src)/"

.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python Debugger: Current File",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "Python: Debug Tests",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "purpose": [
+                "debug-test"
+            ],
+            "console": "integratedTerminal",
+            "justMyCode": false
+        }
+    ]
+}

.vscode/settings.json

@@ -16,18 +16,24 @@
     "**/__pycache__": true,
     ".idea": true
   },
-
   // Python
   "platformSettings.autoLoad": true,
   "python.defaultInterpreterPath": "${workspaceFolder}/.venv",
-  "python.analysis.extraPaths": ["${workspaceFolder}/src"],
+  "python.analysis.extraPaths": [
+    "${workspaceFolder}/src"
+  ],
   "[python]": {
     "editor.defaultFormatter": "charliermarsh.ruff"
   },
+  "python.analysis.exclude": [
+    "tests/artifacts/**"
+  ],
   "python.analysis.typeCheckingMode": "basic",
   "ruff.enable": true,
   "ruff.lint.run": "onSave",
-  "ruff.lint.args": ["--config=pyproject.toml"],
+  "ruff.lint.args": [
+    "--config=pyproject.toml"
+  ],
   "ruff.importStrategy": "fromEnvironment",
   "ruff.fixAll": true, //lint and fix all files in workspace
   "ruff.organizeImports": true, //organize imports on save
@@ -37,7 +43,6 @@
   "ruff.codeAction.fixViolation": {
     "enable": true
   },
-
   "mypy.configFile": "pyproject.toml",
   // set to empty array to use config from project
   "mypy.targets": [],
@@ -52,11 +57,7 @@
       }
     ]
   },
-
-  // PowerShell
-  "[powershell]": {
-    "editor.defaultFormatter": "ms-vscode.powershell"
-  },
-  "powershell.codeFormatting.preset": "Stroustrup",
-  "python.testing.pytestArgs": ["."]
+  "python.testing.pytestArgs": [
+    "."
+  ],
 }

docs/markdown/index.md

@@ -7,46 +7,47 @@ The goal of this library is to provide intuitive, productive utility functions t
 Largely these functions wrap the underlying Algorand SDK, but provide a higher level interface with sensible defaults and capabilities for common tasks.
 
 #### NOTE
+
 If you prefer TypeScript there’s an equivalent [TypeScript utility library](https://github.com/algorandfoundation/algokit-utils-ts).
 
 [Core principles]() | [Installation]() | [Usage]() | [Capabilities]() | [Reference docs]()
 
 # Contents
 
-* [Account management](capabilities/account.md)
-  * [`Account`](capabilities/account.md#account)
-* [Client management](capabilities/client.md)
-  * [Network configuration](capabilities/client.md#network-configuration)
-  * [Clients](capabilities/client.md#clients)
-* [App client](capabilities/app-client.md)
-  * [Design](capabilities/app-client.md#design)
-  * [Creating an application client](capabilities/app-client.md#creating-an-application-client)
-  * [Calling methods on the app](capabilities/app-client.md#calling-methods-on-the-app)
-  * [Composing calls](capabilities/app-client.md#composing-calls)
-  * [Reading state](capabilities/app-client.md#reading-state)
-  * [Handling logic errors and diagnosing errors](capabilities/app-client.md#handling-logic-errors-and-diagnosing-errors)
-* [App deployment](capabilities/app-deploy.md)
-  * [Design](capabilities/app-deploy.md#design)
-  * [Finding apps by creator](capabilities/app-deploy.md#finding-apps-by-creator)
-  * [Deploying an application](capabilities/app-deploy.md#deploying-an-application)
-* [Algo transfers](capabilities/transfer.md)
-  * [Transferring Algos](capabilities/transfer.md#transferring-algos)
-  * [Ensuring minimum Algos](capabilities/transfer.md#ensuring-minimum-algos)
-  * [Transfering Assets](capabilities/transfer.md#transfering-assets)
-  * [Dispenser](capabilities/transfer.md#dispenser)
-* [TestNet Dispenser Client](capabilities/dispenser-client.md)
-  * [Creating a Dispenser Client](capabilities/dispenser-client.md#creating-a-dispenser-client)
-  * [Funding an Account](capabilities/dispenser-client.md#funding-an-account)
-  * [Registering a Refund](capabilities/dispenser-client.md#registering-a-refund)
-  * [Getting Current Limit](capabilities/dispenser-client.md#getting-current-limit)
-  * [Error Handling](capabilities/dispenser-client.md#error-handling)
-* [Debugger](capabilities/debugger.md)
-  * [Configuration](capabilities/debugger.md#configuration)
-  * [Debugging Utilities](capabilities/debugger.md#debugging-utilities)
-* [`algokit_utils`](apidocs/algokit_utils/algokit_utils.md)
-  * [Data](apidocs/algokit_utils/algokit_utils.md#data)
-  * [Classes](apidocs/algokit_utils/algokit_utils.md#classes)
-  * [Functions](apidocs/algokit_utils/algokit_utils.md#functions)
+- [Account management](capabilities/account.md)
+  - [`Account`](capabilities/account.md#account)
+- [Client management](capabilities/client.md)
+  - [Network configuration](capabilities/client.md#network-configuration)
+  - [Clients](capabilities/client.md#clients)
+- [App client](capabilities/app-client.md)
+  - [Design](capabilities/app-client.md#design)
+  - [Creating an application client](capabilities/app-client.md#creating-an-application-client)
+  - [Calling methods on the app](capabilities/app-client.md#calling-methods-on-the-app)
+  - [Composing calls](capabilities/app-client.md#composing-calls)
+  - [Reading state](capabilities/app-client.md#reading-state)
+  - [Handling logic errors and diagnosing errors](capabilities/app-client.md#handling-logic-errors-and-diagnosing-errors)
+- [App deployment](capabilities/app-deploy.md)
+  - [Design](capabilities/app-deploy.md#design)
+  - [Finding apps by creator](capabilities/app-deploy.md#finding-apps-by-creator)
+  - [Deploying an application](capabilities/app-deploy.md#deploying-an-application)
+- [Algo transfers](capabilities/transfer.md)
+  - [Transferring Algos](capabilities/transfer.md#transferring-algos)
+  - [Ensuring minimum Algos](capabilities/transfer.md#ensuring-minimum-algos)
+  - [Transfering Assets](capabilities/transfer.md#transfering-assets)
+  - [Dispenser](capabilities/transfer.md#dispenser)
+- [TestNet Dispenser Client](capabilities/dispenser-client.md)
+  - [Creating a Dispenser Client](capabilities/dispenser-client.md#creating-a-dispenser-client)
+  - [Funding an Account](capabilities/dispenser-client.md#funding-an-account)
+  - [Registering a Refund](capabilities/dispenser-client.md#registering-a-refund)
+  - [Getting Current Limit](capabilities/dispenser-client.md#getting-current-limit)
+  - [Error Handling](capabilities/dispenser-client.md#error-handling)
+- [Debugger](capabilities/debugger.md)
+  - [Configuration](capabilities/debugger.md#configuration)
+  - [Debugging Utilities](capabilities/debugger.md#debugging-utilities)
+- [`algokit_utils`](apidocs/algokit_utils/algokit_utils.md)
+  - [Data](apidocs/algokit_utils/algokit_utils.md#data)
+  - [Classes](apidocs/algokit_utils/algokit_utils.md#classes)
+  - [Functions](apidocs/algokit_utils/algokit_utils.md#functions)
 
 <a id="core-principles"></a>