mrmd-python 0.1.0__tar.gz

mrmd_python-0.1.0/.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Runtime assets (generated)
+.mrmd-assets/
+
+# OS
+.DS_Store
+Thumbs.db

mrmd_python-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: mrmd-python
+Version: 0.1.0
+Summary: Python runtime server implementing the MRMD Runtime Protocol (MRP)
+Author: mrmd contributors
+License: MIT
+Keywords: ipython,mrmd,mrp,notebook,runtime
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: black>=25.12.0
+Requires-Dist: ipython>=8.0.0
+Requires-Dist: jedi>=0.19.0
+Requires-Dist: sse-starlette>=2.0.0
+Requires-Dist: starlette>=0.40.0
+Requires-Dist: uvicorn>=0.32.0
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Provides-Extra: format
+Requires-Dist: black>=24.0.0; extra == 'format'
+Description-Content-Type: text/markdown
+
+# mrmd-python
+
+Python runtime server implementing the MRMD Runtime Protocol (MRP).
+
+## Installation
+
+```bash
+uv pip install mrmd-python
+```
+
+## Usage
+
+### Command Line
+
+```bash
+mrmd-python --port 8000
+```
+
+### Programmatic
+
+```python
+from mrmd_python import create_app
+import uvicorn
+
+app = create_app(cwd="/path/to/project")
+uvicorn.run(app, host="localhost", port=8000)
+```
+
+## API Endpoints
+
+All endpoints are prefixed with `/mrp/v1/`.
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/capabilities` | GET | Runtime capabilities |
+| `/sessions` | GET/POST | List/create sessions |
+| `/execute` | POST | Run code |
+| `/execute/stream` | POST | Run code with SSE streaming |
+| `/complete` | POST | Get completions |
+| `/inspect` | POST | Get symbol info |
+| `/hover` | POST | Get hover tooltip |
+| `/variables` | POST | List variables |
+| `/interrupt` | POST | Cancel execution |
+
+## Protocol
+
+See [PROTOCOL.md](../mrmd-editor/PROTOCOL.md) for the full MRP specification.

mrmd_python-0.1.0/README.md

@@ -0,0 +1,47 @@
+# mrmd-python
+
+Python runtime server implementing the MRMD Runtime Protocol (MRP).
+
+## Installation
+
+```bash
+uv pip install mrmd-python
+```
+
+## Usage
+
+### Command Line
+
+```bash
+mrmd-python --port 8000
+```
+
+### Programmatic
+
+```python
+from mrmd_python import create_app
+import uvicorn
+
+app = create_app(cwd="/path/to/project")
+uvicorn.run(app, host="localhost", port=8000)
+```
+
+## API Endpoints
+
+All endpoints are prefixed with `/mrp/v1/`.
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/capabilities` | GET | Runtime capabilities |
+| `/sessions` | GET/POST | List/create sessions |
+| `/execute` | POST | Run code |
+| `/execute/stream` | POST | Run code with SSE streaming |
+| `/complete` | POST | Get completions |
+| `/inspect` | POST | Get symbol info |
+| `/hover` | POST | Get hover tooltip |
+| `/variables` | POST | List variables |
+| `/interrupt` | POST | Cancel execution |
+
+## Protocol
+
+See [PROTOCOL.md](../mrmd-editor/PROTOCOL.md) for the full MRP specification.

mrmd_python-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "mrmd-python"
+version = "0.1.0"
+description = "Python runtime server implementing the MRMD Runtime Protocol (MRP)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "mrmd contributors" }]
+keywords = ["notebook", "ipython", "runtime", "mrmd", "mrp"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "starlette>=0.40.0",
+    "uvicorn>=0.32.0",
+    "sse-starlette>=2.0.0",
+    "ipython>=8.0.0",
+    "jedi>=0.19.0",
+    "black>=25.12.0",
+]
+
+[project.optional-dependencies]
+format = ["black>=24.0.0"]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+mrmd-python = "mrmd_python.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mrmd_python"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

mrmd_python-0.1.0/src/mrmd_python/__init__.py

@@ -0,0 +1,16 @@
+"""
+mrmd-python: Python runtime server implementing the MRMD Runtime Protocol (MRP)
+
+Usage:
+    mrmd-python [--host HOST] [--port PORT] [--cwd DIR]
+
+Or programmatically:
+    from mrmd_python import create_app
+    app = create_app()
+"""
+
+from .server import create_app, MRPServer
+from .worker import IPythonWorker
+
+__version__ = "0.1.0"
+__all__ = ["create_app", "MRPServer", "IPythonWorker", "__version__"]

mrmd_python-0.1.0/src/mrmd_python/cli.py

@@ -0,0 +1,119 @@
+"""
+mrmd-python CLI
+
+Usage:
+    mrmd-python [--host HOST] [--port PORT] [--cwd DIR] [--assets-dir DIR]
+"""
+
+import argparse
+import os
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Python runtime server implementing the MRMD Runtime Protocol (MRP)"
+    )
+    parser.add_argument(
+        "--host",
+        default="localhost",
+        help="Host to bind to (default: localhost)",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=8000,
+        help="Port to bind to (default: 8000)",
+    )
+    parser.add_argument(
+        "--cwd",
+        default=None,
+        help="Working directory (default: current directory)",
+    )
+    parser.add_argument(
+        "--assets-dir",
+        default=None,
+        help="Directory for saving assets (default: .mrmd-assets in cwd)",
+    )
+    parser.add_argument(
+        "--reload",
+        action="store_true",
+        help="Enable auto-reload for development",
+    )
+    parser.add_argument(
+        "--venv",
+        default=None,
+        help="Path to virtual environment to use for code execution",
+    )
+
+    args = parser.parse_args()
+
+    # Import here to avoid slow startup for --help
+    import uvicorn
+    from .server import create_app
+
+    cwd = args.cwd or os.getcwd()
+    assets_dir = args.assets_dir or os.path.join(cwd, ".mrmd-assets")
+    venv = args.venv
+
+    venv_display = venv[:43] if venv else "System Python"
+    print(
+        f"""
+╔═══════════════════════════════════════════════════════════════╗
+║                    mrmd-python MRP Server                     ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Running on: http://{args.host}:{args.port}/mrp/v1{' ' * (26 - len(args.host) - len(str(args.port)))}║
+║                                                               ║
+║  Endpoints:                                                   ║
+║    GET  /mrp/v1/capabilities                                  ║
+║    GET  /mrp/v1/sessions                                      ║
+║    POST /mrp/v1/execute                                       ║
+║    POST /mrp/v1/execute/stream                                ║
+║    POST /mrp/v1/complete                                      ║
+║    POST /mrp/v1/inspect                                       ║
+║    POST /mrp/v1/hover                                         ║
+║    POST /mrp/v1/variables                                     ║
+║                                                               ║
+║  Working directory: {cwd[:43]:<43}║
+║  Assets directory:  {assets_dir[:43]:<43}║
+║  Virtual env:       {venv_display:<43}║
+║                                                               ║
+║  Press Ctrl+C to stop                                         ║
+╚═══════════════════════════════════════════════════════════════╝
+"""
+    )
+
+    # Create app factory for uvicorn
+    def app_factory():
+        return create_app(cwd=cwd, assets_dir=assets_dir, venv=venv)
+
+    if args.reload:
+        global _cwd, _assets_dir, _venv
+        _cwd = cwd
+        _assets_dir = assets_dir
+        _venv = venv
+        uvicorn.run(
+            "mrmd_python.cli:_create_app_for_reload",
+            host=args.host,
+            port=args.port,
+            reload=True,
+            access_log=False,  # Disable access log to prevent it leaking into execution output
+        )
+    else:
+        app = create_app(cwd=cwd, assets_dir=assets_dir, venv=venv)
+        uvicorn.run(app, host=args.host, port=args.port, access_log=False)
+
+
+# For reload mode
+_cwd = None
+_assets_dir = None
+_venv = None
+
+
+def _create_app_for_reload():
+    from .server import create_app
+
+    return create_app(cwd=_cwd, assets_dir=_assets_dir, venv=_venv)
+
+
+if __name__ == "__main__":
+    main()