click-extended 0.0.3__tar.gz → 0.0.4__tar.gz

click_extended-0.0.4/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: click_extended
+Version: 0.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
+        
+        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
+
+![top language](https://img.shields.io/github/languages/top/marcusfrdk/click-extended)
+![code size](https://img.shields.io/github/languages/code-size/marcusfrdk/click-extended)
+![last commit](https://img.shields.io/github/last-commit/marcusfrdk/click-extended)
+![issues](https://img.shields.io/github/issues/marcusfrdk/click-extended)
+![contributors](https://img.shields.io/github/contributors/marcusfrdk/click-extended)
+![PyPI](https://img.shields.io/pypi/v/click-extended)
+![License](https://img.shields.io/github/license/marcusfrdk/click-extended)
+![Downloads](https://static.pepy.tech/badge/click-extended)
+![Monthly Downloads](https://static.pepy.tech/badge/click-extended/month)
+
+An extension of the [Click](https://github.com/pallets/click) library with additional features like aliasing, asynchronous support, an extended decorator API and more.
+
+## Features
+
+- **Aliasing**: Add multiple aliases to a group or command.
+- **Async supprt**: Automatically run both synchronous and asynchronous functions.
+- **Extensible decorator API**: Extend the Click decorator API with custom decorators like validators, transformers, and more.
+- **Environment variables**: Automatically validate and inject environment variables into the function.
+- **Fully type-hinted**: The library is fully type-hinted and provides good types for easy development.
+- **Help alias**: The `-h` and `--help` automatically show the help menu unless overridden.
+
+## Installation
+
+```bash
+pip install click-extended
+```
+
+## Requirements
+
+- **Python**: 3.10 or higher
+
+## Quick Start
+
+### Basic Command
+
+```python
+from click_extended import command, option
+
+@command()
+@option("--name", default="World", help="Name to greet")
+@option("--count", type=int, default=1, help="Number of greetings")
+def greet(name: str, count: int):
+    """Greet someone multiple times."""
+    for _ in range(count):
+        print(f"Hello, {name}!")
+
+if __name__ == "__main__":
+    greet()
+```
+
+```bash
+$ python app.py --name Alice --count 3
+Hello, Alice!
+Hello, Alice!
+Hello, Alice!
+```
+
+### Async Support
+
+```python
+import asyncio
+
+from click_extended import command, option
+
+@command()
+@option("--url", required=True, help="URL to fetch")
+async def fetch(url: str):
+    """Fetch data from a URL asynchronously."""
+    await asyncio.sleep(1)
+    print(f"Fetched data from {url}")
+
+if __name__ == "__main__":
+    fetch()
+```
+
+### Command Aliases
+
+```python
+from click_extended import command, option
+
+@command(aliases=["hi", "hello"])
+@option("--name", default="World")
+def greet(name: str):
+    """Greet someone."""
+    print(f"Hello, {name}!")
+
+if __name__ == "__main__":
+    greet()
+```
+
+```bash
+$ python app.py greet --name Alice
+Hello, Alice!
+$ python app.py hi --name Bob
+Hello, Bob!
+$ python app.py hello --name Charlie
+Hello, Charlie!
+```
+
+### Environment Variables
+
+Environment variables are automatically loaded from the `.env` file, but as long as the variable is defined in your system environment, it will work.
+
+```txt
+API_TOKEN=secret123
+```
+
+```python
+from click_extended import command, option, env
+
+@command()
+@option("--token", help="API token")
+@env("API_TOKEN", name="token", required=True)
+def api_call(token: str):
+    """Make an API call with authentication."""
+    print(f"Using token: {token[:8]}...")
+
+if __name__ == "__main__":
+    api_call()
+```
+
+```bash
+$ python app.py
+Using token: secret12...
+```
+
+### Value Validation
+
+```python
+from click_extended import command, option, ChildNode
+
+class IsPositive(ChildNode):
+    """Validate that a number is positive."""
+
+    def process(self, value, *args, **kwargs):
+        if value <= 0:
+            raise ValueError(f"Value must be positive, got {value}")
+
+def is_positive(*args, **kwargs):
+    """Validate positive numbers."""
+    return IsPositive.as_decorator(*args, **kwargs)
+
+@command()
+@option("--count", type=int, required=True)
+@is_positive()
+def process(count: int):
+    """Process a positive number of items."""
+    print(f"Processing {count} items")
+
+if __name__ == "__main__":
+    process()
+```
+
+```bash
+$ python app.py --count 5
+Processing 5 items
+$ python app.py --count -1
+Error: Value must be positive, got -1
+```
+
+## Documentation
+
+### Core Concepts
+
+- [Commands and Groups](./docs/ROOT_NODE.md) - CLI entry points
+- [Options, Arguments, and Environment Variables](./docs/PARENT_NODE.md) - Parameter sources
+- [Validators and Transformers](./docs/CHILD_NODE.md) - Value processing
+- [Global Nodes](./docs/GLOBAL_NODE.md) - Tree-level operations
+- [Tags](./docs/TAG.md) - Cross-parameter validation
+- [Tree Architecture](./docs/TREE.md) - Internal structure
+
+### Guides
+
+- [Migrating from Click](./docs/MIGRATING_FROM_CLICK.md) - Upgrade guide
+
+## Contributing
+
+Contributors are more than welcome to work on this project. Read the [contribution documentation](./CONTRIBUTING.md) to learn more.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Acknowledgements
+
+This project is built on top of the [Click](https://github.com/pallets/click) library.

click_extended-0.0.4/README.md

@@ -0,0 +1,190 @@
+![Banner](./assets/click-extended-banner.png)
+
+# Click Extended
+
+![top language](https://img.shields.io/github/languages/top/marcusfrdk/click-extended)
+![code size](https://img.shields.io/github/languages/code-size/marcusfrdk/click-extended)
+![last commit](https://img.shields.io/github/last-commit/marcusfrdk/click-extended)
+![issues](https://img.shields.io/github/issues/marcusfrdk/click-extended)
+![contributors](https://img.shields.io/github/contributors/marcusfrdk/click-extended)
+![PyPI](https://img.shields.io/pypi/v/click-extended)
+![License](https://img.shields.io/github/license/marcusfrdk/click-extended)
+![Downloads](https://static.pepy.tech/badge/click-extended)
+![Monthly Downloads](https://static.pepy.tech/badge/click-extended/month)
+
+An extension of the [Click](https://github.com/pallets/click) library with additional features like aliasing, asynchronous support, an extended decorator API and more.
+
+## Features
+
+- **Aliasing**: Add multiple aliases to a group or command.
+- **Async supprt**: Automatically run both synchronous and asynchronous functions.
+- **Extensible decorator API**: Extend the Click decorator API with custom decorators like validators, transformers, and more.
+- **Environment variables**: Automatically validate and inject environment variables into the function.
+- **Fully type-hinted**: The library is fully type-hinted and provides good types for easy development.
+- **Help alias**: The `-h` and `--help` automatically show the help menu unless overridden.
+
+## Installation
+
+```bash
+pip install click-extended
+```
+
+## Requirements
+
+- **Python**: 3.10 or higher
+
+## Quick Start
+
+### Basic Command
+
+```python
+from click_extended import command, option
+
+@command()
+@option("--name", default="World", help="Name to greet")
+@option("--count", type=int, default=1, help="Number of greetings")
+def greet(name: str, count: int):
+    """Greet someone multiple times."""
+    for _ in range(count):
+        print(f"Hello, {name}!")
+
+if __name__ == "__main__":
+    greet()
+```
+
+```bash
+$ python app.py --name Alice --count 3
+Hello, Alice!
+Hello, Alice!
+Hello, Alice!
+```
+
+### Async Support
+
+```python
+import asyncio
+
+from click_extended import command, option
+
+@command()
+@option("--url", required=True, help="URL to fetch")
+async def fetch(url: str):
+    """Fetch data from a URL asynchronously."""
+    await asyncio.sleep(1)
+    print(f"Fetched data from {url}")
+
+if __name__ == "__main__":
+    fetch()
+```
+
+### Command Aliases
+
+```python
+from click_extended import command, option
+
+@command(aliases=["hi", "hello"])
+@option("--name", default="World")
+def greet(name: str):
+    """Greet someone."""
+    print(f"Hello, {name}!")
+
+if __name__ == "__main__":
+    greet()
+```
+
+```bash
+$ python app.py greet --name Alice
+Hello, Alice!
+$ python app.py hi --name Bob
+Hello, Bob!
+$ python app.py hello --name Charlie
+Hello, Charlie!
+```
+
+### Environment Variables
+
+Environment variables are automatically loaded from the `.env` file, but as long as the variable is defined in your system environment, it will work.
+
+```txt
+API_TOKEN=secret123
+```
+
+```python
+from click_extended import command, option, env
+
+@command()
+@option("--token", help="API token")
+@env("API_TOKEN", name="token", required=True)
+def api_call(token: str):
+    """Make an API call with authentication."""
+    print(f"Using token: {token[:8]}...")
+
+if __name__ == "__main__":
+    api_call()
+```
+
+```bash
+$ python app.py
+Using token: secret12...
+```
+
+### Value Validation
+
+```python
+from click_extended import command, option, ChildNode
+
+class IsPositive(ChildNode):
+    """Validate that a number is positive."""
+
+    def process(self, value, *args, **kwargs):
+        if value <= 0:
+            raise ValueError(f"Value must be positive, got {value}")
+
+def is_positive(*args, **kwargs):
+    """Validate positive numbers."""
+    return IsPositive.as_decorator(*args, **kwargs)
+
+@command()
+@option("--count", type=int, required=True)
+@is_positive()
+def process(count: int):
+    """Process a positive number of items."""
+    print(f"Processing {count} items")
+
+if __name__ == "__main__":
+    process()
+```
+
+```bash
+$ python app.py --count 5
+Processing 5 items
+$ python app.py --count -1
+Error: Value must be positive, got -1
+```
+
+## Documentation
+
+### Core Concepts
+
+- [Commands and Groups](./docs/ROOT_NODE.md) - CLI entry points
+- [Options, Arguments, and Environment Variables](./docs/PARENT_NODE.md) - Parameter sources
+- [Validators and Transformers](./docs/CHILD_NODE.md) - Value processing
+- [Global Nodes](./docs/GLOBAL_NODE.md) - Tree-level operations
+- [Tags](./docs/TAG.md) - Cross-parameter validation
+- [Tree Architecture](./docs/TREE.md) - Internal structure
+
+### Guides
+
+- [Migrating from Click](./docs/MIGRATING_FROM_CLICK.md) - Upgrade guide
+
+## Contributing
+
+Contributors are more than welcome to work on this project. Read the [contribution documentation](./CONTRIBUTING.md) to learn more.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Acknowledgements
+
+This project is built on top of the [Click](https://github.com/pallets/click) library.

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

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: click_extended
+Version: 0.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
+        
+        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
+
+![top language](https://img.shields.io/github/languages/top/marcusfrdk/click-extended)
+![code size](https://img.shields.io/github/languages/code-size/marcusfrdk/click-extended)
+![last commit](https://img.shields.io/github/last-commit/marcusfrdk/click-extended)
+![issues](https://img.shields.io/github/issues/marcusfrdk/click-extended)
+![contributors](https://img.shields.io/github/contributors/marcusfrdk/click-extended)
+![PyPI](https://img.shields.io/pypi/v/click-extended)
+![License](https://img.shields.io/github/license/marcusfrdk/click-extended)
+![Downloads](https://static.pepy.tech/badge/click-extended)
+![Monthly Downloads](https://static.pepy.tech/badge/click-extended/month)
+
+An extension of the [Click](https://github.com/pallets/click) library with additional features like aliasing, asynchronous support, an extended decorator API and more.
+
+## Features
+
+- **Aliasing**: Add multiple aliases to a group or command.
+- **Async supprt**: Automatically run both synchronous and asynchronous functions.
+- **Extensible decorator API**: Extend the Click decorator API with custom decorators like validators, transformers, and more.
+- **Environment variables**: Automatically validate and inject environment variables into the function.
+- **Fully type-hinted**: The library is fully type-hinted and provides good types for easy development.
+- **Help alias**: The `-h` and `--help` automatically show the help menu unless overridden.
+
+## Installation
+
+```bash
+pip install click-extended
+```
+
+## Requirements
+
+- **Python**: 3.10 or higher
+
+## Quick Start
+
+### Basic Command
+
+```python
+from click_extended import command, option
+
+@command()
+@option("--name", default="World", help="Name to greet")
+@option("--count", type=int, default=1, help="Number of greetings")
+def greet(name: str, count: int):
+    """Greet someone multiple times."""
+    for _ in range(count):
+        print(f"Hello, {name}!")
+
+if __name__ == "__main__":
+    greet()
+```
+
+```bash
+$ python app.py --name Alice --count 3
+Hello, Alice!
+Hello, Alice!
+Hello, Alice!
+```
+
+### Async Support
+
+```python
+import asyncio
+
+from click_extended import command, option
+
+@command()
+@option("--url", required=True, help="URL to fetch")
+async def fetch(url: str):
+    """Fetch data from a URL asynchronously."""
+    await asyncio.sleep(1)
+    print(f"Fetched data from {url}")
+
+if __name__ == "__main__":
+    fetch()
+```
+
+### Command Aliases
+
+```python
+from click_extended import command, option
+
+@command(aliases=["hi", "hello"])
+@option("--name", default="World")
+def greet(name: str):
+    """Greet someone."""
+    print(f"Hello, {name}!")
+
+if __name__ == "__main__":
+    greet()
+```
+
+```bash
+$ python app.py greet --name Alice
+Hello, Alice!
+$ python app.py hi --name Bob
+Hello, Bob!
+$ python app.py hello --name Charlie
+Hello, Charlie!
+```
+
+### Environment Variables
+
+Environment variables are automatically loaded from the `.env` file, but as long as the variable is defined in your system environment, it will work.
+
+```txt
+API_TOKEN=secret123
+```
+
+```python
+from click_extended import command, option, env
+
+@command()
+@option("--token", help="API token")
+@env("API_TOKEN", name="token", required=True)
+def api_call(token: str):
+    """Make an API call with authentication."""
+    print(f"Using token: {token[:8]}...")
+
+if __name__ == "__main__":
+    api_call()
+```
+
+```bash
+$ python app.py
+Using token: secret12...
+```
+
+### Value Validation
+
+```python
+from click_extended import command, option, ChildNode
+
+class IsPositive(ChildNode):
+    """Validate that a number is positive."""
+
+    def process(self, value, *args, **kwargs):
+        if value <= 0:
+            raise ValueError(f"Value must be positive, got {value}")
+
+def is_positive(*args, **kwargs):
+    """Validate positive numbers."""
+    return IsPositive.as_decorator(*args, **kwargs)
+
+@command()
+@option("--count", type=int, required=True)
+@is_positive()
+def process(count: int):
+    """Process a positive number of items."""
+    print(f"Processing {count} items")
+
+if __name__ == "__main__":
+    process()
+```
+
+```bash
+$ python app.py --count 5
+Processing 5 items
+$ python app.py --count -1
+Error: Value must be positive, got -1
+```
+
+## Documentation
+
+### Core Concepts
+
+- [Commands and Groups](./docs/ROOT_NODE.md) - CLI entry points
+- [Options, Arguments, and Environment Variables](./docs/PARENT_NODE.md) - Parameter sources
+- [Validators and Transformers](./docs/CHILD_NODE.md) - Value processing
+- [Global Nodes](./docs/GLOBAL_NODE.md) - Tree-level operations
+- [Tags](./docs/TAG.md) - Cross-parameter validation
+- [Tree Architecture](./docs/TREE.md) - Internal structure
+
+### Guides
+
+- [Migrating from Click](./docs/MIGRATING_FROM_CLICK.md) - Upgrade guide
+
+## Contributing
+
+Contributors are more than welcome to work on this project. Read the [contribution documentation](./CONTRIBUTING.md) to learn more.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Acknowledgements
+
+This project is built on top of the [Click](https://github.com/pallets/click) library.

{click_extended-0.0.3 → click_extended-0.0.4}/pyproject.toml

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

{click_extended-0.0.3 → click_extended-0.0.4}/tests/test_argument.py

@@ -472,13 +472,63 @@ class TestArgumentDefault:
         arg = Argument(name="test", default={"key": "value"})
         assert arg.default == {"key": "value"}
 
-    def test_default_with_required_false(self) -> None:
-        """Test default with required=False."""
+    def test_default_makes_argument_optional(self) -> None:
+        """Test that default automatically makes argument optional."""
+        arg = Argument(name="test", default="default")
+        assert arg.required is False
+        assert arg.default == "default"
+
+    def test_default_with_explicit_required_false(self) -> None:
+        """Test default with explicit required=False still works."""
         arg = Argument(name="test", required=False, default="default")
         assert arg.required is False
         assert arg.default == "default"
 
 
+class TestArgumentDefaultBehavior:
+    """Tests for default value auto-optional behavior."""
+
+    def test_default_string_makes_optional(self) -> None:
+        """Test that string default makes argument optional."""
+        arg = Argument(name="test", default="value")
+        assert arg.required is False
+
+    def test_default_int_makes_optional(self) -> None:
+        """Test that int default makes argument optional."""
+        arg = Argument(name="test", default=42)
+        assert arg.required is False
+
+    def test_default_zero_makes_optional(self) -> None:
+        """Test that default=0 makes argument optional."""
+        arg = Argument(name="test", default=0)
+        assert arg.required is False
+
+    def test_default_empty_string_makes_optional(self) -> None:
+        """Test that default='' makes argument optional."""
+        arg = Argument(name="test", default="")
+        assert arg.required is False
+
+    def test_default_false_makes_optional(self) -> None:
+        """Test that default=False makes argument optional."""
+        arg = Argument(name="test", default=False)
+        assert arg.required is False
+
+    def test_default_empty_list_makes_optional(self) -> None:
+        """Test that default=[] makes argument optional."""
+        arg = Argument(name="test", default=[])
+        assert arg.required is False
+
+    def test_no_default_stays_required(self) -> None:
+        """Test that no default keeps argument required."""
+        arg = Argument(name="test")
+        assert arg.required is True
+
+    def test_default_none_stays_required(self) -> None:
+        """Test that default=None doesn't change required status."""
+        arg = Argument(name="test", default=None)
+        assert arg.required is True
+
+
 class TestArgumentExtraKwargs:
     """Tests for extra kwargs parameter."""
 

click_extended-0.0.3/PKG-INFO

@@ -1,101 +0,0 @@
-Metadata-Version: 2.4
-Name: click_extended
-Version: 0.0.3
-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
-
-An extension of the [Click](https://github.com/pallets/click) library with additional features like aliasing, asynchronous support, an extended decorator system and more.
-
-## Features
-
-- **Aliasing**: Add multiple aliases to a group or command.
-- **Async supprt**: Automatically run both synchronous and asynchronous functions.
-- **Extended decorator system**: Create or use pre-made validation and transformation decorators, inject values into the context and more.
-- **Environment variables**: Automatically validate and inject environment variables into the function.
-
-## Installation
-
-```bash
-pip install click-extended
-```
-
-## Requirements
-
-- **Python**: 3.10 or higher
-
-## Usage
-
-TBD
-
-## Contributing
-
-TBD
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
-
-## Acknowledgements
-
-This project is built on top of the [Click](https://github.com/pallets/click) library.

click_extended-0.0.3/README.md

@@ -1,38 +0,0 @@
-![Banner](./assets/click-extended-banner.png)
-
-# Click Extended
-
-An extension of the [Click](https://github.com/pallets/click) library with additional features like aliasing, asynchronous support, an extended decorator system and more.
-
-## Features
-
-- **Aliasing**: Add multiple aliases to a group or command.
-- **Async supprt**: Automatically run both synchronous and asynchronous functions.
-- **Extended decorator system**: Create or use pre-made validation and transformation decorators, inject values into the context and more.
-- **Environment variables**: Automatically validate and inject environment variables into the function.
-
-## Installation
-
-```bash
-pip install click-extended
-```
-
-## Requirements
-
-- **Python**: 3.10 or higher
-
-## Usage
-
-TBD
-
-## Contributing
-
-TBD
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
-
-## Acknowledgements
-
-This project is built on top of the [Click](https://github.com/pallets/click) library.

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

@@ -1,101 +0,0 @@
-Metadata-Version: 2.4
-Name: click_extended
-Version: 0.0.3
-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
-
-An extension of the [Click](https://github.com/pallets/click) library with additional features like aliasing, asynchronous support, an extended decorator system and more.
-
-## Features
-
-- **Aliasing**: Add multiple aliases to a group or command.
-- **Async supprt**: Automatically run both synchronous and asynchronous functions.
-- **Extended decorator system**: Create or use pre-made validation and transformation decorators, inject values into the context and more.
-- **Environment variables**: Automatically validate and inject environment variables into the function.
-
-## Installation
-
-```bash
-pip install click-extended
-```
-
-## Requirements
-
-- **Python**: 3.10 or higher
-
-## Usage
-
-TBD
-
-## Contributing
-
-TBD
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
-
-## Acknowledgements
-
-This project is built on top of the [Click](https://github.com/pallets/click) library.