wry 0.1.9.dev1__tar.gz → 0.1.10.dev4__tar.gz

wry-0.1.10.dev4/.github/workflows/check-requirements.yml

@@ -0,0 +1,32 @@
+name: Check Requirements
+
+on:
+  pull_request:
+    paths:
+      - 'pyproject.toml'
+      - 'requirements-dev.txt'
+      - '.github/workflows/check-requirements.yml'
+
+jobs:
+  check-requirements:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Check requirements consistency
+      run: |
+        echo "Checking that requirements-dev.txt matches pyproject.toml constraints..."
+        python -m pip install --upgrade pip
+
+        # Install from requirements file
+        pip install -r requirements-dev.txt
+
+        # Check if package can be installed with these deps
+        pip install --no-deps -e .
+
+        echo "✅ Requirements file is valid and consistent!"

{wry-0.1.9.dev1 → wry-0.1.10.dev4}/.github/workflows/ci-cd.yml

@@ -35,14 +35,17 @@ jobs:
       uses: actions/cache@v4
       with:
         path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml', 'requirements-dev.txt') }}
         restore-keys: |
           ${{ runner.os }}-pip-
 
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -e ".[dev,test]"
+        # Install exact versions from requirements file first
+        pip install -r requirements-dev.txt
+        # Then install the package in editable mode (without deps to avoid conflicts)
+        pip install --no-deps -e .
 
     - name: Install pre-commit hooks
       run: |

{wry-0.1.9.dev1 → wry-0.1.10.dev4}/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -25,7 +25,7 @@ repos:
         entry: pytest
         language: system
         types: [python]
-        args: [--cov=wry, --cov-branch, --cov-report=xml, --cov-report=term-missing, --cov-fail-under=90]
+        args: [tests/unit/, --cov=wry, --cov-branch, --cov-report=xml, --cov-report=term-missing, --cov-fail-under=85]
         pass_filenames: false
         always_run: true
 
@@ -41,13 +41,6 @@ repos:
           - annotated-types>=0.6.0
           - setuptools-scm>=8.0
 
-# Temporarily disabled - bandit has dependency issues in pre-commit
-  # - repo: https://github.com/PyCQA/bandit
-  #   rev: 1.7.5
-  #   hooks:
-  #     - id: bandit
-  #       args: [-c, pyproject.toml]
-
 exclude: |
   (?x)(
     # Exclude auto-generated files

{wry-0.1.9.dev1 → wry-0.1.10.dev4}/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.9] - 2025-09-29
+
+### Added
+
+- **Automatic multiple option support for list types**
+  - `list[str]` and `tuple[str, ...]` fields now automatically generate Click options with `multiple=True`
+  - Supports both `AutoWryModel` and `WryModel` with proper type conversion
+  - Handles edge cases: empty lists, single values, and multiple values
+  - Works with different data types: `list[int]`, `list[str]`, etc.
+  - Maintains type safety: Click tuples are correctly converted to Python lists
+
+### Fixed
+
+- **Variadic argument bug resolution**
+  - Fixed issue where variadic Click arguments (`nargs=-1`) were incorrectly converted to strings
+  - Variadic arguments now preserve their tuple type when used with `@generate_click_parameters`
+  - Resolves duplicate parameter warnings and validation errors
+
+### Testing
+
+- **Comprehensive test coverage for multiple options**
+  - Added `tests/unit/test_multiple_option_bug.py` with 6 test cases
+  - Added `tests/unit/test_variadic_argument_bug.py` with 3 test cases
+  - Tests cover AutoWryModel, WryModel, edge cases, type validation, and different data types
+  - All tests pass with proper type checking and validation
+
 ## [0.1.8] - 2025-09-10
 
 ### Fixed
@@ -144,7 +170,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial version as `drycli` package (before rename to `wry`)
 
-[Unreleased]: https://github.com/tahouse/wry/compare/v0.1.8...HEAD
+[Unreleased]: https://github.com/tahouse/wry/compare/v0.1.9...HEAD
+[0.1.9]: https://github.com/tahouse/wry/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/tahouse/wry/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/tahouse/wry/compare/v0.1.6...v0.1.7
 [0.1.6]: https://github.com/tahouse/wry/compare/v0.1.5...v0.1.6

{wry-0.1.9.dev1 → wry-0.1.10.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wry
-Version: 0.1.9.dev1
+Version: 0.1.10.dev4
 Summary: Why Repeat Yourself? - Define your CLI once with Pydantic models
 Author-email: Tyler House <26489166+tahouse@users.noreply.github.com>
 License: MIT
@@ -81,7 +81,7 @@ The simplest way to use wry is with `AutoWryModel`, which automatically generate
 ```python
 import click
 from pydantic import Field
-from wry import AutoWryModel, generate_click_parameters
+from wry import AutoWryModel
 
 class AppArgs(AutoWryModel):
     """Configuration for my app."""
@@ -91,9 +91,10 @@ class AppArgs(AutoWryModel):
     verbose: bool = Field(default=False, description="Verbose output")
 
 @click.command()
-@generate_click_parameters(AppArgs)
+@AppArgs.generate_click_parameters()
 def main(**kwargs):
     """My simple CLI application."""
+    # Create the model instance from kwargs
     config = AppArgs(**kwargs)
     click.echo(f"Hello {config.name}, you are {config.age} years old!")
 
@@ -101,6 +102,8 @@ if __name__ == "__main__":
     main()
 ```
 
+**Note**: Currently, `generate_click_parameters()` passes individual parameters as kwargs to your function. You need to instantiate the model yourself. See the [Future Features](#future-features) section for a potential cleaner API.
+
 Run it:
 
 ```bash
@@ -122,7 +125,7 @@ wry can track where each configuration value came from. You have two options:
 
 ```python
 @click.command()
-@generate_click_parameters(AppArgs)
+@AppArgs.generate_click_parameters()
 def main(**kwargs):
     # Simple instantiation - no source tracking
     config = AppArgs(**kwargs)
@@ -133,7 +136,7 @@ def main(**kwargs):
 
 ```python
 @click.command()
-@generate_click_parameters(AppArgs)
+@AppArgs.generate_click_parameters()
 @click.pass_context
 def main(ctx, **kwargs):
     # Full source tracking with context
@@ -210,7 +213,7 @@ Use multiple Pydantic models in a single command:
 ```python
 from typing import Annotated
 import click
-from wry import WryModel, AutoOption, generate_click_parameters, multi_model
+from wry import WryModel, AutoOption, multi_model, create_models
 
 class ServerConfig(WryModel):
     host: Annotated[str, AutoOption] = "localhost"
@@ -222,7 +225,13 @@ class DatabaseArgs(WryModel):
 
 @click.command()
 @multi_model(ServerConfig, DatabaseConfig)
-def serve(server: ServerConfig, database: DatabaseConfig):
+@click.pass_context
+def serve(ctx, **kwargs):
+    # Create model instances
+    configs = create_models(ctx, kwargs, ServerConfig, DatabaseConfig)
+    server = configs[ServerConfig]
+    database = configs[DatabaseConfig]
+
     print(f"Starting server at {server.host}:{server.port}")
     print(f"Database: {database.db_url} (pool size: {database.pool_size})")
 ```
@@ -233,7 +242,7 @@ Automatically generate options for all fields:
 
 ```python
 import click
-from wry import AutoWryModel, generate_click_parameters
+from wry import AutoWryModel
 from pydantic import Field
 
 class QuickConfig(AutoWryModel):
@@ -244,7 +253,7 @@ class QuickConfig(AutoWryModel):
     email: str = Field(description="Your email")
 
 @click.command()
-@generate_click_parameters(QuickConfig)
+@QuickConfig.generate_click_parameters()
 def quickstart(config: QuickConfig):
     print(f"Hello {config.name}!")
 ```
@@ -307,8 +316,8 @@ By default, `generate_click_parameters` runs in strict mode to prevent common mi
 
 ```python
 @click.command()
-@generate_click_parameters(Config)  # strict=True by default
-@generate_click_parameters(Config)  # ERROR: Duplicate decorator detected!
+@Config.generate_click_parameters()  # strict=True by default
+@Config.generate_click_parameters()  # ERROR: Duplicate decorator detected!
 def main(**kwargs):
     pass
 ```
@@ -316,7 +325,7 @@ def main(**kwargs):
 To allow multiple decorators (not recommended):
 
 ```python
-@generate_click_parameters(Config, strict=False)
+@Config.generate_click_parameters(strict=False)
 ```
 
 ### Manual Field Control
@@ -517,6 +526,20 @@ The wry codebase is organized into focused modules:
 
 We welcome contributions! Please follow these guidelines to ensure a smooth process.
 
+### Development Setup
+
+To ensure consistency between local development and CI environments, we use pinned dependencies:
+
+```bash
+# Install development dependencies with exact versions
+pip install -r requirements-dev.txt
+
+# Install the package in editable mode
+pip install -e .
+```
+
+**Important**: Always use `requirements-dev.txt` for development to ensure your local environment matches CI/CD.
+
 ### Getting Started
 
 1. **Fork the repository** on GitHub
@@ -642,7 +665,33 @@ We welcome contributions! Please follow these guidelines to ensure a smooth proc
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Future Features
+
+### Automatic Model Instantiation (Proof of Concept)
+
+We're exploring a cleaner API that would automatically instantiate models and pass them to your function. See `examples/auto_instantiate_poc.py` for a working proof of concept:
+
+```python
+# Potential future syntax
+@click.command()
+@AppConfig.click_command()  # or @auto_instantiate(AppConfig)
+def main(config: AppConfig):
+    """The decorator would handle instantiation automatically."""
+    click.echo(f"Hello {config.name}!")
+    # Source tracking would work automatically too!
+```
+
+This would:
+
+- Automatically handle `@click.pass_context` when needed for source tracking
+- Instantiate the model and pass it with the correct parameter name
+- Support multiple models in a single command
+- Make the API more intuitive and similar to other libraries
+
+If you're interested in this feature, please provide feedback!
+
 ## Acknowledgments
 
 - Built on top of [Click](https://click.palletsprojects.com/) and [Pydantic](https://pydantic-docs.helpmanual.io/)
 - Inspired by the DRY (Don't Repeat Yourself) principle
+We'd also like to acknowledgme `pydanclick`, which uses a similar clean syntax (no kwargs to command functions). The code for this feature will be independently written given that `wry` supports source tracking, constraint help text creation, instantiation from config files, and several other features not supported by `pydanclick`.

{wry-0.1.9.dev1 → wry-0.1.10.dev4}/README.md

@@ -35,7 +35,7 @@ The simplest way to use wry is with `AutoWryModel`, which automatically generate
 ```python
 import click
 from pydantic import Field
-from wry import AutoWryModel, generate_click_parameters
+from wry import AutoWryModel
 
 class AppArgs(AutoWryModel):
     """Configuration for my app."""
@@ -45,9 +45,10 @@ class AppArgs(AutoWryModel):
     verbose: bool = Field(default=False, description="Verbose output")
 
 @click.command()
-@generate_click_parameters(AppArgs)
+@AppArgs.generate_click_parameters()
 def main(**kwargs):
     """My simple CLI application."""
+    # Create the model instance from kwargs
     config = AppArgs(**kwargs)
     click.echo(f"Hello {config.name}, you are {config.age} years old!")
 
@@ -55,6 +56,8 @@ if __name__ == "__main__":
     main()
 ```
 
+**Note**: Currently, `generate_click_parameters()` passes individual parameters as kwargs to your function. You need to instantiate the model yourself. See the [Future Features](#future-features) section for a potential cleaner API.
+
 Run it:
 
 ```bash
@@ -76,7 +79,7 @@ wry can track where each configuration value came from. You have two options:
 
 ```python
 @click.command()
-@generate_click_parameters(AppArgs)
+@AppArgs.generate_click_parameters()
 def main(**kwargs):
     # Simple instantiation - no source tracking
     config = AppArgs(**kwargs)
@@ -87,7 +90,7 @@ def main(**kwargs):
 
 ```python
 @click.command()
-@generate_click_parameters(AppArgs)
+@AppArgs.generate_click_parameters()
 @click.pass_context
 def main(ctx, **kwargs):
     # Full source tracking with context
@@ -164,7 +167,7 @@ Use multiple Pydantic models in a single command:
 ```python
 from typing import Annotated
 import click
-from wry import WryModel, AutoOption, generate_click_parameters, multi_model
+from wry import WryModel, AutoOption, multi_model, create_models
 
 class ServerConfig(WryModel):
     host: Annotated[str, AutoOption] = "localhost"
@@ -176,7 +179,13 @@ class DatabaseArgs(WryModel):
 
 @click.command()
 @multi_model(ServerConfig, DatabaseConfig)
-def serve(server: ServerConfig, database: DatabaseConfig):
+@click.pass_context
+def serve(ctx, **kwargs):
+    # Create model instances
+    configs = create_models(ctx, kwargs, ServerConfig, DatabaseConfig)
+    server = configs[ServerConfig]
+    database = configs[DatabaseConfig]
+
     print(f"Starting server at {server.host}:{server.port}")
     print(f"Database: {database.db_url} (pool size: {database.pool_size})")
 ```
@@ -187,7 +196,7 @@ Automatically generate options for all fields:
 
 ```python
 import click
-from wry import AutoWryModel, generate_click_parameters
+from wry import AutoWryModel
 from pydantic import Field
 
 class QuickConfig(AutoWryModel):
@@ -198,7 +207,7 @@ class QuickConfig(AutoWryModel):
     email: str = Field(description="Your email")
 
 @click.command()
-@generate_click_parameters(QuickConfig)
+@QuickConfig.generate_click_parameters()
 def quickstart(config: QuickConfig):
     print(f"Hello {config.name}!")
 ```
@@ -261,8 +270,8 @@ By default, `generate_click_parameters` runs in strict mode to prevent common mi
 
 ```python
 @click.command()
-@generate_click_parameters(Config)  # strict=True by default
-@generate_click_parameters(Config)  # ERROR: Duplicate decorator detected!
+@Config.generate_click_parameters()  # strict=True by default
+@Config.generate_click_parameters()  # ERROR: Duplicate decorator detected!
 def main(**kwargs):
     pass
 ```
@@ -270,7 +279,7 @@ def main(**kwargs):
 To allow multiple decorators (not recommended):
 
 ```python
-@generate_click_parameters(Config, strict=False)
+@Config.generate_click_parameters(strict=False)
 ```
 
 ### Manual Field Control
@@ -471,6 +480,20 @@ The wry codebase is organized into focused modules:
 
 We welcome contributions! Please follow these guidelines to ensure a smooth process.
 
+### Development Setup
+
+To ensure consistency between local development and CI environments, we use pinned dependencies:
+
+```bash
+# Install development dependencies with exact versions
+pip install -r requirements-dev.txt
+
+# Install the package in editable mode
+pip install -e .
+```
+
+**Important**: Always use `requirements-dev.txt` for development to ensure your local environment matches CI/CD.
+
 ### Getting Started
 
 1. **Fork the repository** on GitHub
@@ -596,7 +619,33 @@ We welcome contributions! Please follow these guidelines to ensure a smooth proc
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Future Features
+
+### Automatic Model Instantiation (Proof of Concept)
+
+We're exploring a cleaner API that would automatically instantiate models and pass them to your function. See `examples/auto_instantiate_poc.py` for a working proof of concept:
+
+```python
+# Potential future syntax
+@click.command()
+@AppConfig.click_command()  # or @auto_instantiate(AppConfig)
+def main(config: AppConfig):
+    """The decorator would handle instantiation automatically."""
+    click.echo(f"Hello {config.name}!")
+    # Source tracking would work automatically too!
+```
+
+This would:
+
+- Automatically handle `@click.pass_context` when needed for source tracking
+- Instantiate the model and pass it with the correct parameter name
+- Support multiple models in a single command
+- Make the API more intuitive and similar to other libraries
+
+If you're interested in this feature, please provide feedback!
+
 ## Acknowledgments
 
 - Built on top of [Click](https://click.palletsprojects.com/) and [Pydantic](https://pydantic-docs.helpmanual.io/)
 - Inspired by the DRY (Don't Repeat Yourself) principle
+We'd also like to acknowledgme `pydanclick`, which uses a similar clean syntax (no kwargs to command functions). The code for this feature will be independently written given that `wry` supports source tracking, constraint help text creation, instantiation from config files, and several other features not supported by `pydanclick`.

wry-0.1.10.dev4/RELEASE_PROCESS.md

@@ -0,0 +1,80 @@
+# Release Process for Wry
+
+This document outlines the correct process for creating a new release.
+
+## Release Checklist
+
+Follow these steps IN ORDER for each release:
+
+1. **Make all code changes**
+   - Implement features/fixes
+   - Ensure all tests pass (`./check.sh`)
+   - Fix any linting issues
+
+2. **Update documentation**
+   - Update README.md if needed
+   - Update any affected documentation
+
+3. **Update CHANGELOG.md**
+   - Add a new version section under `## [Unreleased]`
+   - Document all changes following [Keep a Changelog](https://keepachangelog.com/) format
+   - Update the comparison links at the bottom of the file
+
+4. **Commit all changes**
+   ```bash
+   git add -A
+   git commit -m "chore: prepare for vX.Y.Z release"
+   ```
+
+5. **Create signed tag**
+   ```bash
+   git tag -s vX.Y.Z -m "Release vX.Y.Z: brief description"
+   ```
+
+6. **Push changes and tag**
+   ```bash
+   git push origin main
+   git push origin vX.Y.Z
+   ```
+
+## Example
+
+For v0.1.8 release:
+
+```bash
+# 1. Make code changes
+# ... implement type annotation improvements ...
+
+# 2. Update CHANGELOG.md
+# Add new section:
+## [0.1.8] - 2025-09-10
+
+### Fixed
+- Improved type annotations for `generate_click_parameters` decorator
+
+# 3. Commit everything
+git add -A
+git commit -m "chore: prepare for v0.1.8 release"
+
+# 4. Create tag
+git tag -s v0.1.8 -m "Release v0.1.8: improve type annotations"
+
+# 5. Push
+git push origin main
+git push origin v0.1.8
+```
+
+## Common Mistakes to Avoid
+
+- ❌ Creating the tag before updating CHANGELOG.md
+- ❌ Forgetting to update comparison links in CHANGELOG.md
+- ❌ Not running `./check.sh` before tagging
+- ❌ Creating unsigned tags (always use `-s` for signed tags)
+
+## CI/CD Pipeline
+
+Once a tag is pushed, the GitHub Actions workflow will:
+1. Run all tests across Python 3.10, 3.11, and 3.12
+2. Build the distribution packages
+3. Publish to PyPI (for tags) or TestPyPI (for main branch)
+4. Create a GitHub release with notes from CHANGELOG.md