claude-dev-cli 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

claude_dev_cli/__init__.py

@@ -9,7 +9,7 @@ Features:
 - Interactive and single-shot modes
 """
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __author__ = "Julio"
 __license__ = "MIT"
 

claude_dev_cli/cli.py

@@ -21,6 +21,7 @@ from claude_dev_cli.commands import (
     git_commit_message,
 )
 from claude_dev_cli.usage import UsageTracker
+from claude_dev_cli import toon_utils
 
 console = Console()
 
@@ -394,5 +395,124 @@ def usage(ctx: click.Context, days: Optional[int], api: Optional[str]) -> None:
         sys.exit(1)
 
 
+@main.group()
+def toon() -> None:
+    """TOON format conversion tools."""
+    pass
+
+
+@toon.command('encode')
+@click.argument('input_file', type=click.Path(exists=True), required=False)
+@click.option('-o', '--output', type=click.Path(), help='Output file')
+@click.pass_context
+def toon_encode(ctx: click.Context, input_file: Optional[str], output: Optional[str]) -> None:
+    """Convert JSON to TOON format."""
+    console = ctx.obj['console']
+    
+    if not toon_utils.is_toon_available():
+        console.print("[red]TOON support not installed.[/red]")
+        console.print("Install with: [cyan]pip install claude-dev-cli[toon][/cyan]")
+        sys.exit(1)
+    
+    try:
+        import json
+        
+        # Read input
+        if input_file:
+            with open(input_file, 'r') as f:
+                data = json.load(f)
+        elif not sys.stdin.isatty():
+            data = json.load(sys.stdin)
+        else:
+            console.print("[red]Error: No input provided[/red]")
+            console.print("Usage: cdc toon encode [FILE] or pipe JSON via stdin")
+            sys.exit(1)
+        
+        # Convert to TOON
+        toon_str = toon_utils.to_toon(data)
+        
+        # Output
+        if output:
+            with open(output, 'w') as f:
+                f.write(toon_str)
+            console.print(f"[green]✓[/green] Converted to TOON: {output}")
+        else:
+            console.print(toon_str)
+    
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
+@toon.command('decode')
+@click.argument('input_file', type=click.Path(exists=True), required=False)
+@click.option('-o', '--output', type=click.Path(), help='Output file')
+@click.pass_context
+def toon_decode(ctx: click.Context, input_file: Optional[str], output: Optional[str]) -> None:
+    """Convert TOON format to JSON."""
+    console = ctx.obj['console']
+    
+    if not toon_utils.is_toon_available():
+        console.print("[red]TOON support not installed.[/red]")
+        console.print("Install with: [cyan]pip install claude-dev-cli[toon][/cyan]")
+        sys.exit(1)
+    
+    try:
+        import json
+        
+        # Read input
+        if input_file:
+            with open(input_file, 'r') as f:
+                toon_str = f.read()
+        elif not sys.stdin.isatty():
+            toon_str = sys.stdin.read()
+        else:
+            console.print("[red]Error: No input provided[/red]")
+            console.print("Usage: cdc toon decode [FILE] or pipe TOON via stdin")
+            sys.exit(1)
+        
+        # Convert from TOON
+        data = toon_utils.from_toon(toon_str)
+        
+        # Output
+        json_str = json.dumps(data, indent=2)
+        if output:
+            with open(output, 'w') as f:
+                f.write(json_str)
+            console.print(f"[green]✓[/green] Converted to JSON: {output}")
+        else:
+            console.print(json_str)
+    
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        sys.exit(1)
+
+
+@toon.command('info')
+@click.pass_context
+def toon_info(ctx: click.Context) -> None:
+    """Show TOON format installation status and token savings info."""
+    console = ctx.obj['console']
+    
+    if toon_utils.is_toon_available():
+        console.print("[green]✓[/green] TOON format support is installed")
+        console.print("\n[bold]About TOON:[/bold]")
+        console.print("• Token-Oriented Object Notation")
+        console.print("• 30-60% fewer tokens than JSON")
+        console.print("• Optimized for LLM prompts")
+        console.print("• Human-readable and lossless")
+        console.print("\n[bold]Usage:[/bold]")
+        console.print("  cdc toon encode data.json -o data.toon")
+        console.print("  cdc toon decode data.toon -o data.json")
+        console.print("  cat data.json | cdc toon encode")
+    else:
+        console.print("[yellow]TOON format support not installed[/yellow]")
+        console.print("\nInstall with: [cyan]pip install claude-dev-cli[toon][/cyan]")
+        console.print("\n[bold]Benefits:[/bold]")
+        console.print("• Reduce API costs by 30-60%")
+        console.print("• Faster LLM response times")
+        console.print("• Same data, fewer tokens")
+
+
 if __name__ == '__main__':
     main(obj={})

claude_dev_cli/toon_utils.py

@@ -0,0 +1,117 @@
+"""TOON format utilities for token-efficient LLM communication."""
+
+from typing import Any, Optional
+
+# Try to import toon-format, but make it optional
+try:
+    from toon_format import encode as toon_encode, decode as toon_decode
+    TOON_AVAILABLE = True
+except ImportError:
+    TOON_AVAILABLE = False
+    toon_encode = None
+    toon_decode = None
+
+
+def is_toon_available() -> bool:
+    """Check if TOON format support is available."""
+    return TOON_AVAILABLE
+
+
+def to_toon(data: Any) -> str:
+    """
+    Convert Python data to TOON format.
+    
+    Args:
+        data: Python dict, list, or primitive to encode
+        
+    Returns:
+        TOON-formatted string
+        
+    Raises:
+        ImportError: If toon-format is not installed
+    """
+    if not TOON_AVAILABLE:
+        raise ImportError(
+            "TOON format support not installed. "
+            "Install with: pip install claude-dev-cli[toon]"
+        )
+    
+    return toon_encode(data)
+
+
+def from_toon(toon_str: str) -> Any:
+    """
+    Convert TOON format back to Python data.
+    
+    Args:
+        toon_str: TOON-formatted string
+        
+    Returns:
+        Python dict, list, or primitive
+        
+    Raises:
+        ImportError: If toon-format is not installed
+    """
+    if not TOON_AVAILABLE:
+        raise ImportError(
+            "TOON format support not installed. "
+            "Install with: pip install claude-dev-cli[toon]"
+        )
+    
+    return toon_decode(toon_str)
+
+
+def format_for_llm(data: Any, use_toon: bool = True) -> str:
+    """
+    Format data for LLM consumption, preferring TOON if available.
+    
+    Args:
+        data: Data to format
+        use_toon: Whether to use TOON format if available (default: True)
+        
+    Returns:
+        Formatted string (TOON if available and requested, else JSON)
+    """
+    import json
+    
+    if use_toon and TOON_AVAILABLE:
+        try:
+            return to_toon(data)
+        except Exception:
+            # Fall back to JSON if TOON encoding fails
+            pass
+    
+    return json.dumps(data, indent=2)
+
+
+def auto_detect_format(content: str) -> tuple[str, Any]:
+    """
+    Auto-detect if content is TOON or JSON and decode accordingly.
+    
+    Args:
+        content: String content to decode
+        
+    Returns:
+        Tuple of (format_name, decoded_data)
+        
+    Raises:
+        ValueError: If content cannot be parsed as either format
+    """
+    import json
+    
+    # Try TOON first if available
+    if TOON_AVAILABLE:
+        try:
+            data = from_toon(content)
+            return ("toon", data)
+        except Exception:
+            pass
+    
+    # Try JSON
+    try:
+        data = json.loads(content)
+        return ("json", data)
+    except json.JSONDecodeError:
+        pass
+    
+    raise ValueError("Content is neither valid TOON nor JSON")

{claude_dev_cli-0.1.0.dist-info → claude_dev_cli-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-dev-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: A powerful CLI tool for developers using Claude AI with multi-API routing, test generation, code review, and usage tracking
 Author-email: Julio <thinmanj@users.noreply.github.com>
 License: MIT
@@ -26,11 +26,14 @@ Requires-Dist: anthropic>=0.18.0
 Requires-Dist: click>=8.1.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: pydantic>=2.0.0
+Provides-Extra: toon
+Requires-Dist: toon-format>=0.9.0; extra == "toon"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: toon-format>=0.9.0; extra == "dev"
 Dynamic: license-file
 
 # Claude Dev CLI
@@ -63,12 +66,27 @@ A powerful command-line tool for developers using Claude AI with multi-API routi
 - **Interactive**: Chat mode with conversation history
 - **Streaming**: Real-time responses
 
+### 🎒 TOON Format Support (Optional)
+- **Token Reduction**: 30-60% fewer tokens than JSON
+- **Cost Savings**: Reduce API costs significantly
+- **Format Conversion**: JSON ↔ TOON with CLI tools
+- **Auto-fallback**: Works without TOON installed
+
 ## Installation
 
+### Basic Installation
+
 ```bash
 pip install claude-dev-cli
 ```
 
+### With TOON Support (Recommended for Cost Savings)
+
+```bash
+# Install with TOON format support for 30-60% token reduction
+pip install claude-dev-cli[toon]
+```
+
 ## Quick Start
 
 ### 1. Set Up API Keys
@@ -141,6 +159,28 @@ cdc usage --days 7
 cdc usage --api client
 ```
 
+### 5. TOON Format (Optional - Reduces Tokens by 30-60%)
+
+```bash
+# Check if TOON is installed
+cdc toon info
+
+# Convert JSON to TOON
+echo '{"users": [{"id": 1, "name": "Alice"}]}' | cdc toon encode
+# Output:
+# users[1]{id,name}:
+# 1,Alice
+
+# Convert file
+cdc toon encode data.json -o data.toon
+
+# Convert TOON back to JSON
+cdc toon decode data.toon -o data.json
+
+# Use in workflows
+cat large_data.json | cdc toon encode | cdc ask "analyze this data"
+```
+
 ## Configuration
 
 ### Global Configuration

claude_dev_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+claude_dev_cli/__init__.py,sha256=2ulyIQ3E-s6wBTKyeXAlqHMVA73zUGdaaNUsFiJ-nqs,469
+claude_dev_cli/cli.py,sha256=vWjUgtYljbzutTcEQxWU6mITtboUWA3E17UynuHrXm0,15833
+claude_dev_cli/commands.py,sha256=RKGx2rv56PM6eErvA2uoQ20hY8babuI5jav8nCUyUOk,3964
+claude_dev_cli/config.py,sha256=YwJjVkW9S1O_iq_2O6YCjYtuFWUCmP18zA7esKDwkKU,5776
+claude_dev_cli/core.py,sha256=97rR9BuNfnhJxFrd7dTdApGyPh6MeGNArcRmaiOY69I,4443
+claude_dev_cli/templates.py,sha256=lKxH943ySfUKgyHaWa4W3LVv91SgznKgajRtSRp_4UY,2260
+claude_dev_cli/toon_utils.py,sha256=S3px2UvmNEaltmTa5K-h21n2c0CPvYjZc9mc7kHGqNQ,2828
+claude_dev_cli/usage.py,sha256=32rs0_dUn6ihha3vCfT3rwnvel_-sED7jvLpO7gu-KQ,7446
+claude_dev_cli-0.2.0.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
+claude_dev_cli-0.2.0.dist-info/METADATA,sha256=uaSOqYhfDsIt3dEAh1iBtJHS8MUM6dWTC_aBJZF8m2M,10325
+claude_dev_cli-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_dev_cli-0.2.0.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
+claude_dev_cli-0.2.0.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
+claude_dev_cli-0.2.0.dist-info/RECORD,,

claude_dev_cli-0.1.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-claude_dev_cli/__init__.py,sha256=O2wq4c3zAUKOJ6liwykkHMqEyhhasrv69ybnAmP9BNU,469
-claude_dev_cli/cli.py,sha256=s5nYAvNQDYXfNXFs9NbVRib3EasqXMZayJNekl3JRX4,11574
-claude_dev_cli/commands.py,sha256=RKGx2rv56PM6eErvA2uoQ20hY8babuI5jav8nCUyUOk,3964
-claude_dev_cli/config.py,sha256=YwJjVkW9S1O_iq_2O6YCjYtuFWUCmP18zA7esKDwkKU,5776
-claude_dev_cli/core.py,sha256=97rR9BuNfnhJxFrd7dTdApGyPh6MeGNArcRmaiOY69I,4443
-claude_dev_cli/templates.py,sha256=lKxH943ySfUKgyHaWa4W3LVv91SgznKgajRtSRp_4UY,2260
-claude_dev_cli/usage.py,sha256=32rs0_dUn6ihha3vCfT3rwnvel_-sED7jvLpO7gu-KQ,7446
-claude_dev_cli-0.1.0.dist-info/licenses/LICENSE,sha256=DGueuJwMJtMwgLO5mWlS0TaeBrFwQuNpNZ22PU9J2bw,1062
-claude_dev_cli-0.1.0.dist-info/METADATA,sha256=mdYAz3MjH7qEZ-aOBsM3Jml8NNJUQz2HJvsSQZMioMM,9313
-claude_dev_cli-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_dev_cli-0.1.0.dist-info/entry_points.txt,sha256=zymgUIIVpFTARkFmxAuW2A4BQsNITh_L0uU-XunytHg,85
-claude_dev_cli-0.1.0.dist-info/top_level.txt,sha256=m7MF6LOIuTe41IT5Fgt0lc-DK1EgM4gUU_IZwWxK0pg,15
-claude_dev_cli-0.1.0.dist-info/RECORD,,