rhiza 0.8.6__tar.gz → 0.8.8__tar.gz

rhiza-0.8.8/.github/Makefile.gh

@@ -0,0 +1,34 @@
+## Makefile.gh - github repo maintenance and helpers
+# This file is included by the main Makefile
+
+# Declare phony targets
+.PHONY: gh-install view-prs view-issues failed-workflows whoami print-logo
+
+##@ GitHub Helpers
+gh-install: ## check for gh cli existence and install extensions
+	@if ! command -v gh >/dev/null 2>&1; then \
+		printf "${YELLOW}[WARN] gh cli not found.${RESET}\n"; \
+		printf "${BLUE}[INFO] Please install it from: https://github.com/cli/cli?tab=readme-ov-file#installation${RESET}\n"; \
+	else \
+		printf "${GREEN}[INFO] gh cli is installed.${RESET}\n"; \
+	fi
+
+view-prs: gh-install ## list open pull requests
+	@printf "${BLUE}[INFO] Open Pull Requests:${RESET}\n"
+	@gh pr list --json number,title,author,headRefName,updatedAt --template \
+		'{{tablerow (printf "NUM" | color "bold") (printf "TITLE" | color "bold") (printf "AUTHOR" | color "bold") (printf "BRANCH" | color "bold") (printf "UPDATED" | color "bold")}}{{range .}}{{tablerow (printf "#%v" .number | color "green") .title (.author.login | color "cyan") (.headRefName | color "yellow") (timeago .updatedAt | color "white")}}{{end}}'
+
+view-issues: gh-install ## list open issues
+	@printf "${BLUE}[INFO] Open Issues:${RESET}\n"
+	@gh issue list --json number,title,author,labels,updatedAt --template \
+		'{{tablerow (printf "NUM" | color "bold") (printf "TITLE" | color "bold") (printf "AUTHOR" | color "bold") (printf "LABELS" | color "bold") (printf "UPDATED" | color "bold")}}{{range .}}{{tablerow (printf "#%v" .number | color "green") .title (.author.login | color "cyan") (pluck "name" .labels | join ", " | color "yellow") (timeago .updatedAt | color "white")}}{{end}}'
+
+failed-workflows: gh-install ## list recent failing workflow runs
+	@printf "${BLUE}[INFO] Recent Failing Workflow Runs:${RESET}\n"
+	@gh run list --limit 10 --status failure --json conclusion,name,headBranch,event,createdAt --template \
+		'{{tablerow (printf "STATUS" | color "bold") (printf "NAME" | color "bold") (printf "BRANCH" | color "bold") (printf "EVENT" | color "bold") (printf "TIME" | color "bold")}}{{range .}}{{tablerow (printf "%s" .conclusion | color "red") .name (.headBranch | color "cyan") (.event | color "yellow") (timeago .createdAt | color "white")}}{{end}}'
+
+whoami: gh-install ## check github auth status
+	@printf "${BLUE}[INFO] GitHub Authentication Status:${RESET}\n"
+	@gh auth status --hostname github.com --json hosts --template \
+		'{{range $$host, $$accounts := .hosts}}{{range $$accounts}}{{if .active}}  {{printf "✓" | color "green"}} Logged in to {{$$host}} account {{.login | color "bold"}} ({{.tokenSource}}){{"\n"}}  Active account: {{printf "true" | color "green"}}{{"\n"}}  Git operations protocol: {{.gitProtocol | color "yellow"}}{{"\n"}}  Token scopes: {{.scopes | color "yellow"}}{{"\n"}}{{end}}{{end}}{{end}}' 

rhiza-0.8.8/.github/agents/analyser.md

@@ -0,0 +1,46 @@
+---
+name: analyser
+description: Ongoing technical journal for repository analysis
+---
+
+You are a senior software architect performing a critical, journal-style review of this repository.
+
+Your task:
+- Analyze the repository as it exists at the time of execution.
+- Identify concrete strengths, weaknesses, risks, and notable design decisions.
+- Prefer specific file and module references over general statements.
+- Be concise, factual, and critical. Avoid marketing language.
+
+Journal mode:
+- Treat this as an ongoing analysis.
+- DO NOT rewrite or summarize existing content.
+- APPEND a new dated entry to the end of the file.
+- Each run should add new observations or refine previous ones if warranted.
+
+Output:
+- Write exclusively to `REPOSITORY_ANALYSIS.md`.
+- Append a new section with the following structure:
+
+## YYYY-MM-DD — Analysis Entry
+
+### Summary
+Short high-level assessment of the repository in its current state.
+
+### Strengths
+Bullet points with concrete evidence.
+
+### Weaknesses
+Bullet points with concrete evidence.
+
+### Risks / Technical Debt
+Items that could affect maintainability, correctness, or scalability.
+
+### Score
+Give an overall score between **1 and 10**, where:
+- 9–10: exemplary, production-grade, well-maintained
+- 7–8: solid, minor issues
+- 5–6: mixed quality, notable concerns
+- 3–4: fragile or poorly structured
+- 1–2: critically deficient
+
+Be honest. If information is missing or unclear, state that explicitly.

rhiza-0.8.8/.github/agents/summarise.md

@@ -0,0 +1,19 @@
+---
+name: summarise
+description: Agent for summarizing changes since the last release/tag
+---
+
+You are a software development assistant tasked with summarizing repository changes since the most recent release or tag.
+
+Your task:
+- Identify the most recent git tag or release in the repository.
+- Retrieve all commits made since that tag/release.
+- Provide a concise summary of the changes, including key features, bug fixes, and any notable modifications.
+- Focus on factual, technical details from the commit messages and changes.
+
+Output:
+- Display the summary directly in the terminal or output.
+- Structure the summary with sections like: Recent Tag/Release, Commits Summary, Key Changes.
+- Be concise and avoid unnecessary details.
+
+Use the 'shell' tool to execute git commands as needed (e.g., git describe --tags, git log --oneline since the tag).

rhiza-0.8.8/.github/copilot-instructions.md

@@ -0,0 +1,48 @@
+# Rhiza Copilot Instructions
+
+You are working in a project that utilizes the `rhiza` framework. Rhiza is a collection of reusable
+configuration templates and tooling designed to standardize and streamline modern Python development.
+
+As a Rhiza-based project, this workspace adheres to specific conventions for structure, dependency management, and automation.
+
+## Development Environment
+
+The project uses `make` and `uv` for development tasks.
+
+- **Install Dependencies**: `make install` (installs `uv`, creates `.venv`, installs dependencies)
+- **Run Tests**: `make test` (runs `pytest` with coverage)
+- **Format Code**: `make fmt` (runs `ruff format` and `ruff check --fix`)
+- **Check Dependencies**: `make deptry` (runs `deptry` to check for missing/unused dependencies)
+- **Marimo Notebooks**: `make marimo` (starts the Marimo server)
+- **Build Documentation**: `make book` (builds the documentation book)
+
+## Project Structure
+
+- `src/`: Source code
+- `tests/`: Tests (pytest)
+- `assets/`: Static assets
+- `book/`: Documentation source
+- `docker/`: Docker configuration
+- `presentation/`: Presentation slides
+- `.rhiza/`: Rhiza-specific scripts and configurations
+
+## Coding Standards
+
+- **Style**: Follow PEP 8. Use `make fmt` to enforce style.
+- **Testing**: Write tests in `tests/` using `pytest`. Ensure high coverage.
+- **Documentation**: Document code using docstrings.
+- **Dependencies**: Manage dependencies in `pyproject.toml`. Use `uv add` to add dependencies.
+
+## Workflow
+
+1.  **Setup**: Run `make install` to set up the environment.
+2.  **Develop**: Write code in `src/` and tests in `tests/`.
+3.  **Test**: Run `make test` to verify changes.
+4.  **Format**: Run `make fmt` before committing.
+5.  **Verify**: Run `make deptry` to check dependencies.
+
+## Key Files
+
+- `Makefile`: Main entry point for tasks.
+- `pyproject.toml`: Project configuration and dependencies.
+- `.devcontainer/bootstrap.sh`: Bootstrap script for dev containers.

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_book.yml

@@ -43,7 +43,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.21"
+          version: "0.9.24"
 
       - name: "Sync the virtual environment for ${{ github.repository }}"
         shell: bash
@@ -52,9 +52,6 @@ jobs:
           # will just use .python-version?
           uv sync --all-extras --all-groups --frozen
 
-      - name: Install dev dependencies
-        run: bash .rhiza/scripts/install-dev-deps.sh
-
       - name: "Make the book"
         run: |
           make book

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_ci.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.21"
+          version: "0.9.24"
 
       - id: versions
         run: |
@@ -58,17 +58,9 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.21"
-
-      - name: "Sync the virtual environment for ${{ github.repository }}"
-        shell: bash
-        run: |
-          export UV_EXTRA_INDEX_URL="${{ secrets.uv-extra-index-url }}"
-          uv venv --python ${{ matrix.python-version }}
-          uv sync --all-extras --all-groups --frozen
-
-      - name: Install dev dependencies
-        run: bash .rhiza/scripts/install-dev-deps.sh
+          version: "0.9.24"
+          python-version: ${{ matrix.python-version }}
 
       - name: Run tests
-        run: uv run pytest tests
+        run: |
+          make test

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_deptry.yml

@@ -27,7 +27,7 @@ jobs:
     name: Check dependencies with deptry
     runs-on: ubuntu-latest
     container:
-      image: ghcr.io/astral-sh/uv:0.9.21-python3.12-trixie
+      image: ghcr.io/astral-sh/uv:0.9.24-python3.12-trixie
 
     steps:
       - uses: actions/checkout@v6

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_marimo.yml

@@ -80,7 +80,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.21"
+          version: "0.9.24"
 
       # Execute the notebook with the appropriate runner based on its content
       - name: Run notebook

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_pre-commit.yml

@@ -31,5 +31,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - uses: pre-commit/action@v3.0.1
-
+      # Run pre-commit
+      - name: Run pre-commit
+        run: |
+          make fmt

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_release.yml

@@ -111,7 +111,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.21"
+          version: "0.9.24"
 
       - name: "Sync the virtual environment for ${{ github.repository }}"
         shell: bash
@@ -322,7 +322,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.21"
+          version: "0.9.24"
 
       - name: "Sync the virtual environment for ${{ github.repository }}"
         shell: bash

{rhiza-0.8.6 → rhiza-0.8.8}/.github/workflows/rhiza_validate.yml

@@ -15,7 +15,7 @@ jobs:
     # don't run this in rhiza itself. Rhiza has no template.yml file.
     if: ${{ github.repository != 'jebel-quant/rhiza' }}
     container:
-      image: ghcr.io/astral-sh/uv:0.9.21-python3.12-trixie
+      image: ghcr.io/astral-sh/uv:0.9.24-python3.12-trixie
 
     steps:
       - name: Checkout repository

{rhiza-0.8.6 → rhiza-0.8.8}/.gitignore

@@ -5,6 +5,7 @@
 
 ### Don't expose API keys, etc.
 .env
+!.rhiza/.env
 
 __marimo__
 

{rhiza-0.8.6 → rhiza-0.8.8}/.pre-commit-config.yaml

@@ -9,7 +9,7 @@ repos:
       - id: check-yaml
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.14.10'
+    rev: 'v0.14.11'
     hooks:
       - id: ruff
         args: [ --fix, --exit-non-zero-on-fix, --unsafe-fixes ]

{rhiza-0.8.6 → rhiza-0.8.8}/.rhiza/.cfg.toml

@@ -11,7 +11,7 @@ sign_tags = false
 tag_name = "v{new_version}"
 tag_message = "Bump version: {current_version} → {new_version}"
 allow_dirty = false
-commit = false
+commit = true
 message = "Chore: bump version {current_version} → {new_version}"
 commit_args = ""
 
@@ -28,4 +28,9 @@ values = [
 [[tool.bumpversion.files]]
 filename = "pyproject.toml"
 search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "uv.lock"
+search = 'version = "{current_version}"'
 replace = 'version = "{new_version}"'

rhiza-0.8.8/.rhiza/.env

@@ -0,0 +1,14 @@
+MARIMO_FOLDER=book/marimo
+SOURCE_FOLDER=src
+SCRIPTS_FOLDER=.rhiza/scripts
+CUSTOM_SCRIPTS_FOLDER=.rhiza/customisations/scripts
+
+# Book-specific variables
+BOOK_TITLE=Project Documentation
+BOOK_SUBTITLE=Generated by minibook
+PDOC_TEMPLATE_DIR=book/pdoc-templates
+BOOK_TEMPLATE=book/minibook-templates/custom.html.jinja2
+DOCFORMAT=google
+
+# Agentic-specific variables
+DEFAULT_AI_MODEL=gpt-4.1

rhiza-0.8.8/.rhiza/Makefile.rhiza

@@ -0,0 +1,38 @@
+## Makefile.rhiza - rhiza actions
+# This file is included by the main Makefile
+
+# RHIZA_LOGO definition
+define RHIZA_LOGO
+  ____  _     _
+ |  _ \| |__ (_)______ _
+ | |_) | '_ \| |_  / _\`|
+ |  _ <| | | | |/ / (_| |
+ |_| \_\_| |_|_/___\__,_|
+
+endef
+export RHIZA_LOGO
+
+# Declare phony targets
+.PHONY: print-logo sync validate
+
+##@ Rhiza Workflows
+
+print-logo:
+	@printf "${BLUE}$$RHIZA_LOGO${RESET}\n"
+
+
+sync: ## sync with template repository as defined in .rhiza/template.yml
+	@if git remote get-url origin 2>/dev/null | grep -iqE 'jebel-quant/rhiza(\.git)?$$'; then \
+		printf "${BLUE}[INFO] Skipping sync in rhiza repository (no template.yml by design)${RESET}\n"; \
+	else \
+		$(MAKE) install-uv; \
+		${UVX_BIN} "rhiza>=0.7.1" materialize --force .; \
+	fi
+
+validate: ## validate project structure against template repository as defined in .rhiza/template.yml
+	@if git remote get-url origin 2>/dev/null | grep -iqE 'jebel-quant/rhiza(\.git)?$$'; then \
+		printf "${BLUE}[INFO] Skipping validate in rhiza repository (no template.yml by design)${RESET}\n"; \
+	else \
+		$(MAKE) install-uv; \
+		${UVX_BIN} "rhiza>=0.7.1" validate .; \
+	fi

rhiza-0.8.8/.rhiza/agentic/Makefile.agentic

@@ -0,0 +1,45 @@
+## Makefile.customisations - User-defined scripts and overrides
+# This file is included by the main Makefile
+
+# Declare phony targets
+.PHONY: install-copilot analyse-repo summarize-changes
+
+COPILOT_BIN ?= $(shell command -v copilot 2>/dev/null || echo "$(INSTALL_DIR)/copilot")
+##@ Agentic Workflows
+
+copilot: install-copilot ## open interactive prompt for copilot
+	@"$(COPILOT_BIN)" --model "$(DEFAULT_AI_MODEL)"
+
+analyse-repo: install-copilot ## run the analyser agent to update REPOSITORY_ANALYSIS.md
+	@"$(COPILOT_BIN)" --agent analyser \
+		--model "$(DEFAULT_AI_MODEL)" \
+		--prompt "Analyze the repository and update the journal." \
+		--allow-tool 'write' --deny-tool 'remove' \
+		--allow-all-paths
+
+summarize-changes: install-copilot ## summarize changes since the most recent release/tag
+	@"$(COPILOT_BIN)" -p "Show me the commits since the last release/tag and summarize them" --allow-tool 'shell(git)' --model "$(DEFAULT_AI_MODEL)" --agent summarise
+
+install-copilot:  ## checks for copilot and prompts to install
+	@if command -v copilot >/dev/null 2>&1; then \
+	  printf "${GREEN}[INFO] copilot already installed in PATH, skipping install.${RESET}\n"; \
+	elif [ -x "${INSTALL_DIR}/copilot" ]; then \
+	  printf "${SUCCESS}[INFO] copilot already installed in ${INSTALL_DIR}, skipping install.${RESET}\n"; \
+	else \
+		printf "${YELLOW}[WARN] GitHub Copilot CLI not found in ${INSTALL_DIR}.${RESET}\n"; \
+		printf "${BLUE}Do you want to install GitHub Copilot CLI? [y/N] ${RESET}"; \
+		read -r response; \
+		if [ "$$response" = "y" ] || [ "$$response" = "Y" ]; then \
+			printf "${BLUE}[INFO] Installing GitHub Copilot CLI to ${INSTALL_DIR}...${RESET}\n"; \
+			mkdir -p "${INSTALL_DIR}"; \
+			if curl -fsSL https://gh.io/copilot-install | PREFIX="." bash; then \
+				printf "${GREEN}[INFO] GitHub Copilot CLI installed successfully.${RESET}\n"; \
+			else \
+				printf "${RED}[ERROR] Failed to install GitHub Copilot CLI.${RESET}\n"; \
+				exit 1; \
+			fi; \
+		else \
+			printf "${BLUE}[INFO] Skipping installation.${RESET}\n"; \
+		fi; \
+	fi
+

rhiza-0.8.8/.rhiza/customisations/Makefile.customisations

@@ -0,0 +1,29 @@
+## Makefile.customisations - User-defined scripts and overrides
+# This file is included by the main Makefile
+
+# Declare phony targets
+.PHONY: install-extras post-release
+
+##@ Customisations
+
+install-extras:: ## run custom build script (if exists)
+	@if [ -x "${CUSTOM_SCRIPTS_FOLDER}/build-extras.sh" ]; then \
+		printf "${BLUE}[INFO] Running custom build script from customisations folder...${RESET}\n"; \
+		"${CUSTOM_SCRIPTS_FOLDER}"/build-extras.sh; \
+	elif [ -f "${CUSTOM_SCRIPTS_FOLDER}/build-extras.sh" ]; then \
+		printf "${BLUE}[INFO] Running custom build script from customisations folder...${RESET}\n"; \
+		/bin/sh "${CUSTOM_SCRIPTS_FOLDER}/build-extras.sh"; \
+	else \
+		printf "${BLUE}[INFO] No custom build script in ${CUSTOM_SCRIPTS_FOLDER}, skipping...${RESET}\n"; \
+	fi
+
+post-release:: ## perform post-release tasks
+	@if [ -x "${CUSTOM_SCRIPTS_FOLDER}/post-release.sh" ]; then \
+		printf "${BLUE}[INFO] Running post-release script from customisations folder...${RESET}\n"; \
+		"${CUSTOM_SCRIPTS_FOLDER}"/post-release.sh; \
+	elif [ -f "${CUSTOM_SCRIPTS_FOLDER}/post-release.sh" ]; then \
+		printf "${BLUE}[INFO] Running post-release script from customisations folder...${RESET}\n"; \
+		/bin/sh "${CUSTOM_SCRIPTS_FOLDER}/post-release.sh"; \
+	else \
+		printf "${BLUE}[INFO] No post-release script in ${CUSTOM_SCRIPTS_FOLDER}, skipping...${RESET}\n"; \
+	fi

{rhiza-0.8.6 → rhiza-0.8.8}/.rhiza/history

@@ -5,6 +5,10 @@
 #
 # Files under template control:
 .editorconfig
+.github/Makefile.gh
+.github/agents/analyser.md
+.github/agents/summarise.md
+.github/copilot-instructions.md
 .github/workflows/rhiza_book.yml
 .github/workflows/rhiza_ci.yml
 .github/workflows/rhiza_codeql.yml
@@ -16,6 +20,14 @@
 .github/workflows/rhiza_validate.yml
 .gitignore
 .pre-commit-config.yaml
+.python-version
+.rhiza/.cfg.toml
+.rhiza/.env
+.rhiza/Makefile.rhiza
+.rhiza/agentic/Makefile.agentic
+.rhiza/customisations/Makefile.customisations
+.rhiza/customisations/scripts/build-extras.sh
+.rhiza/customisations/scripts/post-release.sh
 .rhiza/docs/CONFIG.md
 .rhiza/docs/TOKEN_SETUP.md
 .rhiza/requirements/README.md
@@ -24,11 +36,7 @@
 .rhiza/requirements/tests.txt
 .rhiza/requirements/tools.txt
 .rhiza/scripts/book.sh
-.rhiza/scripts/bump.sh
-.rhiza/scripts/customisations/build-extras.sh
-.rhiza/scripts/customisations/post-release.sh
 .rhiza/scripts/generate-coverage-badge.sh
-.rhiza/scripts/install-dev-deps.sh
 .rhiza/scripts/marimushka.sh
 .rhiza/scripts/release.sh
 .rhiza/scripts/update-readme-help.sh
@@ -53,11 +61,11 @@ tests/test_rhiza/benchmarks/.gitignore
 tests/test_rhiza/benchmarks/README.md
 tests/test_rhiza/benchmarks/analyze_benchmarks.py
 tests/test_rhiza/conftest.py
-tests/test_rhiza/test_bump_script.py
 tests/test_rhiza/test_coverage_badge.py
 tests/test_rhiza/test_docstrings.py
 tests/test_rhiza/test_git_repo_fixture.py
 tests/test_rhiza/test_makefile.py
+tests/test_rhiza/test_makefile_gh.py
 tests/test_rhiza/test_marimushka_script.py
 tests/test_rhiza/test_notebooks.py
 tests/test_rhiza/test_readme.py

{rhiza-0.8.6 → rhiza-0.8.8}/.rhiza/requirements/tests.txt

@@ -2,3 +2,8 @@
 pytest==9.0.2
 pytest-cov>=7.0.0
 pytest-html>=4.1.1
+pytest-mock>=3.15.1
+
+# For benchmarks
+pytest-benchmark>=5.2.3
+pygal>=3.1.0

{rhiza-0.8.6 → rhiza-0.8.8}/.rhiza/template.yml

@@ -1,7 +1,7 @@
 template-repository: "jebel-quant/rhiza"
 template-branch: "main"
 include:
-    - .github/workflows
+    - .github  
     - .rhiza
     - tests
     - .editorconfig
@@ -15,6 +15,9 @@ include:
     - presentation
     - book
     - renovate.json
+    - .python-version
 exclude:
     - .github/workflows/rhiza_docker.yml
     - .github/workflows/rhiza_devcontainer.yml
+    - .github/ISSUE_TEMPLATE
+    - .github/dependabot.yml