magmascript 1.0.0__tar.gz

magmascript-1.0.0/LICENSE

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

magmascript-1.0.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: magmascript
+Version: 1.0.0
+Summary: Scripting toolkit with domain-first subcommands
+Author: Jake McCoy
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/magmacrunchmedia/magmascript
+Project-URL: Repository, https://github.com/magmacrunchmedia/magmascript
+Keywords: mcp,scripting,cli,magmacrunch
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: cli
+Requires-Dist: rich>=13.0; extra == "cli"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: build>=0.10; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: magmascript[cli,dev]; extra == "all"
+Dynamic: license-file
+
+# magmascript
+
+Scripting toolkit with domain-first subcommands for managing magmacrunch.com infrastructure.
+
+## Install
+
+```bash
+git clone https://github.com/magmacrunchmedia/magmascript.git
+cd magmascript
+python3 -m venv .venv
+.venv/bin/pip install -e ".[all]"
+```
+
+## Configure
+
+```bash
+export MAGMA_API_KEY="your-mcp-key"
+export GITHUB_TOKEN=$(gh auth token)
+# pi domain works with no config (SSH key auth)
+```
+
+Or use `~/.config/magmascript/config.toml`:
+
+```toml
+[mcp]
+url = "https://magmacrunch.duckdns.org/mcp"
+api_key = "your-key"
+
+[pi]
+host = "192.168.1.16"
+user = "jake"
+
+[gh]
+token = "ghp_..."
+owner = "magmacrunchmedia"
+repo = "magmacrunch.com"
+```
+
+## Usage
+
+### MCP Domain — MusicBrainz, scores, Discogs
+```bash
+magmascript mcp scoreboards                  # game leaderboards
+magmascript mcp scores tetris                # tetris scores
+magmascript mcp search "radiohead"           # search MusicBrainz
+magmascript mcp entities                     # all cached entities
+magmascript mcp games                        # arcade games
+```
+
+### Pi Domain — Direct SSH to Raspberry Pi
+```bash
+magmascript pi status                        # all service statuses
+magmascript pi logs arcade-chat              # service logs
+magmascript pi restart arcade-chat           # restart service
+magmascript pi info                          # uptime, memory, temp
+magmascript pi deploy arcade/chat-server.py  # deploy files
+```
+
+### GitHub Domain — Direct API access
+```bash
+magmascript gh workflows                     # all workflow statuses
+magmascript gh trigger "Deploy to Pi"        # trigger workflow
+magmascript gh issues                        # list issues
+magmascript gh file path/to/file.txt         # read file
+```
+
+## Python Library
+
+```python
+from magmascript import MCPClient, PIClient, GHClient
+
+# MCP
+with MCPClient() as mcp:
+    boards = mcp.scoreboards()
+
+# Pi (direct SSH)
+with PIClient() as pi:
+    status = pi.services()
+
+# GitHub (direct API)
+with GHClient() as gh:
+    workflows = gh.workflows()
+```
+
+## Shell Helpers
+
+```bash
+source lib/magmascript.sh
+
+mcp_scoreboards          # MCP commands
+pi_status                # Pi commands
+gh_workflows             # GitHub commands
+```
+
+## Documentation
+
+Full documentation on the [Wiki](https://github.com/magmacrunchmedia/magmascript/wiki):
+- [Configuration](https://github.com/magmacrunchmedia/magmascript/wiki/Configuration)
+- [MCP Domain](https://github.com/magmacrunchmedia/magmascript/wiki/MCP-Domain)
+- [Pi Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Pi-Domain)
+- [GitHub Domain](https://github.com/magmacrunchmedia/magmascript/wiki/GitHub-Domain)
+- [Architecture](https://github.com/magmacrunchmedia/magmascript/wiki/Architecture)
+- [Shell Helpers](https://github.com/magmacrunchmedia/magmascript/wiki/Shell-Helpers)
+
+## License
+
+MIT

magmascript-1.0.0/README.md

@@ -0,0 +1,107 @@
+# magmascript
+
+Scripting toolkit with domain-first subcommands for managing magmacrunch.com infrastructure.
+
+## Install
+
+```bash
+git clone https://github.com/magmacrunchmedia/magmascript.git
+cd magmascript
+python3 -m venv .venv
+.venv/bin/pip install -e ".[all]"
+```
+
+## Configure
+
+```bash
+export MAGMA_API_KEY="your-mcp-key"
+export GITHUB_TOKEN=$(gh auth token)
+# pi domain works with no config (SSH key auth)
+```
+
+Or use `~/.config/magmascript/config.toml`:
+
+```toml
+[mcp]
+url = "https://magmacrunch.duckdns.org/mcp"
+api_key = "your-key"
+
+[pi]
+host = "192.168.1.16"
+user = "jake"
+
+[gh]
+token = "ghp_..."
+owner = "magmacrunchmedia"
+repo = "magmacrunch.com"
+```
+
+## Usage
+
+### MCP Domain — MusicBrainz, scores, Discogs
+```bash
+magmascript mcp scoreboards                  # game leaderboards
+magmascript mcp scores tetris                # tetris scores
+magmascript mcp search "radiohead"           # search MusicBrainz
+magmascript mcp entities                     # all cached entities
+magmascript mcp games                        # arcade games
+```
+
+### Pi Domain — Direct SSH to Raspberry Pi
+```bash
+magmascript pi status                        # all service statuses
+magmascript pi logs arcade-chat              # service logs
+magmascript pi restart arcade-chat           # restart service
+magmascript pi info                          # uptime, memory, temp
+magmascript pi deploy arcade/chat-server.py  # deploy files
+```
+
+### GitHub Domain — Direct API access
+```bash
+magmascript gh workflows                     # all workflow statuses
+magmascript gh trigger "Deploy to Pi"        # trigger workflow
+magmascript gh issues                        # list issues
+magmascript gh file path/to/file.txt         # read file
+```
+
+## Python Library
+
+```python
+from magmascript import MCPClient, PIClient, GHClient
+
+# MCP
+with MCPClient() as mcp:
+    boards = mcp.scoreboards()
+
+# Pi (direct SSH)
+with PIClient() as pi:
+    status = pi.services()
+
+# GitHub (direct API)
+with GHClient() as gh:
+    workflows = gh.workflows()
+```
+
+## Shell Helpers
+
+```bash
+source lib/magmascript.sh
+
+mcp_scoreboards          # MCP commands
+pi_status                # Pi commands
+gh_workflows             # GitHub commands
+```
+
+## Documentation
+
+Full documentation on the [Wiki](https://github.com/magmacrunchmedia/magmascript/wiki):
+- [Configuration](https://github.com/magmacrunchmedia/magmascript/wiki/Configuration)
+- [MCP Domain](https://github.com/magmacrunchmedia/magmascript/wiki/MCP-Domain)
+- [Pi Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Pi-Domain)
+- [GitHub Domain](https://github.com/magmacrunchmedia/magmascript/wiki/GitHub-Domain)
+- [Architecture](https://github.com/magmacrunchmedia/magmascript/wiki/Architecture)
+- [Shell Helpers](https://github.com/magmacrunchmedia/magmascript/wiki/Shell-Helpers)
+
+## License
+
+MIT

magmascript-1.0.0/magmascript/__init__.py

@@ -0,0 +1,41 @@
+"""magmascript — a scripting toolkit with domain-first subcommands."""
+
+__version__ = "1.0.0"
+
+from magmascript.core.config import Config, GHConfig, MediaConfig, PIConfig, get_config, load_config, set_config
+from magmascript.core.registry import get_domain, list_domains, register_domain
+from magmascript.core.rpc import RPCClient, RPCError, RPCResponse
+from magmascript.core.output import format_output, format_table, format_json
+
+# Import domains to trigger registration
+from magmascript import domains  # noqa: F401
+
+# Convenience: expose clients at top level
+from magmascript.domains.mcp import MCPClient
+from magmascript.domains.pi import PIClient
+from magmascript.domains.gh import GHClient
+from magmascript.domains.media import MediaClient
+
+__all__ = [
+    "__version__",
+    "Config",
+    "GHClient",
+    "GHConfig",
+    "MCPClient",
+    "MediaClient",
+    "MediaConfig",
+    "PIClient",
+    "PIConfig",
+    "RPCClient",
+    "RPCError",
+    "RPCResponse",
+    "format_output",
+    "format_json",
+    "format_table",
+    "get_config",
+    "get_domain",
+    "list_domains",
+    "load_config",
+    "register_domain",
+    "set_config",
+]