click-extended 1.0.1__tar.gz → 1.0.2__tar.gz

{click_extended-1.0.1/click_extended.egg-info → click_extended-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: click_extended
-Version: 1.0.1
+Version: 1.0.2
 Summary: An extension to Click with additional features like automatic async support, aliasing and a modular decorator system.
 Author-email: Marcus Fredriksson <marcus@marcusfredriksson.com>
 License: MIT License

{click_extended-1.0.1 → click_extended-1.0.2}/click_extended/__init__.py

@@ -2,6 +2,7 @@
 
 from click_extended.core.decorators.argument import argument
 from click_extended.core.decorators.command import command
+from click_extended.core.decorators.context import context
 from click_extended.core.decorators.env import env
 from click_extended.core.decorators.group import group
 from click_extended.core.decorators.option import option
@@ -12,6 +13,7 @@ from click_extended.core.decorators.tag import tag
 __all__ = [
     "argument",
     "command",
+    "context",
     "env",
     "group",
     "option",

click_extended-1.0.2/click_extended/core/decorators/context.py

@@ -0,0 +1,56 @@
+"""`ParentNode` to inject the context into the function."""
+
+# pylint: disable=redefined-builtin
+# pylint: disable=redefined-outer-name
+
+from typing import Any
+
+from click_extended.core.nodes.parent_node import ParentNode
+from click_extended.core.other.context import Context as Ctx
+from click_extended.types import Decorator
+
+
+class Context(ParentNode):
+    """`ParentNode` to inject the context into the function."""
+
+    def load(self, context: Ctx, *args: Any, **kwargs: Any) -> Ctx:
+        return context
+
+
+def context(
+    name: str = "ctx",
+    param: str | None = None,
+    help: str | None = None,
+    tags: str | list[str] | None = None,
+    **kwargs: Any,
+) -> Decorator:
+    """
+    A `ParentNode` to inject the context into the function.
+
+    Type: `ParentNode`
+
+    Args:
+        name (str, optional):
+            Internal node name (must be snake_case). Defaults
+            to "ctx".
+        param (str, optional):
+            The parameter name to inject into the function.
+            If not provided, uses `name` (or derived name).
+        help (str, optional):
+            Help text for this parameter.
+        tags (str | list[str], optional):
+            Tag(s) to associate with this parameter for grouping.
+        **kwargs (Any):
+            Additional keyword arguments.
+
+    Returns:
+        Callable:
+            A decorator function that registers the context parent node.
+    """
+    return Context.as_decorator(
+        name=name,
+        param=param,
+        help=help,
+        tags=tags,
+        **kwargs,
+    )

{click_extended-1.0.1 → click_extended-1.0.2/click_extended.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: click_extended
-Version: 1.0.1
+Version: 1.0.2
 Summary: An extension to Click with additional features like automatic async support, aliasing and a modular decorator system.
 Author-email: Marcus Fredriksson <marcus@marcusfredriksson.com>
 License: MIT License

{click_extended-1.0.1 → click_extended-1.0.2}/click_extended.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ click_extended/core/__init__.py
 click_extended/core/decorators/__init__.py
 click_extended/core/decorators/argument.py
 click_extended/core/decorators/command.py
+click_extended/core/decorators/context.py
 click_extended/core/decorators/env.py
 click_extended/core/decorators/group.py
 click_extended/core/decorators/option.py

{click_extended-1.0.1 → click_extended-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "click_extended"
-version = "1.0.1"
+version = "1.0.2"
 description = "An extension to Click with additional features like automatic async support, aliasing and a modular decorator system."
 authors = [
     { name = "Marcus Fredriksson", email = "marcus@marcusfredriksson.com" },