valid8r 0.6.2__tar.gz → 0.7.0__tar.gz

{valid8r-0.6.2 → valid8r-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: valid8r
-Version: 0.6.2
+Version: 0.7.0
 Summary: Clean, flexible input validation for Python applications
 License: MIT
 License-File: LICENSE
@@ -78,6 +78,30 @@ A clean, flexible input validation library for Python applications.
 - **Enums**: `parse_enum` (type-safe enum parsing)
 - **Custom**: `create_parser`, `make_parser`, `validated_parser` (parser factories)
 
+## Available Validators
+
+### Numeric Validators
+- **`minimum(min_value)`** - Ensures value is at least the minimum (inclusive)
+- **`maximum(max_value)`** - Ensures value is at most the maximum (inclusive)
+- **`between(min_value, max_value)`** - Ensures value is within range (inclusive)
+
+### String Validators
+- **`non_empty_string()`** - Rejects empty strings and whitespace-only strings
+- **`matches_regex(pattern)`** - Validates string matches regex pattern (string or compiled)
+- **`length(min_length, max_length)`** - Validates string length within bounds
+
+### Collection Validators
+- **`in_set(allowed_values)`** - Ensures value is in set of allowed values
+- **`unique_items()`** - Ensures all items in a list are unique
+- **`subset_of(allowed_set)`** - Validates set is subset of allowed values
+- **`superset_of(required_set)`** - Validates set is superset of required values
+- **`is_sorted(reverse=False)`** - Ensures list is sorted (ascending or descending)
+
+### Custom Validators
+- **`predicate(func, error_message)`** - Create custom validator from any predicate function
+
+**Note**: All validators support custom error messages and can be combined using `&` (and), `|` (or), and `~` (not) operators.
+
 ## Installation
 
 **Requirements**: Python 3.11 or higher
@@ -168,21 +192,21 @@ from valid8r.core.maybe import Success, Failure
 from valid8r.core import parsers
 
 # Phone number parsing with NANP validation (PhoneNumber)
-match parsers.parse_phone("+1 (555) 123-4567"):
+match parsers.parse_phone("+1 (415) 555-2671"):
     case Success(phone):
         print(f"Country: {phone.country_code}")  # 1
-        print(f"Area: {phone.area_code}")        # 555
-        print(f"Exchange: {phone.exchange}")     # 123
-        print(f"Subscriber: {phone.subscriber}") # 4567
+        print(f"Area: {phone.area_code}")        # 415
+        print(f"Exchange: {phone.exchange}")     # 555
+        print(f"Subscriber: {phone.subscriber}") # 2671
 
         # Format for display using properties
-        print(f"E.164: {phone.e164}")           # +15551234567
-        print(f"National: {phone.national}")    # (555) 123-4567
+        print(f"E.164: {phone.e164}")           # +14155552671
+        print(f"National: {phone.national}")    # (415) 555-2671
     case Failure(err):
         print("Error:", err)
 
 # Also accepts various formats
-for number in ["5551234567", "(555) 123-4567", "555-123-4567"]:
+for number in ["4155552671", "(415) 555-2671", "415-555-2671"]:
     result = parsers.parse_phone(number)
     assert result.is_success()
 ```
@@ -212,24 +236,26 @@ assert assert_maybe_failure(result, "at least 0")
 
 # Test prompts with mock input
 with MockInputContext(["yes", "42", "invalid", "25"]):
-    # First prompt
+    # First prompt - returns Maybe, unwrap with value_or()
     result = prompt.ask("Continue? ", parser=parsers.parse_bool)
     assert result.value_or(False) == True
 
-    # Second prompt
-    age = prompt.ask(
+    # Second prompt - unwrap the Maybe result
+    result = prompt.ask(
         "Age? ",
         parser=parsers.parse_int,
         validator=validate_age
     )
+    age = result.value_or(None)
     assert age == 42
 
-    # Third prompt will fail, fourth succeeds
-    age = prompt.ask(
+    # Third prompt will fail, fourth succeeds - unwrap result
+    result = prompt.ask(
         "Age again? ",
         parser=parsers.parse_int,
-        retries=1  # Retry once after failure
+        retry=1  # Retry once after failure
     )
+    age = result.value_or(None)
     assert age == 25
 ```
 

{valid8r-0.6.2 → valid8r-0.7.0}/README.md

@@ -47,6 +47,30 @@ A clean, flexible input validation library for Python applications.
 - **Enums**: `parse_enum` (type-safe enum parsing)
 - **Custom**: `create_parser`, `make_parser`, `validated_parser` (parser factories)
 
+## Available Validators
+
+### Numeric Validators
+- **`minimum(min_value)`** - Ensures value is at least the minimum (inclusive)
+- **`maximum(max_value)`** - Ensures value is at most the maximum (inclusive)
+- **`between(min_value, max_value)`** - Ensures value is within range (inclusive)
+
+### String Validators
+- **`non_empty_string()`** - Rejects empty strings and whitespace-only strings
+- **`matches_regex(pattern)`** - Validates string matches regex pattern (string or compiled)
+- **`length(min_length, max_length)`** - Validates string length within bounds
+
+### Collection Validators
+- **`in_set(allowed_values)`** - Ensures value is in set of allowed values
+- **`unique_items()`** - Ensures all items in a list are unique
+- **`subset_of(allowed_set)`** - Validates set is subset of allowed values
+- **`superset_of(required_set)`** - Validates set is superset of required values
+- **`is_sorted(reverse=False)`** - Ensures list is sorted (ascending or descending)
+
+### Custom Validators
+- **`predicate(func, error_message)`** - Create custom validator from any predicate function
+
+**Note**: All validators support custom error messages and can be combined using `&` (and), `|` (or), and `~` (not) operators.
+
 ## Installation
 
 **Requirements**: Python 3.11 or higher
@@ -137,21 +161,21 @@ from valid8r.core.maybe import Success, Failure
 from valid8r.core import parsers
 
 # Phone number parsing with NANP validation (PhoneNumber)
-match parsers.parse_phone("+1 (555) 123-4567"):
+match parsers.parse_phone("+1 (415) 555-2671"):
     case Success(phone):
         print(f"Country: {phone.country_code}")  # 1
-        print(f"Area: {phone.area_code}")        # 555
-        print(f"Exchange: {phone.exchange}")     # 123
-        print(f"Subscriber: {phone.subscriber}") # 4567
+        print(f"Area: {phone.area_code}")        # 415
+        print(f"Exchange: {phone.exchange}")     # 555
+        print(f"Subscriber: {phone.subscriber}") # 2671
 
         # Format for display using properties
-        print(f"E.164: {phone.e164}")           # +15551234567
-        print(f"National: {phone.national}")    # (555) 123-4567
+        print(f"E.164: {phone.e164}")           # +14155552671
+        print(f"National: {phone.national}")    # (415) 555-2671
     case Failure(err):
         print("Error:", err)
 
 # Also accepts various formats
-for number in ["5551234567", "(555) 123-4567", "555-123-4567"]:
+for number in ["4155552671", "(415) 555-2671", "415-555-2671"]:
     result = parsers.parse_phone(number)
     assert result.is_success()
 ```
@@ -181,24 +205,26 @@ assert assert_maybe_failure(result, "at least 0")
 
 # Test prompts with mock input
 with MockInputContext(["yes", "42", "invalid", "25"]):
-    # First prompt
+    # First prompt - returns Maybe, unwrap with value_or()
     result = prompt.ask("Continue? ", parser=parsers.parse_bool)
     assert result.value_or(False) == True
 
-    # Second prompt
-    age = prompt.ask(
+    # Second prompt - unwrap the Maybe result
+    result = prompt.ask(
         "Age? ",
         parser=parsers.parse_int,
         validator=validate_age
     )
+    age = result.value_or(None)
     assert age == 42
 
-    # Third prompt will fail, fourth succeeds
-    age = prompt.ask(
+    # Third prompt will fail, fourth succeeds - unwrap result
+    result = prompt.ask(
         "Age again? ",
         parser=parsers.parse_int,
-        retries=1  # Retry once after failure
+        retry=1  # Retry once after failure
     )
+    age = result.value_or(None)
     assert age == 25
 ```
 

{valid8r-0.6.2 → valid8r-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "valid8r"
-version = "0.6.2"
+version = "0.7.0"
 description = "Clean, flexible input validation for Python applications"
 authors = ["Mike Lane <mikelane@gmail.com>"]
 license = "MIT"

{valid8r-0.6.2 → valid8r-0.7.0}/valid8r/core/maybe.py

@@ -108,6 +108,10 @@ class Success(Maybe[T]):
         """Get a string representation."""
         return f'Success({self.value})'
 
+    def __repr__(self) -> str:
+        """Get a repr representation for debugging and doctests."""
+        return f'Success({self.value!r})'
+
 
 class Failure(Maybe[T]):
     """Represents a failed computation with an error message."""
@@ -160,3 +164,7 @@ class Failure(Maybe[T]):
     def __str__(self) -> str:
         """Get a string representation."""
         return f'Failure({self.error})'
+
+    def __repr__(self) -> str:
+        """Get a repr representation for debugging and doctests."""
+        return f'Failure({self.error!r})'