rhiza 0.3.0__tar.gz → 0.4.0__tar.gz

{rhiza-0.3.0 → rhiza-0.4.0}/.github/actions/setup-project/action.yml

@@ -4,8 +4,7 @@
 # Action: Setup Project (composite action)
 #
 # Purpose: Bootstrap a Python project in GitHub Actions by:
-#   - Installing Task, uv, and uvx into a local ./bin directory
-#   - Optionally rendering the repository from a Copier template for tests
+#   - Installing Task, uv, and uvx
 #   - Detecting presence of pyproject.toml and exposing it as an output
 #   - Creating a virtual environment with uv and syncing dependencies
 #
@@ -43,28 +42,7 @@ runs:
     - name: Install uv
       uses: astral-sh/setup-uv@v7
       with:
-        version: "0.9.17"
-
-    - name: Render the project
-      if: hashFiles('tests/resources/render.yml') != ''
-      shell: bash
-      run: |
-        pip install copier
-
-        # Render the current folder in-place
-        copier copy . . \
-          --data-file ./tests/resources/render.yml \
-          --force \
-          --overwrite \
-          --quiet
-
-        # Delete all remaining .jinja files
-        find . -type f -name "*.jinja" -exec rm -f {} +
-
-        # Delete all folders that still contain {{ ... }}
-        find . -depth -type d -name "*{{*}}*" -exec rm -rf {} +
-
-        ls -R
+        version: "0.9.18"
 
     - name: Check for pyproject.toml
       id: check_pyproject

rhiza-0.4.0/.github/scripts/sync.sh

@@ -0,0 +1,310 @@
+#!/bin/sh
+# Sync configuration files from template repository
+# - Reads configuration from .github/template.yml
+# - Downloads specified files from the template repository
+# - Copies them to the current repository
+#
+# This script is POSIX-sh compatible and provides manual sync capability
+# for repositories that use jebel-quant/rhiza as a template.
+
+set -e
+
+BLUE="\033[36m"
+RED="\033[31m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RESET="\033[0m"
+
+TEMPLATE_CONFIG=".github/template.yml"
+TEMP_DIR="/tmp/rhiza-sync-$$"
+
+show_usage() {
+  printf "Usage: %s [OPTIONS]\n\n" "$0"
+  printf "Sync configuration files from the template repository.\n\n"
+  printf "Options:\n"
+  printf "  -h, --help     Show this help message\n"
+  printf "  --dry-run      Show what would be synced without making changes\n\n"
+  printf "Configuration:\n"
+  printf "  Reads from %s to determine:\n" "$TEMPLATE_CONFIG"
+  printf "  - template-repository: Source repository (e.g., 'jebel-quant/rhiza')\n"
+  printf "  - template-branch: Branch to sync from (e.g., 'main')\n"
+  printf "  - include: Files/directories to sync\n"
+  printf "  - exclude: Files/directories to skip (optional)\n\n"
+  printf "Example %s:\n" "$TEMPLATE_CONFIG"
+  printf "  template-repository: \"jebel-quant/rhiza\"\n"
+  printf "  template-branch: \"main\"\n"
+  printf "  include: |\n"
+  printf "    .github\n"
+  printf "    Makefile\n"
+  printf "    ruff.toml\n"
+}
+
+DRY_RUN=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    -h|--help)
+      show_usage
+      exit 0
+      ;;
+    --dry-run)
+      DRY_RUN="true"
+      shift
+      ;;
+    *)
+      printf "%b[ERROR] Unknown option: %s%b\n" "$RED" "$1" "$RESET"
+      show_usage
+      exit 1
+      ;;
+  esac
+done
+
+# Check if template.yml exists
+if [ ! -f "$TEMPLATE_CONFIG" ]; then
+  printf "%b[ERROR] Template configuration not found: %s%b\n" "$RED" "$TEMPLATE_CONFIG" "$RESET"
+  printf "\nThis repository is not configured for template syncing.\n"
+  printf "Create %s with the following content:\n\n" "$TEMPLATE_CONFIG"
+  printf "  template-repository: \"jebel-quant/rhiza\"\n"
+  printf "  template-branch: \"main\"\n"
+  printf "  include: |\n"
+  printf "    .github\n"
+  printf "    Makefile\n"
+  printf "    ruff.toml\n"
+  exit 1
+fi
+
+# Parse template.yml to extract configuration
+# This is a simple parser that works with basic YAML structure
+printf "%b[INFO] Reading configuration from %s...%b\n" "$BLUE" "$TEMPLATE_CONFIG" "$RESET"
+
+TEMPLATE_REPO=""
+TEMPLATE_BRANCH=""
+INCLUDE_LIST=""
+EXCLUDE_LIST=""
+
+# Simple YAML parser
+in_multiline=""
+
+while IFS= read -r line || [ -n "$line" ]; do
+  # Skip comments and empty lines
+  case "$line" in
+    \#*|"") continue ;;
+  esac
+
+  # Check if line starts with spaces by looking at first character
+  first_char=$(printf '%s' "$line" | cut -c1)
+
+  if [ "$first_char" = " " ] || [ "$first_char" = "$(printf '\t')" ]; then
+    # This is indented content (part of a multiline block)
+    if [ -n "$in_multiline" ]; then
+      # Remove leading spaces
+      item=$(echo "$line" | sed 's/^[[:space:]]*//')
+      if [ -n "$item" ]; then
+        if [ "$in_multiline" = "include" ]; then
+          INCLUDE_LIST="${INCLUDE_LIST}${item}
+"
+        elif [ "$in_multiline" = "exclude" ]; then
+          EXCLUDE_LIST="${EXCLUDE_LIST}${item}
+"
+        fi
+      fi
+    fi
+  else
+    # This is a key line (not indented)
+    case "$line" in
+      template-repository:*)
+        TEMPLATE_REPO=$(echo "$line" | sed 's/^template-repository:[[:space:]]*//' | sed 's/"//g' | sed "s/'//g")
+        in_multiline=""
+        ;;
+      template-branch:*)
+        TEMPLATE_BRANCH=$(echo "$line" | sed 's/^template-branch:[[:space:]]*//' | sed 's/"//g' | sed "s/'//g")
+        in_multiline=""
+        ;;
+      include:*)
+        in_multiline="include"
+        ;;
+      exclude:*)
+        in_multiline="exclude"
+        ;;
+    esac
+  fi
+done < "$TEMPLATE_CONFIG"
+
+# Validate required fields
+if [ -z "$TEMPLATE_REPO" ]; then
+  printf "%b[ERROR] template-repository not found in %s%b\n" "$RED" "$TEMPLATE_CONFIG" "$RESET"
+  exit 1
+fi
+
+if [ -z "$TEMPLATE_BRANCH" ]; then
+  printf "%b[WARN] template-branch not specified, using 'main'%b\n" "$YELLOW" "$RESET"
+  TEMPLATE_BRANCH="main"
+fi
+
+if [ -z "$INCLUDE_LIST" ]; then
+  printf "%b[ERROR] include list is empty in %s%b\n" "$RED" "$TEMPLATE_CONFIG" "$RESET"
+  exit 1
+fi
+
+printf "%b[INFO] Template repository: %s%b\n" "$GREEN" "$TEMPLATE_REPO" "$RESET"
+printf "%b[INFO] Template branch: %s%b\n" "$GREEN" "$TEMPLATE_BRANCH" "$RESET"
+printf "%b[INFO] Files to sync:%b\n" "$GREEN" "$RESET"
+echo "$INCLUDE_LIST" | while IFS= read -r item; do
+  [ -n "$item" ] && printf "  - %s\n" "$item"
+done || true
+
+if [ -n "$EXCLUDE_LIST" ]; then
+  printf "%b[INFO] Files to exclude:%b\n" "$YELLOW" "$RESET"
+  echo "$EXCLUDE_LIST" | while IFS= read -r item; do
+    [ -n "$item" ] && printf "  - %s\n" "$item"
+  done || true
+fi
+
+if [ -n "$DRY_RUN" ]; then
+  printf "\n%b[DRY RUN] No changes will be made%b\n" "$YELLOW" "$RESET"
+  exit 0
+fi
+
+# Create temporary directory
+mkdir -p "$TEMP_DIR"
+trap 'rm -rf "$TEMP_DIR"' EXIT INT TERM
+
+# Backup this script to avoid being overwritten during sync
+SELF_SCRIPT=".github/scripts/sync.sh"
+if [ -f "$SELF_SCRIPT" ]; then
+  cp "$SELF_SCRIPT" "$TEMP_DIR/sync.sh.bak"
+fi
+
+# Clone the template repository
+printf "\n%b[INFO] Cloning template repository...%b\n" "$BLUE" "$RESET"
+REPO_URL="https://github.com/${TEMPLATE_REPO}.git"
+
+if ! git clone --depth 1 --branch "$TEMPLATE_BRANCH" "$REPO_URL" "$TEMP_DIR/template" 2>/dev/null; then
+  printf "%b[ERROR] Failed to clone template repository from %s%b\n" "$RED" "$REPO_URL" "$RESET"
+  exit 1
+fi
+
+# Function to check if a file path should be excluded
+is_file_excluded() {
+  file_path="$1"
+  if [ -z "$EXCLUDE_LIST" ]; then
+    return 1  # Not excluded (false)
+  fi
+
+  while IFS= read -r exclude_item || [ -n "$exclude_item" ]; do
+    [ -z "$exclude_item" ] && continue
+    if [ "$file_path" = "$exclude_item" ]; then
+      return 0  # Is excluded (true)
+    fi
+  done <<EOF_EXCLUDE_CHECK
+$EXCLUDE_LIST
+EOF_EXCLUDE_CHECK
+
+  return 1  # Not excluded (false)
+}
+
+# Copy files from template to current directory
+printf "%b[INFO] Syncing files...%b\n" "$BLUE" "$RESET"
+
+synced_count=0
+skipped_count=0
+# Track whether .github (containing this script) was synced and whether a direct self update was requested
+synced_dotgithub="false"
+deferred_self_update="false"
+
+# Use here-document instead of pipeline to avoid subshell
+while IFS= read -r item || [ -n "$item" ]; do
+  [ -z "$item" ] && continue
+
+  # Check if this item is in the exclude list
+  if is_file_excluded "$item"; then
+    printf "  %b[SKIP]%b %s (excluded)\n" "$YELLOW" "$RESET" "$item"
+    skipped_count=$((skipped_count + 1))
+    continue
+  fi
+
+  # Defer updating this script to the very end to avoid mid-run overwrite
+  if [ "$item" = ".github/scripts/sync.sh" ]; then
+    deferred_self_update="true"
+    printf "  %b[DEFER]%b %s (will update at end)\n" "$YELLOW" "$RESET" "$item"
+    continue
+  fi
+
+  src_path="$TEMP_DIR/template/$item"
+  dest_path="./$item"
+
+  if [ -e "$src_path" ]; then
+    # Create parent directory if needed
+    dest_dir=$(dirname "$dest_path")
+    mkdir -p "$dest_dir"
+
+    # Copy the file or directory
+    if [ -d "$src_path" ]; then
+      # Ensure destination directory exists
+      mkdir -p "$dest_path"
+      # Copy contents of the source directory into the destination directory
+      # to avoid nesting (e.g., .github/.github or tests/tests)
+      cp -R "$src_path"/. "$dest_path"/
+      # Mark if we synced the .github directory so we can safely update sync.sh at the end
+      if [ "$item" = ".github" ]; then
+        synced_dotgithub="true"
+      fi
+
+      # Remove excluded files from the copied directory
+      if [ -n "$EXCLUDE_LIST" ]; then
+        while IFS= read -r exclude_item || [ -n "$exclude_item" ]; do
+          [ -z "$exclude_item" ] && continue
+          # Check if the excluded item is a child of the current item
+          # e.g., if item=".github" and exclude_item=".github/workflows/docker.yml"
+          case "$exclude_item" in
+            "$item"/*)
+              # This is a nested file that should be excluded
+              excluded_file_path="./$exclude_item"
+              if [ -e "$excluded_file_path" ]; then
+                rm -rf "$excluded_file_path"
+                printf "  %b[EXCLUDE]%b %s (removed from synced directory)\n" "$YELLOW" "$RESET" "$exclude_item"
+              fi
+              ;;
+          esac
+        done <<EOF_EXCLUDE_NESTED
+$EXCLUDE_LIST
+EOF_EXCLUDE_NESTED
+      fi
+
+      # If we just synced the .github directory, restore this script immediately to avoid mid-run overwrite issues
+      if [ "$item" = ".github" ] && [ -f "$TEMP_DIR/sync.sh.bak" ]; then
+        cp "$TEMP_DIR/sync.sh.bak" "$SELF_SCRIPT"
+      fi
+      printf "  %b[SYNC]%b %s (directory contents)\n" "$GREEN" "$RESET" "$item"
+    else
+      cp "$src_path" "$dest_path"
+      printf "  %b[SYNC]%b %s\n" "$GREEN" "$RESET" "$item"
+    fi
+    synced_count=$((synced_count + 1))
+  else
+    printf "  %b[WARN]%b %s (not found in template)\n" "$YELLOW" "$RESET" "$item"
+    skipped_count=$((skipped_count + 1))
+  fi
+done <<EOF_INCLUDE
+$INCLUDE_LIST
+EOF_INCLUDE
+
+# Finalize self-update of sync.sh if applicable
+TEMPLATE_SELF_SH="$TEMP_DIR/template/.github/scripts/sync.sh"
+if [ -f "$TEMPLATE_SELF_SH" ] && { [ "$deferred_self_update" = "true" ] || [ "$synced_dotgithub" = "true" ]; }; then
+  if is_file_excluded ".github/scripts/sync.sh"; then
+    printf "  %b[SKIP]%b .github/scripts/sync.sh (excluded from final update)\n" "$YELLOW" "$RESET"
+  else
+    cp "$TEMPLATE_SELF_SH" "$SELF_SCRIPT"
+    chmod +x "$SELF_SCRIPT" 2>/dev/null || true
+    printf "  %b[SYNC]%b .github/scripts/sync.sh (finalized)\n" "$GREEN" "$RESET"
+  fi
+fi
+
+printf "\n%b[INFO] Sync complete!%b\n" "$GREEN" "$RESET"
+printf "  Synced: %d files/directories\n" "$synced_count"
+if [ "$skipped_count" -gt 0 ]; then
+  printf "  Skipped: %d files/directories\n" "$skipped_count"
+fi
+
+printf "\n%b[INFO] Review the changes with: git status%b\n" "$BLUE" "$RESET"
+printf "%b[INFO] Commit the changes with: git add . && git commit -m 'chore: sync template files'%b\n" "$BLUE" "$RESET"

rhiza-0.4.0/.github/template.yml

@@ -0,0 +1,16 @@
+template-repository: "jebel-quant/rhiza"
+template-branch: "main"
+include: 
+    - .github
+    - tests
+    - .editorconfig
+    - .gitignore
+    - .pre-commit-config.yaml
+    - CODE_OF_CONDUCT.md
+    - CONTRIBUTING.md
+    - Makefile
+    - ruff.toml
+    - pytest.ini
+exclude:
+    - .github/workflows/docker.yml
+    - .github/workflows/devcontainer.yml

{rhiza-0.3.0 → rhiza-0.4.0}/.github/workflows/deptry.yml

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

{rhiza-0.3.0 → rhiza-0.4.0}/.github/workflows/marimo.yml

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

rhiza-0.4.0/.github/workflows/structure.yml

@@ -0,0 +1,73 @@
+# This file is part of the jebel-quant/rhiza repository
+# (https://github.com/jebel-quant/rhiza).
+#
+# GitHub Actions workflow: repository structure advisory checks
+# Purpose: Soft-check the presence of common scaffolding (src/, tests/, and key dotfiles)
+# and print WARN messages if something is missing. This workflow is advisory:
+# it never fails the job based on these checks; it only surfaces helpful hints
+# for template consumers.
+#
+# Triggers: on push and pull requests targeting main/master.
+# Permissions: read-only; no writes or tokens required. LFS enabled to support
+# repositories that track large files.
+# Notes: The shell steps use printf with optional color variables (e.g., YELLOW,
+# RESET). If these env vars are unset in the runner, the parameter expansion
+# defaults ensure plain text output without ANSI colors.
+name: "STRUCTURE"
+
+# Minimal read permission is sufficient; the workflow does not modify the repo
+permissions:
+  contents: read
+
+# Run on pushes and pull requests to the default branches
+on:
+  push:
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  # Single job that performs presence checks and emits WARN lines (warn-only)
+  structure_check:
+    runs-on: "ubuntu-latest"
+
+    permissions:
+      contents: read
+
+    steps:
+      # Check out the repository code (with Git LFS files, if any)
+      - uses: actions/checkout@v6
+        with:
+          lfs: true
+
+      # Check there is a src folder
+      - name: Check src folder exists
+        run: |
+          if [ ! -d "src" ]; then
+            printf "${YELLOW:-}[WARN] No src folder found, skipping structure check${RESET:-}\n"
+          fi
+
+      # Check there is a tests folder
+      - name: Check tests folder exists
+        run: |
+          if [ ! -d "tests" ]; then
+            printf "${YELLOW:-}[WARN] No tests folder found, skipping structure check${RESET:-}\n"
+          fi
+
+      # Check there is a .editorconfig, .gitignore, .pre-commit-config.yaml and Makefile file
+      - name: Check .editorconfig and .gitignore files exist
+        run: |
+          if [ ! -f ".editorconfig" ]; then
+            printf "${YELLOW:-}[WARN] No .editorconfig file found, skipping structure check${RESET:-}\n"
+          fi
+
+          if [ ! -f ".gitignore" ]; then
+            printf "${YELLOW:-}[WARN] No .gitignore file found, skipping structure check${RESET:-}\n"
+          fi
+
+          if [ ! -f ".pre-commit-config.yaml" ]; then
+            printf "${YELLOW:-}[WARN] No .pre-commit-config file found, skipping structure check${RESET:-}\n"
+          fi
+
+          if [ ! -f "Makefile" ]; then
+            printf "${YELLOW:-}[WARN] No Makefile found, skipping structure check${RESET:-}\n"
+          fi

{rhiza-0.3.0 → rhiza-0.4.0}/.github/workflows/sync.yml

@@ -32,7 +32,7 @@ jobs:
     steps:
       - name: Sync Template
         id: sync
-        uses: jebel-quant/sync_template@v0.4.2
+        uses: jebel-quant/sync_template@v0.4.3
         with:
           token: ${{ secrets.PAT_TOKEN }}
           source: ".github/template.yml"

rhiza-0.4.0/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: rhiza
+Version: 0.4.0
+Summary: Reusable configuration templates for modern Python projects
+Project-URL: Homepage, https://github.com/jebel-quant/rhiza-cli
+Project-URL: Repository, https://github.com/jebel-quant/rhiza-cli
+Project-URL: Issues, https://github.com/jebel-quant/rhiza/issues-cli
+Author: Thomas Schmelzer
+License: MIT
+License-File: LICENSE
+Keywords: ci,configuration,ruff,taskfile,templates
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: typer>=0.20.0
+Provides-Extra: dev
+Requires-Dist: marimo==0.18.4; extra == 'dev'
+Requires-Dist: pdoc>=16.0.0; extra == 'dev'
+Requires-Dist: pre-commit==4.5.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
+Requires-Dist: pytest-html>=4.1.1; extra == 'dev'
+Requires-Dist: pytest==9.0.2; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# rhiza-cli
+Command line interface for Rhiza

rhiza-0.4.0/README.md

@@ -0,0 +1,2 @@
+# rhiza-cli
+Command line interface for Rhiza

{rhiza-0.3.0 → rhiza-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rhiza"
-version = "0.3.0"
+version = "0.4.0"
 description = "Reusable configuration templates for modern Python projects"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -12,7 +12,7 @@ license = { text = "MIT" }
 authors = [
   { name = "Thomas Schmelzer" }
 ]
-keywords = ["templates", "configuration", "ci", "ruff"]
+keywords = ["templates", "configuration", "taskfile", "ci", "ruff"]
 classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -25,10 +25,16 @@ classifiers = [
     "Topic :: Software Development :: Build Tools",
 ]
 
+dependencies = [
+    "loguru>=0.7.3",
+    "typer>=0.20.0",
+    "PyYAML==6.0.3"
+]
+
 [project.urls]
-Homepage = "https://github.com/jebel-quant/rhiza"
-Repository = "https://github.com/jebel-quant/rhiza"
-Issues = "https://github.com/jebel-quant/rhiza/issues"
+Homepage = "https://github.com/jebel-quant/rhiza-cli"
+Repository = "https://github.com/jebel-quant/rhiza-cli"
+Issues = "https://github.com/jebel-quant/rhiza/issues-cli"
 
 
 [project.optional-dependencies]
@@ -49,5 +55,11 @@ packages = ["src/rhiza"]
 # see https://deptry.com/usage/#pep-621-dev-dependency-groups
 pep621_dev_dependency_groups = ["dev"]
 
+[tool.deptry.package_module_name_map]
+PyYAML = "yaml"
+
 [tool.marimo.runtime]
 pythonpath = ["src"]
+
+[project.scripts]
+rhiza = "rhiza.__main__:app"

rhiza-0.4.0/src/rhiza/__init__.py

@@ -0,0 +1,5 @@
+"""Utility tools and command-line helpers for the Rhiza project.
+
+This package groups small, user-facing utilities that can be invoked from
+the command line or other automation scripts.
+"""

rhiza-0.4.0/src/rhiza/__main__.py

@@ -0,0 +1,10 @@
+"""Rhiza module entry point.
+
+This module allows running the Rhiza CLI with `python -m rhiza` by
+delegating execution to the Typer application defined in `rhiza.cli`.
+"""
+
+from rhiza.cli import app
+
+if __name__ == "__main__":
+    app()

rhiza-0.4.0/src/rhiza/cli.py

@@ -0,0 +1,47 @@
+"""Rhiza command-line interface (CLI).
+
+This module defines the Typer application entry points exposed by Rhiza.
+Commands are thin wrappers around implementations in `rhiza.commands.*`.
+"""
+
+from pathlib import Path
+
+import typer
+
+from rhiza.commands.hello import hello as hello_cmd
+from rhiza.commands.inject import inject as inject_cmd
+
+app = typer.Typer(help="rhiza — configuration materialization tools")
+
+
+@app.command()
+def hello():
+    """Sanity check command."""
+    hello_cmd()
+
+
+@app.command()
+def materialize(
+    target: Path = typer.Argument(
+        default=Path("."),  # default to current directory
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        help="Target git repository (defaults to current directory)",
+    ),
+    branch: str = typer.Option("main", "--branch", "-b", help="Rhiza branch to use"),
+    force: bool = typer.Option(False, "--force", "-y", help="Overwrite existing files"),
+):
+    """Inject Rhiza configuration into a target repository.
+
+    Parameters
+    ----------
+    target:
+        Path to the target Git repository directory. Defaults to the
+        current working directory.
+    branch:
+        Name of the Rhiza branch to use when sourcing templates.
+    force:
+        If True, overwrite existing files without prompting.
+    """
+    inject_cmd(target, branch, force)

rhiza-0.4.0/src/rhiza/commands/__init__.py

@@ -0,0 +1,5 @@
+"""Command implementations for the Rhiza CLI.
+
+This package contains the functions that back Typer commands exposed by
+`rhiza.cli`, such as `hello` and `inject`.
+"""

rhiza-0.4.0/src/rhiza/commands/hello.py

@@ -0,0 +1,9 @@
+"""Small demo CLI entrypoint for Rhiza tools.
+
+This module provides a minimal example command that prints a greeting.
+"""
+
+
+def hello():
+    """Print a friendly greeting from Rhiza."""
+    print("Hello from Rhiza!")