ry-tool 1.0.1__tar.gz

ry_tool-1.0.1/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.3
+Name: ry-tool
+Version: 1.0.1
+Summary: Pure YAML command orchestrator - CI/CD for humans
+Author: Fredrik Angelsen
+Author-email: Fredrik Angelsen <fredrikangelsen@gmail.com>
+Requires-Dist: pyyaml>=6.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# ry-next
+
+A clean, modular command augmentation framework that enhances existing CLI tools without breaking their native behavior.
+
+## Features
+
+- **Command Augmentation**: Wrap and enhance existing CLI tools
+- **Clean Architecture**: Modular design with single-responsibility components  
+- **Type-Safe Processing**: Recursive template processing with type dispatch
+- **Token-Based Safety**: Time-limited tokens for dangerous operations
+- **Library System**: Reusable command definitions with metadata
+- **No Shell Escaping**: Direct subprocess execution for safety
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+This installs the `ry-next` command globally.
+
+## Quick Start
+
+```bash
+# List available libraries
+ry-next --list
+
+# Get help for a library
+ry-next git --ry-help
+
+# Execute augmented command
+ry-next git commit -m "feat: new feature"
+
+# Show execution plan (dry run)
+ry-next --ry-run git commit -m "test"
+```
+
+## Production Libraries
+
+- **git** - Enhanced git workflow with review tokens and commit validation
+- **uv** - Python package management with automated version workflows
+- **changelog** - Simple changelog management following Keep a Changelog
+- **ry-lib** - Library development and management tools
+
+## Documentation
+
+- [Full Documentation](docs/README_RYNEXT.md)
+- [Library Development](docs/libraries/ry-lib/README.md)
+- [Examples](examples/README.md)
+
+## Project Structure
+
+```
+ry-next/
+├── src/ry_next/         # Core implementation
+├── docs/
+│   ├── libraries/       # Production libraries
+│   └── README_RYNEXT.md # Full documentation
+├── examples/            # Example libraries
+└── _archive/            # Old ry-tool code (deprecated)
+```
+
+## Key Concepts
+
+### Library Format (v2.0)
+
+```yaml
+version: "2.0"
+name: git
+type: augmentation
+target: /usr/bin/git
+
+commands:
+  commit:
+    flags:
+      m/message: string
+    augment:
+      before:
+        - python: |
+            # Validation logic
+      relay: native
+```
+
+### Token-Based Safety
+
+Critical operations require preview and token verification:
+
+```bash
+# Preview changes
+git diff --staged  # → Generates REVIEW_TOKEN
+
+# Execute with token
+REVIEW_TOKEN=xxx git commit -m "message"
+```
+
+## Development
+
+See [docs/README_RYNEXT.md](docs/README_RYNEXT.md) for complete documentation.
+
+## License
+
+MIT

ry_tool-1.0.1/README.md

@@ -0,0 +1,102 @@
+# ry-next
+
+A clean, modular command augmentation framework that enhances existing CLI tools without breaking their native behavior.
+
+## Features
+
+- **Command Augmentation**: Wrap and enhance existing CLI tools
+- **Clean Architecture**: Modular design with single-responsibility components  
+- **Type-Safe Processing**: Recursive template processing with type dispatch
+- **Token-Based Safety**: Time-limited tokens for dangerous operations
+- **Library System**: Reusable command definitions with metadata
+- **No Shell Escaping**: Direct subprocess execution for safety
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+This installs the `ry-next` command globally.
+
+## Quick Start
+
+```bash
+# List available libraries
+ry-next --list
+
+# Get help for a library
+ry-next git --ry-help
+
+# Execute augmented command
+ry-next git commit -m "feat: new feature"
+
+# Show execution plan (dry run)
+ry-next --ry-run git commit -m "test"
+```
+
+## Production Libraries
+
+- **git** - Enhanced git workflow with review tokens and commit validation
+- **uv** - Python package management with automated version workflows
+- **changelog** - Simple changelog management following Keep a Changelog
+- **ry-lib** - Library development and management tools
+
+## Documentation
+
+- [Full Documentation](docs/README_RYNEXT.md)
+- [Library Development](docs/libraries/ry-lib/README.md)
+- [Examples](examples/README.md)
+
+## Project Structure
+
+```
+ry-next/
+├── src/ry_next/         # Core implementation
+├── docs/
+│   ├── libraries/       # Production libraries
+│   └── README_RYNEXT.md # Full documentation
+├── examples/            # Example libraries
+└── _archive/            # Old ry-tool code (deprecated)
+```
+
+## Key Concepts
+
+### Library Format (v2.0)
+
+```yaml
+version: "2.0"
+name: git
+type: augmentation
+target: /usr/bin/git
+
+commands:
+  commit:
+    flags:
+      m/message: string
+    augment:
+      before:
+        - python: |
+            # Validation logic
+      relay: native
+```
+
+### Token-Based Safety
+
+Critical operations require preview and token verification:
+
+```bash
+# Preview changes
+git diff --staged  # → Generates REVIEW_TOKEN
+
+# Execute with token
+REVIEW_TOKEN=xxx git commit -m "message"
+```
+
+## Development
+
+See [docs/README_RYNEXT.md](docs/README_RYNEXT.md) for complete documentation.
+
+## License
+
+MIT

ry_tool-1.0.1/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "ry-tool"
+version = "1.0.1"
+description = "Pure YAML command orchestrator - CI/CD for humans"
+readme = "README.md"
+authors = [
+    { name = "Fredrik Angelsen", email = "fredrikangelsen@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+ry-next = "ry_tool.app:run"
+
+[build-system]
+requires = ["uv_build>=0.8.13,<0.9.0"]
+build-backend = "uv_build"

ry_tool-1.0.1/src/ry_tool/__init__.py

@@ -0,0 +1,27 @@
+"""
+ry-next: Next generation command augmentation framework.
+
+Clean architecture with semantic command understanding.
+"""
+
+__version__ = "2.0.0-alpha"
+
+from .parser import CommandParser, ParsedCommand
+from .executor import Executor, ExecutionResult
+from .context import ExecutionContext
+from .template import TemplateProcessor
+from .loader import LibraryLoader, LibraryConfig
+from .matcher import CommandMatcher, MatchResult
+
+__all__ = [
+    'CommandParser',
+    'ParsedCommand',
+    'Executor',
+    'ExecutionResult',
+    'ExecutionContext',
+    'TemplateProcessor',
+    'LibraryLoader',
+    'LibraryConfig',
+    'CommandMatcher',
+    'MatchResult',
+]

ry_tool-1.0.1/src/ry_tool/__main__.py

@@ -0,0 +1,9 @@
+"""
+Entry point for ry-next when run as a module.
+
+Usage: python -m ry_next
+"""
+from .app import run
+
+if __name__ == "__main__":
+    run()

ry_tool-1.0.1/src/ry_tool/_cli.py

@@ -0,0 +1,244 @@
+"""
+Lightweight CLI framework for ry.
+A mini framework tailored for ry's command parsing needs.
+"""
+
+import sys
+from typing import Dict, List, Callable, Optional
+from dataclasses import dataclass
+
+
+@dataclass
+class Command:
+    """Represents a CLI command."""
+
+    name: str
+    handler: Callable
+    help: str
+    requires_arg: bool = False
+    arg_name: str = "arg"
+    arg_help: str = ""
+
+
+class CLI:
+    """Lightweight CLI framework for ry."""
+
+    def __init__(self, name: str = "ry", description: str = ""):
+        self.name = name
+        self.description = description
+        self.commands: Dict[str, Command] = {}
+        self.default_handler: Optional[Callable] = None
+        self.global_flags: Dict[str, bool] = {}  # Track global flags
+
+    def command(
+        self,
+        name: str,
+        help: str = "",
+        requires_arg: bool = False,
+        arg_name: str = "arg",
+        arg_help: str = "",
+    ):
+        """Decorator to register a command."""
+
+        def decorator(func: Callable):
+            self.commands[name] = Command(
+                name=name,
+                handler=func,
+                help=help,
+                requires_arg=requires_arg,
+                arg_name=arg_name,
+                arg_help=arg_help,
+            )
+            return func
+
+        return decorator
+
+    def default(self, func: Callable):
+        """Decorator to register the default handler for non-command arguments."""
+        self.default_handler = func
+        return func
+
+    def run(self, argv: Optional[List[str]] = None):
+        """Parse arguments and run the appropriate command."""
+        if argv is None:
+            argv = sys.argv
+
+        # No arguments - show help
+        if len(argv) < 2:
+            self.show_help()
+            sys.exit(0)
+
+        # Parse global flags first
+        self.global_flags = {}
+        filtered_argv = [argv[0]]
+        
+        for arg in argv[1:]:
+            if arg == '--ry-run':
+                self.global_flags['ry_run'] = True
+            else:
+                filtered_argv.append(arg)
+        
+        # If only global flags were provided, show help
+        if len(filtered_argv) < 2:
+            self.show_help()
+            sys.exit(0)
+        
+        first_arg = filtered_argv[1]
+        remaining_args = filtered_argv[2:] if len(filtered_argv) > 2 else []
+
+        # Check for help
+        if first_arg in ["-h", "--help"]:
+            self.show_help()
+            sys.exit(0)
+
+        # Check if it's a registered command
+        if first_arg in self.commands:
+            cmd = self.commands[first_arg]
+
+            # Check if command requires an argument
+            if cmd.requires_arg and not remaining_args:
+                print(f"Error: {first_arg} requires an argument", file=sys.stderr)
+                print(
+                    f"Usage: {self.name} {first_arg} <{cmd.arg_name}>", file=sys.stderr
+                )
+                sys.exit(1)
+
+            # Call the handler
+            try:
+                if cmd.requires_arg:
+                    result = cmd.handler(remaining_args[0], *remaining_args[1:])
+                else:
+                    result = cmd.handler(*remaining_args)
+
+                # Handle result
+                if isinstance(result, bool):
+                    sys.exit(0 if result else 1)
+                elif isinstance(result, int):
+                    sys.exit(result)
+                else:
+                    sys.exit(0)
+            except KeyboardInterrupt:
+                sys.exit(130)
+            except Exception as e:
+                print(f"Error: {e}", file=sys.stderr)
+                sys.exit(1)
+
+        # Not a command - try default handler
+        elif self.default_handler:
+            try:
+                result = self.default_handler(first_arg, *remaining_args)
+                if isinstance(result, bool):
+                    sys.exit(0 if result else 1)
+                elif isinstance(result, int):
+                    sys.exit(result)
+                else:
+                    sys.exit(0)
+            except KeyboardInterrupt:
+                sys.exit(130)
+            except Exception as e:
+                print(f"Error: {e}", file=sys.stderr)
+                sys.exit(1)
+
+        else:
+            print(f"Unknown command: {first_arg}", file=sys.stderr)
+            print(f"Try: {self.name} --help", file=sys.stderr)
+            sys.exit(1)
+
+    def show_help(self):
+        """Display auto-generated help message."""
+        lines = []
+
+        # Header
+        lines.append(f"{self.name} - {self.description}")
+        lines.append("")
+
+        # Usage
+        lines.append("Usage:")
+        if self.default_handler:
+            lines.append(
+                f"  {self.name} <library> [args...]          Execute library command"
+            )
+            lines.append(
+                f"  {self.name} <file.yaml> [args...]        Execute from YAML file"
+            )
+            lines.append(
+                f"  {self.name} --ry-run <library> [args...] Show execution plan"
+            )
+            lines.append("")
+
+        # Group commands by type
+        user_commands = {}
+        dev_commands = {}
+
+        for name, cmd in sorted(self.commands.items()):
+            if name.startswith("--dev-"):
+                dev_commands[name] = cmd
+            else:
+                user_commands[name] = cmd
+
+        # User commands
+        if user_commands:
+            lines.append("Package Management:")
+            for name, cmd in user_commands.items():
+                # Format command line
+                if cmd.requires_arg:
+                    usage = f"{self.name} {name} <{cmd.arg_name}>"
+                else:
+                    usage = f"{self.name} {name}"
+                # Align help text
+                lines.append(f"  {usage:<40} {cmd.help}")
+            lines.append("")
+
+        # Developer commands
+        if dev_commands:
+            lines.append("Developer Commands:")
+            for name, cmd in dev_commands.items():
+                if cmd.requires_arg:
+                    usage = f"{self.name} {name} <{cmd.arg_name}>"
+                else:
+                    usage = f"{self.name} {name}"
+                lines.append(f"  {usage:<40} {cmd.help}")
+            lines.append("")
+
+        # Examples
+        lines.append("Examples:")
+        lines.append(f"  {self.name} hello.yaml world --name Alice")
+        lines.append(f"  {self.name} git commit -m 'feat: add feature'")
+        lines.append(f"  {self.name} --ry-run deploy.yaml production")
+        lines.append(f"  {self.name} --list")
+
+        print("\n".join(lines))
+
+
+# Utility decorators for common CLI patterns
+def requires_git_repo(func):
+    """Decorator to ensure command runs in a git repository."""
+    from functools import wraps
+    
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        import subprocess
+        try:
+            subprocess.run(['git', 'rev-parse', '--git-dir'], 
+                         capture_output=True, check=True)
+            return func(*args, **kwargs)
+        except subprocess.CalledProcessError:
+            print("Error: Not in a git repository", file=sys.stderr)
+            return 1
+    return wrapper
+
+
+def requires_file(file_path: str):
+    """Decorator to ensure required file exists."""
+    def decorator(func):
+        from functools import wraps
+        
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            from pathlib import Path
+            if not Path(file_path).exists():
+                print(f"Error: Required file not found: {file_path}", file=sys.stderr)
+                return 1
+            return func(*args, **kwargs)
+        return wrapper
+    return decorator