steve-cli 0.1.0__py3-none-any.whl

steve_cli/__init__.py

@@ -0,0 +1 @@
+# Steve CLI package

steve_cli/cli.py

@@ -0,0 +1,206 @@
+#!/usr/bin/env python3
+"""
+Steve CLI - A simple tool to run jobs from jobs.yaml with proper environment setup.
+
+Usage:
+    steve <job-name>    Run a job with its environment variables
+    steve ls           List all available jobs
+    steve help         Show this help message
+"""
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+from typing import Dict, List, Any, Optional
+
+import click
+import yaml
+
+
+class JobsConfig:
+    """Handle parsing and querying of jobs.yaml configuration."""
+    
+    def __init__(self, jobs_file: Optional[Path] = None):
+        self.jobs_file = jobs_file or Path.cwd() / "jobs.yaml"
+        self.jobs: List[Dict[str, Any]] = []
+        self._load_jobs()
+    
+    def _load_jobs(self) -> None:
+        """Load and parse the jobs.yaml file."""
+        try:
+            if not self.jobs_file.exists():
+                click.echo(f"❌ Error: jobs.yaml not found at {self.jobs_file}", err=True)
+                click.echo("Make sure you're in a directory with a jobs.yaml file", err=True)
+                sys.exit(1)
+            
+            with open(self.jobs_file, 'r') as f:
+                data = yaml.safe_load(f)
+            
+            if not data or 'jobs' not in data:
+                click.echo(f"❌ Error: Invalid jobs.yaml format. Expected 'jobs' key at root", err=True)
+                sys.exit(1)
+            
+            self.jobs = data['jobs']
+            
+        except yaml.YAMLError as e:
+            click.echo(f"❌ Error parsing jobs.yaml: {e}", err=True)
+            sys.exit(1)
+        except Exception as e:
+            click.echo(f"❌ Error reading jobs.yaml: {e}", err=True)
+            sys.exit(1)
+    
+    def get_job(self, job_name: str) -> Optional[Dict[str, Any]]:
+        """Get a job by name."""
+        for job in self.jobs:
+            if job.get('name') == job_name:
+                return job
+        return None
+    
+    def list_jobs(self) -> List[str]:
+        """Get list of all job names."""
+        return [job.get('name', 'unnamed') for job in self.jobs]
+
+
+def run_job_command(job: Dict[str, Any]) -> int:
+    """Run a job's command with its environment variables."""
+    # Get command
+    command = job.get('command', [])
+    if not command:
+        click.echo(f"❌ Error: No command specified for job '{job.get('name')}'", err=True)
+        return 1
+    
+    # Prepare environment
+    env = os.environ.copy()
+    job_env = job.get('env', {})
+    
+    # Convert all env values to strings and merge
+    for key, value in job_env.items():
+        env[key] = str(value)
+    
+    # Show what we're running
+    job_name = job.get('name', 'unnamed')
+    click.echo(f"🚀 Running job: {click.style(job_name, fg='blue', bold=True)}")
+    click.echo(f"📝 Command: {click.style(' '.join(command), fg='cyan')}")
+    
+    if job_env:
+        click.echo(f"🌍 Environment variables:")
+        for key, value in job_env.items():
+            click.echo(f"   {click.style(key, fg='green')}={click.style(str(value), fg='yellow')}")
+    
+    click.echo()  # Empty line for readability
+    
+    try:
+        # Run the command
+        result = subprocess.run(
+            command,
+            env=env,
+            cwd=Path.cwd(),
+        )
+        return result.returncode
+        
+    except FileNotFoundError:
+        click.echo(f"❌ Error: Command not found: {command[0]}", err=True)
+        return 127
+    except Exception as e:
+        click.echo(f"❌ Error running command: {e}", err=True)
+        return 1
+
+
+@click.group(invoke_without_command=True)
+@click.option('--jobs-file', '-f', type=click.Path(exists=True, path_type=Path), 
+              help='Path to jobs.yaml file (default: ./jobs.yaml)')
+@click.argument('job_name', required=False)
+@click.pass_context
+def main(ctx: click.Context, jobs_file: Optional[Path], job_name: Optional[str]):
+    """Steve CLI - Run jobs from jobs.yaml with proper environment setup."""
+    
+    # Handle the case where a job name is provided directly
+    if job_name:
+        config = JobsConfig(jobs_file)
+        
+        # Special cases for built-in commands
+        if job_name in ['ls', 'list']:
+            list_jobs_command(config)
+            return
+        elif job_name in ['help', '--help', '-h']:
+            click.echo(ctx.get_help())
+            return
+        
+        # Try to run the job
+        job = config.get_job(job_name)
+        if not job:
+            available_jobs = config.list_jobs()
+            click.echo(f"❌ Error: Job '{job_name}' not found", err=True)
+            if available_jobs:
+                click.echo(f"Available jobs: {', '.join(available_jobs)}", err=True)
+            else:
+                click.echo("No jobs found in jobs.yaml", err=True)
+            sys.exit(1)
+        
+        exit_code = run_job_command(job)
+        sys.exit(exit_code)
+    
+    # If no job name provided, show help
+    click.echo(ctx.get_help())
+
+
+@main.command('ls')
+@click.option('--jobs-file', '-f', type=click.Path(exists=True, path_type=Path),
+              help='Path to jobs.yaml file (default: ./jobs.yaml)')
+def list_command(jobs_file: Optional[Path]):
+    """List all available jobs."""
+    config = JobsConfig(jobs_file)
+    list_jobs_command(config)
+
+
+def list_jobs_command(config: JobsConfig):
+    """Show list of available jobs with details."""
+    jobs = config.list_jobs()
+    
+    if not jobs:
+        click.echo("❌ No jobs found in jobs.yaml")
+        return
+    
+    click.echo(f"📋 Available jobs in {click.style(str(config.jobs_file), fg='cyan')}:")
+    click.echo()
+    
+    for job_data in config.jobs:
+        name = job_data.get('name', 'unnamed')
+        command = job_data.get('command', [])
+        cron = job_data.get('cron')
+        depends_on = job_data.get('dependsOn', [])
+        env_vars = job_data.get('env', {})
+        
+        # Job name
+        click.echo(f"  {click.style(name, fg='blue', bold=True)}")
+        
+        # Command
+        if command:
+            click.echo(f"    Command: {click.style(' '.join(command), fg='cyan')}")
+        
+        # Schedule
+        if cron:
+            click.echo(f"    Schedule: {click.style(cron, fg='yellow')}")
+        
+        # Dependencies
+        if depends_on:
+            click.echo(f"    Depends on: {click.style(', '.join(depends_on), fg='magenta')}")
+        
+        # Environment variables
+        if env_vars:
+            click.echo(f"    Environment: {click.style(f'{len(env_vars)} variables', fg='green')}")
+            for key, value in env_vars.items():
+                click.echo(f"      {key}={value}")
+        
+        click.echo()  # Empty line between jobs
+
+
+@main.command('help')
+def help_command():
+    """Show help information."""
+    click.echo(__doc__)
+
+
+if __name__ == '__main__':
+    main()

steve_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: steve-cli
+Version: 0.1.0
+Summary: A simple CLI tool to run jobs from jobs.yaml with proper environment setup
+Author: Frank
+License: MIT
+Project-URL: Homepage, https://github.com/7frank/ds-steve-cli
+Project-URL: Repository, https://github.com/7frank/ds-steve-cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+
+# Steve CLI
+
+A simple CLI tool to run jobs from `jobs.yaml` with proper environment setup. Perfect for local development and testing of automation kernel jobs.
+
+## Installation
+
+### Install from local development
+
+```bash
+cd /home/frank/Projects/7frank/tilt-ts-4/apps/example-hehnke/packages/steve-cli
+uv venv
+uv pip install -e .
+```
+
+### Install from GitHub
+
+```bash
+uv add git+https://github.com/your-org/tilt-ts-4.git#subdirectory=apps/example-hehnke/packages/steve-cli
+```
+
+## Usage
+
+### Run a job
+
+```bash
+steve extract-data
+steve transform-data  
+steve validate-data
+```
+
+This will:
+1. Look for `jobs.yaml` in the current directory
+2. Find the specified job by name
+3. Set all environment variables from the job's `env` section
+4. Execute the job's command with the proper environment
+
+### List available jobs
+
+```bash
+steve ls
+```
+
+Shows all jobs in `jobs.yaml` with their commands, schedules, dependencies, and environment variables.
+
+### Get help
+
+```bash
+steve help
+steve --help
+```
+
+### Use custom jobs file
+
+```bash
+steve -f path/to/custom.yaml extract-data
+steve ls -f path/to/custom.yaml
+```
+
+## Example
+
+Given a `jobs.yaml` file:
+
+```yaml
+jobs:
+  - name: extract-data
+    cron: "0 2 * * *"
+    command: ["uv", "run", "src/extract.py"]
+    env:
+      SOURCE_URL: "https://jsonplaceholder.typicode.com/users"
+      OUTPUT_PATH: "/data/raw/extracted_data.parquet"
+  
+  - name: transform-data
+    dependsOn: ["extract-data"]
+    command: ["uv", "run", "src/transform.py"]
+    env:
+      INPUT_PATH: "/data/raw/extracted_data.parquet"
+      OUTPUT_PATH: "/data/processed"
+```
+
+Running `steve extract-data` will:
+1. Set `SOURCE_URL=https://jsonplaceholder.typicode.com/users`
+2. Set `OUTPUT_PATH=/data/raw/extracted_data.parquet`
+3. Execute: `uv run src/extract.py`
+
+## Features
+
+- ✅ **Simple**: Just `steve <job-name>` to run any job
+- ✅ **Environment**: Automatically sets environment variables from `jobs.yaml`
+- ✅ **Discovery**: Auto-finds `jobs.yaml` in current directory
+- ✅ **Listing**: See all available jobs with `steve ls`
+- ✅ **Flexible**: Supports custom jobs file paths
+- ✅ **Colorful**: Nice colored output for better readability
+- ✅ **Error handling**: Clear error messages for missing jobs or files
+
+## Why Steve?
+
+Named after Steve Jobs - because it helps you run **jobs** locally! 😄
+
+## Requirements
+
+- Python 3.8+
+- click >= 8.0.0
+- pyyaml >= 6.0
+
+## Development
+
+```bash
+# Install in development mode
+uv pip install -e .
+
+# Run tests (when added)
+pytest
+
+# Format code
+black steve_cli/
+isort steve_cli/
+```

steve_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+steve_cli/__init__.py,sha256=9ZNbyxRn5yhpwQWw7C549nt9D-i-RkOw2dUUTRzlGlw,19
+steve_cli/cli.py,sha256=iRNHL0v_5Kz_DPMo0EwSpqdrVTMaNh-1tqyN5r0zV60,6751
+steve_cli-0.1.0.dist-info/METADATA,sha256=6IUkSx52TpV3_tJaDZS95JvL2ihaakeGSyU0lzmnoEc,3550
+steve_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+steve_cli-0.1.0.dist-info/entry_points.txt,sha256=-3uaEJ5HlIVb_tm78oQWSCp_P3O2nO5E2xkrQnJHWfE,45
+steve_cli-0.1.0.dist-info/top_level.txt,sha256=6Qvx-KOimoeaGyjF9PWMD3KNjcaR_ik5bgxlGCnrCjs,10
+steve_cli-0.1.0.dist-info/RECORD,,

steve_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

steve_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+steve = steve_cli.cli:main

steve_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+steve_cli