feat: algokit-cli v2 (#462)

* feat: Add puyapy compile integration (#457)

* feat: enable puya integration

* chore: doc

* chore: refactor compile command and enhance the docs

* docs: wording tweaks to the compile docs

* chore: change install to run, as I think it is the behaviour we want

* chore: fix snapshots

* fix: resolve issue running on windows

* chore: add info about PuyaPy Python version and matching behaviour.

* chore: fix snapshots

* chore: wording tweaks

* chore: allowing running puya with no color

* docs: adjust compile command terminology

---------

Co-authored-by: Neil Campbell <[email protected]>

* feat: command orchestration (#446)

* chore: algokit project poc

* feat: initial implementation

* chore: merge conflicts

* chore: fixing ruff errors

* chore: regen docs

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: minor refinements; adding env var passing; verbose validation

* chore: testing ci

* chore: patching docstrings

* chore: patching tests

* chore: testing ci

* docs: refining documentation and further polish

* chore: adding option to pass custom env file

* chore: addressing pr comments on docs

Co-authored-by: Neil Campbell <[email protected]>

* chore: fix line too long

* chore: removing typos; minor tweaks

* feat: linking and project listing commands (#450)

* chore: env_file file param; list command; link command

* chore: wip

* chore: wip

* chore: wip

* chore: wip

* chore: making deploy and bootstrap compatible with workspaces

* chore: wip

* chore: test

* chore: wip

* chore: wip

* feat: initial implementation of link and list commands; github folder handler

* chore: windows compatibility

* test: fixing windows compatibility

* chore: minor tweaks

* docs: pr feedback

Co-authored-by: Neil Campbell <[email protected]>

* chore: addressing pr feedback

* docs: regen docs

* chore: addressing pr feedback

* chore: minor refinements

* docs: minor paraphrasing of help strings

* chore: refining link behaviour; extra test case

---------

Co-authored-by: Neil Campbell <[email protected]>

* chore: merge conflicts

* chore: extra test cases

* fix: enforce utf-8 encoding to proc.run by default; do not resolve run cmd until run

* chore: addressing pr feedback

* chore: minor tweaks

* chore: adjusting beaker to point to feat branch

* chore: minor refinements

* chore: adding tealscript to point to temp feature branch

* chore: patching docs

* fix: adding search glob for arc32.json prefixed specs

* feat: orchestration pr feedback (#460)

* fix: addressing pr comments; minor improvements

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: testing ci

* chore: wip

* docs: regen docs

* fix: windows bug during git init

* chore: regen tests

* chore: fix test issues

* chore: minor refinements

* chore: renaming puya to python

* docs: regen docs

* chore: renaming puya template repo

* chore: merge conflicts

---------

Co-authored-by: Neil Campbell <[email protected]>

* chore: pin algokit client generator version (#455)

* chore: pin the generator client version by user

* fix: checking for available version

* fix: mypy issues

* test: adding tests

* chore: fix ruff errors

* chore: fix a test and ruff

* chore: update docs

* chore: add a log for a testing

* chore: update logs

* chore: revert the algokit-client-generator dependency

* chore: revert the lock file

* fix: github test on macos

* fix: get use of installed versions

* test: add tests

* fix: some tests

* test: fix some snapshots

* chore: fix ruff

* chore: fix test and pipx run command in windows

* feat: add support for finding a project installed python client generator command

* feat: add support for finding a globally installed ts client generator command

* chore: update docs

* chore: add some debug logs

* chore: update snapshots

* chore: add more tests

* chore: tweak

* chore: merging v2 into branch

* chore: remove orig

* chore: refine test cases for link command

---------

Co-authored-by: Neil Campbell <[email protected]>
Co-authored-by: Altynbek Orumbayev <[email protected]>

* chore: add version option to link command

* chore: minor fixes

* docs: update readme

* docs: add Algorand Python and TEALScript to readme

* chore: change puya to puyapy

* chore: fix windows compile test

* chore: fix test

* chore: ignore test for now

* chore: fix windows compile test

* chore: temporarily disable test

* fix: fixing an issue causing workspace nesting check even if user said yes to overwrite

* chore: use version rather than help for puyapy detects

* docs: update example contract in docs

* chore: removing tmp branches on templates

BREAKING CHANGE: 2.0 release

---------

Co-authored-by: Hoang Dinh <[email protected]>
Co-authored-by: Neil Campbell <[email protected]>
Co-authored-by: Negar <[email protected]>

.github/actions/setup-poetry/action.yaml

@@ -15,7 +15,7 @@ runs:
       run: |
         pip install --user pipx
         pipx ensurepath
-        pipx install poetry
+        pipx install poetry ${{ runner.os == 'macOS' && '--python "$Python_ROOT_DIR/bin/python"' || '' }}
       shell: bash
 
     - name: Get full Python version

.github/workflows/build-python.yaml

@@ -28,7 +28,7 @@ jobs:
 
       - name: Install PuyaPy
         if: ${{ matrix.python == '3.12' }}
-        run: pipx install puya
+        run: pipx install puyapy
 
       - name: pytest
         shell: bash

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
         entry: poetry run ruff format
         language: system
         types: [python]
-        args: []
+        args: [--no-cache]
         require_serial: true
         additional_dependencies: []
         minimum_pre_commit_version: "0"
@@ -17,7 +17,7 @@ repos:
         entry: poetry run ruff
         language: system
         "types": [python]
-        args: [--fix]
+        args: [--fix, --no-cache]
         require_serial: false
         additional_dependencies: []
         minimum_pre_commit_version: "0"

README.md

@@ -46,9 +46,8 @@ AlgoKit helps you develop Algorand solutions:
 - **Development**: AlgoKit provides SDKs, tools and libraries that help you quickly and effectively build high quality Algorand solutions:
   - **AlgoKit Utils** ([Python](https://github.com/algorandfoundation/algokit-utils-py#readme) | [TypeScript](https://github.com/algorandfoundation/algokit-utils-ts#readme)): A set of utility libraries so you can develop, test, build and deploy Algorand solutions quickly and easily
     - [algosdk](https://developer.algorand.org/docs/sdks/) ([Python](https://github.com/algorand/py-algorand-sdk#readme) | [TypeScript](https://github.com/algorand/js-algorand-sdk#readme)) - The core Algorand SDK providing Algorand protocol API calls, which AlgoKit Utils wraps, but still exposes for advanced scenarios
-  - [**Beaker**](https://beaker.algo.xyz/): A productive Python framework for building Smart Contracts on Algorand.
-    - [PyTEAL](https://pyteal.readthedocs.io/en/stable/): The Python language bindings for Algorand Smart Contracts, which Beaker wraps
-    - [TEAL](https://developer.algorand.org/docs/get-details/dapps/smart-contracts/): Transaction Execution Approval Language (TEAL) is the assembly-like language interpreted by the Algorand Virtual Machine (AVM) running within an Algorand node, which Beaker exports
+  - [**Algorand Python**](https://github.com/algorandfoundation/puya): A semantically and syntactically compatible, typed Python language that works with standard Python tooling and allows you to express smart contracts (apps) and smart signatures (logic signatures) for deployment on the Algorand Virtual Machine (AVM).
+  - [**TEALScript**](https://github.com/algorandfoundation/TEALScript): A subset of TypeScript that can be used to express smart contracts (apps) and smart signatures (logic signatures) for deployment on the Algorand Virtual Machine (AVM).
   - [**AlgoKit LocalNet**](https://github.com/algorandfoundation/algokit-cli/blob/main/docs/features/localnet.md): A local isolated Algorand network so you can simulate real transactions and workloads on your computer
 
 ### Operate
@@ -62,7 +61,7 @@ AlgoKit comes with out-of-the-box [Continuous Integration / Continuous Deploymen
 The set of capabilities supported by AlgoKit will evolve over time, but currently includes:
 
 - Quickly run, explore and interact with an isolated local Algorand network (LocalNet)
-- Building, testing, deploying and calling [Algorand PyTEAL](https://github.com/algorand/pyteal) / [Beaker](https://beaker.algo.xyz/) smart contracts
+- Building, testing, deploying and calling [Algorand Python](https://github.com/algorandfoundation/puya) / [TEALScript](https://github.com/algorandfoundation/TEALScript) smart contracts
 
 For a user guide and guidance on how to use AlgoKit, please refer to the [docs](https://github.com/algorandfoundation/algokit-cli/blob/main/docs/algokit.md).
 
@@ -83,7 +82,7 @@ This is an open source project managed by the Algorand Foundation. See the [cont
 
 ## Prerequisites
 
-The key required dependency is Python 3.10+, but some of the installation options below will install that for you.
+The key required dependency is Python 3.10+, but some of the installation options below will install that for you. We recommend using Python 3.12+, as the `algokit compile python` command requires this version.
 
 AlgoKit also has some runtime dependencies that also need to be available for particular commands.
 
@@ -126,10 +125,12 @@ AlgoKit can be installed using OS specific package managers, or using the python
       > **App Installer python.exe** or **App Installer python3.exe**.
 
    3. Install pipx:
+
       ```
       pip install --user pipx
       python -m pipx ensurepath
       ```
+
    4. Restart the terminal to ensure pipx is available on the path
    5. Install AlgoKit via pipx: `pipx install algokit`
    6. Restart the terminal to ensure AlgoKit is available on the path