click-extended 0.0.1__tar.gz

click_extended-0.0.1/AUTHORS.md

@@ -0,0 +1,5 @@
+![Banner](./assets/click-extended-authors-banner.png)
+
+# Authors
+
+- Marcus Fredriksson [@marcusfrdk](https://github.com/marcusfrdk)

click_extended-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Marcus Fredriksson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

click_extended-0.0.1/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: click_extended
+Version: 0.0.1
+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
+        
+        Copyright (c) 2025 Marcus Fredriksson
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/marcusfrdk/click-extended
+Project-URL: Repository, https://github.com/marcusfrdk/click-extended
+Project-URL: Issues, https://github.com/marcusfrdk/click-extended/issues
+Keywords: click,cli,command-line,alias,aliasing,command,group,decorator,terminal,console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: click>=8.3.0
+Requires-Dist: python-dotenv>=1.2.1
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.2; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.2.0; extra == "dev"
+Requires-Dist: mypy>=1.18.2; extra == "dev"
+Requires-Dist: pylint>=3.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: black>=25.9.0; extra == "dev"
+Requires-Dist: pre-commit>=4.3.0; extra == "dev"
+Dynamic: license-file
+
+![Banner](./assets/click-extended-banner.png)
+
+# Click Extended
+
+TBD
+
+## Installation
+
+```bash
+pip install click-extended
+```
+
+## Requirements
+
+TBD
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Contributing
+
+TBD
+
+## Acknowledgements
+
+This project is built on top of the [Click](https://github.com/pallets/click) library.

click_extended-0.0.1/README.md

@@ -0,0 +1,27 @@
+![Banner](./assets/click-extended-banner.png)
+
+# Click Extended
+
+TBD
+
+## Installation
+
+```bash
+pip install click-extended
+```
+
+## Requirements
+
+TBD
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Contributing
+
+TBD
+
+## Acknowledgements
+
+This project is built on top of the [Click](https://github.com/pallets/click) library.

click_extended-0.0.1/click_extended/__init__.py

@@ -0,0 +1,21 @@
+"""Initialization file for the 'click_extended' module."""
+
+from click_extended.core._child_node import ChildNode
+from click_extended.core._parent_node import ParentNode
+from click_extended.core.argument import argument
+from click_extended.core.command import command
+from click_extended.core.env import env
+from click_extended.core.group import group
+from click_extended.core.option import option
+from click_extended.core.tag import tag
+
+__all__ = [
+    "ChildNode",
+    "ParentNode",
+    "argument",
+    "command",
+    "env",
+    "group",
+    "option",
+    "tag",
+]

click_extended-0.0.1/click_extended/errors.py

@@ -0,0 +1,128 @@
+"""Exceptions used in the `click_extended` library."""
+
+# pylint: disable=too-many-arguments
+# pylint: disable=too-many-positional-arguments
+
+
+class ClickExtendedError(Exception):
+    """Base exception for exceptions defined in the `click_extended` library."""
+
+    def __init__(self, message: str) -> None:
+        """
+        Initialize a new `ClickExtendedError` instance.
+
+        Args:
+            message (str):
+                The message to show.
+        """
+        super().__init__(message)
+
+
+class NoParentError(ClickExtendedError):
+    """Exception raised when no `ParentNode` has been defined."""
+
+    def __init__(self, name: str) -> None:
+        """
+        Initialize a new `NoParentError` instance.
+
+        Args:
+            name (str):
+                The name of the child node.
+        """
+
+        message = (
+            f"Failed to register the child node '{name}' as no parent is "
+            "defined. Ensure a parent node is registered before registering a "
+            "child node."
+        )
+        super().__init__(message)
+
+
+class NoRootError(ClickExtendedError):
+    """Exception raised when there is no `RootNode` defined."""
+
+    def __init__(self, message: str | None = None) -> None:
+        """Initialize a new `NoRootError` instance."""
+        super().__init__(message or "No root node is defined in the tree.")
+
+
+class ParentNodeExistsError(ClickExtendedError):
+    """Exception raised when a parent node already exists with the same name."""
+
+    def __init__(self, name: str) -> None:
+        """
+        Initialize a new `ParentNodeExistsError` instance.
+
+        Args:
+            name (str):
+                The name of the parent node.
+        """
+        message = (
+            f"Cannot register parent node '{name}' as a parent node with this "
+            "name already exists. "
+            f"Parent node names must be unique within the tree."
+        )
+        super().__init__(message)
+
+
+class RootNodeExistsError(ClickExtendedError):
+    """Exception raised when a root node already exists for the tree."""
+
+    def __init__(self) -> None:
+        """Initialize a new `RootNodeExistsError` instance."""
+        message = (
+            "Cannot register root node as a root node has already been "
+            "defined. Only one root node is allowed per tree instance."
+        )
+        super().__init__(message)
+
+
+class InvalidChildOnTagError(ClickExtendedError):
+    """Exception raised when a transformation child is attached to a tag."""
+
+    def __init__(self, child_name: str, tag_name: str) -> None:
+        """
+        Initialize a new `InvalidChildOnTagError` instance.
+
+        Args:
+            child_name (str):
+                The name of the child node.
+            tag_name (str):
+                The name of the tag.
+        """
+        message = (
+            f"Cannot attach transformation child '{child_name}' to tag "
+            f"'{tag_name}'. Tags can only have validation-only children "
+            "(no return statement or return None)."
+        )
+        super().__init__(message)
+
+
+class DuplicateNameError(ClickExtendedError):
+    """Exception raised when a name collision is detected."""
+
+    def __init__(
+        self, name: str, type1: str, type2: str, location1: str, location2: str
+    ) -> None:
+        """
+        Initialize a new `DuplicateNameError` instance.
+
+        Args:
+            name (str):
+                The conflicting name.
+            type1 (str):
+                The type of the first node (e.g., "option", "tag").
+            type2 (str):
+                The type of the second node.
+            location1 (str):
+                Description of where the first node is defined.
+            location2 (str):
+                Description of where the second node is defined.
+        """
+        message = (
+            f"The name '{name}' is used by both "
+            f"{type1} {location1} and {type2} {location2}. "
+            f"All names (options, arguments, environment variables, and tags) "
+            f"must be unique within a command."
+        )
+        super().__init__(message)

click_extended-0.0.1/click_extended/types.py

@@ -0,0 +1,34 @@
+"""Types used in `click_extended` which can be useful for users."""
+
+from click_extended.core._child_node import ChildNode
+from click_extended.core._node import Node
+from click_extended.core._parent_node import ParentNode
+from click_extended.core._root_node import RootNode
+from click_extended.core._tree import Tree
+from click_extended.core.argument import Argument
+from click_extended.core.command import Command
+from click_extended.core.env import Env
+from click_extended.core.group import Group
+from click_extended.core.option import Option
+from click_extended.core.tag import Tag
+
+Tags = dict[str, Tag]
+Siblings = list[str]
+Parent = ParentNode | Tag
+
+__all__ = [
+    "ChildNode",
+    "Node",
+    "Parent",
+    "ParentNode",
+    "RootNode",
+    "Tree",
+    "Argument",
+    "Command",
+    "Env",
+    "Group",
+    "Option",
+    "Siblings",
+    "Tag",
+    "Tags",
+]

click_extended-0.0.1/click_extended.egg-info/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: click_extended
+Version: 0.0.1
+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
+        
+        Copyright (c) 2025 Marcus Fredriksson
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/marcusfrdk/click-extended
+Project-URL: Repository, https://github.com/marcusfrdk/click-extended
+Project-URL: Issues, https://github.com/marcusfrdk/click-extended/issues
+Keywords: click,cli,command-line,alias,aliasing,command,group,decorator,terminal,console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: click>=8.3.0
+Requires-Dist: python-dotenv>=1.2.1
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.2; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.2.0; extra == "dev"
+Requires-Dist: mypy>=1.18.2; extra == "dev"
+Requires-Dist: pylint>=3.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: black>=25.9.0; extra == "dev"
+Requires-Dist: pre-commit>=4.3.0; extra == "dev"
+Dynamic: license-file
+
+![Banner](./assets/click-extended-banner.png)
+
+# Click Extended
+
+TBD
+
+## Installation
+
+```bash
+pip install click-extended
+```
+
+## Requirements
+
+TBD
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Contributing
+
+TBD
+
+## Acknowledgements
+
+This project is built on top of the [Click](https://github.com/pallets/click) library.

click_extended-0.0.1/click_extended.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+AUTHORS.md
+LICENSE
+README.md
+pyproject.toml
+click_extended/__init__.py
+click_extended/errors.py
+click_extended/types.py
+click_extended.egg-info/PKG-INFO
+click_extended.egg-info/SOURCES.txt
+click_extended.egg-info/dependency_links.txt
+click_extended.egg-info/requires.txt
+click_extended.egg-info/top_level.txt
+tests/test_argument.py
+tests/test_child_node.py
+tests/test_command.py
+tests/test_env.py
+tests/test_group.py
+tests/test_option.py
+tests/test_parent_node.py
+tests/test_root_node.py
+tests/test_tag.py
+tests/test_transform.py
+tests/test_tree.py

click_extended-0.0.1/click_extended.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

click_extended-0.0.1/click_extended.egg-info/requires.txt

@@ -0,0 +1,16 @@
+click>=8.3.0
+python-dotenv>=1.2.1
+
+[build]
+build
+twine
+
+[dev]
+pytest>=8.4.2
+pytest-cov>=7.0.0
+pytest-asyncio>=1.2.0
+mypy>=1.18.2
+pylint>=3.0.0
+isort>=5.12.0
+black>=25.9.0
+pre-commit>=4.3.0

click_extended-0.0.1/click_extended.egg-info/top_level.txt

@@ -0,0 +1 @@
+click_extended

click_extended-0.0.1/pyproject.toml

@@ -0,0 +1,134 @@
+[project]
+name = "click_extended"
+version = "0.0.1"
+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" },
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Shells",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+readme = "README.md"
+keywords = [
+    "click",
+    "cli",
+    "command-line",
+    "alias",
+    "aliasing",
+    "command",
+    "group",
+    "decorator",
+    "terminal",
+    "console"
+]
+dependencies = [
+    "click>=8.3.0",
+    "python-dotenv>=1.2.1",
+]
+
+[project.optional-dependencies]
+build = ["build", "twine"]
+dev = [
+    "pytest>=8.4.2",
+    "pytest-cov>=7.0.0",
+    "pytest-asyncio>=1.2.0",
+    "mypy>=1.18.2",
+    "pylint>=3.0.0",
+    "isort>=5.12.0",
+    "black>=25.9.0",
+    "pre-commit>=4.3.0"
+]
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["click_extended"]
+
+[tool.pylint.master]
+ignore = [
+    "venv",
+    ".venv",
+    "__pycache__",
+    ".git",
+    "tests",
+    "docs",
+    "build",
+    "dist",
+    ".pytest_cache",
+    ".mypy_cache",
+    "*.egg-info",
+]
+ignore-paths = ["^tests/.*$", "^docs/.*$", "^\\..*$"]
+persistent = true
+
+[tool.pylint.messages_control]
+disable = ["duplicate-code"]
+
+[tool.pylint.format]
+max-line-length = 80
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-ra"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.coverage.run]
+source = ["click_extended"]
+omit = ["*/tests/*", "*/__pycache__/*", "*/.venv/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]
+
+[tool.black]
+line-length = 80
+target-version = ["py310", "py311", "py312", "py313"]
+
+[tool.isort]
+profile = "black"
+line_length = 80
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_unimported = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = false
+warn_no_return = true
+check_untyped_defs = true
+strict_equality = true
+disable_error_code = ["override", "unused-ignore"]
+
+[project.urls]
+Homepage = "https://github.com/marcusfrdk/click-extended"
+Repository = "https://github.com/marcusfrdk/click-extended"
+Issues = "https://github.com/marcusfrdk/click-extended/issues"

click_extended-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+