wry 0.2.3.dev1__py3-none-any.whl → 0.2.4.dev2__py3-none-any.whl

wry/__init__.py

@@ -46,7 +46,7 @@ Example:
 Coming soon - this package is under active development.
 """
 
-# Version is managed by poetry-dynamic-versioning from git tags
+# Version is managed by setuptools-scm from git tags
 try:
     from ._version import __commit_id__, __version__
 
@@ -91,6 +91,9 @@ AutoOption = AutoClickParameter.OPTION
 AutoArgument = AutoClickParameter.ARGUMENT
 AutoExclude = AutoClickParameter.EXCLUDE
 
+# Help system
+from .help_system import get_help_content, print_help, show_help_index  # noqa: E402
+
 # Re-export all public APIs
 __all__ = [
     # Core functionality
@@ -115,6 +118,11 @@ __all__ = [
     # Convenience exports
     "AutoOption",
     "AutoArgument",
+    "AutoExclude",
+    # Help system
+    "get_help_content",
+    "print_help",
+    "show_help_index",
     # Version info
     "__version__",
     "__version_full__",

wry/_version.py

@@ -1,14 +1,34 @@
-# file generated by poetry-dynamic-versioning
-from typing import TYPE_CHECKING
+# file generated by setuptools-scm
+# don't change, don't track in version control
 
-__version__: str = "0.2.3.dev1"  # This will be replaced during build
-__version_tuple__: tuple[int, ...] = (0, 2, 3, "dev1")  # This will be replaced during build
-__commit_id__: str | None = None  # This will be replaced during build
-
-# For compatibility with setuptools-scm test expectations
-VERSION_TUPLE = __version_tuple__
-COMMIT_ID = __commit_id__
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
-    # Version will be injected by poetry-dynamic-versioning
-    pass
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.2.4.dev2'
+__version_tuple__ = version_tuple = (0, 2, 4, 'dev2')
+
+__commit_id__ = commit_id = None

wry/help_system.py

@@ -0,0 +1,161 @@
+"""Help system for wry package.
+
+Provides different levels of documentation:
+- Quick help (README summary)
+- AI Knowledge Base (for LLMs)
+- Source tracking guide
+- Architecture documentation
+"""
+
+from pathlib import Path
+from typing import Literal
+
+HelpType = Literal["readme", "ai", "sources", "architecture", "examples"]
+
+
+def get_help_content(help_type: HelpType = "readme") -> str:
+    """Get help content of specified type.
+
+    Args:
+        help_type: Type of help to retrieve
+            - "readme": Main README documentation
+            - "ai": AI/LLM knowledge base
+            - "sources": Source tracking documentation
+            - "architecture": Architecture and design
+            - "examples": List of examples
+
+    Returns:
+        Help content as string
+    """
+    # Get package root directory
+    package_root = Path(__file__).parent.parent
+
+    if help_type == "readme":
+        readme_path = package_root / "README.md"
+        if readme_path.exists():
+            return readme_path.read_text()
+        return "README.md not found"
+
+    elif help_type == "ai":
+        ai_kb_path = package_root / "AI_KNOWLEDGE_BASE.md"
+        if ai_kb_path.exists():
+            return ai_kb_path.read_text()
+        return "AI_KNOWLEDGE_BASE.md not found"
+
+    elif help_type == "sources":
+        # Extract source tracking section from AI knowledge base
+        ai_kb_path = package_root / "AI_KNOWLEDGE_BASE.md"
+        if ai_kb_path.exists():
+            content = ai_kb_path.read_text()
+            # Find test coverage section
+            if "## Test Coverage Summary" in content:
+                start = content.index("## Test Coverage Summary")
+                # Find next major section or end
+                next_section = content.find("\n## Common Issues", start + 1)
+                if next_section > 0:
+                    return "# Source Tracking - " + content[start:next_section]
+                # Try another section
+                next_section = content.find("\n## ", start + 1)
+                if next_section > 0:
+                    return "# Source Tracking - " + content[start:next_section]
+                return "# Source Tracking - " + content[start:]
+        return "Source tracking documentation not found"
+
+    elif help_type == "architecture":
+        # Extract architecture section from README
+        readme_path = package_root / "README.md"
+        if readme_path.exists():
+            content = readme_path.read_text()
+            # Find architecture section
+            if "## Architecture" in content:
+                start = content.index("## Architecture")
+                # Find next major section
+                next_section = content.find("\n## ", start + 1)
+                if next_section > 0:
+                    return content[start:next_section]
+                return content[start:]
+        return "Architecture documentation not found"
+
+    elif help_type == "examples":
+        examples_dir = package_root / "examples"
+        if examples_dir.exists():
+            examples = []
+            examples.append("# wry Examples\n")
+            examples.append("\nAvailable examples in examples/ directory:\n")
+
+            for example_file in sorted(examples_dir.glob("*.py")):
+                # Read first docstring
+                content = example_file.read_text()
+                lines = content.split("\n")
+                description = ""
+                if lines and lines[0].startswith('"""'):
+                    # Multi-line docstring
+                    for line in lines[1:]:
+                        if '"""' in line:
+                            break
+                        description += line.strip() + " "
+
+                examples.append(f"\n**{example_file.name}**")
+                if description:
+                    examples.append(f"  {description.strip()}")
+                examples.append(f"  Run: `python examples/{example_file.name}`")
+
+            return "\n".join(examples)
+        return "Examples directory not found"
+
+
+def print_help(help_type: HelpType = "readme", pager: bool = True) -> None:
+    """Print help content, optionally using a pager.
+
+    Args:
+        help_type: Type of help to display
+        pager: If True, use click's pager for long content
+    """
+    import click
+
+    content = get_help_content(help_type)
+
+    if pager and len(content.split("\n")) > 50:
+        click.echo_via_pager(content)
+    else:
+        click.echo(content)
+
+
+def show_help_index() -> None:
+    """Show index of available help topics."""
+    import click
+
+    click.echo("=" * 60)
+    click.echo("wry Help System")
+    click.echo("=" * 60)
+    click.echo()
+    click.echo("Available help topics:")
+    click.echo()
+    click.echo("  readme       - Main README documentation (default)")
+    click.echo("  ai           - AI/LLM Knowledge Base (comprehensive)")
+    click.echo("  sources      - Source tracking test coverage")
+    click.echo("  architecture - Architecture and design documentation")
+    click.echo("  examples     - List of available examples")
+    click.echo()
+    click.echo("Usage:")
+    click.echo("  python -m wry.help_system [topic]")
+    click.echo("  python -m wry.help_system ai")
+    click.echo()
+    click.echo("Or in Python:")
+    click.echo("  from wry.help_system import print_help")
+    click.echo("  print_help('ai')")
+    click.echo()
+
+
+if __name__ == "__main__":
+    import sys
+
+    if len(sys.argv) > 1:
+        help_type_arg = sys.argv[1]
+        if help_type_arg in ["readme", "ai", "sources", "architecture", "examples"]:
+            print_help(help_type_arg)  # type: ignore
+        else:
+            print(f"Unknown help type: {help_type_arg}")
+            show_help_index()
+    else:
+        show_help_index()

{wry-0.2.3.dev1.dist-info → wry-0.2.4.dev2.dist-info}/METADATA

@@ -1,33 +1,46 @@
 Metadata-Version: 2.4
 Name: wry
-Version: 0.2.3.dev1
+Version: 0.2.4.dev2
 Summary: Why Repeat Yourself? - Define your CLI once with Pydantic models
+Author-email: Tyler House <26489166+tahouse@users.noreply.github.com>
 License: MIT
-License-File: LICENSE
+Project-URL: Homepage, https://github.com/tahouse/wry
+Project-URL: Documentation, https://github.com/tahouse/wry#readme
+Project-URL: Repository, https://github.com/tahouse/wry
+Project-URL: Issues, https://github.com/tahouse/wry/issues
+Project-URL: Changelog, https://github.com/tahouse/wry/blob/main/CHANGELOG.md
 Keywords: cli,pydantic,click,wry,dry,configuration,type-safe
-Author: Tyler House
-Author-email: 26489166+tahouse@users.noreply.github.com
-Requires-Python: >=3.10,<4.0
-Classifier: Development Status :: 1 - Planning
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 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: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: System Shells
 Classifier: Topic :: Utilities
-Requires-Dist: annotated-types (>=0.6.0,<0.7.0)
-Requires-Dist: click (>=8.0,<9.0)
-Requires-Dist: pydantic (>=2.9.2,<3.0.0)
-Requires-Dist: pydantic-core (>=2.23.4,<3.0.0)
-Project-URL: Documentation, https://github.com/tahouse/wry#readme
-Project-URL: Homepage, https://github.com/tahouse/wry
-Project-URL: Repository, https://github.com/tahouse/wry
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: pydantic>=2.9.2
+Requires-Dist: annotated-types>=0.6.0
+Requires-Dist: pydantic-core>=2.23.4
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.2; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.8.0; extra == "dev"
+Requires-Dist: coverage[toml]>=7.10.7; extra == "dev"
+Requires-Dist: ruff>=0.13.2; extra == "dev"
+Requires-Dist: mypy>=1.18.2; extra == "dev"
+Requires-Dist: build>=1.2.1; extra == "dev"
+Requires-Dist: twine>=6.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.8.0; extra == "dev"
+Requires-Dist: safety>=3.2.3; extra == "dev"
+Requires-Dist: bandit[toml]>=1.7.5; extra == "dev"
+Dynamic: license-file
 
 # wry - Why Repeat Yourself? CLI
 
@@ -104,9 +117,14 @@ Hello Bob, you are 35 years old!
 
 ## Value Source Tracking
 
-wry can track where each configuration value came from. You have two options:
+wry tracks where each configuration value came from, supporting all four sources:
 
-### Option 1: Direct Instantiation (No Source Tracking)
+- **DEFAULT**: Values from model field defaults
+- **ENV**: Values from environment variables
+- **JSON**: Values from configuration files (via `--config`)
+- **CLI**: Values from command-line arguments
+
+### Basic Usage (No Source Tracking)
 
 ```python
 @click.command()
@@ -114,10 +132,12 @@ wry can track where each configuration value came from. You have two options:
 def main(**kwargs):
     # Simple instantiation - no source tracking
     config = AppArgs(**kwargs)
-    # config.source.* will always show CLI regardless of actual source
+    # Works fine, but config.source.* will always show CLI
 ```
 
-### Option 2: With @click.pass_context (Full Source Tracking)
+### Full Source Tracking (Recommended)
+
+To enable accurate source tracking, use `@click.pass_context` and `from_click_context()`:
 
 ```python
 @click.command()
@@ -127,7 +147,7 @@ def main(ctx, **kwargs):
     # Full source tracking with context
     config = AppArgs.from_click_context(ctx, **kwargs)
 
-    # Now sources are accurate
+    # Check individual field sources
     print(config.source.name)     # ValueSource.CLI
     print(config.source.age)      # ValueSource.ENV
     print(config.source.verbose)  # ValueSource.DEFAULT
@@ -137,11 +157,37 @@ def main(ctx, **kwargs):
     # {
     #     ValueSource.CLI: ['name'],
     #     ValueSource.ENV: ['age'],
+    #     ValueSource.JSON: ['timeout'],
     #     ValueSource.DEFAULT: ['verbose']
     # }
 ```
 
-**Note**: `from_click_context()` requires a Click context. If you don't need source tracking, use direct instantiation.
+### Comprehensive Example
+
+See `examples/source_tracking_comprehensive.py` for a complete example showing all four sources working together. Run it with:
+
+```bash
+# With defaults only
+python examples/source_tracking_comprehensive.py
+
+# With environment variables
+export MYAPP_TIMEOUT=120
+export MYAPP_DEBUG=true
+python examples/source_tracking_comprehensive.py
+
+# Mix all sources (CLI > ENV > JSON > DEFAULT)
+export MYAPP_TIMEOUT=120
+python examples/source_tracking_comprehensive.py --config examples/sample_config.json --port 3000
+```
+
+**Output shows source for each field:**
+```
+host         = json-server.com      [from JSON]
+port         = 3000                 [from CLI]    ← CLI overrides JSON
+debug        = True                 [from ENV]
+timeout      = 120                  [from ENV]
+log_level    = DEBUG                [from JSON]
+```
 
 ## Configuration Precedence
 
@@ -363,14 +409,11 @@ cd wry
 python -m venv venv
 source venv/bin/activate  # On Windows: venv\Scripts\activate
 
-# Install Poetry (if not already installed)
-pip install poetry
-
-# Install all dependencies in development mode
-poetry install
+# Install package in development mode with dev dependencies
+pip install -e ".[dev]"
 
 # Install pre-commit hooks
-poetry run pre-commit install
+pre-commit install
 ```
 
 ### Running Tests
@@ -431,8 +474,7 @@ To ensure consistent behavior between local development and CI:
 Install the exact versions used in CI:
 
 ```bash
-poetry update
-poetry install
+pip install -e ".[dev]" --upgrade
 ```
 
 ### Coverage Requirements
@@ -517,42 +559,43 @@ We welcome contributions! Please follow these guidelines to ensure a smooth proc
 
 ### Development Setup
 
-We use Poetry for dependency management to ensure consistent environments:
+We use standard Python virtual environments and pip for dependency management:
 
 ```bash
-# Install Poetry (if not already installed)
-curl -sSL https://install.python-poetry.org | python3 -
-
-# Install dependencies (including dev dependencies)
-poetry install
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
 
-# Activate the virtual environment
-poetry shell
+# Install package in development mode with all dependencies
+pip install -e ".[dev]"
 ```
 
-**Important**: Poetry automatically creates an isolated virtual environment and uses `poetry.lock` to ensure everyone has the exact same dependencies.
+**Note**: All dependencies are specified in `pyproject.toml`. The `[dev]` extra includes testing, linting, and development tools.
 
-### Common Poetry Commands
+### Common Development Commands
 
 ```bash
-# Install dependencies from lock file
-poetry install
+# Install package in editable mode
+pip install -e ".[dev]"
 
-# Update dependencies within version constraints
-poetry update
+# Update dependencies
+pip install -e ".[dev]" --upgrade
 
-# Add a new dependency
-poetry add package-name
+# Show installed packages
+pip list
 
-# Add a development dependency
-poetry add --group dev package-name
+# Run tests
+pytest
 
-# Show installed packages
-poetry show
+# Run with coverage
+pytest --cov=wry
+
+# Run linting
+ruff check wry tests
+ruff format wry tests
 
-# Run commands in the Poetry environment
-poetry run python script.py
-poetry run pytest
+# Run type checking
+mypy wry
 ```
 
 ### Getting Started
@@ -582,9 +625,10 @@ poetry run pytest
 1. **Set up development environment**:
 
    ```bash
-   poetry install        # Creates venv and installs all dependencies
-   poetry shell          # Activate the virtual environment
-   poetry run pre-commit install  # Set up git hooks
+   python -m venv venv       # Create virtual environment
+   source venv/bin/activate  # Activate it
+   pip install -e ".[dev]"   # Install with dev dependencies
+   pre-commit install        # Set up git hooks
    ```
 
 2. **Make your changes**:
@@ -597,13 +641,16 @@ poetry run pytest
 
    ```bash
    # Run tests
-   poetry run pytest
+   pytest
 
-   # Check coverage (must be 100%)
-   poetry run pytest --cov=wry --cov-report=term-missing
+   # Check coverage (must be ≥90%)
+   pytest --cov=wry --cov-report=term-missing
 
    # Run linting
-   poetry run pre-commit run --all-files
+   pre-commit run --all-files
+   # Or run individual tools:
+   ruff check wry tests
+   mypy wry
    ```
 
 4. **Commit your changes**:
@@ -709,4 +756,3 @@ If you're interested in this feature, please provide feedback!
 - 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.2.3.dev1.dist-info → wry-0.2.4.dev2.dist-info}/RECORD

@@ -1,16 +1,18 @@
-wry/__init__.py,sha256=KDP1HwNl2_eF0QDE6p-ST6YAjrATnifnqaG0ECPr29Q,3305
-wry/_version.py,sha256=qmVMHVs6fvYQY9UunIZhHjcS7ZXKE-ONNZzMlBtZL7w,520
+wry/__init__.py,sha256=r42j1WbOhUjsB3lXyhX7H1vZATs2glLoeoxw69uAB_U,3496
+wry/_version.py,sha256=6GrTD3GXfrueUne3XEARvK2os8mc6r-itoSIHvfA0Ok,717
 wry/auto_model.py,sha256=YY71mkYr46P3O4cjY8fN0AmothtPcvsDqvk1eQM4VbE,6927
 wry/click_integration.py,sha256=XDeNDHGh99Now77vrGMo151xp0KjWZYm7nTuIHh6CU4,31775
+wry/help_system.py,sha256=zSryjsOXAWz9HyCpybwuFWrlaP9gwbMNIexuAWTcCns,5731
+wry/multi_model.py,sha256=f6Hf5NMfIZtdXc6t00iTPtUEbiWnQZiC7NKVchQ7QU4,5978
+wry/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wry/core/__init__.py,sha256=24Mu7qGzaFde8tAnyJOPPkD1ScZq-iSXNlDdAWSw_mg,894
 wry/core/accessors.py,sha256=Kn5dziklgcMWClOjbeJSwWNHOCQkpAWV9b1uH9ZGUPI,3708
 wry/core/env_utils.py,sha256=8TCgVPr7n5-YNThEVC5MvAG6qB0TW5MJkO1YT5yHZYI,4051
 wry/core/field_utils.py,sha256=nDFkbzfIf7mNJm6T5BuqcZ1mYUVIKinXfw77xpK_FK0,4134
 wry/core/model.py,sha256=CP0zElttAqpFHj2yD8O8CgMSm9VpSAT46nXcnCHw38U,25150
 wry/core/sources.py,sha256=4uboTc23f_CXiD3ql767-TvrGfe6xXN5NhXEIfNxD2U,1171
-wry/multi_model.py,sha256=f6Hf5NMfIZtdXc6t00iTPtUEbiWnQZiC7NKVchQ7QU4,5978
-wry/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-wry-0.2.3.dev1.dist-info/METADATA,sha256=viAAgfrP7T93g7xksj9_P9iTXjRx1b2G2-WQ-90Dm3g,19922
-wry-0.2.3.dev1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-wry-0.2.3.dev1.dist-info/licenses/LICENSE,sha256=0EfVapSdYZQRHpfqCVAO5OeyT2xMu8cxPKaRkWWdb2g,1068
-wry-0.2.3.dev1.dist-info/RECORD,,
+wry-0.2.4.dev2.dist-info/licenses/LICENSE,sha256=0EfVapSdYZQRHpfqCVAO5OeyT2xMu8cxPKaRkWWdb2g,1068
+wry-0.2.4.dev2.dist-info/METADATA,sha256=B269hopOo1ZmxLSonkPmMhwsisWk2D2u-yAcCBLVZ6g,21429
+wry-0.2.4.dev2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+wry-0.2.4.dev2.dist-info/top_level.txt,sha256=ytpYWd5uCeQpPCdTYaB1Vjzp4C5em03WpUKn3SiDDY8,4
+wry-0.2.4.dev2.dist-info/RECORD,,

{wry-0.2.3.dev1.dist-info → wry-0.2.4.dev2.dist-info}/WHEEL

@@ -1,4 +1,5 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.2.1
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
+

wry-0.2.4.dev2.dist-info/top_level.txt

@@ -0,0 +1 @@
+wry