ralph-code 0.5.0__tar.gz

ralph_code-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ralph Coding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ralph_code-0.5.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include ralph/schemas *.json

ralph_code-0.5.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: ralph-code
+Version: 0.5.0
+Summary: Automated task implementation with Claude Code and Codex
+Author: Ralph Coding
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/ralph-code
+Project-URL: Repository, https://github.com/yourusername/ralph-code
+Project-URL: Issues, https://github.com/yourusername/ralph-code/issues
+Keywords: claude,codex,ai,automation,coding,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: click
+Requires-Dist: jsonschema
+Requires-Dist: platformdirs
+Requires-Dist: questionary
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: types-pygments; extra == "dev"
+Requires-Dist: types-jsonschema; extra == "dev"
+Dynamic: license-file
+Dynamic: requires-python
+
+# ralph-code
+
+Automated task implementation with Claude Code and Codex for "Ralph Coding". What is [Ralph Coding](https://ghuntley.com/ralph/)? It's a method of coding where context rot is avoided by controlling the retention of information. This method involves re-invoking claude or codex for each task, and passing information about the requirements, acceptance testing, and any progress that's made (or roadblocks/challenges faced) through files, rather than retaining all prompts + thinking + response tokens. It tends to result in more requests, some duplicated token work, but fairly consistent performance, and best of all it can largely be done unattended. Recommend Claude Max account or codex equivalent, but be aware that GPT-5 - GPT5.2's slow reasoning and response makes this ponderous, it's fine overnight.
+
+Because LLMs are carrying out the work, we can specify a job of "Find all the python files in the project that directly or indirectly access sqlalchemy objects, and upgrade the code to work with sqlalchemy 2.* This will result in probably a single-task project, but that one task might add 50 other tasks (on per file) to the backlog, which are then processed sequentially."
+
+## Installation
+
+```bash
+pipx install ralph-code
+```
+
+Or with pip:
+
+```bash
+pip install ralph-code
+```
+
+## Usage
+
+```bash
+ralph [OPTIONS] [DIRECTORY]
+```
+
+### Options
+
+- `--debug`: Enable debug logging, logs are saved into the .ralph subdirectory of the project
+- `DIRECTORY`: Target project directory (defaults to current directory)
+
+## Usage
+
+First create a task, give a short name for the task (used for the branch commits will be added to), and then give a description. 
+Then you run the ralph-coder, it will produce a .md file of the specifications, which will be broken into small tasks put into a tasks.json file. Each task will be worked on independently. 
+
+## Requirements
+
+- Python 3.10+
+- Claude Code or Codex CLI installed and configured
+
+## License
+
+MIT

ralph_code-0.5.0/README.md

@@ -0,0 +1,42 @@
+# ralph-code
+
+Automated task implementation with Claude Code and Codex for "Ralph Coding". What is [Ralph Coding](https://ghuntley.com/ralph/)? It's a method of coding where context rot is avoided by controlling the retention of information. This method involves re-invoking claude or codex for each task, and passing information about the requirements, acceptance testing, and any progress that's made (or roadblocks/challenges faced) through files, rather than retaining all prompts + thinking + response tokens. It tends to result in more requests, some duplicated token work, but fairly consistent performance, and best of all it can largely be done unattended. Recommend Claude Max account or codex equivalent, but be aware that GPT-5 - GPT5.2's slow reasoning and response makes this ponderous, it's fine overnight.
+
+Because LLMs are carrying out the work, we can specify a job of "Find all the python files in the project that directly or indirectly access sqlalchemy objects, and upgrade the code to work with sqlalchemy 2.* This will result in probably a single-task project, but that one task might add 50 other tasks (on per file) to the backlog, which are then processed sequentially."
+
+## Installation
+
+```bash
+pipx install ralph-code
+```
+
+Or with pip:
+
+```bash
+pip install ralph-code
+```
+
+## Usage
+
+```bash
+ralph [OPTIONS] [DIRECTORY]
+```
+
+### Options
+
+- `--debug`: Enable debug logging, logs are saved into the .ralph subdirectory of the project
+- `DIRECTORY`: Target project directory (defaults to current directory)
+
+## Usage
+
+First create a task, give a short name for the task (used for the branch commits will be added to), and then give a description. 
+Then you run the ralph-coder, it will produce a .md file of the specifications, which will be broken into small tasks put into a tasks.json file. Each task will be worked on independently. 
+
+## Requirements
+
+- Python 3.10+
+- Claude Code or Codex CLI installed and configured
+
+## License
+
+MIT

ralph_code-0.5.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ralph-code"
+version = "0.5.0"
+description = "Automated task implementation with Claude Code and Codex"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Ralph Coding"}
+]
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Build Tools",
+]
+keywords = ["claude", "codex", "ai", "automation", "coding", "cli"]
+dependencies = [
+    "rich",
+    "click",
+    "jsonschema",
+    "platformdirs",
+    "questionary",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "mypy",
+    "types-pygments",
+    "types-jsonschema",
+]
+
+[project.scripts]
+ralph = "ralph.__main__:cli"
+
+[project.urls]
+Homepage = "https://github.com/yourusername/ralph-code"
+Repository = "https://github.com/yourusername/ralph-code"
+Issues = "https://github.com/yourusername/ralph-code/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["ralph*"]
+
+[tool.setuptools.package-data]
+ralph = ["schemas/*.json"]
+
+[tool.mypy]
+strict = true
+python_version = "3.12"

ralph_code-0.5.0/ralph/__init__.py

@@ -0,0 +1,20 @@
+"""ralph-code: Automated task implementation with Claude Code and Codex."""
+
+__version__ = "0.1.0"
+__author__ = "Ralph Coding"
+
+from .app import RalphApp, main
+from .config import Config, get_config
+from .tasks import Task, TaskManager
+from .workflow import WorkflowEngine, WorkflowState
+
+__all__ = [
+    "RalphApp",
+    "main",
+    "Config",
+    "get_config",
+    "Task",
+    "TaskManager",
+    "WorkflowEngine",
+    "WorkflowState",
+]

ralph_code-0.5.0/ralph/__main__.py

@@ -0,0 +1,34 @@
+"""Entry point for `python -m ralph`."""
+
+import sys
+from pathlib import Path
+
+import click
+
+from .app import main
+
+
+@click.command()
+@click.option(
+    "--debug",
+    is_flag=True,
+    help="Enable verbose logging of all Claude interactions to .ralph/logs/",
+)
+@click.argument(
+    "directory",
+    required=False,
+    type=click.Path(exists=True, file_okay=False, dir_okay=True, path_type=Path),
+)
+def cli(debug: bool, directory: Path | None) -> None:
+    """
+    Ralph Coding - Automated task implementation with Claude Code.
+
+    DIRECTORY is the optional target project directory.
+    Defaults to the current working directory.
+    """
+    project_dir = directory or Path.cwd()
+    main(project_dir=project_dir, debug=debug)
+
+
+if __name__ == "__main__":
+    cli()