capper 0.1.1__tar.gz → 0.3.0__tar.gz

{capper-0.1.1/capper.egg-info → capper-0.3.0}/PKG-INFO

@@ -1,26 +1,34 @@
 Metadata-Version: 2.4
 Name: capper
-Version: 0.1.1
+Version: 0.3.0
 Summary: Semantic, typed wrappers for Faker with automatic Polyfactory integration
 Author-email: Odos Matthews <odosmatthews@gmail.com>
 Project-URL: Documentation, https://github.com/eddiethedean/capper#readme
 Project-URL: Repository, https://github.com/eddiethedean/capper
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: Faker>=20.0
 Requires-Dist: Polyfactory>=2.0
 Provides-Extra: pydantic
 Requires-Dist: pydantic>=2.0; extra == "pydantic"
+Provides-Extra: hypothesis
+Requires-Dist: hypothesis>=6.0; extra == "hypothesis"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Requires-Dist: pytest-xdist>=3.0; extra == "dev"
 Requires-Dist: pydantic>=2.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: hypothesis>=6.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
 
 # Capper
 
 [![PyPI](https://img.shields.io/pypi/v/capper.svg)](https://pypi.org/project/capper/)
-[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://pypi.org/project/capper/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://pypi.org/project/capper/)
 [![CI](https://img.shields.io/github/actions/workflow/status/eddiethedean/capper/ci.yml?branch=main&label=CI)](https://github.com/eddiethedean/capper/actions/workflows/ci.yml)
 [![Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://docs.astral.sh/ruff/)
 [![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
@@ -42,11 +50,10 @@ Semantic, typed wrappers for [Faker](https://faker.readthedocs.io/) with automat
 pip install capper
 ```
 
-Requires **Python 3.9+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. For **Pydantic** models, install the optional extra:
+Requires **Python 3.10+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. Optional extras:
 
-```bash
-pip install capper[pydantic]
-```
+- **Pydantic** (for Pydantic models): `pip install capper[pydantic]`
+- **Hypothesis** (for property-based tests with `st.from_type(...)`): `pip install capper[hypothesis]`
 
 ## Usage
 
@@ -117,6 +124,10 @@ Works automatically. No extra steps. IDE autocompletion.
 - **Text**: `Paragraph`, `Sentence`
 - **Phone**: `PhoneNumber`, `CountryCallingCode`
 - **Finance**: `CreditCardNumber`, `CreditCardExpiry`, `CreditCardProvider`
+- **File**: `FilePath`, `FileName`, `FileExtension`
+- **Misc**: `UUID`
+- **Color**: `HexColor`
+- **Barcode**: `EAN13`, `EAN8`
 
 Import from the top level: `from capper import Name, Email, Address, ...`  
 See [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/docs/FAKER_PROVIDERS.md) for the Faker provider used by each type.
@@ -125,9 +136,20 @@ See [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/d
 
 **Custom types:** Subclass `FakerType`, set `faker_provider` to the Faker method name (e.g. `"company"`), and optionally `faker_kwargs`. The type auto-registers with Polyfactory when the class is defined.
 
+## CLI
+
+Generate fake values from the command line:
+
+```bash
+capper generate Name Email --count 5
+capper generate Name Email --count 3 --seed 42
+```
+
+Use `-n`/`--count` for the number of rows and `-s`/`--seed` for reproducible output. Type names are the same as the Python types (e.g. `Name`, `Email`, `Address`).
+
 ## Compatibility
 
-Capper targets **Faker >= 20.0** and **Polyfactory >= 2.0**. Major Faker upgrades may change or rename provider methods; if a type fails, check [Faker's changelog](https://faker.readthedocs.io/en/stable/changelog.html) and [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/docs/FAKER_PROVIDERS.md) and update the provider name if needed.
+Capper targets **Python 3.10+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. For version ranges, upgrade guidance, and the deprecation policy, see [Compatibility](docs/compatibility.md).
 
 ## Development
 
@@ -136,6 +158,8 @@ pip install -e ".[dev]"
 pytest capper/tests
 ```
 
+Lint and type-check: `ruff check .`, `ruff format .`, `mypy capper`.
+
 Run tests with coverage: `pytest capper/tests --cov=capper --cov-report=term-missing`.
 
 **Reproducibility:** Capper and Polyfactory share the same Faker instance, so one seed controls both capper types and built-in types (`str`, `int`, etc.):
@@ -159,20 +183,23 @@ UserFactory.seed_random(42)
 user2 = UserFactory.build()  # same data as user1 if you seed the same before each
 ```
 
-Use `UserFactory.__random_seed__ = 42` to seed once when the factory class is created, or call `seed(42)` / `UserFactory.seed_random(42)` before each build for identical builds.
+Use `UserFactory.__random_seed__ = 42` to seed once when the factory class is created, or call `seed(42)` / `UserFactory.seed_random(42)` before each build for identical builds. For a custom locale (e.g. German names), use **`use_faker(Faker('de_DE'))`** so both Capper and Polyfactory use the same Faker instance; see [Reproducible data](docs/user_guides/reproducible_data.md#locales-and-custom-faker).
 
 ## Publishing
 
 Releases are built and published to PyPI via [GitHub Actions](https://github.com/eddiethedean/capper/blob/main/.github/workflows/publish.yml). To publish:
 
-1. Add a `PYPI_API_TOKEN` secret (PyPI API token) to the repo.
-2. Create a GitHub release (tag e.g. `v0.1.0`). The workflow runs tests, builds the package, and uploads to PyPI.
+1. Update [CHANGELOG.md](CHANGELOG.md): move Unreleased entries into a new version section and date it.
+2. Add a `PYPI_API_TOKEN` secret (PyPI API token) to the repo.
+3. Create a GitHub release (tag e.g. `v0.3.0`). The workflow runs tests, builds the package, and uploads to PyPI.
 
 To build and upload manually: `pip install build twine`, `python -m build`, `twine upload dist/*`.
 
 ## Documentation
 
 - **[Docs index](docs/README.md)** — overview and links to all documentation
+- **[API reference](docs/api.md)** — generated API docs (build with `mkdocs serve`; see [Contributing](CONTRIBUTING.md))
+- **[Contributing](CONTRIBUTING.md)** — dev setup and how to add new types
 - **User guides** (step-by-step, with runnable examples):
   - [Getting started](docs/user_guides/getting_started.md) — install, first model, first factory
   - [Models and factories](docs/user_guides/models_and_factories.md) — Pydantic, dataclasses, batches
@@ -181,3 +208,4 @@ To build and upload manually: `pip install build twine`, `python -m build`, `twi
 - [Package plan](docs/capper_package_plan.md) — design and rationale
 - [Roadmap](docs/ROADMAP.md) — development phases and status
 - [Faker provider mapping](docs/FAKER_PROVIDERS.md) — which Faker method each type uses
+- [Example notebooks](docs/notebooks/README.md) — Jupyter notebooks in `docs/notebooks/`

capper-0.1.1/PKG-INFO → capper-0.3.0/README.md

@@ -1,26 +1,7 @@
-Metadata-Version: 2.4
-Name: capper
-Version: 0.1.1
-Summary: Semantic, typed wrappers for Faker with automatic Polyfactory integration
-Author-email: Odos Matthews <odosmatthews@gmail.com>
-Project-URL: Documentation, https://github.com/eddiethedean/capper#readme
-Project-URL: Repository, https://github.com/eddiethedean/capper
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: Faker>=20.0
-Requires-Dist: Polyfactory>=2.0
-Provides-Extra: pydantic
-Requires-Dist: pydantic>=2.0; extra == "pydantic"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: pytest-xdist>=3.0; extra == "dev"
-Requires-Dist: pydantic>=2.0; extra == "dev"
-
 # Capper
 
 [![PyPI](https://img.shields.io/pypi/v/capper.svg)](https://pypi.org/project/capper/)
-[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://pypi.org/project/capper/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://pypi.org/project/capper/)
 [![CI](https://img.shields.io/github/actions/workflow/status/eddiethedean/capper/ci.yml?branch=main&label=CI)](https://github.com/eddiethedean/capper/actions/workflows/ci.yml)
 [![Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://docs.astral.sh/ruff/)
 [![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
@@ -42,11 +23,10 @@ Semantic, typed wrappers for [Faker](https://faker.readthedocs.io/) with automat
 pip install capper
 ```
 
-Requires **Python 3.9+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. For **Pydantic** models, install the optional extra:
+Requires **Python 3.10+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. Optional extras:
 
-```bash
-pip install capper[pydantic]
-```
+- **Pydantic** (for Pydantic models): `pip install capper[pydantic]`
+- **Hypothesis** (for property-based tests with `st.from_type(...)`): `pip install capper[hypothesis]`
 
 ## Usage
 
@@ -117,6 +97,10 @@ Works automatically. No extra steps. IDE autocompletion.
 - **Text**: `Paragraph`, `Sentence`
 - **Phone**: `PhoneNumber`, `CountryCallingCode`
 - **Finance**: `CreditCardNumber`, `CreditCardExpiry`, `CreditCardProvider`
+- **File**: `FilePath`, `FileName`, `FileExtension`
+- **Misc**: `UUID`
+- **Color**: `HexColor`
+- **Barcode**: `EAN13`, `EAN8`
 
 Import from the top level: `from capper import Name, Email, Address, ...`  
 See [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/docs/FAKER_PROVIDERS.md) for the Faker provider used by each type.
@@ -125,9 +109,20 @@ See [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/d
 
 **Custom types:** Subclass `FakerType`, set `faker_provider` to the Faker method name (e.g. `"company"`), and optionally `faker_kwargs`. The type auto-registers with Polyfactory when the class is defined.
 
+## CLI
+
+Generate fake values from the command line:
+
+```bash
+capper generate Name Email --count 5
+capper generate Name Email --count 3 --seed 42
+```
+
+Use `-n`/`--count` for the number of rows and `-s`/`--seed` for reproducible output. Type names are the same as the Python types (e.g. `Name`, `Email`, `Address`).
+
 ## Compatibility
 
-Capper targets **Faker >= 20.0** and **Polyfactory >= 2.0**. Major Faker upgrades may change or rename provider methods; if a type fails, check [Faker's changelog](https://faker.readthedocs.io/en/stable/changelog.html) and [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/docs/FAKER_PROVIDERS.md) and update the provider name if needed.
+Capper targets **Python 3.10+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. For version ranges, upgrade guidance, and the deprecation policy, see [Compatibility](docs/compatibility.md).
 
 ## Development
 
@@ -136,6 +131,8 @@ pip install -e ".[dev]"
 pytest capper/tests
 ```
 
+Lint and type-check: `ruff check .`, `ruff format .`, `mypy capper`.
+
 Run tests with coverage: `pytest capper/tests --cov=capper --cov-report=term-missing`.
 
 **Reproducibility:** Capper and Polyfactory share the same Faker instance, so one seed controls both capper types and built-in types (`str`, `int`, etc.):
@@ -159,20 +156,23 @@ UserFactory.seed_random(42)
 user2 = UserFactory.build()  # same data as user1 if you seed the same before each
 ```
 
-Use `UserFactory.__random_seed__ = 42` to seed once when the factory class is created, or call `seed(42)` / `UserFactory.seed_random(42)` before each build for identical builds.
+Use `UserFactory.__random_seed__ = 42` to seed once when the factory class is created, or call `seed(42)` / `UserFactory.seed_random(42)` before each build for identical builds. For a custom locale (e.g. German names), use **`use_faker(Faker('de_DE'))`** so both Capper and Polyfactory use the same Faker instance; see [Reproducible data](docs/user_guides/reproducible_data.md#locales-and-custom-faker).
 
 ## Publishing
 
 Releases are built and published to PyPI via [GitHub Actions](https://github.com/eddiethedean/capper/blob/main/.github/workflows/publish.yml). To publish:
 
-1. Add a `PYPI_API_TOKEN` secret (PyPI API token) to the repo.
-2. Create a GitHub release (tag e.g. `v0.1.0`). The workflow runs tests, builds the package, and uploads to PyPI.
+1. Update [CHANGELOG.md](CHANGELOG.md): move Unreleased entries into a new version section and date it.
+2. Add a `PYPI_API_TOKEN` secret (PyPI API token) to the repo.
+3. Create a GitHub release (tag e.g. `v0.3.0`). The workflow runs tests, builds the package, and uploads to PyPI.
 
 To build and upload manually: `pip install build twine`, `python -m build`, `twine upload dist/*`.
 
 ## Documentation
 
 - **[Docs index](docs/README.md)** — overview and links to all documentation
+- **[API reference](docs/api.md)** — generated API docs (build with `mkdocs serve`; see [Contributing](CONTRIBUTING.md))
+- **[Contributing](CONTRIBUTING.md)** — dev setup and how to add new types
 - **User guides** (step-by-step, with runnable examples):
   - [Getting started](docs/user_guides/getting_started.md) — install, first model, first factory
   - [Models and factories](docs/user_guides/models_and_factories.md) — Pydantic, dataclasses, batches
@@ -181,3 +181,4 @@ To build and upload manually: `pip install build twine`, `python -m build`, `twi
 - [Package plan](docs/capper_package_plan.md) — design and rationale
 - [Roadmap](docs/ROADMAP.md) — development phases and status
 - [Faker provider mapping](docs/FAKER_PROVIDERS.md) — which Faker method each type uses
+- [Example notebooks](docs/notebooks/README.md) — Jupyter notebooks in `docs/notebooks/`

{capper-0.1.1 → capper-0.3.0}/capper/__init__.py

@@ -2,14 +2,27 @@
 
 Import types (e.g. ``Name``, ``Email``) and use them in Pydantic models, dataclasses,
 or attrs; Polyfactory will generate values via Faker. Use ``seed(n)`` for reproducibility.
+With Hypothesis installed (pip install capper[hypothesis]), import capper.strategies
+and use st.from_type(Name) for property-based tests.
 """
 
-from .base import FakerType, faker, seed
+try:
+    from importlib.metadata import version as _version
+
+    __version__ = _version("capper")
+except Exception:  # Package not installed (e.g. dev tree) or metadata missing
+    __version__ = "0.3.0"
+
+from .barcode import EAN8, EAN13
+from .base import FakerType, faker, seed, use_faker
+from .color import HexColor
 from .commerce import Company, Currency, Price, Product
 from .date_time import Date, DateTime, Time
+from .file import FileExtension, FileName, FilePath
 from .finance import CreditCardExpiry, CreditCardNumber, CreditCardProvider
 from .geo import Address, City, Country
-from .internet import Email, IP, URL, UserName
+from .internet import IP, URL, Email, UserName
+from .misc import UUID
 from .person import FirstName, Job, LastName, Name
 from .phone import CountryCallingCode, PhoneNumber
 from .text import Paragraph, Sentence
@@ -26,9 +39,15 @@ __all__ = [
     "Currency",
     "Date",
     "DateTime",
+    "EAN13",
+    "EAN8",
     "Email",
     "FakerType",
+    "FileExtension",
+    "FileName",
+    "FilePath",
     "FirstName",
+    "HexColor",
     "IP",
     "Job",
     "LastName",
@@ -40,7 +59,9 @@ __all__ = [
     "Sentence",
     "Time",
     "URL",
+    "UUID",
     "UserName",
     "faker",
     "seed",
+    "use_faker",
 ]

capper-0.3.0/capper/barcode.py

@@ -0,0 +1,15 @@
+"""Barcode-related semantic Faker types."""
+
+from .base import FakerType
+
+
+class EAN13(FakerType):
+    """EAN-13 barcode. Uses Faker provider ``ean13``."""
+
+    faker_provider = "ean13"
+
+
+class EAN8(FakerType):
+    """EAN-8 barcode. Uses Faker provider ``ean8``."""
+
+    faker_provider = "ean8"

{capper-0.1.1 → capper-0.3.0}/capper/base.py

@@ -2,6 +2,9 @@
 
 The module-level ``faker`` is attached to Polyfactory's BaseFactory so that one seed
 controls both capper types and built-in types. Use ``seed(n)`` for reproducible data.
+
+Note: The shared ``faker`` and ``use_faker()`` are not thread-safe; do not switch
+the global Faker from multiple threads while building models.
 """
 
 from typing import Any
@@ -24,6 +27,24 @@ def seed(seed_value: int) -> None:
     faker.seed_instance(seed_value)
 
 
+def use_faker(instance: Faker) -> None:
+    """Use a custom Faker instance for both Capper and Polyfactory.
+
+    Replaces the module-level faker and Polyfactory's BaseFactory.__faker__
+    so that one instance (e.g. a locale-specific Faker) is used everywhere.
+    Call before building any models.
+
+    Note: The shared faker is not thread-safe. Do not call use_faker() from
+    multiple threads while other threads are building models.
+
+    Args:
+        instance: The Faker instance to use (e.g. Faker('de_DE')).
+    """
+    global faker
+    faker = instance
+    BaseFactory.__faker__ = instance
+
+
 def _install_pydantic_schema() -> None:
     """If Pydantic is available, attach __get_pydantic_core_schema__ to FakerType."""
     try:
@@ -32,9 +53,7 @@ def _install_pydantic_schema() -> None:
     except ImportError:
         return
 
-    def __get_pydantic_core_schema__(
-        source_type: Any, handler: GetCoreSchemaHandler
-    ) -> CoreSchema:
+    def __get_pydantic_core_schema__(source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
         """Validate as str then coerce to the FakerType subclass."""
         return core_schema.no_info_after_validator_function(source_type, handler(str))
 
@@ -42,11 +61,12 @@ def _install_pydantic_schema() -> None:
 
 
 class FakerType(str):
-    """Base class for semantic Faker types; subclasses are auto-registered with Polyfactory.
+    """Base class for semantic Faker types; subclasses auto-register with Polyfactory.
 
     Subclasses must set a non-empty ``faker_provider`` (the Faker method name).
     Optional ``faker_kwargs`` is a dict of keyword arguments passed to that provider
     (e.g. ``faker_kwargs = {"nb_words": 10}`` for ``sentence``).
+    When Hypothesis is installed, use ``st.from_type(YourFakerType)`` for property-based tests.
     """
 
     faker_provider: str = ""
@@ -63,7 +83,15 @@ _install_pydantic_schema()
 
 def _register(cls: type, provider_name: str) -> None:
     """Register a FakerType subclass with Polyfactory so factories can generate values."""
-    provider_kwargs = getattr(cls, "faker_kwargs", None) or {}
+    if not hasattr(faker, provider_name):
+        raise AttributeError(
+            f"Faker has no provider {provider_name!r} (used by {cls.__name__}). "
+            "Check faker_provider on the type."
+        )
+    provider_fn = getattr(faker, provider_name)
+    if not callable(provider_fn):
+        raise TypeError(f"Faker.{provider_name} is not callable (used by {cls.__name__}).")
+    provider_kwargs = dict(getattr(cls, "faker_kwargs", None) or {})
 
     def _provide() -> str:
         value = getattr(faker, provider_name)(**provider_kwargs)

capper-0.3.0/capper/cli.py

@@ -0,0 +1,79 @@
+"""CLI for ad-hoc fake data generation."""
+
+import argparse
+import sys
+from typing import Type
+
+import capper
+
+from .base import FakerType, faker, seed
+
+
+def _type_registry() -> dict[str, Type[FakerType]]:
+    """Map type name -> FakerType subclass (only types with faker_provider)."""
+    registry: dict[str, Type[FakerType]] = {}
+    for name in getattr(capper, "__all__", []):
+        if name in ("FakerType", "faker", "seed", "use_faker"):
+            continue
+        obj = getattr(capper, name, None)
+        provider = getattr(obj, "faker_provider", None)
+        if (
+            isinstance(obj, type)
+            and issubclass(obj, FakerType)
+            and isinstance(provider, str)
+            and len(provider) > 0
+        ):
+            registry[name] = obj
+    return registry
+
+
+def _generate_one(typ: Type[FakerType]) -> str:
+    """Generate a single value for the given FakerType."""
+    provider = getattr(typ, "faker_provider", "")
+    kwargs = getattr(typ, "faker_kwargs", None) or {}
+    value = getattr(faker, provider)(**kwargs)
+    return str(value)
+
+
+def cmd_generate(args: argparse.Namespace) -> int:
+    """Run generate subcommand."""
+    registry = _type_registry()
+    types: list[Type[FakerType]] = []
+    for name in args.types:
+        if name not in registry:
+            known = ", ".join(sorted(registry))
+            print(f"Unknown type: {name}. Known: {known}", file=sys.stderr)
+            return 1
+        types.append(registry[name])
+
+    if args.seed is not None:
+        seed(args.seed)
+
+    count = max(0, args.count)
+    for _ in range(count):
+        row = [_generate_one(t) for t in types]
+        print("\t".join(row))
+    return 0
+
+
+def main() -> int:
+    """Entry point for the capper CLI."""
+    parser = argparse.ArgumentParser(
+        prog="capper", description="Capper: fake data via Faker types."
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    gen = subparsers.add_parser("generate", help="Generate fake values for one or more types.")
+    gen.add_argument(
+        "types",
+        nargs="+",
+        metavar="TYPE",
+        help="Type names (e.g. Name, Email).",
+    )
+    gen.add_argument("-n", "--count", type=int, default=1, help="Number of rows (default: 1).")
+    gen.add_argument("-s", "--seed", type=int, default=None, help="Seed for reproducible output.")
+    gen.set_defaults(func=cmd_generate)
+
+    args = parser.parse_args()
+    result: int = args.func(args)
+    return result

capper-0.3.0/capper/color.py

@@ -0,0 +1,10 @@
+"""Color-related semantic Faker types."""
+
+from .base import FakerType
+
+
+class HexColor(FakerType):
+    """Hex color string (e.g. #ff5500). Uses Faker provider ``color`` with hex format."""
+
+    faker_provider = "color"
+    faker_kwargs = {"color_format": "hex"}

capper-0.3.0/capper/file.py

@@ -0,0 +1,21 @@
+"""File-related semantic Faker types (path, name, extension)."""
+
+from .base import FakerType
+
+
+class FilePath(FakerType):
+    """File path. Uses Faker provider ``file_path``."""
+
+    faker_provider = "file_path"
+
+
+class FileName(FakerType):
+    """File name with extension. Uses Faker provider ``file_name``."""
+
+    faker_provider = "file_name"
+
+
+class FileExtension(FakerType):
+    """File extension. Uses Faker provider ``file_extension``."""
+
+    faker_provider = "file_extension"

capper-0.3.0/capper/misc.py

@@ -0,0 +1,9 @@
+"""Miscellaneous semantic Faker types (e.g. UUID)."""
+
+from .base import FakerType
+
+
+class UUID(FakerType):
+    """UUID v4 string. Uses Faker provider ``uuid4``."""
+
+    faker_provider = "uuid4"

capper-0.3.0/capper/strategies.py

@@ -0,0 +1,100 @@
+"""Hypothesis strategies for Capper types (optional; requires hypothesis>=6.0).
+
+Use ``st.from_type(Name)`` after importing capper and capper.strategies, or call
+``strategies.for_type(Name)`` to get a strategy that generates instances of that type.
+"""
+
+from __future__ import annotations
+
+from typing import Type, TypeVar, cast
+
+from hypothesis import strategies as st
+
+from .barcode import EAN8, EAN13
+from .base import FakerType, faker
+from .color import HexColor
+from .commerce import Company, Currency, Price, Product
+from .date_time import Date, DateTime, Time
+from .file import FileExtension, FileName, FilePath
+from .finance import CreditCardExpiry, CreditCardNumber, CreditCardProvider
+from .geo import Address, City, Country
+from .internet import IP, URL, Email, UserName
+from .misc import UUID
+from .person import FirstName, Job, LastName, Name
+from .phone import CountryCallingCode, PhoneNumber
+from .text import Paragraph, Sentence
+
+T = TypeVar("T", bound=FakerType)
+
+# All built-in FakerType subclasses for registration
+_BUILTIN_TYPES: tuple[type[FakerType], ...] = (
+    Address,
+    City,
+    Company,
+    Country,
+    CountryCallingCode,
+    CreditCardExpiry,
+    CreditCardNumber,
+    CreditCardProvider,
+    Currency,
+    Date,
+    DateTime,
+    EAN13,
+    EAN8,
+    Email,
+    FileExtension,
+    FileName,
+    FilePath,
+    FirstName,
+    HexColor,
+    IP,
+    Job,
+    LastName,
+    Name,
+    Paragraph,
+    PhoneNumber,
+    Price,
+    Product,
+    Sentence,
+    Time,
+    URL,
+    UUID,
+    UserName,
+)
+
+
+def for_type(cls: Type[T]) -> st.SearchStrategy[T]:
+    """Return a Hypothesis strategy that generates instances of the given FakerType subclass."""
+    provider = getattr(cls, "faker_provider", None)
+    if not provider:
+        raise ValueError(f"{cls.__name__} has no faker_provider")
+    if not hasattr(faker, provider):
+        raise AttributeError(
+            f"Faker has no provider {provider!r} (used by {cls.__name__}). "
+            "Check faker_provider on the type."
+        )
+    if not callable(getattr(faker, provider)):
+        raise TypeError(f"Faker.{provider} is not callable (used by {cls.__name__}).")
+    kwargs = getattr(cls, "faker_kwargs", None) or {}
+
+    @st.composite
+    def _draw(draw: st.DrawFn) -> T:
+        seed_val = draw(st.integers(min_value=0, max_value=2**32 - 1))
+        faker.seed_instance(seed_val)
+        value = getattr(faker, provider)(**kwargs)
+        return cls(str(value))
+
+    return cast(st.SearchStrategy[T], _draw())
+
+
+def _register_strategies() -> None:
+    """Register all built-in Capper types with Hypothesis so st.from_type() works."""
+    from hypothesis.strategies import register_type_strategy
+
+    for typ in _BUILTIN_TYPES:
+        register_type_strategy(typ, for_type(typ))
+
+
+_register_strategies()
+
+__all__ = ["for_type"]

capper-0.3.0/capper/tests/test_cli.py

@@ -0,0 +1,41 @@
+"""Tests for the capper CLI (generate subcommand)."""
+
+import sys
+
+import pytest
+
+if sys.version_info >= (3, 10):
+    from capper import cli
+else:
+    cli = None  # type: ignore[assignment]
+
+
+@pytest.mark.skipif(sys.version_info < (3, 10), reason="capper CLI uses Python 3.10+ syntax")
+def test_cli_generate_exit_zero_and_non_empty_output() -> None:
+    """Invoke generate subcommand; assert exit 0 and non-empty output for a known type."""
+    orig_argv = sys.argv
+    try:
+        sys.argv = ["capper", "generate", "Name", "--count", "1"]
+        exit_code = cli.main()
+        assert exit_code == 0
+    finally:
+        sys.argv = orig_argv
+
+
+@pytest.mark.skipif(sys.version_info < (3, 10), reason="capper CLI uses Python 3.10+ syntax")
+def test_cli_generate_produces_output(capsys: pytest.CaptureFixture[str]) -> None:
+    """Generate subcommand prints one tab-separated value per row."""
+    orig_argv = sys.argv
+    try:
+        sys.argv = ["capper", "generate", "Name", "Email", "--count", "2"]
+        exit_code = cli.main()
+        assert exit_code == 0
+        out = capsys.readouterr().out
+        lines = [line for line in out.strip().splitlines() if line.strip()]
+        assert len(lines) == 2
+        for line in lines:
+            parts = line.split("\t")
+            assert len(parts) == 2
+            assert len(parts[0]) > 0 and len(parts[1]) > 0
+    finally:
+        sys.argv = orig_argv

capper-0.3.0/capper/tests/test_hypothesis_strategies.py

@@ -0,0 +1,34 @@
+"""Tests for Hypothesis strategies (require capper[hypothesis])."""
+
+import pytest
+
+pytest.importorskip("hypothesis")
+
+from hypothesis import given
+from hypothesis import strategies as st
+
+import capper.strategies  # noqa: F401 - register types with Hypothesis
+from capper import Email, Name
+
+
+@given(st.from_type(Name))
+def test_from_type_name_produces_non_empty_string(name: Name) -> None:
+    """st.from_type(Name) yields non-empty Name instances."""
+    assert isinstance(name, Name)
+    assert isinstance(name, str)
+    assert len(name) > 0
+
+
+@given(st.from_type(Email))
+def test_from_type_email_contains_at(email: Email) -> None:
+    """st.from_type(Email) yields strings containing '@'."""
+    assert isinstance(email, Email)
+    assert "@" in email
+    assert len(email) > 0
+
+
+@given(capper.strategies.for_type(Name))
+def test_for_type_name_produces_name(name: Name) -> None:
+    """strategies.for_type(Name) yields Name instances."""
+    assert isinstance(name, Name)
+    assert len(name) > 0

{capper-0.1.1 → capper-0.3.0}/capper/tests/test_polyfactory_integration.py

@@ -1,10 +1,10 @@
-"""Tests for Polyfactory integration: ModelFactory, DataclassFactory, shared Faker, auto-registration."""
+"""Tests for Polyfactory: ModelFactory, DataclassFactory, shared Faker, auto-registration."""
 
 from dataclasses import dataclass
 
-from pydantic import BaseModel
 from polyfactory.factories import DataclassFactory
 from polyfactory.factories.pydantic_factory import ModelFactory
+from pydantic import BaseModel
 
 from capper import Email, Name
 
@@ -50,14 +50,15 @@ def test_seed_random_and_capper_seed_produce_same_value() -> None:
 
 def test_model_factory_uses_capper_faker() -> None:
     """Asserts ModelFactory.__faker__ is capper's faker to document the shared instance."""
-    import capper
     from polyfactory.factories.pydantic_factory import ModelFactory
 
+    import capper
+
     assert ModelFactory.__faker__ is capper.faker
 
 
 def test_dataclass_factory_builds_with_capper_types() -> None:
-    """Builds a dataclass with Name and Email via DataclassFactory; asserts non-empty and valid email."""
+    """Dataclass with Name/Email via DataclassFactory; asserts non-empty and valid email."""
 
     @dataclass
     class Person:
@@ -94,11 +95,12 @@ def test_dataclass_factory_batch() -> None:
 
 
 def test_capper_types_auto_registered_with_polyfactory() -> None:
-    """Asserts that importing capper registers types so Polyfactory can build a model with PhoneNumber."""
-    from capper import PhoneNumber
+    """Importing capper registers types so Polyfactory can build a model with PhoneNumber."""
     from polyfactory.factories.pydantic_factory import ModelFactory
     from pydantic import BaseModel
 
+    from capper import PhoneNumber
+
     class Contact(BaseModel):
         phone: PhoneNumber
 

{capper-0.1.1 → capper-0.3.0}/capper/tests/test_types.py

@@ -3,6 +3,11 @@
 import pytest
 
 from capper import (
+    EAN8,
+    EAN13,
+    IP,
+    URL,
+    UUID,
     Address,
     City,
     Company,
@@ -15,8 +20,11 @@ from capper import (
     Date,
     DateTime,
     Email,
+    FileExtension,
+    FileName,
+    FilePath,
     FirstName,
-    IP,
+    HexColor,
     Job,
     LastName,
     Name,
@@ -26,7 +34,6 @@ from capper import (
     Product,
     Sentence,
     Time,
-    URL,
     UserName,
 )
 
@@ -59,25 +66,45 @@ from capper import (
         CreditCardNumber,
         CreditCardExpiry,
         CreditCardProvider,
+        FilePath,
+        FileName,
+        FileExtension,
+        UUID,
+        HexColor,
+        EAN13,
+        EAN8,
     ],
 )
 def test_type_generates_non_empty_string(type_class: type) -> None:
-    """Asserts each type's Faker provider exists and returns a non-empty value (provider availability)."""
+    """Each type's Faker provider exists and returns a non-empty value."""
     from faker import Faker
 
     faker = Faker()
     provider_name = getattr(type_class, "faker_provider")
-    value = getattr(faker, provider_name)()
+    kwargs = getattr(type_class, "faker_kwargs", None) or {}
+    value = getattr(faker, provider_name)(**kwargs)
     assert isinstance(value, (str, type_class))
     assert len(str(value)) > 0
 
 
 @pytest.mark.parametrize(
     "type_class",
-    [Name, Email, PhoneNumber, FirstName, Address, Sentence, CreditCardNumber],
+    [
+        Name,
+        Email,
+        PhoneNumber,
+        FirstName,
+        Address,
+        Sentence,
+        CreditCardNumber,
+        FilePath,
+        UUID,
+        HexColor,
+        EAN13,
+    ],
 )
 def test_model_factory_builds_capper_type(type_class: type) -> None:
-    """Builds a Pydantic model with a single capper type via ModelFactory; asserts non-empty and type."""
+    """Pydantic model with one capper type via ModelFactory; asserts non-empty and type."""
     from typing import Any, Type
 
     from polyfactory.factories.pydantic_factory import ModelFactory
@@ -94,7 +121,7 @@ def test_model_factory_builds_capper_type(type_class: type) -> None:
 
 
 def test_faker_kwargs_support() -> None:
-    """Asserts types can set faker_kwargs and provider is called with them; builds via ModelFactory and checks value."""
+    """faker_kwargs passed to provider; ModelFactory builds and checks value."""
     from capper.base import FakerType
 
     class ShortSentence(FakerType):
@@ -121,12 +148,22 @@ def test_faker_kwargs_support() -> None:
     assert isinstance(instance.text, (str, ShortSentence)) and len(instance.text) > 0
 
 
+def test_hex_color_format() -> None:
+    """HexColor yields a string starting with #."""
+    from faker import Faker
+
+    faker = Faker()
+    value = faker.color(color_format="hex")
+    assert isinstance(value, str) and value.startswith("#") and len(value) == 7
+
+
 def test_seed_reproducibility(seeded_faker: None) -> None:
     """Builds twice after seeding with same value; asserts identical generated name."""
-    from capper import Name, seed
     from polyfactory.factories.pydantic_factory import ModelFactory
     from pydantic import BaseModel
 
+    from capper import Name, seed
+
     class User(BaseModel):
         name: Name
 
@@ -138,3 +175,38 @@ def test_seed_reproducibility(seeded_faker: None) -> None:
     seed(42)
     user2 = UserFactory.build()
     assert user1.name == user2.name
+
+
+def test_use_faker_switches_global_faker() -> None:
+    """use_faker() switches the global Faker; next factory build uses that instance (e.g. seed)."""
+    from faker import Faker
+    from polyfactory.factories.base import BaseFactory
+    from polyfactory.factories.pydantic_factory import ModelFactory
+    from pydantic import BaseModel
+
+    from capper import Name, use_faker
+    from capper import faker as default_faker
+
+    try:
+        custom = Faker()
+        custom.seed_instance(123)
+        use_faker(custom)
+        from capper.base import faker as module_faker
+
+        assert module_faker is custom
+        assert BaseFactory.__faker__ is custom
+
+        class User(BaseModel):
+            name: Name
+
+        class UserFactory(ModelFactory[User]):
+            pass
+
+        seed_val = 999
+        custom.seed_instance(seed_val)
+        user1 = UserFactory.build()
+        custom.seed_instance(seed_val)
+        user2 = UserFactory.build()
+        assert user1.name == user2.name
+    finally:
+        use_faker(default_faker)

capper-0.1.1/README.md → capper-0.3.0/capper.egg-info/PKG-INFO

@@ -1,7 +1,34 @@
+Metadata-Version: 2.4
+Name: capper
+Version: 0.3.0
+Summary: Semantic, typed wrappers for Faker with automatic Polyfactory integration
+Author-email: Odos Matthews <odosmatthews@gmail.com>
+Project-URL: Documentation, https://github.com/eddiethedean/capper#readme
+Project-URL: Repository, https://github.com/eddiethedean/capper
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: Faker>=20.0
+Requires-Dist: Polyfactory>=2.0
+Provides-Extra: pydantic
+Requires-Dist: pydantic>=2.0; extra == "pydantic"
+Provides-Extra: hypothesis
+Requires-Dist: hypothesis>=6.0; extra == "hypothesis"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.0; extra == "dev"
+Requires-Dist: pydantic>=2.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: hypothesis>=6.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+
 # Capper
 
 [![PyPI](https://img.shields.io/pypi/v/capper.svg)](https://pypi.org/project/capper/)
-[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://pypi.org/project/capper/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://pypi.org/project/capper/)
 [![CI](https://img.shields.io/github/actions/workflow/status/eddiethedean/capper/ci.yml?branch=main&label=CI)](https://github.com/eddiethedean/capper/actions/workflows/ci.yml)
 [![Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://docs.astral.sh/ruff/)
 [![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
@@ -23,11 +50,10 @@ Semantic, typed wrappers for [Faker](https://faker.readthedocs.io/) with automat
 pip install capper
 ```
 
-Requires **Python 3.9+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. For **Pydantic** models, install the optional extra:
+Requires **Python 3.10+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. Optional extras:
 
-```bash
-pip install capper[pydantic]
-```
+- **Pydantic** (for Pydantic models): `pip install capper[pydantic]`
+- **Hypothesis** (for property-based tests with `st.from_type(...)`): `pip install capper[hypothesis]`
 
 ## Usage
 
@@ -98,6 +124,10 @@ Works automatically. No extra steps. IDE autocompletion.
 - **Text**: `Paragraph`, `Sentence`
 - **Phone**: `PhoneNumber`, `CountryCallingCode`
 - **Finance**: `CreditCardNumber`, `CreditCardExpiry`, `CreditCardProvider`
+- **File**: `FilePath`, `FileName`, `FileExtension`
+- **Misc**: `UUID`
+- **Color**: `HexColor`
+- **Barcode**: `EAN13`, `EAN8`
 
 Import from the top level: `from capper import Name, Email, Address, ...`  
 See [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/docs/FAKER_PROVIDERS.md) for the Faker provider used by each type.
@@ -106,9 +136,20 @@ See [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/d
 
 **Custom types:** Subclass `FakerType`, set `faker_provider` to the Faker method name (e.g. `"company"`), and optionally `faker_kwargs`. The type auto-registers with Polyfactory when the class is defined.
 
+## CLI
+
+Generate fake values from the command line:
+
+```bash
+capper generate Name Email --count 5
+capper generate Name Email --count 3 --seed 42
+```
+
+Use `-n`/`--count` for the number of rows and `-s`/`--seed` for reproducible output. Type names are the same as the Python types (e.g. `Name`, `Email`, `Address`).
+
 ## Compatibility
 
-Capper targets **Faker >= 20.0** and **Polyfactory >= 2.0**. Major Faker upgrades may change or rename provider methods; if a type fails, check [Faker's changelog](https://faker.readthedocs.io/en/stable/changelog.html) and [docs/FAKER_PROVIDERS.md](https://github.com/eddiethedean/capper/blob/main/docs/FAKER_PROVIDERS.md) and update the provider name if needed.
+Capper targets **Python 3.10+**, **Faker >= 20.0**, and **Polyfactory >= 2.0**. For version ranges, upgrade guidance, and the deprecation policy, see [Compatibility](docs/compatibility.md).
 
 ## Development
 
@@ -117,6 +158,8 @@ pip install -e ".[dev]"
 pytest capper/tests
 ```
 
+Lint and type-check: `ruff check .`, `ruff format .`, `mypy capper`.
+
 Run tests with coverage: `pytest capper/tests --cov=capper --cov-report=term-missing`.
 
 **Reproducibility:** Capper and Polyfactory share the same Faker instance, so one seed controls both capper types and built-in types (`str`, `int`, etc.):
@@ -140,20 +183,23 @@ UserFactory.seed_random(42)
 user2 = UserFactory.build()  # same data as user1 if you seed the same before each
 ```
 
-Use `UserFactory.__random_seed__ = 42` to seed once when the factory class is created, or call `seed(42)` / `UserFactory.seed_random(42)` before each build for identical builds.
+Use `UserFactory.__random_seed__ = 42` to seed once when the factory class is created, or call `seed(42)` / `UserFactory.seed_random(42)` before each build for identical builds. For a custom locale (e.g. German names), use **`use_faker(Faker('de_DE'))`** so both Capper and Polyfactory use the same Faker instance; see [Reproducible data](docs/user_guides/reproducible_data.md#locales-and-custom-faker).
 
 ## Publishing
 
 Releases are built and published to PyPI via [GitHub Actions](https://github.com/eddiethedean/capper/blob/main/.github/workflows/publish.yml). To publish:
 
-1. Add a `PYPI_API_TOKEN` secret (PyPI API token) to the repo.
-2. Create a GitHub release (tag e.g. `v0.1.0`). The workflow runs tests, builds the package, and uploads to PyPI.
+1. Update [CHANGELOG.md](CHANGELOG.md): move Unreleased entries into a new version section and date it.
+2. Add a `PYPI_API_TOKEN` secret (PyPI API token) to the repo.
+3. Create a GitHub release (tag e.g. `v0.3.0`). The workflow runs tests, builds the package, and uploads to PyPI.
 
 To build and upload manually: `pip install build twine`, `python -m build`, `twine upload dist/*`.
 
 ## Documentation
 
 - **[Docs index](docs/README.md)** — overview and links to all documentation
+- **[API reference](docs/api.md)** — generated API docs (build with `mkdocs serve`; see [Contributing](CONTRIBUTING.md))
+- **[Contributing](CONTRIBUTING.md)** — dev setup and how to add new types
 - **User guides** (step-by-step, with runnable examples):
   - [Getting started](docs/user_guides/getting_started.md) — install, first model, first factory
   - [Models and factories](docs/user_guides/models_and_factories.md) — Pydantic, dataclasses, batches
@@ -162,3 +208,4 @@ To build and upload manually: `pip install build twine`, `python -m build`, `twi
 - [Package plan](docs/capper_package_plan.md) — design and rationale
 - [Roadmap](docs/ROADMAP.md) — development phases and status
 - [Faker provider mapping](docs/FAKER_PROVIDERS.md) — which Faker method each type uses
+- [Example notebooks](docs/notebooks/README.md) — Jupyter notebooks in `docs/notebooks/`

{capper-0.1.1 → capper-0.3.0}/capper.egg-info/SOURCES.txt

@@ -1,23 +1,32 @@
 README.md
 pyproject.toml
 capper/__init__.py
+capper/barcode.py
 capper/base.py
+capper/cli.py
+capper/color.py
 capper/commerce.py
 capper/date_time.py
+capper/file.py
 capper/finance.py
 capper/geo.py
 capper/internet.py
+capper/misc.py
 capper/person.py
 capper/phone.py
+capper/strategies.py
 capper/text.py
 capper.egg-info/PKG-INFO
 capper.egg-info/SOURCES.txt
 capper.egg-info/dependency_links.txt
+capper.egg-info/entry_points.txt
 capper.egg-info/requires.txt
 capper.egg-info/top_level.txt
 capper/examples/user_factory.py
 capper/tests/__init__.py
 capper/tests/conftest.py
+capper/tests/test_cli.py
 capper/tests/test_docs_examples.py
+capper/tests/test_hypothesis_strategies.py
 capper/tests/test_polyfactory_integration.py
 capper/tests/test_types.py

capper-0.3.0/capper.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+capper = capper.cli:main

{capper-0.1.1 → capper-0.3.0}/capper.egg-info/requires.txt

@@ -6,6 +6,16 @@ pytest>=7.0
 pytest-cov>=4.0
 pytest-xdist>=3.0
 pydantic>=2.0
+ruff>=0.4
+mypy>=1.0
+hypothesis>=6.0
+
+[docs]
+mkdocs>=1.5
+mkdocstrings[python]>=0.24
+
+[hypothesis]
+hypothesis>=6.0
 
 [pydantic]
 pydantic>=2.0

{capper-0.1.1 → capper-0.3.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "capper"
-version = "0.1.1"
+version = "0.3.0"
 description = "Semantic, typed wrappers for Faker with automatic Polyfactory integration"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 authors = [
     { name = "Odos Matthews", email = "odosmatthews@gmail.com" },
 ]
@@ -20,17 +20,30 @@ dependencies = [
 pydantic = [
     "pydantic>=2.0",
 ]
+hypothesis = [
+    "hypothesis>=6.0",
+]
 dev = [
     "pytest>=7.0",
     "pytest-cov>=4.0",
     "pytest-xdist>=3.0",
     "pydantic>=2.0",
+    "ruff>=0.4",
+    "mypy>=1.0",
+    "hypothesis>=6.0",
+]
+docs = [
+    "mkdocs>=1.5",
+    "mkdocstrings[python]>=0.24",
 ]
 
 [project.urls]
 Documentation = "https://github.com/eddiethedean/capper#readme"
 Repository = "https://github.com/eddiethedean/capper"
 
+[project.scripts]
+capper = "capper.cli:main"
+
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["capper*"]
@@ -39,3 +52,18 @@ include = ["capper*"]
 testpaths = ["capper/tests"]
 pythonpath = ["."]
 addopts = ["-v", "--tb=short"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+exclude = ["docs/notebooks"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+exclude = ["capper/tests"]

{capper-0.1.1 → capper-0.3.0}/capper/examples/user_factory.py

@@ -4,8 +4,8 @@ Run: python -m capper.examples.user_factory
 Output varies each run; use capper.seed(n) for reproducible data.
 """
 
-from pydantic import BaseModel
 from polyfactory.factories.pydantic_factory import ModelFactory
+from pydantic import BaseModel
 
 from capper import Email, Name