valid8r 0.7.1__tar.gz → 0.7.3__tar.gz

{valid8r-0.7.1 → valid8r-0.7.3}/.github/CONVENTIONAL_COMMITS.md

@@ -25,7 +25,7 @@ This is a quick reference guide for writing conventional commits for the valid8r
 | `test` | 🔼 **patch** | Adding or updating tests | `test: add edge cases for validators` |
 | `chore` | 🔼 **patch** | Maintenance tasks | `chore: update dependencies` |
 | `ci` | ⚪ **none** | CI/CD changes | `ci: add Python 3.13 to matrix` |
-| `build` | ⚪ **none** | Build system changes | `build: update poetry config` |
+| `build` | ⚪ **none** | Build system changes | `build: update uv config` |
 
 ## Breaking Changes (Major Bump)
 
@@ -268,9 +268,9 @@ Before committing, check:
 
 ```bash
 # Run checks before committing
-poetry run ruff check .
-poetry run mypy valid8r
-poetry run pytest
+uv run ruff check .
+uv run mypy valid8r
+uv run pytest
 
 # Then commit
 git commit -m "feat(parsers): add parse_phone_number"

{valid8r-0.7.1 → valid8r-0.7.3}/.github/QUICK_REFERENCE.md

@@ -31,9 +31,9 @@ git commit -m "feat(parsers): add phone validation"
 gh pr create --fill
 
 # Run checks locally
-poetry run pytest
-poetry run mypy valid8r
-poetry run ruff check .
+uv run pytest
+uv run mypy valid8r
+uv run ruff check .
 ```
 
 ### Manual Workflow Triggers

{valid8r-0.7.1 → valid8r-0.7.3}/.github/README.md

@@ -184,9 +184,9 @@ git checkout -b feat/add-parser
 # ... edit code ...
 
 # 3. Run tests locally
-poetry run pytest
-poetry run mypy valid8r
-poetry run ruff check .
+uv run pytest
+uv run mypy valid8r
+uv run ruff check .
 
 # 4. Commit with conventional format
 git commit -m "feat(parsers): add phone number parser"
@@ -284,11 +284,11 @@ gh workflow run stale.yml
 
 **Run locally**:
 ```bash
-poetry run ruff check .
-poetry run ruff format --check .
-poetry run mypy valid8r
-poetry run pytest
-poetry run behave tests/bdd/features
+uv run ruff check .
+uv run ruff format --check .
+uv run mypy valid8r
+uv run pytest
+uv run behave tests/bdd/features
 ```
 
 Fix issues and push again.

{valid8r-0.7.1 → valid8r-0.7.3}/.github/SETUP_CHECKLIST.md

@@ -121,17 +121,16 @@ Create `test-pypi` environment (optional):
 
 ```bash
 # Ensure version is 0.1.0 in pyproject.toml
-poetry version 0.1.0
+# Version is managed by semantic-release, but for first publish verify it's set correctly
 
 # Build the package
-poetry build
+uv build
 
 # Publish to Test PyPI first (to verify)
-poetry config repositories.testpypi https://test.pypi.org/legacy/
-poetry publish -r testpypi --username __token__ --password pypi-...
+uv publish --publish-url https://test.pypi.org/legacy/ --token pypi-...
 
 # If test publish succeeds, publish to production PyPI
-poetry publish --username __token__ --password pypi-...
+uv publish --token pypi-...
 ```
 
 **Option B: Trusted Publisher** (More secure, no tokens needed)
@@ -219,8 +218,9 @@ Final verification checklist:
 **Expected behavior**: The workflow skips publishing if version exists.
 
 **If you need to republish**:
-1. Bump version manually: `poetry version patch`
-2. Commit and push to trigger new release
+1. Version bump happens automatically via semantic-release based on conventional commits
+2. Commit with appropriate conventional commit type and push to trigger new release
+3. Or manually trigger version bump: `gh workflow run semantic-release.yml`
 
 ### Issue: Required checks not appearing in branch protection
 

{valid8r-0.7.1 → valid8r-0.7.3}/.github/WORKFLOWS.md

@@ -240,7 +240,7 @@ vim valid8r/core/parsers.py
 vim tests/unit/test_parsers.py
 
 # Run tests locally
-poetry run pytest
+uv run pytest
 
 # Commit with conventional format
 git add .
@@ -386,11 +386,11 @@ gh workflow run version-and-release.yml -f version_bump=patch
 1. Check workflow run logs in GitHub Actions tab
 2. Run same checks locally:
    ```bash
-   poetry run ruff check .
-   poetry run ruff format --check .
-   poetry run mypy valid8r
-   poetry run pytest
-   poetry run behave tests/bdd/features
+   uv run ruff check .
+   uv run ruff format --check .
+   uv run mypy valid8r
+   uv run pytest
+   uv run behave tests/bdd/features
    ```
 3. Fix issues and push again
 

{valid8r-0.7.1 → valid8r-0.7.3}/.github/pull_request_template.md

@@ -31,7 +31,7 @@ Fixes #
 
 - [ ] Unit tests added/updated
 - [ ] BDD tests added/updated (if applicable)
-- [ ] All tests pass locally (`poetry run tox`)
+- [ ] All tests pass locally (`uv run tox`)
 - [ ] Test coverage maintained or improved
 
 ## Test Evidence
@@ -40,7 +40,7 @@ Fixes #
 
 ```
 # Example:
-$ poetry run pytest tests/unit/test_my_feature.py
+$ uv run pytest tests/unit/test_my_feature.py
 ================================ test session starts =================================
 collected 15 items
 
@@ -52,9 +52,9 @@ tests/unit/test_my_feature.py ............... [100%]
 
 ## Checklist
 
-- [ ] Code follows the project's style guidelines (`poetry run ruff check .`)
-- [ ] Code is formatted properly (`poetry run ruff format .`)
-- [ ] Type hints are complete and pass mypy (`poetry run mypy valid8r`)
+- [ ] Code follows the project's style guidelines (`uv run ruff check .`)
+- [ ] Code is formatted properly (`uv run ruff format .`)
+- [ ] Type hints are complete and pass mypy (`uv run mypy valid8r`)
 - [ ] Docstrings added/updated for public API
 - [ ] `__all__` exports updated if public API changed
 - [ ] CLAUDE.md updated if architecture/patterns changed
@@ -72,7 +72,7 @@ N/A
 - [ ] README.md updated (if needed)
 - [ ] API documentation updated (docstrings)
 - [ ] Usage examples added (if new feature)
-- [ ] Sphinx docs build successfully (`poetry run docs-build`)
+- [ ] Sphinx docs build successfully (`uv run docs-build`)
 
 # Additional Notes
 

{valid8r-0.7.1 → valid8r-0.7.3}/.readthedocs.yaml

@@ -10,14 +10,12 @@ build:
   tools:
     python: "3.11"
   commands:
-    # Install poetry
-    - pip install poetry
-    # Configure poetry to not create virtualenvs
-    - poetry config virtualenvs.create false
+    # Install uv
+    - pip install uv
     # Install all dependencies including the project itself
-    - poetry install --with docs --no-interaction
-    # Let Poetry run Sphinx to avoid dependency conflicts
-    - poetry run sphinx-build -b html docs $READTHEDOCS_OUTPUT/html
+    - uv sync --group docs
+    # Let uv run Sphinx to avoid dependency conflicts
+    - uv run sphinx-build -b html docs $READTHEDOCS_OUTPUT/html
 
 # Build documentation formats
 formats:

{valid8r-0.7.1 → valid8r-0.7.3}/CLAUDE.md

@@ -77,7 +77,11 @@ All new features MUST follow this exact workflow using the specialized agents de
 
 ## Common Development Commands
 
-**Note**: This project uses `uv` for dependency management (not Poetry). Install it with:
+**Note**: This project uses `uv` for dependency management. The migration from Poetry to uv was completed in November 2025 (PR #48), bringing 60% faster CI pipelines and 300x+ faster dependency resolution.
+
+See `docs/migration-poetry-to-uv.md` for the complete migration guide, including command comparisons and troubleshooting.
+
+**Install uv:**
 ```bash
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
@@ -156,15 +160,22 @@ uv run python smoke_test.py
 
 ### Dependency Management
 ```bash
-# Add a new dependency
+# Add a production dependency
 uv add requests
 
 # Add a dev dependency
-uv add --dev pytest-timeout
+uv add --group dev pytest-timeout
+
+# Add to specific dependency groups
+uv add --group test pytest-mock
+uv add --group docs sphinx-theme
 
 # Update all dependencies
 uv lock --upgrade
 
+# Update a specific package
+uv lock --upgrade-package requests
+
 # Export requirements for other tools
 uv export > requirements.txt
 ```

{valid8r-0.7.1 → valid8r-0.7.3}/CONTRIBUTING.md

@@ -24,8 +24,8 @@ This project adheres to the [Contributor Covenant Code of Conduct](CODE_OF_CONDU
 
 ### Prerequisites
 
-- Python 3.11 or higher
-- [Poetry](https://python-poetry.org/) for dependency management
+- Python 3.11 or higher (3.11-3.14 supported)
+- [uv](https://docs.astral.sh/uv/) for dependency management (10-100x faster than Poetry)
 - [pyenv](https://github.com/pyenv/pyenv) (recommended for managing Python versions)
 - Git
 
@@ -56,24 +56,32 @@ pyenv install 3.14.0
 pyenv local 3.11.11 3.12.9 3.13.5 3.14.0
 ```
 
-### 2. Install Poetry
+### 2. Install uv
 
 ```bash
-curl -sSL https://install.python-poetry.org | python3 -
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+**Verify installation:**
+```bash
+uv --version
+# Should show: uv 0.9.x or later
 ```
 
 ### 3. Install Dependencies
 
 ```bash
-poetry install
+uv sync
 ```
 
 This installs all dependencies including dev, test, lint, and docs groups.
 
+**Note**: If you previously used Poetry, see [docs/migration-poetry-to-uv.md](../docs/migration-poetry-to-uv.md) for migration instructions.
+
 ### 4. Set Up Pre-commit Hooks
 
 ```bash
-poetry run pre-commit install
+uv run pre-commit install
 ```
 
 Pre-commit hooks automatically:
@@ -101,16 +109,16 @@ Write clean, well-tested code following our style guidelines.
 
 ```bash
 # Run all tests with coverage
-poetry run tox
+uv run tox
 
 # Run only unit tests
-poetry run pytest tests/unit
+uv run pytest tests/unit
 
 # Run BDD tests
-poetry run tox -e bdd
+uv run tox -e bdd
 
 # Run linting
-poetry run tox -e lint
+uv run tox -e lint
 ```
 
 ### 4. Commit Your Changes
@@ -145,13 +153,13 @@ Then create a Pull Request on GitHub.
 
 ```bash
 # Format code with ruff
-poetry run ruff format .
+uv run ruff format .
 
 # Check and fix linting issues
-poetry run ruff check . --fix
+uv run ruff check . --fix
 
 # Check type hints
-poetry run mypy valid8r
+uv run mypy valid8r
 ```
 
 ### Code Patterns
@@ -312,7 +320,7 @@ See [.github/CONVENTIONAL_COMMITS.md](.github/CONVENTIONAL_COMMITS.md) for more
 
 ### Before Submitting
 
-1. Ensure all tests pass: `poetry run tox`
+1. Ensure all tests pass: `uv run tox`
 2. Update documentation if needed
 3. Add changelog entry if applicable
 4. Verify your commits follow the conventional commit format
@@ -403,10 +411,10 @@ def parse_email(text: str) -> Maybe[EmailAddress]:
 
 ```bash
 # Build documentation
-poetry run docs-build
+uv run docs-build
 
 # Serve with live reload
-poetry run docs-serve
+uv run docs-serve
 ```
 
 View at http://localhost:8000
@@ -431,17 +439,17 @@ View at http://localhost:8000
 
 ```bash
 # Run smoke test
-python smoke_test.py
+uv run python smoke_test.py
 
 # Check coverage
-poetry run pytest --cov=valid8r --cov-report=html tests/unit
+uv run pytest --cov=valid8r --cov-report=html tests/unit
 # View at htmlcov/index.html
 
 # Run specific test
-poetry run pytest tests/unit/test_parsers.py::DescribeParseInt::it_parses_positive_integers
+uv run pytest tests/unit/test_parsers.py::DescribeParseInt::it_parses_positive_integers
 
 # Watch mode (requires pytest-watch)
-poetry run ptw tests/unit
+uv run ptw tests/unit
 ```
 
 ### Debugging

valid8r-0.7.3/PKG-INFO

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: valid8r
+Version: 0.7.3
+Summary: Clean, flexible input validation for Python applications
+Project-URL: Homepage, https://valid8r.readthedocs.io/
+Project-URL: Repository, https://github.com/mikelane/valid8r
+Project-URL: Documentation, https://valid8r.readthedocs.io/
+Project-URL: Issues, https://github.com/mikelane/valid8r/issues
+Author-email: Mike Lane <mikelane@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,functional-programming,input,maybe-monad,parsing,validation
+Classifier: Development Status :: 5 - Production/Stable
+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.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 :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: email-validator>=2.3.0
+Requires-Dist: pydantic-core>=2.27.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: uuid-utils>=0.11.0
+Description-Content-Type: text/markdown
+
+# Valid8r
+
+[![PyPI version](https://img.shields.io/pypi/v/valid8r.svg)](https://pypi.org/project/valid8r/)
+[![Python versions](https://img.shields.io/pypi/pyversions/valid8r.svg)](https://pypi.org/project/valid8r/)
+[![License](https://img.shields.io/github/license/mikelane/valid8r.svg)](https://github.com/mikelane/valid8r/blob/main/LICENSE)
+[![CI Status](https://img.shields.io/github/actions/workflow/status/mikelane/valid8r/ci.yml?branch=main)](https://github.com/mikelane/valid8r/actions)
+[![codecov](https://codecov.io/gh/mikelane/valid8r/branch/main/graph/badge.svg)](https://codecov.io/gh/mikelane/valid8r)
+[![Documentation](https://img.shields.io/readthedocs/valid8r.svg)](https://valid8r.readthedocs.io/)
+
+**Clean, composable input validation for Python using functional programming patterns.**
+
+Valid8r makes input validation elegant and type-safe by using the Maybe monad for error handling. No more try-except blocks or boolean validation chains—just clean, composable parsers that tell you exactly what went wrong.
+
+```python
+from valid8r import parsers, validators, prompt
+
+# Parse and validate user input with rich error messages
+age = prompt.ask(
+    "Enter your age: ",
+    parser=parsers.parse_int,
+    validator=validators.minimum(0) & validators.maximum(120)
+)
+
+print(f"Your age is {age}")
+```
+
+## Why Valid8r?
+
+**Type-Safe Parsing**: Every parser returns `Maybe[T]` (Success or Failure), making error handling explicit and composable.
+
+**Rich Structured Results**: Network parsers return dataclasses with parsed components—no more manual URL/email splitting.
+
+**Chainable Validators**: Combine validators using `&` (and), `|` (or), and `~` (not) operators for complex validation logic.
+
+**Zero Dependencies**: Core library uses only Python's standard library (with optional `uuid-utils` for faster UUID parsing).
+
+**Interactive Prompts**: Built-in user input prompting with automatic retry and validation.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install valid8r
+```
+
+**Requirements**: Python 3.11 or higher
+
+### Basic Parsing
+
+```python
+from valid8r import parsers
+from valid8r.core.maybe import Success, Failure
+
+# Parse integers with automatic error handling
+match parsers.parse_int("42"):
+    case Success(value):
+        print(f"Parsed: {value}")  # Parsed: 42
+    case Failure(error):
+        print(f"Error: {error}")
+
+# Parse dates (ISO 8601 format)
+result = parsers.parse_date("2025-01-15")
+assert result.is_success()
+
+# Parse UUIDs with version validation
+result = parsers.parse_uuid("550e8400-e29b-41d4-a716-446655440000", version=4)
+assert result.is_success()
+```
+
+### Validation with Combinators
+
+```python
+from valid8r import validators
+
+# Combine validators using operators
+age_validator = validators.minimum(0) & validators.maximum(120)
+result = age_validator(42)
+assert result.is_success()
+
+# String validation
+password_validator = (
+    validators.length(8, 128) &
+    validators.matches_regex(r'^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d@$!%*#?&]')
+)
+
+# Set validation
+tags_validator = validators.subset_of({'python', 'rust', 'go', 'typescript'})
+```
+
+### Structured Network Parsing
+
+```python
+from valid8r import parsers
+
+# Parse URLs into structured components
+match parsers.parse_url("https://user:pass@example.com:8443/path?query=1#fragment"):
+    case Success(url):
+        print(f"Scheme: {url.scheme}")      # https
+        print(f"Host: {url.host}")          # example.com
+        print(f"Port: {url.port}")          # 8443
+        print(f"Path: {url.path}")          # /path
+        print(f"Query: {url.query}")        # {'query': '1'}
+        print(f"Fragment: {url.fragment}")  # fragment
+
+# Parse emails with normalized domains
+match parsers.parse_email("User@Example.COM"):
+    case Success(email):
+        print(f"Local: {email.local}")    # User
+        print(f"Domain: {email.domain}")  # example.com (normalized)
+
+# Parse phone numbers (NANP format)
+match parsers.parse_phone("+1 (415) 555-2671"):
+    case Success(phone):
+        print(f"E.164: {phone.e164}")      # +14155552671
+        print(f"National: {phone.national}")  # (415) 555-2671
+```
+
+### Collection Parsing
+
+```python
+from valid8r import parsers
+
+# Parse lists with element validation
+result = parsers.parse_list("1,2,3,4,5", element_parser=parsers.parse_int)
+assert result.value_or([]) == [1, 2, 3, 4, 5]
+
+# Parse dictionaries with key/value parsers
+result = parsers.parse_dict(
+    "name=Alice,age=30",
+    key_parser=lambda x: Success(x),
+    value_parser=lambda x: parsers.parse_int(x) if x.isdigit() else Success(x)
+)
+```
+
+### Interactive Prompting
+
+```python
+from valid8r import prompt, parsers, validators
+
+# Prompt with validation and automatic retry
+email = prompt.ask(
+    "Email address: ",
+    parser=parsers.parse_email,
+    retry=2  # Retry twice on invalid input
+)
+
+# Combine parsing and validation
+port = prompt.ask(
+    "Server port: ",
+    parser=parsers.parse_int,
+    validator=validators.between(1024, 65535),
+    retry=3
+)
+```
+
+## Features
+
+### Parsers
+
+**Basic Types**:
+- `parse_int`, `parse_float`, `parse_bool`, `parse_decimal`, `parse_complex`
+- `parse_date` (ISO 8601), `parse_uuid` (with version validation)
+
+**Collections**:
+- `parse_list`, `parse_dict`, `parse_set` (with element parsers)
+
+**Network & Communication**:
+- `parse_ipv4`, `parse_ipv6`, `parse_ip`, `parse_cidr`
+- `parse_url` → `UrlParts` (structured URL components)
+- `parse_email` → `EmailAddress` (normalized domain)
+- `parse_phone` → `PhoneNumber` (NANP validation with E.164 formatting)
+
+**Advanced**:
+- `parse_enum` (type-safe enum parsing)
+- `create_parser`, `make_parser`, `validated_parser` (custom parser factories)
+
+### Validators
+
+**Numeric**: `minimum`, `maximum`, `between`
+
+**String**: `non_empty_string`, `matches_regex`, `length`
+
+**Collection**: `in_set`, `unique_items`, `subset_of`, `superset_of`, `is_sorted`
+
+**Custom**: `predicate` (create validators from any function)
+
+**Combinators**: Combine validators using `&` (and), `|` (or), `~` (not)
+
+### Testing Utilities
+
+```python
+from valid8r.testing import (
+    assert_maybe_success,
+    assert_maybe_failure,
+    MockInputContext,
+)
+
+# Test validation logic
+result = validators.minimum(0)(42)
+assert assert_maybe_success(result, 42)
+
+result = validators.minimum(0)(-5)
+assert assert_maybe_failure(result, "at least 0")
+
+# Mock user input for testing prompts
+with MockInputContext(["invalid", "valid@example.com"]):
+    result = prompt.ask("Email: ", parser=parsers.parse_email, retry=1)
+    assert result.is_success()
+```
+
+## Documentation
+
+**Full documentation**: [valid8r.readthedocs.io](https://valid8r.readthedocs.io/)
+
+- [API Reference](https://valid8r.readthedocs.io/en/latest/api.html)
+- [Parser Guide](https://valid8r.readthedocs.io/en/latest/parsers.html)
+- [Validator Guide](https://valid8r.readthedocs.io/en/latest/validators.html)
+- [Testing Guide](https://valid8r.readthedocs.io/en/latest/testing.html)
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+**Quick links**:
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Development Setup](CONTRIBUTING.md#development-setup)
+- [Commit Message Format](CONTRIBUTING.md#commit-messages)
+- [Pull Request Process](CONTRIBUTING.md#pull-request-process)
+
+### Development Quick Start
+
+```bash
+# Install uv (fast dependency manager)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Clone and install dependencies
+git clone https://github.com/mikelane/valid8r
+cd valid8r
+uv sync
+
+# Run tests
+uv run tox
+
+# Run linters
+uv run ruff check .
+uv run ruff format .
+uv run mypy valid8r
+```
+
+## Project Status
+
+Valid8r is in active development (v0.7.x). The API is stabilizing but may change before v1.0.0.
+
+- ✅ Core parsers and validators
+- ✅ Maybe monad error handling
+- ✅ Interactive prompting
+- ✅ Network parsers (URL, Email, IP, Phone)
+- ✅ Collection parsers
+- ✅ Comprehensive testing utilities
+- 🚧 Additional validators (in progress)
+- 🚧 Custom error types (planned)
+
+See [ROADMAP.md](ROADMAP.md) for planned features.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+Copyright (c) 2025 Mike Lane
+
+---
+
+**Made with ❤️ for the Python community**