click-extended 1.0.3__py3-none-any.whl → 1.0.4__py3-none-any.whl

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/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/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.3.dist-info → click_extended-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: click_extended
-Version: 1.0.3
+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.3.dist-info → click_extended-1.0.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-click_extended/__init__.py,sha256=mF6rVnQnG-IiMSo-hX16ZzgSv8F-F3BoAyX5PDx6x90,714
+click_extended/__init__.py,sha256=E0-jE6thELe-ZP3oqx4ah-OvBSttcLuRUnUP0Yku7JI,795
 click_extended/classes.py,sha256=SdwglQ7O5ahjYeVnaM9_hCU14BYZBv8C0ZjWQIo7A_I,837
 click_extended/errors.py,sha256=tkvAXs4oUZ8SFgX37KhYrHAlsxmOGrSFLIezCH9NDQI,13897
 click_extended/types.py,sha256=0YT4QN269H-01RVxDGSpMT_hJm8cTcONonpX4_YxJlg,238
@@ -22,11 +22,12 @@ click_extended/core/nodes/node.py,sha256=Q5OgaSNhz1dAIcYNDQOaAS2eCdu9XMMyDA5lXfZ
 click_extended/core/nodes/option_node.py,sha256=fCYrnW846mz1aDyf9sTQAnuIYUGd5g6XyUN6aBMIWgE,7055
 click_extended/core/nodes/parent_node.py,sha256=x526r7XjfsUypsB1N-5aXjEbP2d06eLF30G6IszxV3w,7352
 click_extended/core/nodes/validation_node.py,sha256=9X_dBbr1BB-OYRxnGsM8CoKRbKT1MuQ29Injtf_Iu_E,4020
-click_extended/core/other/__init__.py,sha256=xZl7jM1Wud-g2c0l-CQYSMNwsJqwNwFDLE8FGL57XjA,155
+click_extended/core/other/__init__.py,sha256=ZYPlENo4widfcRWcg4yojmkNf_E89Y7U_8hRFCTOZoY,236
 click_extended/core/other/_click_command.py,sha256=NR7e-GyKiqyVJC8X5NjRXz5ehsYl9axVIxZCSejzUg4,1738
 click_extended/core/other/_click_group.py,sha256=BoEQoyx13n27Qy1-h_Dkaie68MlyPClIVB8cNtfPGdY,7714
 click_extended/core/other/_tree.py,sha256=IFSA3aQ-1tHjdjLO392-RLzQrpxO9b4JsyXvjdoJZ6k,16404
 click_extended/core/other/context.py,sha256=KrXfDGoVV_xuIv6fFskF0hHtWDyRDETWoSXw24GxYs8,14619
+click_extended/core/other/get_context.py,sha256=FtoyCJmSRAVdqJZTTYFnfWinF6phv3u3z5yA97WgpGA,3255
 click_extended/decorators/__init__.py,sha256=BzOreglycbxGITsWLSB3VkN8e37F-ADYlGOWoO1aO7A,1142
 click_extended/decorators/check/__init__.py,sha256=WKwRFBWFQHxA69DcHgO23fBZfLRzM8N9uUlkrl7UCS4,2180
 click_extended/decorators/check/conflicts.py,sha256=qnu4k9uAWWFkzuOUXWtDS6M8VlIjzfEAH3m4qLUdwH8,4557
@@ -142,9 +143,9 @@ click_extended/utils/naming.py,sha256=kNmzOqidgZZ1dE5aMYrxpWt4VwcLuEiFunpumpfHuZ
 click_extended/utils/process.py,sha256=sU3ZCMjBgjKcDnTRLKPdQ_TAjk0AT7Q8SatagD0JyHA,9729
 click_extended/utils/selection.py,sha256=_OQC88pGPUh29boxmS5ugXEi9jZGqAG180S27PeQaj0,9875
 click_extended/utils/time.py,sha256=H5m5caIEau_1GHkiYgKL_LcTtVdw2TkFVbkqJu7A9rQ,1067
-click_extended-1.0.3.dist-info/licenses/AUTHORS.md,sha256=NkShPinjqtnRDQVRyVnfJuOGM56sejauE3WRoYCcbtw,132
-click_extended-1.0.3.dist-info/licenses/LICENSE,sha256=gjO8hzM4mFSBXFikktaXVSgmXGcre91_GPJ-E_yP56E,1075
-click_extended-1.0.3.dist-info/METADATA,sha256=MTJuY2J-kEmVhNjLLlIeMT6-CSN9PiX0eP7kdfa5uXI,10762
-click_extended-1.0.3.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-click_extended-1.0.3.dist-info/top_level.txt,sha256=2G3bm6tCNv80okRm773jKTk-_z1ElY-seaozZrn_TxA,15
-click_extended-1.0.3.dist-info/RECORD,,
+click_extended-1.0.4.dist-info/licenses/AUTHORS.md,sha256=NkShPinjqtnRDQVRyVnfJuOGM56sejauE3WRoYCcbtw,132
+click_extended-1.0.4.dist-info/licenses/LICENSE,sha256=gjO8hzM4mFSBXFikktaXVSgmXGcre91_GPJ-E_yP56E,1075
+click_extended-1.0.4.dist-info/METADATA,sha256=T9OnyBvzTlf1Eyo2y635O8x0oYjvx77TwJ2JbSK3dX8,10841
+click_extended-1.0.4.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+click_extended-1.0.4.dist-info/top_level.txt,sha256=2G3bm6tCNv80okRm773jKTk-_z1ElY-seaozZrn_TxA,15
+click_extended-1.0.4.dist-info/RECORD,,