feat: GitHub Codespaces support in LocalNet command group

.github/workflows/pr.yaml

@@ -1,6 +1,9 @@
-name: Pull Request validation
+name: Codebase validation
 
-on: [pull_request]
+on:
+  pull_request:
+  schedule:
+    - cron: "0 8 * * 1" # Each monday 8 AM UTC
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}

.pre-commit-config.yaml

@@ -14,7 +14,7 @@ repos:
       - id: ruff
         name: ruff
         description: "Run 'ruff' for extremely fast Python linting"
-        entry: poetry run ruff
+        entry: poetry run ruff check
         language: system
         "types": [python]
         args: [--fix, --no-cache]

docs/cli/index.md

@@ -24,48 +24,53 @@
     - [Options](#options-3)
     - [--shell ](#--shell--1)
   - [config](#config)
-    - [version-prompt](#version-prompt)
+    - [container-engine](#container-engine)
+    - [Options](#options-4)
+    - [-f, --force](#-f---force)
     - [Arguments](#arguments-2)
+    - [ENGINE](#engine)
+    - [version-prompt](#version-prompt)
+    - [Arguments](#arguments-3)
     - [ENABLE](#enable)
   - [dispenser](#dispenser)
     - [fund](#fund)
-    - [Options](#options-4)
+    - [Options](#options-5)
     - [-r, --receiver ](#-r---receiver-)
     - [-a, --amount ](#-a---amount-)
     - [--whole-units](#--whole-units)
     - [limit](#limit)
-    - [Options](#options-5)
+    - [Options](#options-6)
     - [--whole-units](#--whole-units-1)
     - [login](#login)
-    - [Options](#options-6)
+    - [Options](#options-7)
     - [--ci](#--ci)
     - [-o, --output ](#-o---output-)
     - [-f, --file ](#-f---file-)
     - [logout](#logout)
     - [refund](#refund)
-    - [Options](#options-7)
+    - [Options](#options-8)
     - [-t, --txID ](#-t---txid-)
   - [doctor](#doctor)
-    - [Options](#options-8)
+    - [Options](#options-9)
     - [-c, --copy-to-clipboard](#-c---copy-to-clipboard)
   - [explore](#explore)
-    - [Arguments](#arguments-3)
+    - [Arguments](#arguments-4)
     - [NETWORK](#network)
   - [generate](#generate)
     - [client](#client)
-    - [Options](#options-9)
+    - [Options](#options-10)
     - [-o, --output ](#-o---output--1)
     - [-l, --language ](#-l---language-)
     - [-v, --version ](#-v---version--1)
-    - [Arguments](#arguments-4)
+    - [Arguments](#arguments-5)
     - [APP_SPEC_PATH_OR_DIR](#app_spec_path_or_dir)
   - [goal](#goal)
-    - [Options](#options-10)
+    - [Options](#options-11)
     - [--console](#--console)
-    - [Arguments](#arguments-5)
+    - [Arguments](#arguments-6)
     - [GOAL_ARGS](#goal_args)
   - [init](#init)
-    - [Options](#options-11)
+    - [Options](#options-12)
     - [-n, --name ](#-n---name-)
     - [-t, --template ](#-t---template-)
     - [--template-url ](#--template-url-)
@@ -78,67 +83,81 @@
     - [--workspace, --no-workspace](#--workspace---no-workspace)
     - [-a, --answer  ](#-a---answer--)
   - [localnet](#localnet)
+    - [codespace](#codespace)
+    - [Options](#options-13)
+    - [-m, --machine ](#-m---machine-)
+    - [-a, --algod-port ](#-a---algod-port-)
+    - [-i, --indexer-port ](#-i---indexer-port-)
+    - [-k, --kmd-port ](#-k---kmd-port-)
+    - [-n, --codespace-name ](#-n---codespace-name-)
+    - [-r, --repo-url ](#-r---repo-url-)
+    - [-f, --force](#-f---force-1)
+    - [config](#config-1)
+    - [Options](#options-14)
+    - [-f, --force](#-f---force-2)
+    - [Arguments](#arguments-7)
+    - [ENGINE](#engine-1)
     - [console](#console)
     - [explore](#explore-1)
     - [logs](#logs)
-    - [Options](#options-12)
+    - [Options](#options-15)
     - [--follow, -f](#--follow--f)
     - [--tail ](#--tail-)
     - [reset](#reset)
-    - [Options](#options-13)
+    - [Options](#options-16)
     - [--update, --no-update](#--update---no-update)
     - [start](#start)
-    - [Options](#options-14)
+    - [Options](#options-17)
     - [-n, --name ](#-n---name--1)
     - [status](#status)
     - [stop](#stop)
   - [project](#project)
     - [bootstrap](#bootstrap)
-    - [Options](#options-15)
+    - [Options](#options-18)
     - [--force](#--force)
-    - [Options](#options-16)
+    - [Options](#options-19)
     - [--interactive, --non-interactive, --ci](#--interactive---non-interactive---ci)
     - [-p, --project-name ](#-p---project-name-)
     - [-t, --type ](#-t---type-)
-    - [Options](#options-17)
+    - [Options](#options-20)
     - [--interactive, --non-interactive, --ci](#--interactive---non-interactive---ci-1)
     - [deploy](#deploy)
-    - [Options](#options-18)
+    - [Options](#options-21)
     - [-C, --command ](#-c---command-)
     - [--interactive, --non-interactive, --ci](#--interactive---non-interactive---ci-2)
     - [-P, --path ](#-p---path-)
     - [--deployer ](#--deployer-)
     - [--dispenser ](#--dispenser-)
     - [-p, --project-name ](#-p---project-name--1)
-    - [Arguments](#arguments-6)
+    - [Arguments](#arguments-8)
     - [ENVIRONMENT_NAME](#environment_name)
     - [link](#link)
-    - [Options](#options-19)
+    - [Options](#options-22)
     - [-p, --project-name ](#-p---project-name--2)
     - [-l, --language ](#-l---language--1)
     - [-a, --all](#-a---all)
     - [-f, --fail-fast](#-f---fail-fast)
     - [-v, --version ](#-v---version--2)
     - [list](#list)
-    - [Arguments](#arguments-7)
+    - [Arguments](#arguments-9)
     - [WORKSPACE_PATH](#workspace_path)
     - [run](#run)
   - [task](#task)
     - [analyze](#analyze)
-    - [Options](#options-20)
+    - [Options](#options-23)
     - [-r, --recursive](#-r---recursive)
     - [--force](#--force-1)
     - [--diff](#--diff)
     - [-o, --output ](#-o---output--2)
     - [-e, --exclude ](#-e---exclude-)
-    - [Arguments](#arguments-8)
+    - [Arguments](#arguments-10)
     - [INPUT_PATHS](#input_paths)
     - [ipfs](#ipfs)
-    - [Options](#options-21)
+    - [Options](#options-24)
     - [-f, --file ](#-f---file--1)
     - [-n, --name ](#-n---name--2)
     - [mint](#mint)
-    - [Options](#options-22)
+    - [Options](#options-25)
     - [--creator ](#--creator-)
     - [-n, --name ](#-n---name--3)
     - [-u, --unit ](#-u---unit-)
@@ -150,67 +169,67 @@
     - [--nft, --ft](#--nft---ft)
     - [-n, --network ](#-n---network-)
     - [nfd-lookup](#nfd-lookup)
-    - [Options](#options-23)
+    - [Options](#options-26)
     - [-o, --output ](#-o---output--3)
-    - [Arguments](#arguments-9)
+    - [Arguments](#arguments-11)
     - [VALUE](#value)
     - [opt-in](#opt-in)
-    - [Options](#options-24)
+    - [Options](#options-27)
     - [-a, --account ](#-a---account-)
     - [-n, --network ](#-n---network--1)
-    - [Arguments](#arguments-10)
+    - [Arguments](#arguments-12)
     - [ASSET_IDS](#asset_ids)
     - [opt-out](#opt-out)
-    - [Options](#options-25)
+    - [Options](#options-28)
     - [-a, --account ](#-a---account--1)
     - [--all](#--all)
     - [-n, --network ](#-n---network--2)
-    - [Arguments](#arguments-11)
+    - [Arguments](#arguments-13)
     - [ASSET_IDS](#asset_ids-1)
     - [send](#send)
-    - [Options](#options-26)
+    - [Options](#options-29)
     - [-f, --file ](#-f---file--2)
     - [-t, --transaction ](#-t---transaction-)
     - [-n, --network ](#-n---network--3)
     - [sign](#sign)
-    - [Options](#options-27)
+    - [Options](#options-30)
     - [-a, --account ](#-a---account--2)
     - [-f, --file ](#-f---file--3)
     - [-t, --transaction ](#-t---transaction--1)
     - [-o, --output ](#-o---output--4)
     - [--force](#--force-2)
     - [transfer](#transfer)
-    - [Options](#options-28)
+    - [Options](#options-31)
     - [-s, --sender ](#-s---sender-)
     - [-r, --receiver ](#-r---receiver--1)
     - [--asset, --id ](#--asset---id-)
     - [-a, --amount ](#-a---amount--1)
     - [--whole-units](#--whole-units-2)
     - [-n, --network ](#-n---network--4)
     - [vanity-address](#vanity-address)
-    - [Options](#options-29)
+    - [Options](#options-32)
     - [-m, --match ](#-m---match-)
     - [-o, --output ](#-o---output--5)
     - [-a, --alias ](#-a---alias-)
     - [--file-path ](#--file-path-)
-    - [-f, --force](#-f---force)
-    - [Arguments](#arguments-12)
+    - [-f, --force](#-f---force-3)
+    - [Arguments](#arguments-14)
     - [KEYWORD](#keyword)
     - [wallet](#wallet)
-    - [Options](#options-30)
+    - [Options](#options-33)
     - [-a, --address ](#-a---address-)
     - [-m, --mnemonic](#-m---mnemonic)
-    - [-f, --force](#-f---force-1)
-    - [Arguments](#arguments-13)
+    - [-f, --force](#-f---force-4)
+    - [Arguments](#arguments-15)
     - [ALIAS_NAME](#alias_name)
-    - [Arguments](#arguments-14)
+    - [Arguments](#arguments-16)
     - [ALIAS](#alias)
-    - [Options](#options-31)
-    - [-f, --force](#-f---force-2)
-    - [Arguments](#arguments-15)
+    - [Options](#options-34)
+    - [-f, --force](#-f---force-5)
+    - [Arguments](#arguments-17)
     - [ALIAS](#alias-1)
-    - [Options](#options-32)
-    - [-f, --force](#-f---force-3)
+    - [Options](#options-35)
+    - [-f, --force](#-f---force-6)
 
 # algokit
 
@@ -342,6 +361,26 @@ Configure settings used by AlgoKit
 algokit config [OPTIONS] COMMAND [ARGS]...
 ```
 
+### container-engine
+
+Set the default container engine for use by AlgoKit CLI to run LocalNet images.
+
+```shell
+algokit config container-engine [OPTIONS] [[docker|podman]]
+```
+
+### Options
+
+
+### -f, --force
+Skip confirmation prompts. Defaults to 'yes' to all prompts.
+
+### Arguments
+
+
+### ENGINE
+Optional argument
+
 ### version-prompt
 
 Controls whether AlgoKit checks and prompts for new versions.
@@ -636,6 +675,70 @@ Manage the AlgoKit LocalNet.
 algokit localnet [OPTIONS] COMMAND [ARGS]...
 ```
 
+### codespace
+
+Manage the AlgoKit LocalNet in GitHub Codespaces.
+
+```shell
+algokit localnet codespace [OPTIONS]
+```
+
+### Options
+
+
+### -m, --machine <machine>
+The GitHub Codespace machine type to use. Defaults to base tier.
+
+
+* **Options**
+
+    basicLinux32gb | standardLinux32gb | premiumLinux | largePremiumLinux
+
+
+
+### -a, --algod-port <algod_port>
+The port for the Algorand daemon. Defaults to 4001.
+
+
+### -i, --indexer-port <indexer_port>
+The port for the Algorand indexer. Defaults to 8980.
+
+
+### -k, --kmd-port <kmd_port>
+The port for the Algorand kmd. Defaults to 4002.
+
+
+### -n, --codespace-name <codespace_name>
+The name of the codespace. Defaults to random name with timestamp.
+
+
+### -r, --repo-url <repo_url>
+The URL of the repository. Defaults to algokit base template repo.
+
+
+### -f, --force
+Force delete stale codespaces and skip confirmation prompts. Defaults to explicitly prompting for confirmation.
+
+### config
+
+Set the default container engine for use by AlgoKit CLI to run LocalNet images.
+
+```shell
+algokit localnet config [OPTIONS] [[docker|podman]]
+```
+
+### Options
+
+
+### -f, --force
+Skip confirmation prompts. Defaults to 'yes' to all prompts.
+
+### Arguments
+
+
+### ENGINE
+Optional argument
+
 ### console
 
 Run the Algorand goal CLI against the AlgoKit LocalNet via a Bash console so you can execute multiple goal commands and/or interact with a filesystem.