jaymd96-pants-clawthor 0.1.0__py3-none-any.whl

jaymd96_pants_clawthor-0.1.0.dist-info/METADATA

@@ -0,0 +1,293 @@
+Metadata-Version: 2.4
+Name: jaymd96-pants-clawthor
+Version: 0.1.0
+Summary: Pants plugin for compiling Clawthor Claude Code plugins
+Project-URL: Homepage, https://github.com/anthropics/clawthor
+Project-URL: Documentation, https://github.com/anthropics/clawthor/tree/main/pants-plugin
+Project-URL: Repository, https://github.com/anthropics/clawthor.git
+Project-URL: Issues, https://github.com/anthropics/clawthor/issues
+Author-email: jaymd96 <jay@anthropic.com>
+License: MIT
+License-File: LICENSE
+Keywords: claude,clawthor,dsl,pants,plugin
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Plugins
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Requires-Dist: pants>=2.18.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: flake8>=6.0; extra == 'dev'
+Requires-Dist: isort>=5.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Pants Clawthor Plugin
+
+A Pants build backend plugin that integrates Clawthor DSL compilation into your Pants build system.
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install jaymd96-pants-clawthor
+```
+
+## Configuration
+
+Add to your `pants.toml`:
+
+```toml
+[python]
+plugins = [
+    "jaymd96-pants-clawthor==0.1.0",
+]
+```
+
+## Requirements
+
+- **Pants** >= 2.18.0
+- **clawthor gem** >= 0.3.0 (install with `gem install clawthor`)
+- **Python** >= 3.9
+- **Ruby** >= 3.0.0 (for clawthor gem)
+
+Ensure `clawthor` executable is in your PATH:
+
+```bash
+gem install clawthor
+which clawthor  # Verify it's available
+```
+
+## Usage
+
+### Define a Plugin Target
+
+Create a BUILD file in your plugin directory:
+
+```python
+claude_plugin(
+    name="my_plugin",
+    definition="definition.rb",
+    output_dir="output",
+    marketplace=False,
+)
+```
+
+### Options
+
+- **definition** (required): Path to the Clawthor definition file (e.g., `definition.rb`)
+- **output_dir** (optional): Output directory for generated plugin files (default: `output`)
+- **marketplace** (optional): Generate marketplace layout instead of plugin layout (`true` or `false`, default: `false`)
+
+### Build the Plugin
+
+```bash
+pants build //my_plugins:my_plugin
+```
+
+The generated plugin files will be in the output directory specified.
+
+### Marketplace Mode
+
+To generate in marketplace layout:
+
+```python
+claude_plugin(
+    name="my_plugin",
+    definition="definition.rb",
+    output_dir="output-marketplace",
+    marketplace=True,
+)
+```
+
+## Example
+
+```
+my_project/
+├── BUILD
+├── definition.rb
+└── modules/
+    ├── planning.rb
+    └── quality.rb
+```
+
+**BUILD**:
+```python
+claude_plugin(
+    name="dev_tools",
+    definition="definition.rb",
+    output_dir="plugin",
+    marketplace=False,
+)
+```
+
+**definition.rb**:
+```ruby
+workspace :dev_tools do
+  version "1.0.0"
+  author "My Team"
+end
+
+require_module "./modules/planning.rb"
+require_module "./modules/quality.rb"
+
+use :planning
+use :quality
+```
+
+**Build**:
+```bash
+pants build //my_project:dev_tools
+```
+
+## Integration with Architect
+
+Use the Architect reference plugin as a base:
+
+```python
+# Copy from baseline/definition.rb
+claude_plugin(
+    name="architect",
+    definition="architect/definition.rb",
+    output_dir="plugins/architect",
+    marketplace=False,
+)
+```
+
+Then import modules:
+
+```ruby
+require_module "../architect/modules/planning.rb"
+require_module "../architect/modules/quality.rb"
+
+use :planning
+use :quality
+```
+
+## How It Works
+
+The plugin:
+1. Accepts a Clawthor definition file path
+2. Invokes `clawthor compile` with appropriate arguments
+3. Generates plugin files in the specified output directory
+4. Returns the compilation result
+
+No magic—just a clean bridge between Pants and Clawthor.
+
+## Troubleshooting
+
+### "clawthor command not found"
+Install the clawthor gem:
+```bash
+gem install clawthor
+```
+
+Verify it's in PATH:
+```bash
+which clawthor
+```
+
+If using a Ruby version manager (rvm, rbenv, etc.), ensure it's configured:
+```bash
+which ruby  # Should show your Ruby version manager's path
+```
+
+### Compilation fails with "Definition file not found"
+Ensure the definition file path is relative to the BUILD file:
+
+```python
+claude_plugin(
+    name="my_plugin",
+    definition="definition.rb",  # Same directory as BUILD file
+)
+```
+
+### Output directory is empty
+Check that the definition file has valid declarations. Run manually to debug:
+
+```bash
+cd my_project
+clawthor compile definition.rb output
+```
+
+## Development
+
+### Setup
+
+```bash
+hatch env create
+```
+
+This creates a virtual environment configured via Hatch.
+
+### Run Tests
+
+```bash
+hatch run test
+```
+
+### Formatting and Linting
+
+```bash
+hatch run format
+hatch run lint
+```
+
+Or run individually:
+
+```bash
+hatch run black src/
+hatch run isort src/
+hatch run flake8 src/
+```
+
+## Publishing
+
+To publish a new version to PyPI:
+
+```bash
+hatch build
+hatch publish
+```
+
+Hatch will use your PyPI credentials from `~/.pypirc` or environment variables:
+- `HATCH_INDEX_USER` — PyPI username
+- `HATCH_INDEX_AUTH` — PyPI API token
+
+## Architecture
+
+```
+Pants Build System
+    ↓
+pants-clawthor Plugin (jaymd96-pants-clawthor)
+    ↓ invokes
+Clawthor DSL Compiler (clawthor gem)
+    ↓ generates
+Claude Code Plugin Files
+    ↓ can be tested with
+claude --plugin-dir ./output
+```
+
+## License
+
+MIT — See [../clawthor/LICENSE](../clawthor/LICENSE)
+
+## Related
+
+- [Clawthor gem](../clawthor/) — The DSL compiler
+- [Architect plugin](../baseline/) — Reference implementation
+- [Pants](https://www.pantsbuild.org/) — Build system
+
+---
+
+**Questions?** Open an issue on [GitHub](https://github.com/anthropics/clawthor/issues)

jaymd96_pants_clawthor-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pants_clawthor/__init__.py,sha256=dK1Vo_AAC_Y-Ga9xq2EtBsy8XolwPrX4ZCM_Vb_zEF4,96
+pants_clawthor/register.py,sha256=quSgKINdumPxMpyNGpgcFu_xeX06Z_UivIjhaoD9MGo,486
+pants_clawthor/rules.py,sha256=LOvRBq4nqiNAcD2T0zoIqVKmD9SCqgdJwH8hjbZO97M,1667
+pants_clawthor/targets.py,sha256=pvApklAA94qNlkLlX5yRzkkdqBsJiKqor51y4UDeqgQ,1288
+jaymd96_pants_clawthor-0.1.0.dist-info/METADATA,sha256=ADy5lwWGM-E9ih4QnykSD8JTD2hfZqoIjlxHI4U2n4E,6056
+jaymd96_pants_clawthor-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+jaymd96_pants_clawthor-0.1.0.dist-info/licenses/LICENSE,sha256=y8CeiP6Qd9jxidfFjPkyZhsRjs9XarMIMVDP91lZsJE,1066
+jaymd96_pants_clawthor-0.1.0.dist-info/RECORD,,

jaymd96_pants_clawthor-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

jaymd96_pants_clawthor-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anthropic
+
+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.

pants_clawthor/__init__.py

@@ -0,0 +1,5 @@
+"""Pants plugin for Clawthor DSL compilation."""
+
+__version__ = "0.1.0"
+__author__ = "jaymd96"
+

pants_clawthor/register.py

@@ -0,0 +1,19 @@
+"""Register clawthor plugin with Pants."""
+
+from pants.engine.rules import collect_rules
+from pants.engine.target import TargetRuleset
+
+from pants_clawthor.rules import rules as clawthor_rules
+from pants_clawthor.targets import ClaudoPluginTarget
+
+
+def rules():
+    """Register all rules for the clawthor plugin."""
+    return [
+        *collect_rules(clawthor_rules),
+    ]
+
+
+def target_types():
+    """Register target types for the clawthor plugin."""
+    return [ClaudoPluginTarget]

pants_clawthor/rules.py

@@ -0,0 +1,57 @@
+"""Build rules for Clawthor plugin compilation."""
+
+import os
+import shutil
+import subprocess
+from pathlib import Path
+
+from pants.engine.engine_types import ProcessResult
+from pants.engine.fs import Digest, MergedDigest
+from pants.engine.process import Process, ProcessResult
+from pants.engine.rules import rule
+from pants.engine.target import Target
+from pants.util.dirutil import safe_mkdir
+
+from pants_clawthor.targets import ClaudoPluginTarget
+
+
+@rule
+async def compile_claude_plugin(target: ClaudoPluginTarget) -> ProcessResult:
+    """Compile a Clawthor definition into a Claude Code plugin."""
+
+    definition_file = target[ClaudoPluginDefinitionField].value
+    output_dir = target[ClaudoPluginOutputDirField].value
+    marketplace_mode = target[ClaudoPluginMarketplaceModeField].value.lower() == "true"
+
+    # Build clawthor command
+    cmd = ["clawthor", "compile", definition_file, output_dir]
+    if marketplace_mode:
+        cmd.append("--marketplace")
+
+    # Run clawthor
+    try:
+        result = subprocess.run(
+            cmd,
+            cwd=target.address.spec_path,
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+
+        if result.returncode != 0:
+            raise RuntimeError(
+                f"Clawthor compilation failed:\n{result.stderr}"
+            )
+
+        return ProcessResult(
+            exit_code=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )
+    except FileNotFoundError:
+        raise RuntimeError(
+            "clawthor command not found. Install the clawthor gem: gem install clawthor"
+        )
+
+
+rules = [compile_claude_plugin]

pants_clawthor/targets.py

@@ -0,0 +1,47 @@
+"""Target types for Clawthor plugin compilation."""
+
+from pants.engine.target import (
+    COMMON_TARGET_FIELDS,
+    SingleSourceField,
+    StringField,
+    Target,
+)
+
+
+class ClaudoPluginDefinitionField(SingleSourceField):
+    """Path to the Clawthor definition.rb file."""
+
+    alias = "definition"
+    help = "Path to the Clawthor definition file (e.g., 'definition.rb')"
+
+
+class ClaudoPluginOutputDirField(StringField):
+    """Output directory for the generated plugin."""
+
+    alias = "output_dir"
+    default = "output"
+    help = "Output directory for generated plugin files (default: 'output')"
+
+
+class ClaudoPluginMarketplaceModeField(StringField):
+    """Whether to generate marketplace layout."""
+
+    alias = "marketplace"
+    default = "false"
+    help = "Generate marketplace layout instead of plugin layout ('true' or 'false')"
+
+
+class ClaudoPluginTarget(Target):
+    """A Claude Code plugin built from a Clawthor definition."""
+
+    alias = "claude_plugin"
+    core_fields = (
+        *COMMON_TARGET_FIELDS,
+        ClaudoPluginDefinitionField,
+        ClaudoPluginOutputDirField,
+        ClaudoPluginMarketplaceModeField,
+    )
+    help = (
+        "A Claude Code plugin compiled from a Clawthor definition.\n\n"
+        "Requires the clawthor gem to be installed."
+    )