feat: adding latest changes from beaker template (debugger, typed simulate) (#2)

* feat: adding latest changes from beaker template (debugger, typed simulate)

* chore: minor tweaks

* refactor: simplifying configuration and test variations

* chore: fixing typos

* feat: Update contract.py.j2 templates

- Updated the `hello` method in the `contract.py.j2` template files to return a modified greeting message.
- The greeting message now includes a comma after "Hello" for better readability and clarity.

Author: aorumbayev

copier.yaml

@@ -30,11 +30,13 @@ author_name:
   type: str
   help: Package author name
   placeholder: "Your Name"
+  default: "Your Name"
 
 author_email:
   type: str
   help: Package author email
   placeholder: "your@email.tld"
+  default: "your@email.tld"
 
 ide_vscode:
   type: bool
@@ -55,9 +57,33 @@ deployment_language:
     TypeScript: "typescript"
   default: "python"
 
+use_python_pytest:
+  type: bool
+  when: false
+  help: Do you want to include unit tests (via pytest)?
+  # deployment_language is empty when using the default_language
+  default: |-
+    {% if deployment_language|length == 0 or deployment_language == 'python' -%}
+        yes
+    {%- else -%}
+        no
+    {%- endif %}
+
+use_typescript_jest:
+  type: bool
+  when: false
+  help: Do you want to include unit tests (via jest)?
+  default: |-
+    {% if deployment_language == 'typescript' -%}
+        yes
+    {%- else -%}
+        no
+    {%- endif %}
+
 python_linter:
   type: str
   help: Do you want to use a Python linter?
+  when: false
   choices:
     Ruff: "ruff"
     Flake8: "flake8"
@@ -67,39 +93,40 @@ python_linter:
 
 use_python_black:
   type: bool
+  when: false
   help: Do you want to use a Python formatter (via Black)?
   default: yes
 
 use_python_mypy:
   type: bool
+  when: false
   help: Do you want to use a Python type checker (via mypy)?
   default: |-
     yes
 
-use_python_pytest:
-  type: bool
-  help: Do you want to include unit tests (via pytest)?
-  default: yes
-
 use_python_pip_audit:
   type: bool
+  when: false
   help: Do you want to include Python dependency vulnerability scanning (via pip-audit)?
   default: yes
 
 use_github_actions:
   type: bool
+  when: false
   help: Do you want to include Github Actions workflows for build and testnet deployment?
   default: |-
     yes
 
 use_pre_commit:
   type: bool
+  when: false
   help: Do you want to include pre-commit for linting, type checking and formatting?
   default: |-
     yes
 
 use_dispenser:
   type: bool
+  when: false
   help: Do you want to fund your deployment account using an optional dispenser account?
   default: no
 

includes/contract_name_kebab.jinja

@@ -0,0 +1 @@
+{{- contract_name.split('_')|join('-') -}}

includes/contract_name_pascal.jinja

@@ -0,0 +1 @@
+{{- contract_name.split('_')|map('capitalize')|join -}}

template_content/.algokit.toml.jinja

@@ -1,5 +1,5 @@
 [algokit]
-min_version = "v1.7.3"
+min_version = "v1.8.0"
 
 [deploy]
 {%- if deployment_language == 'python' %}

template_content/.algokit/generators/create_contract/smart_contracts/{% raw %}{{ contract_name }}{% endraw %}/contract.py.j2

@@ -5,4 +5,4 @@ from puyapy.arc4 import String, abimethod
 class {{ contract_name.split('_')|map('capitalize')|join }}(ARC4Contract):
     @abimethod()
     def hello(self, name: String) -> String:
-        return String.encode(Bytes(b"Hello ") + name.decode())
+        return String.encode(Bytes(b"Hello, ") + name.decode())

template_content/.gitignore.jinja

@@ -50,6 +50,7 @@ coverage.xml
 .hypothesis/
 .pytest_cache/
 cover/
+coverage/
 
 # Translations
 *.mo
@@ -172,3 +173,6 @@ cython_debug/
 
 # NPM
 node_modules
+
+# AlgoKit
+debug_traces/

template_content/README.md.jinja

@@ -56,6 +56,19 @@ This project has been generated using AlgoKit. See below for default getting sta
 
 This project uses [GitHub Actions](https://docs.github.com/en/actions/learn-github-actions/understanding-github-actions) to define CI/CD workflows, which are located in the [`.github/workflows`](./.github/workflows) folder.
 
+### Debugging Smart Contracts
+
+This project is optimized to work with AlgoKit AVM Debugger extension. To activate it:
+{%- if deployment_language == 'python' %}
+Refer to the commented header in the `__main__.py` file in the `smart_contracts` folder.
+{%- elif deployment_language == 'typescript' %}
+Refer to the commented header in the `index.ts` file in the `smart_contracts` folder.
+{%- endif %}
+
+If you have opted in to include VSCode launch configurations in your project, you can also use the `Debug TEAL via AlgoKit AVM Debugger` launch configuration to interactively select an available trace file and launch the debug session for your smart contract.
+
+For information on using and setting up the `AlgoKit AVM Debugger` VSCode extension refer [here](https://github.com/algorandfoundation/algokit-avm-vscode-debugger). To install the extension from the VSCode Marketplace, use the following link: [AlgoKit AVM Debugger extension](https://marketplace.visualstudio.com/items?itemName=algorandfoundation.algokit-avm-vscode-debugger).
+
 #### Setting up GitHub for CI/CD workflow and TestNet deployment
 
   1. Every time you have a change to your smart contract, and when you first initialize the project you need to [build the contract](#initial-setup) and then commit the `smart_contracts/artifacts` folder so the [output stability](https://github.com/algorandfoundation/algokit-cli/blob/main/docs/articles/output_stability.md) tests pass

template_content/pyproject.toml.jinja

@@ -7,9 +7,9 @@ readme = "README.md"
 
 [tool.poetry.dependencies]
 python = "^3.12"
-algokit-utils = "^2.0.1"
+algokit-utils = "^2.2.0"
 python-dotenv = "^1.0.0"
-puya = "^0.1.3"
+puya = "^0.2.0"
 
 [tool.poetry.group.dev.dependencies]
 {% if use_python_black -%}

template_content/smart_contracts/__main__.py.jinja

@@ -5,13 +5,16 @@ from pathlib import Path
 from dotenv import load_dotenv
 
 from smart_contracts.config import contracts
-{% if deployment_language == 'python' -%}
 from smart_contracts.helpers.build import build
+{% if deployment_language == 'python' -%}
 from smart_contracts.helpers.deploy import deploy
-{%- elif deployment_language == 'typescript' -%}
-from smart_contracts.helpers.build import build
-{%- endif %}
 
+# Uncomment the following lines to enable auto generation of AVM Debugger compliant sourcemap and simulation trace file.
+# Learn more about using AlgoKit AVM Debugger to debug your TEAL source codes and inspect various kinds of
+# Algorand transactions in atomic groups -> https://github.com/algorandfoundation/algokit-avm-vscode-debugger
+# from algokit_utils.config import config
+# config.configure(debug=True, trace_all=True)
+{%- endif %}
 logging.basicConfig(
     level=logging.DEBUG, format="%(asctime)s %(levelname)-10s: %(message)s"
 )

template_content/smart_contracts/{% if deployment_language == 'typescript' %}index.ts{% endif %}.jinja

@@ -3,8 +3,13 @@ import * as path from 'path'
 import { consoleLogger } from '@algorandfoundation/algokit-utils/types/logging'
 import * as algokit from '@algorandfoundation/algokit-utils'
 
+// Uncomment the debug and traceAll options to enable auto generation of AVM Debugger compliant sourceMap and simulation trace file.
+// Learn more about using AlgoKit AVM Debugger to debug your TEAL source codes and inspect various kinds of Algorand transactions in atomic groups -> https://github.com/algorandfoundation/algokit-avm-vscode-Debugger
+
 algokit.Config.configure({
   logger: consoleLogger,
+  //  debug: true,
+  //  traceAll: true,
 })
 
 // base directory