panda-cli 0.1.0__tar.gz

panda_cli-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

panda_cli-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: panda-cli
+Version: 0.1.0
+Summary: Add your description here
+Author-email: meleshuk0804@gmail.com
+Requires-Python: >=3.12
+Requires-Dist: click>=8.3.1
+Requires-Dist: pydantic>=2.12.5

panda_cli-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "panda-cli"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { email = "meleshuk0804@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "click>=8.3.1",
+    "pydantic>=2.12.5",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/panda-cli"]
+
+[dependency-groups]
+dev = [
+    "mypy>=1.19.1",
+    "ruff>=0.15.4",
+    "twine>=6.2.0",
+]

panda_cli-0.1.0/src/_temp/__init__.py

@@ -0,0 +1,6 @@
+from .base_tree import BaseCommand, BaseGroup
+from .base_option import Option
+
+__all__ = ["BaseCommand", "BaseGroup", "Option"]
+
+__version__ = "0.1.0"

panda_cli-0.1.0/src/_temp/base_option.py

@@ -0,0 +1,99 @@
+from __future__ import annotations
+
+import typing as t
+
+from pydantic.fields import FieldInfo
+from pydantic_core import PydanticUndefined
+
+
+# ---------------------------------------------------------------------------
+# Option — симбиоз pydantic.Field + click метаданных
+# ---------------------------------------------------------------------------
+
+_CLICK_META_KEY = "__click_meta__"
+
+
+class OptionMeta(t.TypedDict, total=False):
+    flags: t.Sequence[str]
+    """Click-специфичные параметры, хранящиеся внутри FieldInfo.metadata."""
+    show_default: bool | str | None
+    prompt: bool | str
+    confirmation_prompt: bool | str
+    prompt_required: bool
+    hide_input: bool
+    is_flag: bool | None
+    flag_value: t.Any
+    multiple: bool
+    count: bool
+    allow_from_autoenv: bool
+    hidden: bool
+    show_choices: bool
+    show_envvar: bool
+    deprecated: bool | str
+
+
+def Option(
+    *flags: str,
+    # pydantic Field-совместимые
+    default: t.Any = PydanticUndefined,
+    description: str | None = None,
+    # click-специфичные
+    show_default: bool | str | None = None,
+    prompt: bool | str = False,
+    confirmation_prompt: bool | str = False,
+    prompt_required: bool = True,
+    hide_input: bool = False,
+    is_flag: bool | None = None,
+    flag_value: t.Any | None = None,
+    multiple: bool = False,
+    count: bool = False,
+    allow_from_autoenv: bool = True,
+    hidden: bool = False,
+    show_choices: bool = True,
+    show_envvar: bool = False,
+    deprecated: bool | str = False,
+    **field_kwargs: t.Any,
+) -> t.Any:
+    """
+    Замена/расширение pydantic.Field с поддержкой click-параметров.
+    Можно использовать вместо Field, сохраняя все возможности Pydantic.
+    """
+    from pydantic import Field
+
+    click_meta: OptionMeta = dict(  # type: ignore[assignment]
+        flags=flags,
+        show_default=show_default,
+        prompt=prompt,
+        confirmation_prompt=confirmation_prompt,
+        prompt_required=prompt_required,
+        hide_input=hide_input,
+        is_flag=is_flag,
+        flag_value=flag_value,
+        multiple=multiple,
+        count=count,
+        allow_from_autoenv=allow_from_autoenv,
+        hidden=hidden,
+        show_choices=show_choices,
+        show_envvar=show_envvar,
+        deprecated=deprecated,
+    )
+    # if param_decls:
+    #     click_meta["param_decls"] = param_decls
+
+    kw: dict[str, t.Any] = dict(description=description, **field_kwargs)
+    if default is not PydanticUndefined:
+        kw["default"] = default
+
+    field = Field(**kw)
+    # Прячем click-мету в metadata списке FieldInfo
+    object.__setattr__(
+        field, "metadata", [*field.metadata, {_CLICK_META_KEY: click_meta}]
+    )
+    return field
+
+
+def get_click_meta(field: FieldInfo) -> OptionMeta:
+    for item in field.metadata:
+        if isinstance(item, dict) and _CLICK_META_KEY in item:
+            return item[_CLICK_META_KEY]
+    return {}  # type: ignore[return-value]

panda_cli-0.1.0/src/_temp/base_tree.py

@@ -0,0 +1,127 @@
+from __future__ import annotations
+
+import typing as t
+import collections.abc as cabc
+
+import click
+from pydantic import BaseModel, ConfigDict
+
+from _temp.option_contstructor import field_to_click_option
+
+
+class BaseCommand(BaseModel):
+    """
+    Базовый класс команды.
+    Поля (Option / Field) автоматически становятся click-опциями.
+    Переопределите __call__ для логики команды.
+    """
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    # -- внутреннее построение ----------------------------------------------
+
+    @classmethod
+    def _build_click_params(cls) -> list[click.Option]:
+        hints = t.get_type_hints(cls)
+        params: list[click.Option] = []
+        for name, field in cls.model_fields.items():
+            ann = hints.get(name, field.annotation)
+            # Пропускаем поля, тип которых сам является BaseCommand/BaseGroup
+            if isinstance(ann, type) and issubclass(ann, (BaseCommand, BaseGroup)):
+                continue
+            params.append(field_to_click_option(name, field, ann))
+        return params
+
+    @classmethod
+    def _build_click_command(cls, field_name: str) -> click.Command:
+        def _callback(**kwargs: t.Any) -> t.Any:
+            instance = cls(**kwargs)
+            return instance()
+
+        return click.Command(
+            name=cls._cli_name(field_name),
+            params=cls._build_click_params(),  # type: ignore
+            callback=_callback,
+            help=cls.__doc__,
+        )
+
+    @classmethod
+    def _cli_name(cls, field_name: str) -> str:
+        # Можно переопределить через ClassVar или оставить авто
+        override = getattr(cls, "__cli_name__", None)
+        return override or field_name
+
+    # -- публичный интерфейс ------------------------------------------------
+
+    def __call__(self) -> t.Any:
+        """Логика команды. Переопределите в подклассе."""
+        raise NotImplementedError(f"{self.__class__.__name__}.__call__ not implemented")
+
+    @classmethod
+    def run(cls, args: cabc.Sequence[str] | None = None) -> None:
+        """Запустить команду как самостоятельный CLI."""
+        cls._build_click_command()(standalone_mode=True, args=args)
+
+
+class BaseGroup(BaseModel):
+    """
+    Базовый класс группы.
+    Поля, тип которых — подкласс BaseCommand, автоматически становятся
+    подкомандами. Остальные поля — групповые опции.
+
+    Пример::
+
+        class CLI(BaseGroup):
+            __cli_name__ = "my-cli"
+
+            deploy:  DeployCommand
+            migrate: MigrateCommand
+    """
+
+    __cli_name__: t.ClassVar[str | None] = None
+
+    model_config = {"arbitrary_types_allowed": True}
+
+    @classmethod
+    def _cli_name(cls, field_name: str | None) -> str:
+        override = getattr(cls, "__cli_name__", None)
+        return override or field_name or cls.__name__.lower().removesuffix("group").removesuffix("cli")
+
+    @classmethod
+    def _build_click_group(cls, _field_name: str | None = None) -> click.Group:
+        hints = t.get_type_hints(cls)
+
+        group_params: list[click.Option] = []
+        subcommands: list[click.Command] = []
+
+        for field_name, field in cls.model_fields.items():
+            ann = hints.get(field_name, field.annotation)
+            # Поле-команда → подкоманда группы
+            if isinstance(ann, type) and issubclass(ann, BaseCommand):
+                subcommands.append(ann._build_click_command(field_name))
+            # Поле-группа → вложенная группа
+            elif isinstance(ann, type) and issubclass(ann, BaseGroup):
+                subcommands.append(ann._build_click_group(field_name))
+            # Всё остальное → групповая опция
+            else:
+                group_params.append(field_to_click_option(field_name, field, ann))
+
+        def _callback(**kwargs: t.Any) -> None:
+            pass
+
+        grp = click.Group(
+            name=cls._cli_name(_field_name),
+            params=group_params,
+            callback=_callback,
+            invoke_without_command=True,
+            help=cls.__doc__,
+        )
+        for cmd in subcommands:
+            grp.add_command(cmd)
+
+        return grp
+
+    @classmethod
+    def run(cls, args: cabc.Sequence[str] | None = None) -> None:
+        """Запустить группу как корневой CLI."""
+        cls._build_click_group()(standalone_mode=True, args=args)

panda_cli-0.1.0/src/_temp/option_contstructor.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+import typing as t
+
+import click
+from pydantic.fields import FieldInfo
+from pydantic_core import PydanticUndefined
+
+from _temp.base_option import get_click_meta
+from _temp.tools import _is_bool_flag, _is_multiple, _resolve_click_type
+
+
+def field_to_click_option(
+    field_name: str,
+    field: FieldInfo,
+    annotation: t.Any,
+) -> click.Option:
+    meta = get_click_meta(field)
+
+    flags = list(meta.get("flags", ()))
+    flags.append(f"--{field_name.replace('_', '-')}")
+
+    has_default = field.default is not PydanticUndefined
+    default = (
+        field.default
+        if has_default
+        else (field.default_factory() if field.default_factory else None)  # type: ignore
+    )
+    required = not has_default and field.default_factory is None  # type: ignore
+
+    multiple = meta.get("multiple", _is_multiple(annotation))
+    is_flag  = meta.get("is_flag",  _is_bool_flag(annotation) and not multiple)
+    click_type = _resolve_click_type(annotation)
+
+    return click.Option(
+        param_decls=flags,
+        type=None if is_flag else click_type,   # ← ключевой фикс
+        default=default,
+        required=required,
+        multiple=multiple,
+        is_flag=is_flag,
+        # ← не передаём flag_value вообще если None
+        **({"flag_value": meta["flag_value"]} if meta.get("flag_value") is not None else {}),
+        help=field.description,
+        show_default=meta.get("show_default", has_default),
+        prompt=meta.get("prompt", False),
+        confirmation_prompt=meta.get("confirmation_prompt", False),
+        prompt_required=meta.get("prompt_required", True),
+        hide_input=meta.get("hide_input", False),
+        count=meta.get("count", False),
+        allow_from_autoenv=meta.get("allow_from_autoenv", True),
+        hidden=meta.get("hidden", False),
+        show_choices=meta.get("show_choices", True),
+        show_envvar=meta.get("show_envvar", False),
+        deprecated=meta.get("deprecated", False),
+    )

panda_cli-0.1.0/src/_temp/tools.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import types
+import typing as t
+
+import click
+
+
+
+_TYPE_MAP_CLICK: t.Final[dict[t.Any, t.Any]] = {
+    str: click.STRING,
+    int: click.INT,
+    float: click.FLOAT,
+    bool: click.BOOL,
+    bytes: click.STRING,
+}
+
+
+def _resolve_click_type(annotation: t.Any) -> click.ParamType:
+    origin = t.get_origin(annotation)
+
+    # Optional[X] | X | None
+    if origin in (t.Union, types.UnionType):
+        args = [a for a in t.get_args(annotation) if a is not type(None)]
+        if len(args) == 1:
+            return _resolve_click_type(args[0])
+
+    # Literal["a", "b"] → Choice
+    if origin is t.Literal:
+        return click.Choice([str(c) for c in t.get_args(annotation)])
+
+    # list[X] / set[X] → тип элемента (multiple обрабатывается отдельно)
+    if origin in (list, tuple, set, frozenset):
+        args = t.get_args(annotation)  # type: ignore
+        return _resolve_click_type(args[0]) if args else click.STRING
+
+    return _TYPE_MAP_CLICK.get(annotation, click.STRING)
+
+
+def _is_multiple(annotation: t.Any) -> bool:
+    origin = t.get_origin(annotation)
+    if origin in (t.Union, types.UnionType):
+        args = [a for a in t.get_args(annotation) if a is not type(None)]
+        return _is_multiple(args[0]) if len(args) == 1 else False
+    return origin in (list, tuple, set, frozenset)
+
+
+def _is_bool_flag(annotation: t.Any) -> bool:
+    origin = t.get_origin(annotation)
+    if origin in (t.Union, types.UnionType):
+        args = [a for a in t.get_args(annotation) if a is not type(None)]
+        return _is_bool_flag(args[0]) if len(args) == 1 else False
+    return annotation is bool
+

panda_cli-0.1.0/src/clipy1 copy/base_tree.py

@@ -0,0 +1,127 @@
+from __future__ import annotations
+
+import typing as t
+import collections.abc as cabc
+
+import click
+from pydantic import BaseModel, ConfigDict
+
+from _temp.option_contstructor import field_to_click_option
+
+
+class BaseCommand(BaseModel):
+    """
+    Базовый класс команды.
+    Поля (Option / Field) автоматически становятся click-опциями.
+    Переопределите __call__ для логики команды.
+    """
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    # -- внутреннее построение ----------------------------------------------
+
+    @classmethod
+    def _build_click_params(cls) -> list[click.Option]:
+        hints = t.get_type_hints(cls)
+        params: list[click.Option] = []
+        for name, field in cls.model_fields.items():
+            ann = hints.get(name, field.annotation)
+            # Пропускаем поля, тип которых сам является BaseCommand/BaseGroup
+            if isinstance(ann, type) and issubclass(ann, (BaseCommand, BaseGroup)):
+                continue
+            params.append(field_to_click_option(name, field, ann))
+        return params
+
+    @classmethod
+    def _build_click_command(cls, field_name: str) -> click.Command:
+        def _callback(**kwargs: t.Any) -> t.Any:
+            instance = cls(**kwargs)
+            return instance()
+
+        return click.Command(
+            name=cls._cli_name(field_name),
+            params=cls._build_click_params(),  # type: ignore
+            callback=_callback,
+            help=cls.__doc__,
+        )
+
+    @classmethod
+    def _cli_name(cls, field_name: str) -> str:
+        # Можно переопределить через ClassVar или оставить авто
+        override = getattr(cls, "__cli_name__", None)
+        return override or field_name
+
+    # -- публичный интерфейс ------------------------------------------------
+
+    def __call__(self) -> t.Any:
+        """Логика команды. Переопределите в подклассе."""
+        raise NotImplementedError(f"{self.__class__.__name__}.__call__ not implemented")
+
+    @classmethod
+    def run(cls, args: cabc.Sequence[str] | None = None) -> None:
+        """Запустить команду как самостоятельный CLI."""
+        cls._build_click_command()(standalone_mode=True, args=args)
+
+
+class BaseGroup(BaseModel):
+    """
+    Базовый класс группы.
+    Поля, тип которых — подкласс BaseCommand, автоматически становятся
+    подкомандами. Остальные поля — групповые опции.
+
+    Пример::
+
+        class CLI(BaseGroup):
+            __cli_name__ = "my-cli"
+
+            deploy:  DeployCommand
+            migrate: MigrateCommand
+    """
+
+    __cli_name__: t.ClassVar[str | None] = None
+
+    model_config = {"arbitrary_types_allowed": True}
+
+    @classmethod
+    def _cli_name(cls, field_name: str | None) -> str:
+        override = getattr(cls, "__cli_name__", None)
+        return override or field_name or cls.__name__.lower().removesuffix("group").removesuffix("cli")
+
+    @classmethod
+    def _build_click_group(cls, _field_name: str | None = None) -> click.Group:
+        hints = t.get_type_hints(cls)
+
+        group_params: list[click.Option] = []
+        subcommands: list[click.Command] = []
+
+        for field_name, field in cls.model_fields.items():
+            ann = hints.get(field_name, field.annotation)
+            # Поле-команда → подкоманда группы
+            if isinstance(ann, type) and issubclass(ann, BaseCommand):
+                subcommands.append(ann._build_click_command(field_name))
+            # Поле-группа → вложенная группа
+            elif isinstance(ann, type) and issubclass(ann, BaseGroup):
+                subcommands.append(ann._build_click_group(field_name))
+            # Всё остальное → групповая опция
+            else:
+                group_params.append(field_to_click_option(field_name, field, ann))
+
+        def _callback(**kwargs: t.Any) -> None:
+            pass
+
+        grp = click.Group(
+            name=cls._cli_name(_field_name),
+            params=group_params,
+            callback=_callback,
+            invoke_without_command=True,
+            help=cls.__doc__,
+        )
+        for cmd in subcommands:
+            grp.add_command(cmd)
+
+        return grp
+
+    @classmethod
+    def run(cls, args: cabc.Sequence[str] | None = None) -> None:
+        """Запустить группу как корневой CLI."""
+        cls._build_click_group()(standalone_mode=True, args=args)

panda_cli-0.1.0/src/clipy1 copy/option_contstructor.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+import typing as t
+
+import click
+from pydantic.fields import FieldInfo
+from pydantic_core import PydanticUndefined
+
+from _temp.base_option import get_click_meta
+from _temp.tools import _is_bool_flag, _is_multiple, _resolve_click_type
+
+
+def field_to_click_option(
+    field_name: str,
+    field: FieldInfo,
+    annotation: t.Any,
+) -> click.Option:
+    meta = get_click_meta(field)
+
+    flags = list(meta.get("flags", ()))
+    flags.append(f"--{field_name.replace('_', '-')}")
+
+    has_default = field.default is not PydanticUndefined
+    default = (
+        field.default
+        if has_default
+        else (field.default_factory() if field.default_factory else None)  # type: ignore
+    )
+    required = not has_default and field.default_factory is None  # type: ignore
+
+    multiple = meta.get("multiple", _is_multiple(annotation))
+    is_flag  = meta.get("is_flag",  _is_bool_flag(annotation) and not multiple)
+    click_type = _resolve_click_type(annotation)
+
+    return click.Option(
+        param_decls=flags,
+        type=None if is_flag else click_type,   # ← ключевой фикс
+        default=default,
+        required=required,
+        multiple=multiple,
+        is_flag=is_flag,
+        # ← не передаём flag_value вообще если None
+        **({"flag_value": meta["flag_value"]} if meta.get("flag_value") is not None else {}),
+        help=field.description,
+        show_default=meta.get("show_default", has_default),
+        prompt=meta.get("prompt", False),
+        confirmation_prompt=meta.get("confirmation_prompt", False),
+        prompt_required=meta.get("prompt_required", True),
+        hide_input=meta.get("hide_input", False),
+        count=meta.get("count", False),
+        allow_from_autoenv=meta.get("allow_from_autoenv", True),
+        hidden=meta.get("hidden", False),
+        show_choices=meta.get("show_choices", True),
+        show_envvar=meta.get("show_envvar", False),
+        deprecated=meta.get("deprecated", False),
+    )

panda_cli-0.1.0/src/pandpa-cli/__init__.py

@@ -0,0 +1,6 @@
+from .base import BaseCommand, BaseGroup
+from .option import Option
+
+__all__ = ["BaseCommand", "BaseGroup", "Option"]
+
+__version__ = "0.1.0"