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

jaymd96_pants_clawthor-0.1.2.dist-info/METADATA

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: jaymd96-pants-clawthor
+Version: 0.1.2
+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
+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
+
+Optional Pants backend that compiles Clawthor plugins as part of your build.
+
+**Use this when**: You define plugins in `BUILD` files and want automatic compilation via Pants.
+
+**Don't use if**: You just want to compile manually with `clawthor compile` (use the gem directly instead).
+
+## Installation
+
+### 1. Install clawthor gem
+
+```bash
+gem install clawthor
+which clawthor    # Verify it's available
+```
+
+### 2. Add to pants.toml
+
+```toml
+[GLOBAL]
+plugins = [
+    "jaymd96-pants-clawthor==0.1.0",
+]
+```
+
+### Requirements
+
+- **Pants** 2.18+
+- **Python** 3.9+
+- **Ruby** 3.0+
+- **clawthor gem** 0.3.0+
+
+## Quick Start
+
+### 1. Create a BUILD file
+
+```python
+# plugins/my_plugin/BUILD
+claude_plugin(
+    name="my_plugin",
+    definition="definition.rb",
+)
+```
+
+### 2. Create definition.rb
+
+```ruby
+# plugins/my_plugin/definition.rb
+workspace :my_plugin do
+  version "1.0.0"
+  author "My Team"
+end
+
+skill :example do
+  description "Example skill"
+end
+
+command :hello do
+  description "Say hello"
+  template { prompt "Say hello" }
+end
+```
+
+### 3. Build
+
+```bash
+pants build //plugins/my_plugin:my_plugin
+```
+
+That's it! Generated plugin is in `plugins/my_plugin/output/`.
+
+## Target Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `definition` | string | required | Path to `definition.rb` |
+| `output_dir` | string | `output` | Where to generate files |
+| `marketplace` | bool | `false` | Use marketplace layout? |
+
+## Examples
+
+### Basic plugin
+
+```python
+# plugins/docs/BUILD
+claude_plugin(
+    name="docs",
+    definition="definition.rb",
+)
+```
+
+### With modules
+
+```python
+# plugins/dev/BUILD
+claude_plugin(
+    name="dev",
+    definition="definition.rb",
+    output_dir="plugin",
+)
+```
+
+```ruby
+# plugins/dev/definition.rb
+workspace :dev_tools do
+  version "1.0.0"
+end
+
+require_relative './modules/planning'
+use :planning
+```
+
+### Marketplace layout
+
+```python
+claude_plugin(
+    name="release",
+    definition="definition.rb",
+    marketplace=True,
+)
+```
+
+## Reusing Claudo modules
+
+Copy Claudo modules into your project:
+
+```bash
+cp ../baseline/modules/planning.rb plugins/my_plugin/
+```
+
+Then use them:
+
+```ruby
+require_relative './modules/planning'
+
+workspace :my_plugin do
+  use :planning
+end
+```
+
+## Troubleshooting
+
+### "clawthor command not found"
+
+1. Install: `gem install clawthor`
+2. Verify: `which clawthor`
+3. If using rbenv/rvm, check Ruby version: `ruby --version`
+
+### Compilation fails
+
+Check definition file manually:
+```bash
+cd plugins/my_plugin
+clawthor compile definition.rb output/
+```
+
+### Path issues
+
+Make sure `definition` is relative to the BUILD file:
+
+```python
+claude_plugin(
+    name="my_plugin",
+    definition="definition.rb",  # Same dir as BUILD
+)
+```
+
+## Development
+
+### Setup
+
+```bash
+cd pants-plugin
+hatch env create
+hatch run test
+```
+
+### Test your backend
+
+```bash
+hatch run test
+```
+
+### Format code
+
+```bash
+hatch run fmt
+```
+
+## How It Works
+
+This backend:
+1. Takes a `definition.rb` file
+2. Runs `clawthor compile` automatically
+3. Generates plugin files
+4. Makes them available to Pants
+
+That's all—it's a simple bridge between Pants and Clawthor.
+
+## Related
+
+- [Clawthor Gem](../clawthor/README.md) — The DSL compiler
+- [Baseline Plugin](../baseline/README.md) — Reference & modules
+- [Clawthor Monorepo](../README.md) — Overview
+- [Pants Docs](https://www.pantsbuild.org/) — Build system
+
+## License
+
+MIT — See [../clawthor/LICENSE](../clawthor/LICENSE)

jaymd96_pants_clawthor-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+pants_clawthor/__init__.py,sha256=dK1Vo_AAC_Y-Ga9xq2EtBsy8XolwPrX4ZCM_Vb_zEF4,96
+pants_clawthor/register.py,sha256=1-Xh9V6ZDIMS7pIPxto4wim6EpSHb2gJpEo5XDEBlmU,366
+pants_clawthor/rules.py,sha256=Rpf9dmikcbBHzwDbfGschRZEW3RxnNcRELoXfKcKte0,1781
+pants_clawthor/targets.py,sha256=pvApklAA94qNlkLlX5yRzkkdqBsJiKqor51y4UDeqgQ,1288
+jaymd96_pants_clawthor-0.1.2.dist-info/METADATA,sha256=kKn7kktthocG6EYYHfwIR-tiZ40ltGf0otp1jmNk7X0,4859
+jaymd96_pants_clawthor-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+jaymd96_pants_clawthor-0.1.2.dist-info/licenses/LICENSE,sha256=y8CeiP6Qd9jxidfFjPkyZhsRjs9XarMIMVDP91lZsJE,1066
+jaymd96_pants_clawthor-0.1.2.dist-info/RECORD,,

pants_clawthor/register.py

@@ -1,17 +1,12 @@
 """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),
-    ]
+    return [*clawthor_rules()]
 
 
 def target_types():

pants_clawthor/rules.py

@@ -1,22 +1,29 @@
 """Build rules for Clawthor plugin compilation."""
 
-import os
-import shutil
 import subprocess
-from pathlib import Path
+from dataclasses import dataclass
 
-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.rules import collect_rules, goal_rule, rule
 from pants.engine.target import Target
-from pants.util.dirutil import safe_mkdir
 
-from pants_clawthor.targets import ClaudoPluginTarget
+from pants_clawthor.targets import (
+    ClaudoPluginDefinitionField,
+    ClaudoPluginMarketplaceModeField,
+    ClaudoPluginOutputDirField,
+    ClaudoPluginTarget,
+)
+
+
+@dataclass(frozen=True)
+class ClawthorCompileResult:
+    """Result of compiling a Clawthor definition."""
+    exit_code: int
+    stdout: str
+    stderr: str
 
 
 @rule
-async def compile_claude_plugin(target: ClaudoPluginTarget) -> ProcessResult:
+async def compile_claude_plugin(target: ClaudoPluginTarget) -> ClawthorCompileResult:
     """Compile a Clawthor definition into a Claude Code plugin."""
 
     definition_file = target[ClaudoPluginDefinitionField].value
@@ -32,7 +39,7 @@ async def compile_claude_plugin(target: ClaudoPluginTarget) -> ProcessResult:
     try:
         result = subprocess.run(
             cmd,
-            cwd=target.address.spec_path,
+            cwd=target.address.spec_path or ".",
             capture_output=True,
             text=True,
             check=False,
@@ -43,7 +50,7 @@ async def compile_claude_plugin(target: ClaudoPluginTarget) -> ProcessResult:
                 f"Clawthor compilation failed:\n{result.stderr}"
             )
 
-        return ProcessResult(
+        return ClawthorCompileResult(
             exit_code=result.returncode,
             stdout=result.stdout,
             stderr=result.stderr,
@@ -54,4 +61,5 @@ async def compile_claude_plugin(target: ClaudoPluginTarget) -> ProcessResult:
         )
 
 
-rules = [compile_claude_plugin]
+def rules():
+    return collect_rules()

jaymd96_pants_clawthor-0.1.0.dist-info/METADATA

@@ -1,293 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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,,