brew release updates to python dependencies

Author: dudash

.github/workflows/release.yml

@@ -41,13 +41,6 @@ jobs:
           path: .venv
           key: venv-${{ runner.os }}-${{ env.PYTHON_VERSION }}-${{ hashFiles('**/poetry.lock') }}
 
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-        with:
-          version: latest
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-
       - name: Install dependencies
         if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
         run: poetry install --no-interaction --with dev --no-root
@@ -110,11 +103,6 @@ jobs:
           poetry build
         shell: bash
 
-      - name: Install PyInstaller
-        run: |
-          poetry add --group dev pyinstaller
-        shell: bash
-
       - name: Build standalone executable
         run: |
           poetry run pyinstaller --onefile --name mdbub-${{ matrix.platform }} src/mdbub/cli.py
@@ -240,6 +228,17 @@ jobs:
         env:
           COMMITTER_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
 
+  homebrew-test:
+    needs: update-homebrew
+    runs-on: macos-latest
+    steps:
+      - name: Install from Homebrew Tap
+        run: |
+          brew tap ${{ github.repository_owner }}/homebrew-tap
+          brew install mdbub
+          mdbub version
+
+
   update-chocolatey:
     needs: [release, publish-pypi]
     runs-on: windows-latest

.github/workflows/update-python-dependencies.yml

@@ -0,0 +1,43 @@
+name: Update Python Dependencies for Homebrew
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - 'pyproject.toml'
+      - 'poetry.lock'
+      - '.github/workflows/update-python-dependencies.yml'
+
+jobs:
+  update-python-dependencies:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout tap repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository_owner }}/homebrew-tap
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          path: tap-repo
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install homebrew-pypi-poet
+        run: |
+          pip install homebrew-pypi-poet
+
+      - name: Generate Homebrew resource blocks
+        run: |
+          poet click markdown markdown-it-py packaging platformdirs prompt-toolkit pyyaml requests rich rich-click ruamel.yaml tomli typer \
+            > tap-repo/Formula/mdbub_resources.rb
+
+      - name: Commit and push changes
+        run: |
+          cd tap-repo
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+          git add Formula/mdbub_resources.rb
+          git commit -m "Update Python dependencies for mdbub formula"
+          git push

autogen/PLAN_HOMEBREW_DEPENDENCIES.md

@@ -0,0 +1,46 @@
+# Homebrew Formula Dependency Declaration Plan
+
+## Goal
+Update `packaging/homebrew/mdbub.rb` to fully comply with Homebrew Python-for-Formula-Authors guidelines by explicitly declaring all non-stdlib dependencies as `resource` blocks.
+
+## Steps
+
+- [x] Extract all runtime dependencies from `[tool.poetry.dependencies]` in `pyproject.toml`.
+- [x] For each dependency (excluding `python` itself):
+  - [x] Find the latest matching version and PyPI tarball URL.
+  - [x] Compute or note the need for the correct SHA256 for each resource.
+  - [x] Add a `resource` block for each dependency in the formula.
+- [ ] Update the formula's `url` and `sha256` to match the latest release.
+- [ ] Test formula install locally or via CI.
+- [ ] Check off after successful install and test.
+
+## Extracted Dependencies
+
+- click
+- markdown
+- markdown-it-py
+- packaging
+- platformdirs
+- prompt-toolkit
+- pyyaml
+- requests
+- rich
+- rich-click
+- ruamel-yaml
+- tomli
+- typer
+
+## Notes
+- `python` is already specified as a dependency in the formula.
+- For each dependency, use the PyPI sdist (tar.gz) URL and compute the SHA256.
+- Homebrew will use these resources to populate the virtualenv at install time.
+- After updating, bump the formula version and update the top-level `sha256` for the main tarball.
+- Test with `brew install --build-from-source mdbub`.
+
+---
+
+## TODO
+- [ ] Add all resource blocks to `packaging/homebrew/mdbub.rb`
+- [ ] Update formula version and sha256
+- [ ] Test install
+- [ ] Remove this plan file after validation

packaging/homebrew/mdbub.rb

@@ -5,13 +5,17 @@
 class Mdbub < Formula
   desc "Terminal-first interactive mindmap CLI tool"
   homepage "https://github.com/collabinator/mdbubbles"
-  url "https://github.com/collabinator/mdbubbles/archive/refs/tags/v0.2.1.tar.gz"
-  sha256 "REPLACE_WITH_ACTUAL_SHA256"
+  url "https://github.com/collabinator/mdbubbles/archive/refs/tags/v0.3.0.tar.gz"
+  sha256 "REPLACE_WITH_ACTUAL_SHA256" # updated automatically by GitHub Actions
   license "Apache-2.0"
   head "https://github.com/collabinator/mdbubbles.git", branch: "main"
 
   depends_on "python@3.11"
 
+  # Python dependencies are dynamically generated by CI and included here
+  # See .github/workflows/release.yml for the update-python-dependencies job
+  instance_eval(File.read(File.expand_path("../mdbub_resources.rb", __FILE__)))
+
   def install
     virtualenv_install_with_resources
   end

poetry.lock

@@ -59,6 +59,7 @@ toml = "^0.10.2"
 ruff = "^0.11.13"
 twine = "^5.0.0"
 types-toml = "^0.10.8.20240310"
+pyinstaller = "^6.14.1"
 
 
 [tool.black]