feat: add Odoo launcher script generation

Add launcher module that generates bash scripts for auto-activating venv
and running Odoo. Includes:
- --create-launcher flag on 'create' command to auto-generate launcher
- Template-based script generation with full Odoo option support
- Security checks (symlink detection, path validation)
- PATH warning if launcher dir not in environment

Author: trisdoan

.gitignore

@@ -214,3 +214,8 @@ __marimo__/
 
 # Streamlit
 .streamlit/secrets.toml
+
+.claude/
+.opencode/
+plans/
+release-manifest.json

odoo_venv/assets/launcher.sh.template

@@ -0,0 +1,140 @@
+#!/bin/bash
+#
+# Odoo Launcher Script
+#
+# Auto-generated by odoo-venv. This script activates the virtual environment
+# and runs Odoo with the configured options.
+#
+# Configure Odoo startup by editing the variables below.
+# Only parameters with non-empty values will be passed to odoo.
+#
+# Usage:
+#   1. Edit variables below (e.g., DATABASE="mydb", DEV_MODE="all")
+#   2. Run: odoo-v{version}
+#   3. Script activates venv and builds command: odoo -d mydb --dev all
+
+set -uo pipefail
+
+# ============================================================================
+# VIRTUAL ENVIRONMENT ACTIVATION
+# ============================================================================
+
+VENV_DIR="$VENV_DIR"
+export VIRTUAL_ENV="$$VENV_DIR"
+export PATH="$$VENV_DIR/bin:$$PATH"
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+# Database
+DATABASE="odoo_db" # -d: Database name
+INIT_MODULES=""    # -i: Modules to install (comma-separated)
+UPDATE_MODULES=""  # -u: Modules to update (comma-separated)
+ADDONS_PATH=""     # --addons-path: Addons paths (comma-separated)
+DB_FILTER=""       # --db-filter: Database filter regex
+
+# Database Connection
+DB_USER="odoo"      # -r: Database user
+DB_PASSWORD="odoo"  # -w: Database password
+DB_HOST="localhost" # --db_host: Database host
+DB_PORT=""          # --db_port: Database port
+
+# Configuration
+CONFIG_FILE=""     # -c: Configuration file path
+SAVE_CONFIG=""     # -s: Save configuration to file
+STOP_AFTER_INIT="" # --stop-after-init: Stop after init (true/false)
+
+# Developer Mode
+DEV_MODE="" # --dev: Dev mode (all, reload, qweb, werkzeug, xml)
+
+# Web Server
+HTTP_PORT=""      # --http-port: HTTP port (default: 8069)
+HTTP_INTERFACE="" # --http-interface: Interface to bind (default: 0.0.0.0)
+NO_HTTP=""        # --no-http: Disable HTTP server (true/false)
+
+# Testing
+TEST_ENABLE="" # --test-enable: Enable unit tests (true/false)
+TEST_TAGS=""   # --test-tags: Test tags (comma-separated)
+
+# Logging
+LOGFILE=""     # --logfile: Log file path
+LOG_LEVEL=""   # --log-level: Log level (debug, info, warn, error, critical)
+LOG_HANDLER="" # --log-handler: Log handler (e.g., :INFO)
+
+# Performance
+WORKERS="0"            # --workers: Number of worker processes
+LIMIT_TIME_CPU="3600"  # --limit-time-cpu: CPU time limit (seconds)
+LIMIT_TIME_REAL="3600" # --limit-time-real: Real time limit (seconds)
+MAX_CRON_THREADS="0"   # --max-cron-threads: Max cron threads
+PROXY_MODE=""          # --proxy-mode: Enable proxy mode (true/false)
+
+# ============================================================================
+# COMMAND BUILDER
+# ============================================================================
+
+CMD=()
+
+add_arg() { [[ -n "$$2" ]] && CMD+=("$$1" "$$2"); }
+add_flag() { [[ "$$2" == "true" ]] && CMD+=("$$1"); }
+
+build_command() {
+  CMD=("odoo")
+
+  # Database
+  add_arg "-d" "$$DATABASE"
+  add_arg "-i" "$$INIT_MODULES"
+  add_arg "-u" "$$UPDATE_MODULES"
+  add_arg "--addons-path" "$$ADDONS_PATH"
+  add_arg "--db-filter" "$$DB_FILTER"
+
+  # Database connection
+  add_arg "-r" "$$DB_USER"
+  add_arg "-w" "$$DB_PASSWORD"
+  add_arg "--db_host" "$$DB_HOST"
+  add_arg "--db_port" "$$DB_PORT"
+
+  # Configuration
+  add_arg "-c" "$$CONFIG_FILE"
+  add_arg "-s" "$$SAVE_CONFIG"
+  add_flag "--stop-after-init" "$$STOP_AFTER_INIT"
+
+  # Developer mode
+  add_arg "--dev" "$$DEV_MODE"
+
+  # Web server
+  add_arg "--http-port" "$$HTTP_PORT"
+  add_arg "--http-interface" "$$HTTP_INTERFACE"
+  add_flag "--no-http" "$$NO_HTTP"
+
+  # Testing
+  add_flag "--test-enable" "$$TEST_ENABLE"
+  add_arg "--test-tags" "$$TEST_TAGS"
+
+  # Logging
+  add_arg "--logfile" "$$LOGFILE"
+  add_arg "--log-level" "$$LOG_LEVEL"
+  add_arg "--log-handler" "$$LOG_HANDLER"
+
+  # Performance
+  add_arg "--workers" "$$WORKERS"
+  add_arg "--limit-time-cpu" "$$LIMIT_TIME_CPU"
+  add_arg "--limit-time-real" "$$LIMIT_TIME_REAL"
+  add_arg "--max-cron-threads" "$$MAX_CRON_THREADS"
+  add_flag "--proxy-mode" "$$PROXY_MODE"
+}
+
+# ============================================================================
+# MAIN
+# ============================================================================
+
+main() {
+  build_command
+  CMD+=("$$@")
+
+  echo "Executing: $${CMD[*]}"
+  echo "---"
+  "$${CMD[@]}"
+}
+
+main "$$@"

odoo_venv/cli/main.py

@@ -6,6 +6,7 @@
 import typer
 
 from odoo_venv.exceptions import PresetNotFoundError
+from odoo_venv.launcher import create_launcher
 from odoo_venv.main import create_odoo_venv
 from odoo_venv.utils import initialize_presets, load_presets, run_migration
 
@@ -146,6 +147,13 @@ def create(
             help="Use a preset of options. Preset values can be overriden by other options.",
         ),
     ] = None,
+    create_launcher_flag: Annotated[
+        bool,
+        typer.Option(
+            "--create-launcher/--no-create-launcher",
+            help="Generate a launcher script in ~/.local/bin/.",
+        ),
+    ] = False,
 ):
     """Create virtual environment to run Odoo"""
     if not odoo_dir:
@@ -191,3 +199,17 @@ def create(
         verbose=verbose,
         dry_run=dry_run,
     )
+
+    if create_launcher_flag:
+        create_launcher(odoo_version, venv_dir_path, force=True)
+
+
+@app.command()
+def create_odoo_launcher(
+    odoo_version: Annotated[str, typer.Argument(help="Odoo version, e.g: 19.0")],
+    venv_dir: Annotated[str, typer.Option(help="Path to the virtual environment.")],
+    force: Annotated[bool, typer.Option(help="Overwrite existing launcher script.")] = False,
+):
+    """Generate a launcher script in ~/.local/bin/ for the Odoo environment"""
+    venv_dir_path = Path(venv_dir).expanduser().resolve()
+    create_launcher(odoo_version, venv_dir_path, force=force)

odoo_venv/launcher.py

@@ -0,0 +1,90 @@
+"""Launcher script generation for Odoo environments."""
+
+import os
+import sys
+from pathlib import Path
+from string import Template
+
+import typer
+
+LAUNCHER_DIR = Path("~/.local/bin").expanduser()
+TEMPLATE_PATH = Path(__file__).parent / "assets" / "launcher.sh.template"
+
+
+def create_launcher(odoo_version: str, venv_dir: str | Path, force: bool = False) -> Path:
+    """
+    Generate a bash launcher script that auto-activates the venv and runs Odoo.
+
+    Args:
+        odoo_version: Odoo version string (e.g., "19.0")
+        venv_dir: Path to the virtual environment
+        force: Overwrite existing launcher if True
+
+    Returns:
+        Path to the created launcher script
+
+    Raises:
+        SystemExit: If file exists and force=False, or on write errors
+    """
+    # Extract major version for script name
+    major_version = odoo_version.split(".")[0]
+    script_name = f"odoo-v{major_version}"
+    output_path = LAUNCHER_DIR / script_name
+
+    # Resolve venv path to absolute
+    venv_path = Path(venv_dir).expanduser().resolve()
+
+    # Check if file exists
+    if output_path.exists() and not force:
+        typer.secho(
+            f"Launcher script already exists: {output_path}\nUse --force to overwrite.",
+            fg=typer.colors.YELLOW,
+        )
+        return output_path
+
+    # Create output directory if needed
+    LAUNCHER_DIR.mkdir(parents=True, exist_ok=True)
+
+    # Read and render template
+    try:
+        template_content = TEMPLATE_PATH.read_text()
+        rendered = Template(template_content).substitute(VENV_DIR=str(venv_path))
+    except FileNotFoundError:
+        typer.secho(f"Template not found: {TEMPLATE_PATH}", fg=typer.colors.RED, err=True)
+        sys.exit(1)
+    except (KeyError, ValueError) as e:
+        typer.secho(f"Template substitution failed: {e}", fg=typer.colors.RED, err=True)
+        sys.exit(1)
+
+    # Security: Check for symlink before writing
+    if output_path.is_symlink():
+        typer.secho(
+            f"Error: {output_path} is a symbolic link. Refusing to overwrite for security reasons.",
+            fg=typer.colors.RED,
+            err=True,
+        )
+        sys.exit(1)
+
+    # Write script
+    try:
+        output_path.write_text(rendered)
+        output_path.chmod(0o755)
+    except PermissionError:
+        typer.secho(
+            f"Permission denied writing to {output_path}\nEnsure you have write access to {LAUNCHER_DIR}",
+            fg=typer.colors.RED,
+            err=True,
+        )
+        sys.exit(1)
+
+    # Check if launcher dir is in PATH
+    if str(LAUNCHER_DIR) not in os.environ.get("PATH", ""):
+        typer.secho(
+            f"\nWarning: {LAUNCHER_DIR} is not in your PATH.\n"
+            f"Add this to your shell profile (~/.bashrc or ~/.zshrc):\n"
+            f'  export PATH="$PATH:{LAUNCHER_DIR}"',
+            fg=typer.colors.YELLOW,
+        )
+
+    typer.secho(f"✓ Launcher created: {output_path}", fg=typer.colors.GREEN)
+    return output_path