wizard-codegen 0.1.7__tar.gz → 0.1.8__tar.gz

wizard_codegen-0.1.7/README.md → wizard_codegen-0.1.8/PKG-INFO

@@ -1,3 +1,18 @@
+Metadata-Version: 2.4
+Name: wizard-codegen
+Version: 0.1.8
+Summary: A powerful, template-driven code generation tool for Protocol Buffers
+Requires-Python: >=3.10
+Requires-Dist: click==8.3.1
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: protobuf==6.33.2
+Requires-Dist: pydantic-core==2.41.5
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: rich==14.2.0
+Requires-Dist: typer==0.21.0
+Description-Content-Type: text/markdown
+
 # 🧙 Wizard Codegen
 
 [![CircleCI](https://dl.circleci.com/status-badge/img/gh/ConsultingMD/wizard-codegen/tree/main.svg?style=svg&circle-token=CCIPRJ_6cYihJ2CPYtLrt8VjrCcSV_f02bbbce30f122a85da4e93588e8887e973128fd)](https://dl.circleci.com/status-badge/redirect/gh/ConsultingMD/wizard-codegen/tree/main)
@@ -56,17 +71,48 @@ Wizard Codegen transforms your `.proto` definitions into typed code for multiple
 
 ## 🚀 Quick Start
 
+### 1. Install Prerequisites
+
+**Protocol Buffer Compiler (protoc):**
+
 ```bash
-# 1. Clone and setup
-git clone <your-repo-url>
-cd wizard-codegen
-make deps
+# macOS
+brew install protobuf
+
+# Ubuntu/Debian
+sudo apt install -y protobuf-compiler
+
+# Verify installation
+protoc --version
+```
 
-# 2. Create your configuration
-cat > wizard/codegen.yaml << 'EOF'
+**uv (Python package manager):**
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Or via Homebrew
+brew install uv
+
+# Verify installation
+uv --version
+```
+
+### 2. Install Wizard Codegen
+
+```bash
+uv tool install wizard-codegen
+```
+
+### 3. Create Configuration
+
+Create `wizard/codegen.yaml` in your project:
+
+```yaml
 proto:
+  root: "path/to/your/protos"    # Local path to proto files
   cache_dir: ".cache/protos"
-  root: "path/to/your/protos"
   files:
     - "**/*.proto"
 
@@ -81,13 +127,19 @@ targets:
           all:
             - name: "*Form"
         output: "components/{{ item.name.kebab_case }}/index.tsx"
-EOF
+```
 
-# 3. Generate code
-uv run wizard-codegen generate
+### 4. Generate Code
 
-# Or with verbose output
-uv run wizard-codegen --verbose generate
+```bash
+# Generate code
+wizard-codegen generate
+
+# Preview changes without writing files
+wizard-codegen --dry-run generate
+
+# Verbose output for debugging
+wizard-codegen --verbose generate
 ```
 
 ---
@@ -96,64 +148,52 @@ uv run wizard-codegen --verbose generate
 
 ### Prerequisites
 
-- **Python 3.10+**
-- **[uv](https://docs.astral.sh/uv/)** — Fast Python package manager (installed via `ih-setup upgrade`)
-- **protoc** (Protocol Buffer Compiler) — [Installation Guide](https://grpc.io/docs/protoc-installation/)
-- **Git** (for fetching proto sources from repositories)
+| Requirement | Description | Installation |
+|-------------|-------------|--------------|
+| **Python 3.10+** | Runtime | [python.org](https://www.python.org/downloads/) |
+| **uv** | Fast Python package manager | See Quick Start or [docs.astral.sh/uv](https://docs.astral.sh/uv/) |
+| **protoc** | Protocol Buffer Compiler | See Quick Start or [grpc.io](https://grpc.io/docs/protoc-installation/) |
+| **Git** | For fetching proto sources | Usually pre-installed |
 
-### Install via uv tool (Recommended)
+### Install via uv (Recommended)
 
 ```bash
-# Install protobuf compiler
-brew install protobuf
-
-# Install wizard-codegen from public PyPI
 uv tool install wizard-codegen
 ```
 
-#### Upgrade
+### Upgrade
 
 ```bash
 uv tool upgrade wizard-codegen
 ```
 
-### From Source
+### Install from Source (for development)
 
 ```bash
-# Clone the repository
-git clone <repo-url>
+git clone <internal-repo-url>
 cd wizard-codegen
-
-# Install protobuf compiler
-brew install protobuf
-
-# Install dependencies
-make deps
-
-# Install the cli
-make install
-
-# Run the CLI
-wizard-codegen --version
+make deps      # Install dependencies
+make install   # Install CLI tool
 ```
 
-#### Upgrade From Source
+### Upgrade from Source
+
 ```bash
 make upgrade
-````
+```
 
 ### Dependencies
 
-Dependencies are managed in `pyproject.toml` and locked in `uv.lock`:
+Core dependencies (managed in `pyproject.toml`):
 
-```
-typer==0.20.1          # CLI framework
-pydantic==2.12.5       # Configuration validation
-jinja2==3.1.6          # Template engine
-rich==14.2.0           # Beautiful terminal output
-protobuf==6.33.2       # Proto descriptor handling
-pyyaml==6.0.3          # YAML configuration
-```
+| Package | Version | Purpose |
+|---------|---------|---------|
+| typer | 0.20.1 | CLI framework |
+| pydantic | 2.12.5 | Configuration validation |
+| jinja2 | 3.1.6 | Template engine |
+| rich | 14.2.0 | Terminal output |
+| protobuf | 6.33.2 | Proto descriptor handling |
+| pyyaml | 6.0.3 | YAML configuration |
 
 ---
 

wizard_codegen-0.1.7/PKG-INFO → wizard_codegen-0.1.8/README.md

@@ -1,18 +1,3 @@
-Metadata-Version: 2.4
-Name: wizard-codegen
-Version: 0.1.7
-Summary: A powerful, template-driven code generation tool for Protocol Buffers
-Requires-Python: >=3.10
-Requires-Dist: click==8.3.1
-Requires-Dist: jinja2==3.1.6
-Requires-Dist: protobuf==6.33.2
-Requires-Dist: pydantic-core==2.41.5
-Requires-Dist: pydantic==2.12.5
-Requires-Dist: pyyaml==6.0.3
-Requires-Dist: rich==14.2.0
-Requires-Dist: typer==0.20.1
-Description-Content-Type: text/markdown
-
 # 🧙 Wizard Codegen
 
 [![CircleCI](https://dl.circleci.com/status-badge/img/gh/ConsultingMD/wizard-codegen/tree/main.svg?style=svg&circle-token=CCIPRJ_6cYihJ2CPYtLrt8VjrCcSV_f02bbbce30f122a85da4e93588e8887e973128fd)](https://dl.circleci.com/status-badge/redirect/gh/ConsultingMD/wizard-codegen/tree/main)
@@ -71,17 +56,48 @@ Wizard Codegen transforms your `.proto` definitions into typed code for multiple
 
 ## 🚀 Quick Start
 
+### 1. Install Prerequisites
+
+**Protocol Buffer Compiler (protoc):**
+
 ```bash
-# 1. Clone and setup
-git clone <your-repo-url>
-cd wizard-codegen
-make deps
+# macOS
+brew install protobuf
+
+# Ubuntu/Debian
+sudo apt install -y protobuf-compiler
+
+# Verify installation
+protoc --version
+```
 
-# 2. Create your configuration
-cat > wizard/codegen.yaml << 'EOF'
+**uv (Python package manager):**
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Or via Homebrew
+brew install uv
+
+# Verify installation
+uv --version
+```
+
+### 2. Install Wizard Codegen
+
+```bash
+uv tool install wizard-codegen
+```
+
+### 3. Create Configuration
+
+Create `wizard/codegen.yaml` in your project:
+
+```yaml
 proto:
+  root: "path/to/your/protos"    # Local path to proto files
   cache_dir: ".cache/protos"
-  root: "path/to/your/protos"
   files:
     - "**/*.proto"
 
@@ -96,13 +112,19 @@ targets:
           all:
             - name: "*Form"
         output: "components/{{ item.name.kebab_case }}/index.tsx"
-EOF
+```
 
-# 3. Generate code
-uv run wizard-codegen generate
+### 4. Generate Code
 
-# Or with verbose output
-uv run wizard-codegen --verbose generate
+```bash
+# Generate code
+wizard-codegen generate
+
+# Preview changes without writing files
+wizard-codegen --dry-run generate
+
+# Verbose output for debugging
+wizard-codegen --verbose generate
 ```
 
 ---
@@ -111,64 +133,52 @@ uv run wizard-codegen --verbose generate
 
 ### Prerequisites
 
-- **Python 3.10+**
-- **[uv](https://docs.astral.sh/uv/)** — Fast Python package manager (installed via `ih-setup upgrade`)
-- **protoc** (Protocol Buffer Compiler) — [Installation Guide](https://grpc.io/docs/protoc-installation/)
-- **Git** (for fetching proto sources from repositories)
+| Requirement | Description | Installation |
+|-------------|-------------|--------------|
+| **Python 3.10+** | Runtime | [python.org](https://www.python.org/downloads/) |
+| **uv** | Fast Python package manager | See Quick Start or [docs.astral.sh/uv](https://docs.astral.sh/uv/) |
+| **protoc** | Protocol Buffer Compiler | See Quick Start or [grpc.io](https://grpc.io/docs/protoc-installation/) |
+| **Git** | For fetching proto sources | Usually pre-installed |
 
-### Install via uv tool (Recommended)
+### Install via uv (Recommended)
 
 ```bash
-# Install protobuf compiler
-brew install protobuf
-
-# Install wizard-codegen from public PyPI
 uv tool install wizard-codegen
 ```
 
-#### Upgrade
+### Upgrade
 
 ```bash
 uv tool upgrade wizard-codegen
 ```
 
-### From Source
+### Install from Source (for development)
 
 ```bash
-# Clone the repository
-git clone <repo-url>
+git clone <internal-repo-url>
 cd wizard-codegen
-
-# Install protobuf compiler
-brew install protobuf
-
-# Install dependencies
-make deps
-
-# Install the cli
-make install
-
-# Run the CLI
-wizard-codegen --version
+make deps      # Install dependencies
+make install   # Install CLI tool
 ```
 
-#### Upgrade From Source
+### Upgrade from Source
+
 ```bash
 make upgrade
-````
+```
 
 ### Dependencies
 
-Dependencies are managed in `pyproject.toml` and locked in `uv.lock`:
+Core dependencies (managed in `pyproject.toml`):
 
-```
-typer==0.20.1          # CLI framework
-pydantic==2.12.5       # Configuration validation
-jinja2==3.1.6          # Template engine
-rich==14.2.0           # Beautiful terminal output
-protobuf==6.33.2       # Proto descriptor handling
-pyyaml==6.0.3          # YAML configuration
-```
+| Package | Version | Purpose |
+|---------|---------|---------|
+| typer | 0.20.1 | CLI framework |
+| pydantic | 2.12.5 | Configuration validation |
+| jinja2 | 3.1.6 | Template engine |
+| rich | 14.2.0 | Terminal output |
+| protobuf | 6.33.2 | Proto descriptor handling |
+| pyyaml | 6.0.3 | YAML configuration |
 
 ---
 

{wizard_codegen-0.1.7 → wizard_codegen-0.1.8}/proto/protoc_runner.py

@@ -19,7 +19,11 @@ def build_descriptor_set(
         fds_path = expand_path(config.proto.source.fds).resolve()
         return fds_path, None
 
-    cache_dir = expand_path(config.proto.cache_dir).resolve() if config.proto.cache_dir else (Path.cwd() / ".cache")
+    if config.proto.cache_dir:
+        cache_dir = expand_path(config.proto.cache_dir, mkdir=True).resolve()
+    else:
+        cache_dir = Path.cwd() / ".cache"
+        cache_dir.mkdir(parents=True, exist_ok=True)
     out_dir = Path(tempfile.mkdtemp(prefix="wizard_protoc_codegen_", dir=cache_dir))
     fds_path = out_dir / "descriptor.pb"
 

{wizard_codegen-0.1.7 → wizard_codegen-0.1.8}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "wizard-codegen"
-version = "0.1.7"
+version = "0.1.8"
 description = "A powerful, template-driven code generation tool for Protocol Buffers"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "typer==0.20.1",
+    "typer==0.21.0",
     "pydantic==2.12.5",
     "pydantic_core==2.41.5",
     "jinja2==3.1.6",

{wizard_codegen-0.1.7 → wizard_codegen-0.1.8}/utils/path.py

@@ -8,7 +8,7 @@ from pathlib import Path
 import os
 
 
-def expand_path(path_str: str) -> Path:
+def expand_path(path_str: str, *, mkdir: bool = False) -> Path:
     """
     Expand environment variables and ~ in a path string.
 
@@ -18,10 +18,14 @@ def expand_path(path_str: str) -> Path:
 
     Args:
         path_str: Path string that may contain variables
+        mkdir: If True, create the directory (and parents) if it doesn't exist
 
     Returns:
         Path object with variables expanded
     """
     expanded = os.path.expandvars(path_str)  # $VAR, ${VAR}
     expanded = os.path.expanduser(expanded)   # ~
-    return Path(expanded)
+    path = Path(expanded)
+    if mkdir:
+        path.mkdir(parents=True, exist_ok=True)
+    return path