muscles-cli 1.0.0__tar.gz

muscles_cli-1.0.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: muscles-cli
+Version: 1.0.0
+Summary: Muscles CLI runtime for shared command routing and strategy execution
+License: MIT
+Author: Denis B.
+Author-email: denis@butko.info
+Requires-Python: >=3.10,<4.0
+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
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: dnspython (==2.6.1)
+Requires-Dist: greenlet (==3.0.2)
+Requires-Dist: jsonschema (==4.16.0)
+Requires-Dist: muscles (>=1.0.0rc1,<2.0.0)
+Requires-Dist: pyyaml (>=6.0.0,<6.1.0)
+Requires-Dist: watchdog (>=4.0.0,<5.0.0)
+Requires-Dist: werkzeug (==2.1.1)
+Description-Content-Type: text/markdown
+
+# Muscles CLI
+
+`muscles-cli` is the console runtime for Muscles. It uses the same application
+shape as the HTTP runtimes: an `ApplicationMeta` class owns a `Context`, and the
+context delegates execution to `CliStrategy`.
+
+## Installation
+
+```bash
+pip install muscles-cli
+```
+
+Canonical ecosystem install matrix is documented in core:
+[Muscles installation matrix](https://github.com/butkoden/muscles/blob/master/docs/installation.md).
+
+## Related Repositories
+
+- [`muscles`](https://github.com/butkoden/muscles) - core contracts, actions, inspect output and canonical documentation.
+- [`muscles-asgi`](https://github.com/butkoden/muscles-asgi) - ASGI runtime generated projects can target.
+- [`muscles-wsgi`](https://github.com/butkoden/muscles-wsgi) - WSGI runtime generated projects can target.
+- [`muscles-mcp`](https://github.com/butkoden/muscles-mcp) - MCP projection over the same action contracts.
+- [`muscles-benchmarks`](https://github.com/butkoden/muscles-benchmarks) - CLI regression and architecture checks.
+
+## Project Scaffolding
+
+Use canonical command `muscles new`:
+
+```bash
+muscles new demo --runtime asgi
+muscles new demo --runtime wsgi
+muscles new demo --runtime cli
+```
+
+Notes:
+
+- `muscular new` is not a canonical command.
+- Existing non-empty directory is rejected unless `--force` is used.
+
+## AI Workflow Commands
+
+```bash
+muscles capabilities --json
+muscles inspect --json --app app.application:App
+muscles action list --app app.application:App --json
+muscles action inspect bookings.echo --app app.application:App --json
+muscles action run bookings.echo --app app.application:App --payload-json '{"title":"Call"}' --json
+muscles routes --app app.application:App
+muscles schemas --app app.application:App
+muscles rules --app app.application:App
+muscles cli --app app.application:App
+muscles generate page Home --with-tests
+muscles doctor --json
+muscles test --doctor
+```
+
+## Quick Start
+
+```python
+from muscles import ApplicationMeta, Context, cli
+from muscles.cli import CliStrategy
+
+
+class App(metaclass=ApplicationMeta):
+    context = Context(CliStrategy)
+
+    def run(self, *args):
+        return self.context.execute(*args, shutup=True)
+
+
+@cli.group()
+def bookings(*args):
+    """Booking commands."""
+    return True
+
+
+@bookings.command(command_name="remove")
+def remove_booking(*args):
+    booking_id = args[0]
+    return f"removed {booking_id}"
+
+
+app = App()
+assert app.run("bookings", "remove", "1") == "removed 1"
+```
+
+## Routing Model
+
+Groups and commands form a tree. That makes CLI routing close to HTTP routing:
+
+- `bookings remove 1` is a nested route with an argument;
+- `bookings/list` can be normalized by an application before calling the CLI;
+- groups can have handlers, but returning `True` lets execution continue to a
+  child command.
+
+More detail: [docs/routing.md](docs/routing.md).
+
+## Core Stream Output
+
+English: CLI progress output uses core `StreamEvent` items from
+`StreamResult`. `render_stream_result()` can print human-readable progress/log
+and result lines, or machine-readable JSON lines. The CLI layer only owns
+presentation and exit code mapping; stream semantics stay in `muscles.core`.
+
+Русский: CLI progress output использует core `StreamEvent` из `StreamResult`.
+`render_stream_result()` может печатать human-readable progress/log/result
+строки или machine-readable JSON lines. CLI слой отвечает только за presentation
+и exit code mapping; stream semantics остаётся в `muscles.core`.
+
+## Arguments
+
+Use `@cli.argument()` for named arguments and `@cli.flag()` for boolean flags.
+Required prompted arguments use `input()` or `getpass.getpass()` when hidden.
+
+For nested commands, define options on the parent group object:
+
+```python
+@cli.group(command_name="bookings")
+def bookings(*args):
+    return True
+
+@bookings.command(command_name="list")
+@bookings.argument("--limit", nargs=1, default="25")
+def bookings_list(*args, limit):
+    return limit
+```
+
+Canonical invocations for benchmark/automation scripts:
+
+```bash
+bookings list --limit 10
+bookings list --limit=10
+```
+
+## Development
+
+Run tests with the core package on `PYTHONPATH`:
+
+```bash
+PYTHONPATH=../muscles/src:src python -m pytest -q
+```
+

muscles_cli-1.0.0/README.md

@@ -0,0 +1,140 @@
+# Muscles CLI
+
+`muscles-cli` is the console runtime for Muscles. It uses the same application
+shape as the HTTP runtimes: an `ApplicationMeta` class owns a `Context`, and the
+context delegates execution to `CliStrategy`.
+
+## Installation
+
+```bash
+pip install muscles-cli
+```
+
+Canonical ecosystem install matrix is documented in core:
+[Muscles installation matrix](https://github.com/butkoden/muscles/blob/master/docs/installation.md).
+
+## Related Repositories
+
+- [`muscles`](https://github.com/butkoden/muscles) - core contracts, actions, inspect output and canonical documentation.
+- [`muscles-asgi`](https://github.com/butkoden/muscles-asgi) - ASGI runtime generated projects can target.
+- [`muscles-wsgi`](https://github.com/butkoden/muscles-wsgi) - WSGI runtime generated projects can target.
+- [`muscles-mcp`](https://github.com/butkoden/muscles-mcp) - MCP projection over the same action contracts.
+- [`muscles-benchmarks`](https://github.com/butkoden/muscles-benchmarks) - CLI regression and architecture checks.
+
+## Project Scaffolding
+
+Use canonical command `muscles new`:
+
+```bash
+muscles new demo --runtime asgi
+muscles new demo --runtime wsgi
+muscles new demo --runtime cli
+```
+
+Notes:
+
+- `muscular new` is not a canonical command.
+- Existing non-empty directory is rejected unless `--force` is used.
+
+## AI Workflow Commands
+
+```bash
+muscles capabilities --json
+muscles inspect --json --app app.application:App
+muscles action list --app app.application:App --json
+muscles action inspect bookings.echo --app app.application:App --json
+muscles action run bookings.echo --app app.application:App --payload-json '{"title":"Call"}' --json
+muscles routes --app app.application:App
+muscles schemas --app app.application:App
+muscles rules --app app.application:App
+muscles cli --app app.application:App
+muscles generate page Home --with-tests
+muscles doctor --json
+muscles test --doctor
+```
+
+## Quick Start
+
+```python
+from muscles import ApplicationMeta, Context, cli
+from muscles.cli import CliStrategy
+
+
+class App(metaclass=ApplicationMeta):
+    context = Context(CliStrategy)
+
+    def run(self, *args):
+        return self.context.execute(*args, shutup=True)
+
+
+@cli.group()
+def bookings(*args):
+    """Booking commands."""
+    return True
+
+
+@bookings.command(command_name="remove")
+def remove_booking(*args):
+    booking_id = args[0]
+    return f"removed {booking_id}"
+
+
+app = App()
+assert app.run("bookings", "remove", "1") == "removed 1"
+```
+
+## Routing Model
+
+Groups and commands form a tree. That makes CLI routing close to HTTP routing:
+
+- `bookings remove 1` is a nested route with an argument;
+- `bookings/list` can be normalized by an application before calling the CLI;
+- groups can have handlers, but returning `True` lets execution continue to a
+  child command.
+
+More detail: [docs/routing.md](docs/routing.md).
+
+## Core Stream Output
+
+English: CLI progress output uses core `StreamEvent` items from
+`StreamResult`. `render_stream_result()` can print human-readable progress/log
+and result lines, or machine-readable JSON lines. The CLI layer only owns
+presentation and exit code mapping; stream semantics stay in `muscles.core`.
+
+Русский: CLI progress output использует core `StreamEvent` из `StreamResult`.
+`render_stream_result()` может печатать human-readable progress/log/result
+строки или machine-readable JSON lines. CLI слой отвечает только за presentation
+и exit code mapping; stream semantics остаётся в `muscles.core`.
+
+## Arguments
+
+Use `@cli.argument()` for named arguments and `@cli.flag()` for boolean flags.
+Required prompted arguments use `input()` or `getpass.getpass()` when hidden.
+
+For nested commands, define options on the parent group object:
+
+```python
+@cli.group(command_name="bookings")
+def bookings(*args):
+    return True
+
+@bookings.command(command_name="list")
+@bookings.argument("--limit", nargs=1, default="25")
+def bookings_list(*args, limit):
+    return limit
+```
+
+Canonical invocations for benchmark/automation scripts:
+
+```bash
+bookings list --limit 10
+bookings list --limit=10
+```
+
+## Development
+
+Run tests with the core package on `PYTHONPATH`:
+
+```bash
+PYTHONPATH=../muscles/src:src python -m pytest -q
+```

muscles_cli-1.0.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+
+[tool.poetry]
+name = "muscles-cli"
+version = "1.0.0"
+description = "Muscles CLI runtime for shared command routing and strategy execution"
+readme = "README.md"
+authors = ["Denis B. <denis@butko.info>"]
+license = "MIT"
+packages = [{include = "muscles", from = "src"}]
+
+
+[tool.poetry.dependencies]
+python = ">=3.10,<4.0"
+muscles = ">=1.0.0rc1,<2.0.0"
+watchdog = "^4.0.0"
+dnspython = "==2.6.1"
+pyyaml = "~=6.0.0"
+werkzeug = "==2.1.1"
+greenlet = "==3.0.2"
+jsonschema = "==4.16.0"
+
+
+[tool.poetry.dev-dependencies]
+pytest = "==7.1.3"
+setuptools = "==69.0.2"
+
+[tool.poetry.scripts]
+muscles = "muscles.cli.tooling:main"

muscles_cli-1.0.0/src/muscles/cli/Makefile

@@ -0,0 +1,26 @@
+# Makefile
+
+start:
+	docker-compose up -d
+	docker exec -it butkoinfo_core_1 bash
+
+
+stop:
+	docker-compose up -d
+	docker exec -it butkoinfo-core-1 bash
+
+
+console:
+	docker exec -it butkoinfo_core_1 bash
+
+
+logs:
+	docker-compose logs
+
+
+develop:
+	#docker exec -it butkoinfo_core_1 pipenv install
+	pipenv run python setup.py develop
+	pipenv install
+
+

muscles_cli-1.0.0/src/muscles/cli/__about__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+__name__ = "Muscular CLI Framework"
+__version__ = "1.0.0.dev"
+__description__ = (
+    "Muscular CLI Framework"
+)

muscles_cli-1.0.0/src/muscles/cli/__init__.py

@@ -0,0 +1,66 @@
+from .cli import Colors
+from .cli import Command
+from .cli import Argument
+from .cli import Group
+from .cli import Console
+from .cli import cli
+from .cli import argsparse
+from .cli import CliStrategy
+from .cli import ConsoleErrorHandler
+from .streaming import CliStreamRenderResult
+from .streaming import render_stream_result
+from .tooling import build_capabilities_payload
+from .tooling import build_inspection_payload
+from .tooling import detect_project_root
+from .tooling import generate_artifact
+from .tooling import load_app_from_entrypoint
+from .tooling import main
+from .tooling import run_doctor
+from .tooling import run_project_tests
+from .tooling import scaffold_project
+
+
+_TOOLING_EXPORTS = {
+    "scaffold_project",
+    "main",
+    "build_capabilities_payload",
+    "load_app_from_entrypoint",
+    "build_inspection_payload",
+    "generate_artifact",
+    "detect_project_root",
+    "run_doctor",
+    "run_project_tests",
+}
+
+
+def __getattr__(name):
+    if name in _TOOLING_EXPORTS:
+        import importlib
+
+        tooling = importlib.import_module(".tooling", __name__)
+        return getattr(tooling, name)
+    raise AttributeError(name)
+
+
+__all__ = (
+    "Colors",
+    "Command",
+    "Argument",
+    "Group",
+    "Console",
+    "cli",
+    "argsparse",
+    "CliStrategy",
+    "ConsoleErrorHandler",
+    "scaffold_project",
+    "build_capabilities_payload",
+    "load_app_from_entrypoint",
+    "build_inspection_payload",
+    "generate_artifact",
+    "detect_project_root",
+    "run_doctor",
+    "run_project_tests",
+    "CliStreamRenderResult",
+    "render_stream_result",
+    "main",
+)

muscles_cli-1.0.0/src/muscles/cli/__main__.py

@@ -0,0 +1,5 @@
+from .tooling import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

muscles_cli-1.0.0/src/muscles/cli/cli/__init__.py

@@ -0,0 +1,6 @@
+from .colory import Colors
+from .command import Command, Argument, Group
+from .instance import Console, cli
+from .func import argsparse
+from .strategy import CliStrategy
+from .error_handler import ConsoleErrorHandler

muscles_cli-1.0.0/src/muscles/cli/cli/cli.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class CliCommand(ABC):
+    """
+    Интерфейс консольной команды или группы
+
+    """
+
+    _key = None
+    _parent = None
+
+    @property
+    def parent(self) -> CliCommand | None:
+        return self._parent
+
+    @parent.setter
+    def parent(self, parent: CliCommand | None):
+        self._parent = parent
+
+    @property
+    def key(self) -> list[str]:
+        return self._key or []
+
+    @key.setter
+    def key(self, key) -> None:
+        self._key = key
+
+    def add(self, command) -> None:
+        pass
+
+    def remove(self, command) -> None:
+        pass
+
+    @abstractmethod
+    def execute(self, *args, **kwargs) -> Any:
+        """
+        Базовый Компонент может сам реализовать некоторое поведение по умолчанию
+        или поручить это конкретным классам, объявив метод, содержащий поведение
+        абстрактным.
+        """
+        pass

muscles_cli-1.0.0/src/muscles/cli/cli/colory.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+
+class Colors:
+    HEADER = '\033[95m'
+    OKBLUE = '\033[94m'
+    OKCYAN = '\033[96m'
+    OKGREEN = '\033[92m'
+    WARNING = '\033[93m'
+    FAIL = '\033[91m'
+    ENDC = '\033[0m'
+    BOLD = '\033[1m'
+    UNDERLINE = '\033[4m'
+
+