rhylthyme-cli-runner 0.1.0a0__tar.gz

rhylthyme_cli_runner-0.1.0a0/PKG-INFO

@@ -0,0 +1,268 @@
+Metadata-Version: 2.4
+Name: rhylthyme-cli-runner
+Version: 0.1.0a0
+Summary: CLI runner for Rhylthyme real-time program schedules
+Home-page: https://github.com/rhylthyme/rhylthyme-cli-runner
+Author: Rhylthyme Team
+Author-email: team@rhylthyme.org
+Project-URL: Bug Reports, https://github.com/rhylthyme/rhylthyme-cli-runner/issues
+Project-URL: Source, https://github.com/rhylthyme/rhylthyme-cli-runner
+Project-URL: Documentation, https://github.com/rhylthyme/rhylthyme-cli-runner#readme
+Keywords: real-time,scheduling,logistics,cli,validation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: colorama>=0.4.0
+Requires-Dist: rhylthyme-spec>=0.1.0-alpha
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.10.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=2.0.0; extra == "dev"
+Requires-Dist: black>=21.0.0; extra == "dev"
+Requires-Dist: flake8>=3.8.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=0.800; extra == "dev"
+Requires-Dist: responses>=0.12.0; extra == "dev"
+Requires-Dist: freezegun>=1.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=4.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
+Provides-Extra: build
+Requires-Dist: build>=0.7.0; extra == "build"
+Requires-Dist: twine>=3.4.0; extra == "build"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Rhylthyme CLI Runner
+
+Command-line interface for validating and running Rhylthyme real-time program schedules.
+
+## Installation
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/rhylthyme/rhylthyme-cli-runner.git
+cd rhylthyme-cli-runner
+
+# Install the package
+pip install -e .
+
+# Or install with development dependencies
+pip install -e ".[dev]"
+```
+
+### From PyPI (when published)
+
+```bash
+pip install rhylthyme-cli-runner
+```
+
+## Quick Start
+
+The Rhylthyme CLI provides commands for working with real-time program schedules defined using the Rhylthyme JSON or YAML schema.
+
+### Validate a Program
+
+Validate a program file against the schema to ensure it's properly formatted:
+
+```bash
+# Validate a JSON or YAML program file
+rhylthyme validate my_program.json
+
+# Validate with verbose output
+rhylthyme validate my_program.json --verbose
+
+# Validate with JSON output for CI/scripting
+rhylthyme validate my_program.json --json
+
+# Validate in strict mode (requires all tasks in resourceConstraints)
+rhylthyme validate my_program.json --strict
+```
+
+### Run a Program
+
+Run a program with an interactive terminal UI for monitoring and controlling execution:
+
+```bash
+# Run a program file
+rhylthyme run examples/breakfast_schedule.json
+
+# Run with automatic start (no manual trigger needed)
+rhylthyme run examples/breakfast_schedule.json --auto-start
+
+# Run with a different time scale (2x faster)
+rhylthyme run examples/breakfast_schedule.json --time-scale 2.0
+
+# Run with a specific environment
+rhylthyme run examples/breakfast_schedule.json --environment kitchen
+
+# Run without validation (if you're sure the file is valid)
+rhylthyme run examples/breakfast_schedule.json --no-validate
+```
+
+### Optimize a Program
+
+Create an optimized version of a program to reduce resource contention:
+
+```bash
+# Optimize a program and save to new file
+rhylthyme plan examples/breakfast_schedule.json optimized_breakfast.json
+
+# Optimize with verbose output
+rhylthyme plan examples/breakfast_schedule.json optimized_breakfast.json --verbose
+```
+
+### Work with Environments
+
+List and validate environment catalogs:
+
+```bash
+# List all available environments
+rhylthyme environments
+
+# List environments in JSON format
+rhylthyme environments --format json
+
+# Validate all environment files
+rhylthyme validate-environments
+
+# Show information about a specific environment type
+rhylthyme environment-info kitchen
+```
+
+## Program File Examples
+
+### Simple Breakfast Schedule
+
+```json
+{
+  "programId": "breakfast-schedule",
+  "name": "Breakfast Schedule",
+  "description": "Coordinated breakfast preparation",
+  "environmentType": "kitchen",
+  "startTrigger": {
+    "type": "manual"
+  },
+  "tracks": [
+    {
+      "trackId": "eggs",
+      "name": "Scrambled Eggs",
+      "steps": [
+        {
+          "stepId": "crack-eggs",
+          "name": "Crack and Whisk Eggs",
+          "startTrigger": {
+            "type": "programStart"
+          },
+          "duration": {
+            "type": "fixed",
+            "seconds": 60
+          }
+        }
+      ]
+    }
+  ],
+  "resourceConstraints": [
+    {
+      "task": "stove-burner",
+      "maxConcurrent": 2,
+      "description": "Maximum stove burners"
+    }
+  ],
+  "version": "1.0.0"
+}
+```
+
+## Interactive UI Controls
+
+When running a program, the interactive UI provides these controls:
+
+- **Space**: Start/stop the program
+- **Enter**: Trigger manual steps
+- **Arrow keys**: Navigate between steps
+- **q**: Quit the program
+- **r**: Refresh the display
+- **s**: Sort by different criteria
+
+## Command Reference
+
+### `rhylthyme validate`
+
+Validates program files against the schema.
+
+**Options:**
+- `--schema PATH`: Path to schema file (default: built-in schema)
+- `--verbose, -v`: Show detailed validation information
+
+### `rhylthyme run`
+
+Runs programs with interactive terminal UI.
+
+**Options:**
+- `--schema PATH`: Path to schema file (default: built-in schema)
+- `-e, --environment TEXT`: Environment ID to use
+- `--time-scale FLOAT`: Time scale factor (default: 1.0)
+- `--validate / --no-validate`: Validate before running (default: True)
+- `--auto-start`: Automatically start without manual trigger
+
+### `rhylthyme plan`
+
+Optimizes program schedules to reduce resource contention.
+
+**Options:**
+- `--verbose, -v`: Show detailed planning information
+
+### `rhylthyme environments`
+
+Lists available environment catalogs.
+
+**Options:**
+- `--format, -f`: Output format (table, json, yaml)
+
+### `rhylthyme validate-environments`
+
+Validates environment catalog files.
+
+**Options:**
+- `--environments-dir PATH`: Directory containing environment files
+- `--verbose, -v`: Show detailed validation information
+
+### `rhylthyme environment-info`
+
+Shows information about a specific environment type.
+
+## Development
+
+1. Clone the repository
+2. Install development dependencies: `pip install -e ".[dev]"`
+3. Run tests: `pytest`
+
+## License
+
+Apache License 2.0 

rhylthyme_cli_runner-0.1.0a0/README.md

@@ -0,0 +1,209 @@
+# Rhylthyme CLI Runner
+
+Command-line interface for validating and running Rhylthyme real-time program schedules.
+
+## Installation
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/rhylthyme/rhylthyme-cli-runner.git
+cd rhylthyme-cli-runner
+
+# Install the package
+pip install -e .
+
+# Or install with development dependencies
+pip install -e ".[dev]"
+```
+
+### From PyPI (when published)
+
+```bash
+pip install rhylthyme-cli-runner
+```
+
+## Quick Start
+
+The Rhylthyme CLI provides commands for working with real-time program schedules defined using the Rhylthyme JSON or YAML schema.
+
+### Validate a Program
+
+Validate a program file against the schema to ensure it's properly formatted:
+
+```bash
+# Validate a JSON or YAML program file
+rhylthyme validate my_program.json
+
+# Validate with verbose output
+rhylthyme validate my_program.json --verbose
+
+# Validate with JSON output for CI/scripting
+rhylthyme validate my_program.json --json
+
+# Validate in strict mode (requires all tasks in resourceConstraints)
+rhylthyme validate my_program.json --strict
+```
+
+### Run a Program
+
+Run a program with an interactive terminal UI for monitoring and controlling execution:
+
+```bash
+# Run a program file
+rhylthyme run examples/breakfast_schedule.json
+
+# Run with automatic start (no manual trigger needed)
+rhylthyme run examples/breakfast_schedule.json --auto-start
+
+# Run with a different time scale (2x faster)
+rhylthyme run examples/breakfast_schedule.json --time-scale 2.0
+
+# Run with a specific environment
+rhylthyme run examples/breakfast_schedule.json --environment kitchen
+
+# Run without validation (if you're sure the file is valid)
+rhylthyme run examples/breakfast_schedule.json --no-validate
+```
+
+### Optimize a Program
+
+Create an optimized version of a program to reduce resource contention:
+
+```bash
+# Optimize a program and save to new file
+rhylthyme plan examples/breakfast_schedule.json optimized_breakfast.json
+
+# Optimize with verbose output
+rhylthyme plan examples/breakfast_schedule.json optimized_breakfast.json --verbose
+```
+
+### Work with Environments
+
+List and validate environment catalogs:
+
+```bash
+# List all available environments
+rhylthyme environments
+
+# List environments in JSON format
+rhylthyme environments --format json
+
+# Validate all environment files
+rhylthyme validate-environments
+
+# Show information about a specific environment type
+rhylthyme environment-info kitchen
+```
+
+## Program File Examples
+
+### Simple Breakfast Schedule
+
+```json
+{
+  "programId": "breakfast-schedule",
+  "name": "Breakfast Schedule",
+  "description": "Coordinated breakfast preparation",
+  "environmentType": "kitchen",
+  "startTrigger": {
+    "type": "manual"
+  },
+  "tracks": [
+    {
+      "trackId": "eggs",
+      "name": "Scrambled Eggs",
+      "steps": [
+        {
+          "stepId": "crack-eggs",
+          "name": "Crack and Whisk Eggs",
+          "startTrigger": {
+            "type": "programStart"
+          },
+          "duration": {
+            "type": "fixed",
+            "seconds": 60
+          }
+        }
+      ]
+    }
+  ],
+  "resourceConstraints": [
+    {
+      "task": "stove-burner",
+      "maxConcurrent": 2,
+      "description": "Maximum stove burners"
+    }
+  ],
+  "version": "1.0.0"
+}
+```
+
+## Interactive UI Controls
+
+When running a program, the interactive UI provides these controls:
+
+- **Space**: Start/stop the program
+- **Enter**: Trigger manual steps
+- **Arrow keys**: Navigate between steps
+- **q**: Quit the program
+- **r**: Refresh the display
+- **s**: Sort by different criteria
+
+## Command Reference
+
+### `rhylthyme validate`
+
+Validates program files against the schema.
+
+**Options:**
+- `--schema PATH`: Path to schema file (default: built-in schema)
+- `--verbose, -v`: Show detailed validation information
+
+### `rhylthyme run`
+
+Runs programs with interactive terminal UI.
+
+**Options:**
+- `--schema PATH`: Path to schema file (default: built-in schema)
+- `-e, --environment TEXT`: Environment ID to use
+- `--time-scale FLOAT`: Time scale factor (default: 1.0)
+- `--validate / --no-validate`: Validate before running (default: True)
+- `--auto-start`: Automatically start without manual trigger
+
+### `rhylthyme plan`
+
+Optimizes program schedules to reduce resource contention.
+
+**Options:**
+- `--verbose, -v`: Show detailed planning information
+
+### `rhylthyme environments`
+
+Lists available environment catalogs.
+
+**Options:**
+- `--format, -f`: Output format (table, json, yaml)
+
+### `rhylthyme validate-environments`
+
+Validates environment catalog files.
+
+**Options:**
+- `--environments-dir PATH`: Directory containing environment files
+- `--verbose, -v`: Show detailed validation information
+
+### `rhylthyme environment-info`
+
+Shows information about a specific environment type.
+
+## Development
+
+1. Clone the repository
+2. Install development dependencies: `pip install -e ".[dev]"`
+3. Run tests: `pytest`
+
+## License
+
+Apache License 2.0 

rhylthyme_cli_runner-0.1.0a0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rhylthyme_cli_runner-0.1.0a0/setup.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+"""
+Setup script for Rhylthyme CLI Runner
+"""
+
+from setuptools import setup, find_packages
+import os
+
+# Read the README file
+def read_readme():
+    readme_path = os.path.join(os.path.dirname(__file__), 'README.md')
+    if os.path.exists(readme_path):
+        with open(readme_path, 'r', encoding='utf-8') as f:
+            return f.read()
+    return "Rhylthyme CLI Runner - Command-line interface for running and validating Rhylthyme programs"
+
+setup(
+    name="rhylthyme-cli-runner",
+    version="0.1.0-alpha",
+    description="CLI runner for Rhylthyme real-time program schedules",
+    long_description=read_readme(),
+    long_description_content_type="text/markdown",
+    author="Rhylthyme Team",
+    author_email="team@rhylthyme.org",
+    url="https://github.com/rhylthyme/rhylthyme-cli-runner",
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    install_requires=[
+        "click>=8.0.0",
+        "jsonschema>=4.0.0",
+        "pyyaml>=6.0",
+        "colorama>=0.4.0",
+        "rhylthyme-spec>=0.1.0-alpha",
+    ],
+    extras_require={
+        "dev": [
+            # Testing framework
+            "pytest>=6.0.0",
+            "pytest-cov>=2.10.0",
+            "pytest-mock>=3.0.0",
+            "pytest-xdist>=2.0.0",  # Parallel test execution
+            
+            # Code quality
+            "black>=21.0.0",
+            "flake8>=3.8.0",
+            "isort>=5.0.0",
+            
+            # Type checking
+            "mypy>=0.800",
+            
+            # Testing utilities
+            "responses>=0.12.0",  # Mock HTTP responses
+            "freezegun>=1.0.0",   # Mock datetime
+        ],
+        "docs": [
+            "sphinx>=4.0.0",
+            "sphinx-rtd-theme>=1.0.0",
+        ],
+        "build": [
+            "build>=0.7.0",
+            "twine>=3.4.0",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "rhylthyme=rhylthyme_cli_runner.cli:main",
+        ],
+    },
+    python_requires=">=3.8",
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: System :: Distributed Computing",
+    ],
+    keywords="real-time, scheduling, logistics, cli, validation",
+    project_urls={
+        "Bug Reports": "https://github.com/rhylthyme/rhylthyme-cli-runner/issues",
+        "Source": "https://github.com/rhylthyme/rhylthyme-cli-runner",
+        "Documentation": "https://github.com/rhylthyme/rhylthyme-cli-runner#readme",
+    },
+) 

rhylthyme_cli_runner-0.1.0a0/src/rhylthyme_cli_runner/__init__.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+"""
+Rhylthyme CLI Runner Package
+
+This package provides the command-line interface for running and validating
+Rhylthyme real-time program schedules.
+"""
+
+__version__ = "0.1.0-alpha"
+__author__ = "Rhylthyme Team"
+__description__ = "CLI runner for Rhylthyme real-time program schedules"
+
+from .cli import cli, main
+
+__all__ = ['cli', 'main']