socx-cli 0.13.7__tar.gz → 0.13.9__tar.gz

{socx_cli-0.13.7 → socx_cli-0.13.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: socx-cli
-Version: 0.13.7
+Version: 0.13.9
 Summary: System on chip verification and tooling infrastructure.
 Project-URL: Issues, https://github.com/sagikimhi/socx-cli/issues
 Project-URL: Homepage, https://sagikimhi.dev/socx-cli
@@ -29,6 +29,7 @@ Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
 Requires-Python: >=3.12
 Requires-Dist: anyio[trio]>=4.12.1
+Requires-Dist: blinker>=1.9.0
 Requires-Dist: click
 Requires-Dist: copier~=9.11
 Requires-Dist: declare
@@ -53,6 +54,7 @@ Requires-Dist: sh~=2.2
 Requires-Dist: sqlmodel>=0.0.31
 Requires-Dist: textual
 Requires-Dist: textual-fspicker>=0.6.0
+Requires-Dist: textual-serve>=1.1.3
 Requires-Dist: textual-speedups
 Requires-Dist: typer~=0.19
 Requires-Dist: uv

{socx_cli-0.13.7 → socx_cli-0.13.9}/pyproject.toml

@@ -29,7 +29,7 @@ socx = 'socx.__main__:main'
 [project]
 name = "socx-cli"
 readme = "README.md"
-version = "0.13.7"
+version = "0.13.9"
 license = "Apache-2.0"
 authors = [{ name = "Sagi Kimhi", email = "sagi.kim5@gmail.com" }]
 maintainers = [{ name = "Sagi Kimhi", email = "sagi.kim5@gmail.com" }]
@@ -83,6 +83,8 @@ dependencies = [
     "pydantic-settings>=2.12.0",
     "sqlmodel>=0.0.31",
     "anyio[trio]>=4.12.1",
+    "blinker>=1.9.0",
+    "textual-serve>=1.1.3",
 ]
 
 [project.urls]
@@ -129,7 +131,7 @@ docs = [
     "mkdocs-llmstxt>=0.4.0",
     "mkdocs-coverage",
     "mkdocs-glightbox",
-    "mkdocstrings-python",
+    "mkdocstrings[python]>=0.18",
     "mkdocs-material[git, recommended, imaging]",
     "mkdocs-section-index",
     "griffe-typingdoc>=0.3.0",

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/__init__.py

@@ -90,6 +90,7 @@ __all__ = (
     # config
     "schema",
     "settings",
+    "Model",
     "Script",
     "NewPath",
     "FilePath",
@@ -139,6 +140,7 @@ __all__ = (
 
 from socx.core import enums as enums
 from socx.core import schema as schema
+from socx.core import Model as Model
 from socx.core import Script as Script
 from socx.core import NewPath as NewPath
 from socx.core import FilePath as FilePath

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/cli/callbacks.py

@@ -46,10 +46,12 @@ def cwd_cb(ctx: Context, param: Parameter, value: Path) -> Path:
 def debug_cb(_: Context, param: Parameter, value: bool) -> bool:
     """Enable debug logging and persist the CLI switch to settings."""
     socx_logger = _get_logger()
+    settings[param.name] = value
     settings.cli.params[param.name] = value
     if value:
         set_level(Level.DEBUG, socx_logger)
         settings.cli.params["verbosity"] = get_level().name
+        settings.logging.handlers.console.level = Level.DEBUG.name
     return value
 
 

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/config/_config.py

@@ -10,6 +10,7 @@ from typing import Any
 from pathlib import Path
 
 from werkzeug.local import LocalProxy
+from dynaconf.base import Settings as DynaSettings
 
 from socx.config import converters
 from socx.core import (
@@ -21,7 +22,10 @@ from socx.config._settings import Settings
 from socx.patterns.mixins.proxy import ProxyMixin
 
 
-class SettingsProxy(ProxyMixin[Settings], Settings): ...
+class SettingsProxyBase(Settings, DynaSettings): ...
+
+
+class SettingsProxy(ProxyMixin[SettingsProxyBase], SettingsProxyBase): ...
 
 
 logger = logging.getLogger(__name__)

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/config/converters.py

@@ -25,7 +25,6 @@ from importlib import import_module
 from functools import cached_property, singledispatchmethod
 from collections.abc import Iterable, Callable
 
-import sh
 import rich_click as click
 import rich_click.patch as click_patch
 import rich_click.rich_click_theme as click_theme
@@ -310,8 +309,8 @@ class SymbolConverter(Converter[str | Lazy, Any]):
 
 class CommandConverter(
     Converter[
-        str | Lazy | sh.Command | click.Command | PluginModel,
-        str | Lazy | click.Command,
+        str | Lazy | BaseCommand | click.Command | PluginModel,
+        str | Lazy | click.Command | click.Group,
     ]
 ):
     """Turn module or script references into Rich Click commands."""
@@ -351,7 +350,7 @@ class CommandConverter(
     @overload
     def __call__(
         self,
-        value: sh.Command,
+        value: BaseCommand,
         *args: Any,
         **kwargs: Any,
     ) -> click.Command: ...
@@ -374,10 +373,10 @@ class CommandConverter(
     @_validate
     def __call__(
         self,
-        value: str | Lazy | sh.Command | click.Command | PluginModel,
+        value: str | Lazy | BaseCommand | click.Command | PluginModel,
         *args: Any,
         **kwargs: Any,
-    ) -> Lazy | click.Command | click.Group:
+    ) -> str | Lazy | click.Command | click.Group:
         """Build a Click command from dotted paths or reuse existing ones."""
         if isinstance(value, Lazy):
             if value.casting is self:
@@ -401,9 +400,9 @@ class CommandConverter(
             nonlocal value
 
             if TYPE_CHECKING:
-                value = cast(str | sh.Command | PluginModel, value)
+                value = cast(str | BaseCommand | PluginModel, value)
 
-            if isinstance(value, sh.Command):
+            if isinstance(value, str | BaseCommand):
                 return self._run_shell_script(value, *args)
 
             if isinstance(value, PluginModel) and value.is_script():
@@ -679,7 +678,7 @@ class CommandConverter(
         )
 
     def is_shell_command(self, value: Any) -> bool:
-        return isinstance(value, sh.Command)
+        return isinstance(value, BaseCommand)
 
     def is_click_command(self, value: Any) -> bool:
         return isinstance(value, click.Command)

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/core/__init__.py

@@ -7,6 +7,7 @@ __all__ = (
     "schema",
     "metadata",
     # types
+    "Model",
     "Script",
     "NewPath",
     "FilePath",
@@ -57,6 +58,7 @@ from . import paths as paths
 from . import schema as schema
 from . import metadata as metadata
 
+from socx.core.schema import Model as Model
 from socx.core.schema import Script as Script
 from socx.core.schema import NewPath as NewPath
 from socx.core.schema import FilePath as FilePath

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/core/enums.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import enum
 from typing import Self
 from pathlib import Path
-from functools import cache
 
 
 class AutoNumber(int, enum.ReprEnum):
@@ -18,22 +17,20 @@ class AutoNumber(int, enum.ReprEnum):
 
 
 class SettingsFormat(AutoNumber):
-    Json = ".json"
-    Yaml = ".yaml", ".yml"
+    Ini = ".ini", ".conf"
     Toml = ".toml"
-    Ini = ".ini"
-    Python = ".python"
+    Yaml = ".yaml", ".yml"
+    Json = ".json", ".jsonc", ".json5"
+    Python = ".py"
 
     def __init__(self, extension: str, *extensions: str) -> None:
         self.extensions = {extension, *extensions}
 
     @classmethod
-    @cache
     def all_extensions(cls) -> set[str]:
         return {extension for member in cls for extension in member.extensions}
 
     @classmethod
-    @cache
     def from_path(cls, path: str | Path) -> SettingsFormat:
         if isinstance(path, str):
             path = Path(path)

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/core/schema/__init__.py

@@ -2,6 +2,7 @@ __all__ = (
     "git",
     "types",
     "plugin",
+    "Model",
     "Script",
     "NewPath",
     "FilePath",
@@ -15,6 +16,7 @@ from . import plugin as plugin
 
 from .git import git as git
 
+from socx.core.schema.types import Model as Model
 from socx.core.schema.types import Script as Script
 from socx.core.schema.types import NewPath as NewPath
 from socx.core.schema.types import FilePath as FilePath

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/core/schema/plugin.py

@@ -7,18 +7,14 @@ from pathlib import Path
 
 from box import SBox
 import rich_click as click
-from pydantic import Field, BaseModel, ConfigDict
+from pydantic import Field
 
-from socx.core.schema.types import DirectoryPath, Script
+from socx.core.schema.types import DirectoryPath, Script, Model
 
 
-class PluginModel(BaseModel):
+class PluginModel(Model):
     """Metadata describing a plugin-backed CLI command."""
 
-    name: str = Field(
-        ..., pattern=r"[a-zA-Z0-9_-]+", description="Name of the plugin."
-    )
-
     cwd: DirectoryPath = Field(
         default_factory=Path.cwd,
         description=dedent("""
@@ -29,83 +25,89 @@ class PluginModel(BaseModel):
 
     env: dict[str, str] = Field(
         default_factory=dict,
-        description="""
-            Environment variables that should be present when the
-            command/script is invoked
-        """.strip(),
+        description=dedent("""
+        Environment variables that should be present when the
+        command/script is invoked
+        """),
+    )
+
+    name: str = Field(
+        ..., pattern=r"[a-zA-Z0-9_-]+", description="Name of the plugin."
+    )
+
+    help: str = Field(
+        default="",
+        description=dedent("""
+        Description of what the plugin does to be printed during plugin
+        invocation if any of -h or --help flags were passed with the
+        command.
+        """),
+    )
+
+    enabled: bool = Field(
+        True,
+        description=dedent("""
+        Enable/disable the plugin. Disabled plugins are hidden and cannot be
+        invoked from the commandline. Defaults to True.
+        """),
     )
 
     timeout: float | None = Field(
-        default=None,
+        None,
         ge=0,
-        description="""
+        description=dedent("""
         An optional timeout in seconds for the plugin execution.
         If left unspecified, then plugin execution may last indefinitely.
-        """,
-    )
-
-    enabled: bool = Field(
-        default=True,
-        description="""
-            Whether or not the plugin should be enabled.
-            If left unspecified, defaults to True.
-        """,
+        """),
     )
 
     fresh_env: bool = Field(
-        default=False,
-        description="""
-            Whether or not to execute the plugin in a fresh environment.
-            A fresh environment is an environment with no environment
-            variables defined other than those defined in the ``env`` field.
-            A non-fresh environment will contain all environment variables of
-            the current process, as well as any variables defined in the
-            ``env`` field.
-            If left unspecified, defaults to False.
-        """,
+        False,
+        description=dedent("""
+        Whether or not to execute the plugin in a fresh environment.
+        A fresh environment is an environment with no environment
+        variables defined other than those defined in the ``env`` field.
+        A non-fresh environment will contain all environment variables of
+        the current process, as well as any variables defined in the
+        ``env`` field.
+        If left unspecified, defaults to False.
+        """),
     )
 
     script: Script = Field(
-        default="",
-        description="""
-            A shell command or a path to an executable file to run on plugin
-            invocation.
-        """.strip(),
+        "",
+        description=dedent("""
+        A shell command or a path to an executable file to run on plugin
+        invocation.
+        """),
+        exclude_if=bool,
     )
 
     command: str | click.Command = Field(
         default="",
         pattern=r"(((((\w+)(.|/))*)(\w+))(:(\w+))?)?",
-        description="""
-            A path to a python module or symbol that will be called upon
-            plugin invocation specified in the form of
-            `<module_path/file_path>[:<symbol_name>]`.
-        """.strip(),
-    )
-
-    help: str = Field(
-        default="",
-        description="""
-        Description of what the plugin does to be printed during plugin
-        invocation if any of -h or --help flags were passed with the
-        command.
-    """.strip(),
+        exclude_if=bool,
+        description=dedent("""
+        A path to a python module or symbol that will be called upon
+        plugin invocation specified in the form of
+        `<module_path/file_path>[:<symbol_name>]`.
+        """),
     )
 
     panel: str = Field(
         default="Plugins",
-        description="""
+        description=dedent("""
         Custom panel name in which plugin help text will be displayed when
         CLI is invoked with the -h/--help flag.
-        """.strip(),
+        """),
     )
 
     epilog: str = Field(
         default="",
-        description="""
-            Help string printed at the end of the help page after everything
-            else.
-        """.strip(),
+        description=dedent("""
+        Help string printed at the end of the help page after everything
+        else.
+        """),
     )
 
     aliases: tuple[str, ...] = Field(
@@ -118,12 +120,6 @@ class PluginModel(BaseModel):
         description="The short help to use for this command",
     )
 
-    model_config = ConfigDict(
-        extra="allow",
-        from_attributes=True,
-        arbitrary_types_allowed=True,
-    )
-
     def is_script(self) -> bool:
         return bool(self.script)
 

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/core/schema/types.py

@@ -13,6 +13,8 @@ from pydantic import (
     GetJsonSchemaHandler,
     BeforeValidator,
     PlainSerializer,
+    ConfigDict,
+    BaseModel,
 )
 
 
@@ -232,3 +234,11 @@ Script = Annotated[
     BeforeValidator(validate_script),
     PlainSerializer(str, str),
 ]
+
+
+class Model(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+        from_attributes=True,
+        arbitrary_types_allowed=True,
+    )

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/io/console.py

@@ -121,7 +121,7 @@ _console_cv = contextvars.ContextVar[Console]("console")
 
 _console_cv.set(_console)
 
-console: ConsoleProxy = LocalProxy(  # type: ignore[assignment]
+console: ConsoleProxy = LocalProxy(
     _console_cv,
     unbound_message="""
     Working outside of application context.
@@ -129,4 +129,4 @@ console: ConsoleProxy = LocalProxy(  # type: ignore[assignment]
     Attempted to use functionality that expected a current application to
     be set. To solve this, set up an app context.
     """,
-)
+)  # ty:ignore[invalid-assignment]

{socx_cli-0.13.7 → socx_cli-0.13.9}/socx/io/log.py

@@ -139,26 +139,26 @@ def _get_file_handler(
     tracebacks_suppress: Iterable[ModuleType] | None = None,
     tracebacks_show_locals: bool = True,
 ) -> logging.Handler:
-    import atexit
 
     def close_if_open(file: IO) -> None:
         if not file.closed:
             file.close()
 
     mode = mode or "a"
-    file = open(path, mode=mode)  # noqa: SIM115
-    atexit.register(close_if_open, file)
-    handler = _get_console_handler(
-        file=file,
-        level=level,
-        stderr=stderr,
-        tab_size=tab_size,
-        tracebacks=tracebacks,
-        force_terminal=force_terminal,
-        tracebacks_theme=tracebacks_theme,
-        tracebacks_suppress=tracebacks_suppress,
-        tracebacks_show_locals=tracebacks_show_locals,
-    )
+    # file = open(path, mode=mode)
+    # atexit.register(close_if_open, file)
+    # handler = _get_console_handler(
+    #     file=file,
+    #     level=level,
+    #     stderr=stderr,
+    #     tab_size=tab_size,
+    #     tracebacks=tracebacks,
+    #     force_terminal=force_terminal,
+    #     tracebacks_theme=tracebacks_theme,
+    #     tracebacks_suppress=tracebacks_suppress,
+    #     tracebacks_show_locals=tracebacks_show_locals,
+    # )
+    handler = logging.handlers.WatchedFileHandler(path, mode)
     handler.name = "file"
     handler.setFormatter(DEFAULT_CHILD_FORMATTER)
     return handler