feat: add poetry setup dev

Author: wislertt

.amazonq/rules/development-rules.md

@@ -0,0 +1,20 @@
+# Shared Scripts Development Rules
+
+## Code Quality
+
+- Run `make lint` at the end of any code changes to ensure code quality
+
+## Discussion Mode
+
+- **Discussion Mode**: Prefix prompt with "D:" to enter read-only discussion mode
+- In discussion mode: NO code updates, only read files and provide analysis/suggestions
+- Always start responses with "[Discussion Mode]" header when in discussion mode
+- Never exit discussion mode automatically - only when user uses "XD:" prefix
+- If user seems to want code changes, remind them to use "XD:" to exit discussion mode
+- **Exit Discussion**: Use "XD:" prefix to exit discussion mode and resume normal operations
+
+## Project Structure
+
+- Follow the existing module organization by language/tool (`node/`, `rust/`, `python/`, `common/`, `shell/`)
+- Place setup scripts as `setup_dev.sh` and validation scripts as `assert_setup_dev.sh`
+- Maintain separation between different tool ecosystems

common/update_brew.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-set -e
+set -ex
 
 brew update
 brew upgrade

node/assert_tools.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-set -e
+set -ex
 
 echo "Node: $(which node)"
 echo "NPM: $(which npm)"

node/load_nvm.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-set -e
+set -ex
 
 export NVM_DIR="$HOME/.nvm"
 [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"                   # This loads nvm

node/setup_dev.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-set -e
+set -ex
 
 chmod +x "$(dirname "$0")/setup_zshrc_nvm.sh"
 "$(dirname "$0")/setup_zshrc_nvm.sh"

node/setup_zshrc_nvm.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-set -e
+set -ex
 
 if ! grep -q "# >>> nvm initialize >>>" ~/.zshrc; then
       if [ -s ~/.zshrc ] && [ "$(tail -c 1 ~/.zshrc | wc -l)" -eq 0 ]; then

node/update_node.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-set -e
+set -ex
 
 chmod +x "$(dirname "$0")/load_nvm.sh"
 source "$(dirname "$0")/load_nvm.sh"

python/poetry/assert_setup_dev.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+set -ex
+
+echo "Asserting setup_dev..."
+
+chmod +x "$(dirname "$0")/assert_python_poetry.sh"
+"$(dirname "$0")/assert_python_poetry.sh"
+
+make lint test 2>/dev/null || just lint test 2>/dev/null || {
+      echo "❌ Error: Neither Makefile nor justfile found with lint and test targets"
+      exit 1
+}

python/poetry/setup_dev.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+
+set -exx
+
+while [[ $# -gt 0 ]]; do
+      case $1 in
+      --colima-docker)
+            COLIMA_DOCKER=true
+            shift
+            ;;
+      --python-version)
+            PYTHON_VERSION="$2"
+            shift
+            shift
+            ;;
+      --just)
+            JUST=true
+            shift
+            ;;
+      *)
+            echo "Unknown option $1"
+            exit 1
+            ;;
+      esac
+done
+
+chmod +x "$(dirname "$0")/../clean.sh"
+"$(dirname "$0")/../clean.sh"
+
+chmod +x "$(dirname "$0")/../clean_venv.sh"
+"$(dirname "$0")/../clean_venv.sh"
+
+chmod +x "$(dirname "$0")/../../common/update_brew.sh"
+"$(dirname "$0")/../../common/update_brew.sh"
+
+chmod +x "$(dirname "$0")/../setup_pyenv.sh"
+"$(dirname "$0")/../setup_pyenv.sh"
+
+chmod +x "$(dirname "$0")/../setup_pipx.sh"
+"$(dirname "$0")/../setup_pipx.sh"
+
+chmod +x "$(dirname "$0")/setup_poetry.sh"
+"$(dirname "$0")/setup_poetry.sh"
+
+if [[ "$COLIMA_DOCKER" == "true" ]]; then
+      echo "Ensure colima and docker are installed."
+      brew install colima docker --quiet
+fi
+
+if [[ "$JUST" == "true" ]]; then
+      echo "Ensure just are installed."
+      brew install just --quiet
+fi
+
+echo "Setup local python to ${PYTHON_VERSION}"
+pyenv install "${PYTHON_VERSION}" --skip-existing
+
+echo "Setup .venv"
+poetry env use "python${PYTHON_VERSION}"
+
+chmod +x "$(dirname "$0")/../setup_venv_zshrc.sh"
+"$(dirname "$0")/../setup_venv_zshrc.sh"
+
+poetry install
+poetry run pre-commit install

python/poetry/setup_poetry.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+set -exx
+
+pipx install poetry
+pipx ensurepath
+poetry config virtualenvs.in-project true
+pipx inject poetry keyrings.google-artifactregistry-auth