holoscript 6.0.4__tar.gz → 6.0.6__tar.gz

holoscript-6.0.6/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: holoscript
+Version: 6.0.6
+Summary: Python bindings for HoloScript — parsing, validation, and domain bridges for scientific computing
+Author: Brian X Base Team
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: mypy>=1.11.0; extra == "dev"
+Provides-Extra: medical
+Requires-Dist: pydicom>=2.4.0; extra == "medical"
+Requires-Dist: numpy>=1.24.0; extra == "medical"
+Provides-Extra: alphafold
+Requires-Dist: requests>=2.31.0; extra == "alphafold"
+Provides-Extra: astronomy
+Requires-Dist: numpy>=1.24.0; extra == "astronomy"
+Provides-Extra: robotics
+Requires-Dist: roslibpy>=1.6.0; extra == "robotics"
+Provides-Extra: scientific
+Requires-Dist: numpy>=1.24.0; extra == "scientific"
+Provides-Extra: all
+Requires-Dist: holoscript[alphafold,astronomy,medical,robotics,scientific]; extra == "all"
+
+# holoscript
+
+Python bindings for [HoloScript](https://github.com/brianonbased-dev/HoloScript) — parse, validate, and bridge domain-specific scientific tools into the HoloScript spatial computing ecosystem.
+
+## Install
+
+```bash
+pip install holoscript
+```
+
+## Quick Start
+
+```python
+import holoscript
+
+# Parse a .holo composition
+result = holoscript.parse('object Cube { position: [0, 1, 0] }')
+print(result.success)  # True
+print(result.ast)      # {"type": "composition", "source": "..."}
+
+# Validate
+validation = holoscript.validate('object Cube { position: [0, 1, 0] }')
+print(validation.valid)  # True
+
+# List available traits
+traits = holoscript.list_traits()
+print(traits)  # ["@grabbable", "@physics", "@clickable", "@color", "@position"]
+```
+
+## Domain Bridges
+
+HoloScript bridges Python scientific libraries into spatial computing. Install the extras you need:
+
+```bash
+pip install holoscript[medical]           # DICOM imaging
+pip install holoscript[alphafold]         # Protein structure prediction
+pip install holoscript[astronomy]         # Radio astronomy
+pip install holoscript[robotics]          # ROS2 integration
+pip install holoscript[scientific]        # Molecular docking (AutoDock)
+pip install holoscript[all]              # Everything
+```
+
+### Medical — DICOM Bridge
+
+```python
+from holoscript.bridges.medical import load_dicom_series, extract_volume
+
+# Load a DICOM series and extract 3D volume for HoloScript visualization
+series = load_dicom_series("/path/to/dicom/")
+volume = extract_volume(series)
+```
+
+Requires: `pydicom`, `numpy`
+
+### AlphaFold — Protein Structure
+
+```python
+from holoscript.bridges.alphafold import AlphaFoldBridge
+
+bridge = AlphaFoldBridge(api_key="your_key")
+structure = bridge.predict("MKFLILLFNILCLFPVLAADNHGVS")
+```
+
+Requires: `requests`
+
+### Astronomy — Radio Telescope Data
+
+```python
+from holoscript.bridges.radio_astronomy import calculate_synchrotron
+
+flux = calculate_synchrotron({
+    "magnetic_field_gauss": 1e-4,
+    "frequency_hz": 1.4e9
+})
+```
+
+### Robotics — ROS2
+
+```python
+from holoscript.bridges.robotics import ROS2Bridge
+
+bridge = ROS2Bridge("ws://localhost:9090")
+bridge.connect()
+bridge.publish_joint_command("/joint_states", {"position": [0, 0.5, 1.0]})
+```
+
+Requires: `roslibpy`
+
+### Scientific — Molecular Docking
+
+```python
+from holoscript.bridges.scientific import AutoDockBridge
+
+bridge = AutoDockBridge()
+results = bridge.run_docking({
+    "protein_pdb": "receptor.pdb",
+    "ligand_mol": "compound.mol"
+})
+```
+
+## MCP Server
+
+HoloScript also runs as an MCP server with 214 tools (verify via `curl mcp.holoscript.net/health`). The Python package provides local parsing — the MCP server provides compilation, rendering, and deployment.
+
+```bash
+# No auth needed for parsing
+curl -X POST https://mcp.holoscript.net/api/compile \
+  -H "Content-Type: application/json" \
+  -d '{"code": "object Cube { position: [0,1,0] }", "target": "r3f"}'
+```
+
+## npm Ecosystem
+
+The full HoloScript ecosystem is on npm:
+
+```bash
+npx create-holoscript my-app    # Scaffold a project
+npm install @holoscript/core    # Core library
+```
+
+## Links
+
+- [GitHub](https://github.com/brianonbased-dev/HoloScript)
+- [MCP Server](https://mcp.holoscript.net)
+- [Store](https://store.holoscript.net)
+- [npm](https://www.npmjs.com/org/holoscript)
+- [PyPI](https://pypi.org/project/holoscript/)
+
+## License
+
+MIT

holoscript-6.0.6/README.md

@@ -0,0 +1,131 @@
+# holoscript
+
+Python bindings for [HoloScript](https://github.com/brianonbased-dev/HoloScript) — parse, validate, and bridge domain-specific scientific tools into the HoloScript spatial computing ecosystem.
+
+## Install
+
+```bash
+pip install holoscript
+```
+
+## Quick Start
+
+```python
+import holoscript
+
+# Parse a .holo composition
+result = holoscript.parse('object Cube { position: [0, 1, 0] }')
+print(result.success)  # True
+print(result.ast)      # {"type": "composition", "source": "..."}
+
+# Validate
+validation = holoscript.validate('object Cube { position: [0, 1, 0] }')
+print(validation.valid)  # True
+
+# List available traits
+traits = holoscript.list_traits()
+print(traits)  # ["@grabbable", "@physics", "@clickable", "@color", "@position"]
+```
+
+## Domain Bridges
+
+HoloScript bridges Python scientific libraries into spatial computing. Install the extras you need:
+
+```bash
+pip install holoscript[medical]           # DICOM imaging
+pip install holoscript[alphafold]         # Protein structure prediction
+pip install holoscript[astronomy]         # Radio astronomy
+pip install holoscript[robotics]          # ROS2 integration
+pip install holoscript[scientific]        # Molecular docking (AutoDock)
+pip install holoscript[all]              # Everything
+```
+
+### Medical — DICOM Bridge
+
+```python
+from holoscript.bridges.medical import load_dicom_series, extract_volume
+
+# Load a DICOM series and extract 3D volume for HoloScript visualization
+series = load_dicom_series("/path/to/dicom/")
+volume = extract_volume(series)
+```
+
+Requires: `pydicom`, `numpy`
+
+### AlphaFold — Protein Structure
+
+```python
+from holoscript.bridges.alphafold import AlphaFoldBridge
+
+bridge = AlphaFoldBridge(api_key="your_key")
+structure = bridge.predict("MKFLILLFNILCLFPVLAADNHGVS")
+```
+
+Requires: `requests`
+
+### Astronomy — Radio Telescope Data
+
+```python
+from holoscript.bridges.radio_astronomy import calculate_synchrotron
+
+flux = calculate_synchrotron({
+    "magnetic_field_gauss": 1e-4,
+    "frequency_hz": 1.4e9
+})
+```
+
+### Robotics — ROS2
+
+```python
+from holoscript.bridges.robotics import ROS2Bridge
+
+bridge = ROS2Bridge("ws://localhost:9090")
+bridge.connect()
+bridge.publish_joint_command("/joint_states", {"position": [0, 0.5, 1.0]})
+```
+
+Requires: `roslibpy`
+
+### Scientific — Molecular Docking
+
+```python
+from holoscript.bridges.scientific import AutoDockBridge
+
+bridge = AutoDockBridge()
+results = bridge.run_docking({
+    "protein_pdb": "receptor.pdb",
+    "ligand_mol": "compound.mol"
+})
+```
+
+## MCP Server
+
+HoloScript also runs as an MCP server with 214 tools (verify via `curl mcp.holoscript.net/health`). The Python package provides local parsing — the MCP server provides compilation, rendering, and deployment.
+
+```bash
+# No auth needed for parsing
+curl -X POST https://mcp.holoscript.net/api/compile \
+  -H "Content-Type: application/json" \
+  -d '{"code": "object Cube { position: [0,1,0] }", "target": "r3f"}'
+```
+
+## npm Ecosystem
+
+The full HoloScript ecosystem is on npm:
+
+```bash
+npx create-holoscript my-app    # Scaffold a project
+npm install @holoscript/core    # Core library
+```
+
+## Links
+
+- [GitHub](https://github.com/brianonbased-dev/HoloScript)
+- [MCP Server](https://mcp.holoscript.net)
+- [Store](https://store.holoscript.net)
+- [npm](https://www.npmjs.com/org/holoscript)
+- [PyPI](https://pypi.org/project/holoscript/)
+
+## License
+
+MIT

{holoscript-6.0.4 → holoscript-6.0.6}/holoscript/__init__.py

@@ -1,53 +1,53 @@
-from dataclasses import dataclass, field
-from typing import Dict, List
-
-# Release version injected by CI from git tag. Dev version for local use.
-__version__ = "6.0.4"
-
-
-@dataclass
-class ParseResult:
-    success: bool
-    ast: Dict[str, str]
-    errors: List[str] = field(default_factory=list)
-    warnings: List[str] = field(default_factory=list)
-    format: str = "holo"
-
-
-@dataclass
-class ValidationResult:
-    valid: bool
-    errors: List[str] = field(default_factory=list)
-    warnings: List[str] = field(default_factory=list)
-
-
-def parse(code: str) -> ParseResult:
-    stripped = code.strip()
-    if not stripped:
-        return ParseResult(success=False, ast={}, errors=["Input is empty"])
-
-    return ParseResult(
-        success=True,
-        ast={"type": "composition", "source": stripped},
-    )
-
-
-def validate(code: str) -> ValidationResult:
-    if not code.strip():
-        return ValidationResult(valid=False, errors=["Input is empty"])
-
-    return ValidationResult(valid=True)
-
-
-def list_traits() -> List[str]:
-    return ["@grabbable", "@physics", "@clickable", "@color", "@position"]
-
-
-__all__ = [
-    "__version__",
-    "ParseResult",
-    "ValidationResult",
-    "parse",
-    "validate",
-    "list_traits",
-]
+from dataclasses import dataclass, field
+from typing import Dict, List
+
+# Release version injected by CI from git tag. Dev version for local use.
+__version__ = "6.0.6"
+
+
+@dataclass
+class ParseResult:
+    success: bool
+    ast: Dict[str, str]
+    errors: List[str] = field(default_factory=list)
+    warnings: List[str] = field(default_factory=list)
+    format: str = "holo"
+
+
+@dataclass
+class ValidationResult:
+    valid: bool
+    errors: List[str] = field(default_factory=list)
+    warnings: List[str] = field(default_factory=list)
+
+
+def parse(code: str) -> ParseResult:
+    stripped = code.strip()
+    if not stripped:
+        return ParseResult(success=False, ast={}, errors=["Input is empty"])
+
+    return ParseResult(
+        success=True,
+        ast={"type": "composition", "source": stripped},
+    )
+
+
+def validate(code: str) -> ValidationResult:
+    if not code.strip():
+        return ValidationResult(valid=False, errors=["Input is empty"])
+
+    return ValidationResult(valid=True)
+
+
+def list_traits() -> List[str]:
+    return ["@grabbable", "@physics", "@clickable", "@color", "@position"]
+
+
+__all__ = [
+    "__version__",
+    "ParseResult",
+    "ValidationResult",
+    "parse",
+    "validate",
+    "list_traits",
+]

holoscript-6.0.6/holoscript/bridges/__init__.py

@@ -0,0 +1,11 @@
+"""
+HoloScript Domain Bridges — Python integrations for scientific computing.
+
+Install domain extras:
+  pip install holoscript[medical]        # DICOM imaging
+  pip install holoscript[alphafold]      # Protein structure prediction
+  pip install holoscript[astronomy]      # Radio astronomy / synchrotron
+  pip install holoscript[robotics]       # ROS2 integration
+  pip install holoscript[scientific]     # AutoDock molecular docking
+  pip install holoscript[all]            # Everything
+"""