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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: click_extended
-Version: 1.0.2
+Version: 1.0.4
 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
@@ -96,6 +96,7 @@ An extension of the [Click](https://github.com/pallets/click) library with addit
 - **Full Type Support**: Built with type-hinting from the ground up, meaning everything is fully typed.
 - **Improved Errors**: Improved error output like tips, debugging, and more.
 - **Short Flag Concatenation**: Automatically support concatenating short hand flags where `-r -f` is the same as `-rf`.
+- **Global state**: Access global state through the context's `data` property.
 
 ## Installation
 

{click_extended-1.0.2 → click_extended-1.0.4}/README.md

@@ -26,6 +26,7 @@ An extension of the [Click](https://github.com/pallets/click) library with addit
 - **Full Type Support**: Built with type-hinting from the ground up, meaning everything is fully typed.
 - **Improved Errors**: Improved error output like tips, debugging, and more.
 - **Short Flag Concatenation**: Automatically support concatenating short hand flags where `-r -f` is the same as `-rf`.
+- **Global state**: Access global state through the context's `data` property.
 
 ## Installation
 

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

@@ -9,12 +9,14 @@ from click_extended.core.decorators.option import option
 from click_extended.core.decorators.prompt import prompt
 from click_extended.core.decorators.selection import selection
 from click_extended.core.decorators.tag import tag
+from click_extended.core.other.get_context import get_context
 
 __all__ = [
     "argument",
     "command",
     "context",
     "env",
+    "get_context",
     "group",
     "option",
     "prompt",

{click_extended-1.0.2 → click_extended-1.0.4}/click_extended/core/other/__init__.py

@@ -1,7 +1,9 @@
 """Initialization file for the `click_extended.core.other` module."""
 
 from click_extended.core.other.context import Context
+from click_extended.core.other.get_context import get_context
 
 __all__ = [
     "Context",
+    "get_context",
 ]

{click_extended-1.0.2 → click_extended-1.0.4}/click_extended/core/other/_tree.py

@@ -220,6 +220,15 @@ class Tree:
             "yes",
         )
 
+        parent_data: dict[str, Any] | None = None
+        if context.parent is not None:
+            parent_meta = context.parent.meta.get("click_extended", {})
+            parent_data = parent_meta.get("data")
+
+        data: dict[str, Any] = (
+            parent_data if isinstance(parent_data, dict) else {}
+        )
+
         context.meta["click_extended"] = {
             "current_scope": "root",
             "root_node": root_node,
@@ -228,7 +237,7 @@ class Tree:
             "parents": parents_dict,
             "tags": root_node.tree.tags,
             "children": children_dict,
-            "data": {},
+            "data": data,
             "debug": debug,
         }
 

click_extended-1.0.4/click_extended/core/other/get_context.py

@@ -0,0 +1,105 @@
+"""Function to get the active context."""
+
+# pylint: disable=too-many-branches
+# pylint: disable=used-before-assignment
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, cast
+
+import click
+
+from click_extended.core.other.context import Context
+
+if TYPE_CHECKING:
+    from click_extended.core.decorators.tag import Tag
+    from click_extended.core.nodes._root_node import RootNode
+    from click_extended.core.nodes.child_node import ChildNode
+    from click_extended.core.nodes.node import Node
+    from click_extended.core.nodes.parent_node import ParentNode
+
+
+def get_context() -> Context:
+    """
+    Get the active context.
+
+    Returns:
+        Context:
+            The active context.
+
+    Raises:
+        RuntimeError:
+            If called outside a Click command or before initialization.
+    """
+    click_context = click.get_current_context(silent=True)
+    if click_context is None:
+        raise RuntimeError("No active Click context is available.")
+
+    meta_raw = click_context.meta.get("click_extended")
+    if not isinstance(meta_raw, dict) or not meta_raw:
+        raise RuntimeError(
+            "click-extended context has not been initialized yet."
+        )
+
+    meta: dict[str, Any] = cast(dict[str, Any], meta_raw)
+
+    root_node = meta.get("root_node")
+    if root_node is None:
+        raise RuntimeError(
+            "click-extended root node is not available in context."
+        )
+
+    parents: dict[str, Any] = meta.get("parents", {})
+    tags: dict[str, Any] = meta.get("tags", {})
+    children: dict[str, Any] = meta.get("children", {})
+    globals_nodes: dict[str, Any] = meta.get("globals", {})
+
+    if not isinstance(parents, dict):
+        parents = {}
+    if not isinstance(tags, dict):
+        tags = {}
+    if not isinstance(children, dict):
+        children = {}
+    if not isinstance(globals_nodes, dict):
+        globals_nodes = {}
+
+    all_nodes: dict[str, Any] = {}
+    if isinstance(parents, dict):
+        all_nodes.update(parents)
+    if isinstance(tags, dict):
+        all_nodes.update(tags)
+    if isinstance(children, dict):
+        all_nodes.update(children)
+    if isinstance(globals_nodes, dict):
+        all_nodes.update(globals_nodes)
+    if root_node is not None:
+        all_nodes[root_node.name] = root_node
+
+    current_scope = meta.get("current_scope", "root")
+    if current_scope not in ("root", "parent", "child"):
+        current_scope = "root"
+    parent_node = meta.get("parent_node")
+    child_node = meta.get("child_node")
+
+    current = None
+    parent = None
+    if current_scope == "root":
+        current = root_node
+    elif current_scope == "parent":
+        current = parent_node
+    elif current_scope == "child":
+        current = child_node
+        parent = parent_node
+
+    return Context(
+        root=cast(RootNode, root_node),
+        current=cast(Node | None, current),
+        parent=cast(ParentNode | Tag | None, parent),
+        click_context=click_context,
+        nodes=cast(dict[str, Node], all_nodes),
+        parents=cast(dict[str, ParentNode], parents),
+        tags=cast(dict[str, Tag], tags),
+        children=cast(dict[str, ChildNode], children),
+        data=meta.get("data", {}),
+        debug=bool(meta.get("debug", False)),
+    )

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: click_extended
-Version: 1.0.2
+Version: 1.0.4
 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
@@ -96,6 +96,7 @@ An extension of the [Click](https://github.com/pallets/click) library with addit
 - **Full Type Support**: Built with type-hinting from the ground up, meaning everything is fully typed.
 - **Improved Errors**: Improved error output like tips, debugging, and more.
 - **Short Flag Concatenation**: Automatically support concatenating short hand flags where `-r -f` is the same as `-rf`.
+- **Global state**: Access global state through the context's `data` property.
 
 ## Installation
 

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

@@ -36,6 +36,7 @@ click_extended/core/other/_click_command.py
 click_extended/core/other/_click_group.py
 click_extended/core/other/_tree.py
 click_extended/core/other/context.py
+click_extended/core/other/get_context.py
 click_extended/decorators/__init__.py
 click_extended/decorators/check/__init__.py
 click_extended/decorators/check/conflicts.py

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

@@ -1,6 +1,6 @@
 [project]
 name = "click_extended"
-version = "1.0.2"
+version = "1.0.4"
 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" },