dycw-utilities 0.132.2__tar.gz → 0.132.4__tar.gz

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.132.2
+Version: 0.132.4
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -17,7 +17,6 @@ Requires-Dist: pytest-asyncio<1.1,>=1.0.0; extra == 'test'
 Requires-Dist: pytest-cov<6.2,>=6.1.1; extra == 'test'
 Requires-Dist: pytest-instafail<0.6,>=0.5.0; extra == 'test'
 Requires-Dist: pytest-lazy-fixtures<1.2,>=1.1.4; extra == 'test'
-Requires-Dist: pytest-randomly<3.17,>=3.16.0; extra == 'test'
 Requires-Dist: pytest-regressions<2.9,>=2.8.0; extra == 'test'
 Requires-Dist: pytest-rerunfailures<16,>=15.1; extra == 'test'
 Requires-Dist: pytest-rng<1.1,>=1.0.0; extra == 'test'

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/pyproject.toml

@@ -7,80 +7,88 @@ requires = ["hatchling"]
 
 # dependency groups
 [dependency-groups]
+aiolimiter = ["aiolimiter >= 1.2.1, < 1.3"]
+altair = ["altair >= 5.5.0, < 5.6"]
+altair-test = [
+  "polars-lts-cpu",
+  "img2pdf",
+  "vl-convert-python",
+]
+atools = ["atools >= 0.14.2, < 0.15"]
+cachetools = ["cachetools >= 5.5.2, < 5.6"]
+click = ["click >= 8.2.1, < 8.3"]
+core = [
+  "atomicwrites >= 1.4.1, < 1.5",
+  "typing-extensions >= 4.14.0, < 4.15",
+  "tzlocal >= 5.3.1, < 5.4",
+  "whenever >= 0.8.5, < 0.9",
+]
+cryptography = ["cryptography >= 45.0.4, < 45.1"]
+cvxpy = ["cvxpy >= 1.6.5, < 1.7"]
+dataclasses-test = ["orjson", "polars-lts-cpu"]
 dev = [
-  "aiohttp >= 3.12.12, < 3.13",  # for slack
-  "aiolimiter >= 1.2.1, < 1.3",
-  "aiosqlite >= 0.21.0, < 0.22",
-  "altair >= 5.5.0, < 5.6",
-  "asyncpg >= 0.30.0, < 0.31",  # for sqlalchemy async
-  "atools >= 0.14.2, < 0.15",
-  "cachetools >= 5.5.2, < 5.6",  # blocked by streamlit
-  "click >= 8.2.1, < 8.3",
   "coloredlogs >= 15.0.1, < 15.1",
-  "cryptography >= 45.0.4, < 45.1",
-  "cvxpy >= 1.6.5, < 1.7",
-  "eventkit >= 1.0.3, < 1.1",
-  "fastapi >= 0.115.11, < 0.116",
-  "fpdf2 >= 2.8.3, < 2.9",
-  "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
-  "httpx >= 0.28.1, < 0.29",  # for fastapi
-  "hypothesis >= 6.135.2, < 6.136",
-  "img2pdf >= 0.6.0, < 0.7",
-  "inflect >= 7.5.0, < 7.6",
-  "lightweight-charts >= 2.1, < 2.2",
-  "luigi >= 3.6.0, < 3.7",
-  "memory-profiler >= 0.61.0, < 0.62",
-  "more-itertools >= 10.7.0, < 10.8",
-  "nest-asyncio >= 1.6.0, < 1.7",  # for sqlalchemy async
-  "nox >= 2025.2.9, < 2025.3",
-  "numpy >= 2.3.0, < 2.4",
-  "libcst >= 1.8.0, < 1.9",
-  "optuna >= 4.3.0, < 4.4",
-  "orjson >= 3.10.18, < 3.11",
-  "pathvalidate >= 3.2.3, < 3.3",
-  "polars-lts-cpu >= 1.30.0, < 1.31",
-  "polars-ols >= 0.3.5, < 0.4",
-  "pottery >= 3.0.1, < 3.1",
-  "pqdm >= 0.2.0, < 0.3",
-  "psutil >= 7.0.0, < 7.1",
-  "psycopg2-binary >= 2.9.10, < 2.10",  # for sqlalchemy
-  "pydantic >= 2.11.4, < 2.12",
-  "pyinstrument >= 5.0.2, < 5.1",
+  "coverage-conditional-plugin >= 0.9.0, < 0.10",
   "pyright[nodejs] >= 1.1.401, < 1.2",
-  "pyrsistent >= 0.20.0, < 0.21",
+  "pytest-cov >= 6.1.1, < 6.2",
+]
+eventkit = ["eventkit >= 1.0.3, < 1.1"]
+fastapi = ["fastapi >= 0.115.11, < 0.116"]
+fastapi-test = ["httpx", "uvicorn"]
+fpdf2 = ["fpdf2 >= 2.8.3, < 2.9"]
+hashlib-test = ["orjson"]
+http-test = ["orjson"]
+hypothesis = ["hypothesis >= 6.135.2, < 6.136"]
+hypothesis-test = ["luigi", "pathvalidate", "numpy", "pytest-rerunfailures"]
+inflect = ["inflect >= 7.5.0, < 7.6"]
+jupyter-test = ["pandas", "polars"]
+libcst = ["libcst >= 1.8.0, < 1.9"]
+lightweight-charts = ["lightweight-charts >= 2.1, < 2.2"]
+lightweight-charts-test = ["polars-lts-cpu", "pyarrow"]
+luigi = ["luigi >= 3.6.0, < 3.7"]
+math-test = ["numpy"]
+memory-profiler = ["memory-profiler >= 0.61.0, < 0.62"]
+more-itertools = ["more-itertools >= 10.7.0, < 10.8"]
+numpy = ["numpy >= 2.3.0, < 2.4"]
+operator = ["polars-lts-cpu"]
+optuna = ["optuna >= 4.3.0, < 4.4"]
+orjson = ["orjson >= 3.10.18, < 3.11"]
+orjson-test = ["polars-lts-cpu"]
+polars = ["polars-lts-cpu >= 1.30.0, < 1.31"]
+polars-ols = ["polars-ols >= 0.3.5, < 0.4"]
+polars-ols-test = ["scikit-learn"]
+polars-test = ["numpy", "statsmodels"]
+pottery = ["pottery >= 3.0.1, < 3.1"]
+pottery-test = ["orjson", "pytest-rerunfailures"]
+pqdm = ["pqdm >= 0.2.0, < 0.3"]
+psutil = ["psutil >= 7.0.0, < 7.1"]
+pydantic = ["pydantic >= 2.11.4, < 2.12"]
+pyinstrument = ["pyinstrument >= 5.0.2, < 5.1"]
+pytest = [
   "pytest >= 8.3.5, < 8.4",
-  "pytest-regressions >= 2.8.0, < 2.9",
-  "python-dotenv >= 1.1.0, < 1.2",
-  "redis >= 6.2.0, < 6.3",
-  "rich >= 14.0.0, < 14.1",
-  "scikit-learn >= 1.7.0, < 1.8",
-  "scipy >= 1.15.3, < 1.16",
-  "slack-sdk >= 3.35.0, < 3.36",
-  "sqlalchemy >= 2.0.41, < 2.1",
-  "statsmodels >= 0.14.4, < 0.15",
-  "streamlit >= 1.45.0, < 1.46",
-  "tomlkit >= 0.13.2, < 0.14",
-  "typed-settings >= 24.6.0, < 24.7",
-  "tzdata >= 2025.2, < 2025.3",
-  "uvicorn >= 0.34.1, < 0.35",
-  "vegafusion >= 2.0.2, < 2.1",
-  "vegafusion-python-embed >= 1.6.9, < 1.7",
-  "vl-convert-python >= 1.8.0, < 1.9",
-  # test
-  "coverage-conditional-plugin >= 0.9.0, < 0.10",
-  "dycw-pytest-only >= 2.1.1, < 2.2",
   "pytest-asyncio >= 1.0.0, < 1.1",
-  "pytest-cov >= 6.1.1, < 6.2",
-  "pytest-instafail >= 0.5.0, < 0.6",
-  "pytest-lazy-fixtures >= 1.1.4, < 1.2",
   "pytest-randomly >= 3.16.0, < 3.17",
-  "pytest-rerunfailures >= 15.1, < 16",
-  "pytest-rng >= 1.0.0, < 1.1",
-  "pytest-timeout >= 2.4.0, < 2.5",
   "pytest-xdist >= 3.7.0, < 3.8",
-  # CI
-  "aiolimiter>=1.2.1",
 ]
+pytest-regressions = ["pytest-regressions >= 2.8.0, < 2.9"]
+pytest-regressions-test = ["orjson", "polars-lts-cpu"]
+pytest-test = ["orjson", "pytest-rng", "pytest-rerunfailures"]
+python-dotenv = ["python-dotenv >= 1.1.0, < 1.2"]
+redis = ["redis >= 6.2.0, < 6.3", "orjson"]
+redis-test = ["pytest-rerunfailures"]
+reprlib-test = ["rich"]
+scipy = ["scipy >= 1.15.3, < 1.16"]
+sklearn = ["scikit-learn >= 1.7.0, < 1.8"]
+slack-sdk = ["slack-sdk >= 3.35.0, < 3.36"]
+slack-sdk-test = ["aiohttp"]
+sqlalchemy = ["sqlalchemy >= 2.0.41, < 2.1"]
+sqlalchemy-polars = ["sqlalchemy", "polars-lts-cpu"]
+sqlalchemy-polars-test = ["aiosqlite", "asyncpg", "greenlet"]
+sqlalchemy-test = ["aiosqlite", "asyncpg", "greenlet"]
+statsmodels = ["statsmodels >= 0.14.4, < 0.15"]
+streamlit = ["streamlit >= 1.45.0, < 1.46"]
+typed-settings = ["typed-settings >= 24.6.0, < 24.7"]
+tzdata = ["tzdata >= 2025.2, < 2025.3"]
 
 # project
 [project]
@@ -94,7 +102,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.132.2"
+version = "0.132.4"
 
 [project.optional-dependencies]
 logging = [
@@ -108,7 +116,6 @@ test = [
   "pytest-cov >= 6.1.1, < 6.2",
   "pytest-instafail >= 0.5.0, < 0.6",
   "pytest-lazy-fixtures >= 1.1.4, < 1.2",
-  "pytest-randomly >= 3.16.0, < 3.17",
   "pytest-regressions >= 2.8.0, < 2.9",
   "pytest-rerunfailures >= 15.1, < 16",
   "pytest-rng >= 1.0.0, < 1.1",
@@ -121,7 +128,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.132.2"
+current_version = "0.132.4"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"
@@ -223,17 +230,17 @@ addopts = [
   "--durations=10",
   "--durations-min=10",
   "--strict-markers",
-  "--timeout=300",
 ]
 asyncio_default_fixture_loop_scope = "function"
 asyncio_mode = "auto"
 filterwarnings = [
   "error",
   "ignore:.*utcfromtimestamp.* is deprecated and scheduled for removal in a future version:DeprecationWarning",  # luigi
+  "ignore:Exception ignored in.* <coroutine object .* at .*>:pytest.PytestUnraisableExceptionWarning",
   "ignore:Implicitly cleaning up <TemporaryDirectory '.*'>:ResourceWarning",
   "ignore:ResourceTracker called reentrantly for resource cleanup, which is unsupported:UserWarning",
   "ignore:Task .* without outputs has no custom complete.* method:UserWarning",  # luigi
-  "ignore:The garbage collector is trying to clean up non-checked-in connection <AdaptedConnection <Connection(.*)>>:sqlalchemy.exc.SAWarning",  # sqlalchemy
+  "ignore:The garbage collector is trying to clean up non-checked-in connection <AdaptedConnection <Connection(.*)>:RuntimeWarning",  # sqlalchemy
   "ignore:There is no current event loop:DeprecationWarning",  # eventkit
   "ignore:Using fork.* can cause Polars to deadlock in the child process:RuntimeWarning",  # polars/pqdm
   "ignore:coroutine 'AsyncConnection.close' was never awaited:RuntimeWarning",
@@ -328,3 +335,7 @@ ban-relative-imports = "all"
 [tool.ruff.lint.isort]
 required-imports = ["from __future__ import annotations"]
 split-on-trailing-comma = false
+
+# uv
+[tool.uv]
+default-groups = "all"

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/tests/conftest.py

@@ -8,7 +8,6 @@ from typing import TYPE_CHECKING, Any
 
 from hypothesis import HealthCheck
 from pytest import fixture, mark, param
-from sqlalchemy import text
 from whenever import PlainDateTime
 
 from utilities.platform import IS_NOT_LINUX, IS_WINDOWS
@@ -64,6 +63,8 @@ def set_log_factory() -> AbstractContextManager[None]:
 
 @fixture(params=[param("sqlite"), param("postgresql", marks=SKIPIF_CI)])
 async def test_engine(*, request: SubRequest, tmp_path: Path) -> Any:
+    from sqlalchemy import text
+
     from utilities.sqlalchemy import create_async_engine
 
     dialect = request.param

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/tests/test_click.py

@@ -16,6 +16,7 @@ from hypothesis.strategies import (
     booleans,
     data,
     frozensets,
+    ip_addresses,
     lists,
     sampled_from,
 )
@@ -36,6 +37,8 @@ from utilities.click import (
     FrozenSetChoices,
     FrozenSetEnums,
     FrozenSetStrs,
+    IPv4Address,
+    IPv6Address,
     ListEnums,
     ListStrs,
     Month,
@@ -227,6 +230,8 @@ class TestParameters:
                 _lift_serializer(str, sort=True),
                 False,
             ),
+            param(IPv4Address(), "IPV4 ADDRESS", ip_addresses(v=4), str, True),
+            param(IPv6Address(), "IPV6 ADDRESS", ip_addresses(v=6), str, True),
             param(
                 ListEnums(_ExampleEnum),
                 "LIST[ENUM[_ExampleEnum]]",

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/tests/test_parse.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from collections.abc import Iterable
+from ipaddress import IPv4Address, IPv6Address
 from pathlib import Path
 from types import NoneType
 from typing import Final, Literal
@@ -12,6 +13,7 @@ from hypothesis.strategies import (
     floats,
     frozensets,
     integers,
+    ip_addresses,
     lists,
     none,
     sampled_from,
@@ -110,6 +112,18 @@ class TestSerializeAndParseObject:
         result = parse_object(int, serialized)
         assert result == int_
 
+    @given(address=ip_addresses(v=4))
+    def test_ipv4_address(self, *, address: IPv4Address) -> None:
+        serialized = serialize_object(address)
+        result = parse_object(IPv4Address, serialized)
+        assert result == address
+
+    @given(address=ip_addresses(v=6))
+    def test_ipv6_address(self, *, address: IPv6Address) -> None:
+        serialized = serialize_object(address)
+        result = parse_object(IPv6Address, serialized)
+        assert result == address
+
     @given(ints=lists(int64s()))
     def test_list(self, *, ints: list[int]) -> None:
         serialized = serialize_object(ints)

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.132.2"
+__version__ = "0.132.4"

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/utilities/click.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import ipaddress
 import pathlib
 from typing import TYPE_CHECKING, Generic, TypedDict, TypeVar, assert_never, override
 
@@ -12,12 +13,15 @@ import utilities.whenever
 from utilities.enum import EnsureEnumError, ensure_enum
 from utilities.functions import EnsureStrError, ensure_str, get_class_name
 from utilities.iterables import is_iterable_not_str
+from utilities.parse import ParseObjectError, parse_object
 from utilities.text import split_str
 from utilities.types import (
     DateDeltaLike,
     DateLike,
     DateTimeDeltaLike,
     EnumLike,
+    IPv4AddressLike,
+    IPv6AddressLike,
     MaybeStr,
     PlainDateTimeLike,
     TEnum,
@@ -173,6 +177,58 @@ class Enum(ParamType, Generic[TEnum]):
         return _make_metavar(param, desc)
 
 
+class IPv4Address(ParamType):
+    """An IPv4 address-valued parameter."""
+
+    name = "ipv4 address"
+
+    @override
+    def __repr__(self) -> str:
+        return self.name.upper()
+
+    @override
+    def convert(
+        self, value: IPv4AddressLike, param: Parameter | None, ctx: Context | None
+    ) -> ipaddress.IPv4Address:
+        """Convert a value into the `IPv4Address` type."""
+        match value:
+            case ipaddress.IPv4Address():
+                return value
+            case str():
+                try:
+                    return parse_object(ipaddress.IPv4Address, value)
+                except ParseObjectError as error:
+                    self.fail(str(error), param, ctx)
+            case _ as never:
+                assert_never(never)
+
+
+class IPv6Address(ParamType):
+    """An IPv6 address-valued parameter."""
+
+    name = "ipv6 address"
+
+    @override
+    def __repr__(self) -> str:
+        return self.name.upper()
+
+    @override
+    def convert(
+        self, value: IPv6AddressLike, param: Parameter | None, ctx: Context | None
+    ) -> ipaddress.IPv6Address:
+        """Convert a value into the `IPv6Address` type."""
+        match value:
+            case ipaddress.IPv6Address():
+                return value
+            case str():
+                try:
+                    return parse_object(ipaddress.IPv6Address, value)
+                except ParseObjectError as error:
+                    self.fail(str(error), param, ctx)
+            case _ as never:
+                assert_never(never)
+
+
 class Month(ParamType):
     """A month-valued parameter."""
 
@@ -467,6 +523,8 @@ __all__ = [
     "FrozenSetEnums",
     "FrozenSetParameter",
     "FrozenSetStrs",
+    "IPv4Address",
+    "IPv6Address",
     "ListEnums",
     "ListParameter",
     "ListStrs",

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/utilities/parse.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from contextlib import suppress
 from dataclasses import dataclass
 from enum import Enum
+from ipaddress import IPv4Address, IPv6Address
 from pathlib import Path
 from re import DOTALL
 from types import NoneType
@@ -176,14 +177,9 @@ def _parse_object_type(
             return parse_bool(text)
         except ParseBoolError:
             raise _ParseObjectParseError(type_=cls, text=text) from None
-    if is_subclass_gen(cls, int):
+    if is_subclass_gen(cls, int | float | IPv4Address | IPv6Address):
         try:
-            return int(text)
-        except ValueError:
-            raise _ParseObjectParseError(type_=cls, text=text) from None
-    if issubclass(cls, float):
-        try:
-            return float(text)
+            return cls(text)
         except ValueError:
             raise _ParseObjectParseError(type_=cls, text=text) from None
     if issubclass(cls, Enum):
@@ -443,7 +439,16 @@ def serialize_object(
         with suppress(_SerializeObjectSerializeError):
             return _serialize_object_extra(obj, extra)
     if (obj is None) or isinstance(
-        obj, bool | int | float | str | Path | Sentinel | Version
+        obj,
+        bool
+        | int
+        | float
+        | str
+        | IPv4Address
+        | IPv6Address
+        | Path
+        | Sentinel
+        | Version,
     ):
         return str(obj)
     if isinstance(

{dycw_utilities-0.132.2 → dycw_utilities-0.132.4}/src/utilities/types.py

@@ -4,6 +4,7 @@ import datetime as dt
 from asyncio import Event
 from collections.abc import Awaitable, Callable, Coroutine, Hashable, Iterable, Mapping
 from enum import Enum
+from ipaddress import IPv4Address, IPv6Address
 from logging import Logger
 from pathlib import Path
 from random import Random
@@ -112,6 +113,11 @@ THashable1 = TypeVar("THashable1", bound=Hashable)
 THashable2 = TypeVar("THashable2", bound=Hashable)
 
 
+# ipaddress
+IPv4AddressLike = MaybeStr[IPv4Address]
+IPv6AddressLike = MaybeStr[IPv6Address]
+
+
 # iterables
 type MaybeIterable[_T] = _T | Iterable[_T]
 type IterableHashable[_THashable: Hashable] = (
@@ -295,6 +301,8 @@ __all__ = [
     "DateTimeRoundUnit",
     "EnumLike",
     "ExcInfo",
+    "IPv4AddressLike",
+    "IPv6AddressLike",
     "IterableHashable",
     "LogLevel",
     "LoggerOrName",

dycw_utilities-0.132.2/src/tests/test_pyrsistent.py

@@ -1,49 +0,0 @@
-from __future__ import annotations
-
-from types import NoneType
-
-from pyrsistent import PTypeError
-from pytest import raises
-
-from utilities.pyrsistent import PRecord, field
-
-
-class TestPRecord:
-    def test_mandatory_field_without_type_checking(self) -> None:
-        class ARecord(PRecord):
-            x: int = field()
-
-        r = ARecord(x=3)
-        assert repr(r) == "ARecord(x=3)"
-        assert r.x == 3
-        assert r.set(x=2) == ARecord(x=2)
-        with raises(
-            AttributeError, match="'y' is not among the specified fields for ARecord"
-        ):
-            _ = r.set(y=2)
-
-    def test_optional_field_without_type_checking(self) -> None:
-        class ARecord(PRecord):
-            x: int | None = field(default=None)
-
-        r = ARecord()
-        assert repr(r) == "ARecord(x=None)"
-        assert r.x is None
-
-    def test_mandatory_field_with_type_checking(self) -> None:
-        class ARecord(PRecord):
-            x: int = field(type=int)
-
-        r = ARecord(x=3)
-        assert repr(r) == "ARecord(x=3)"
-        with raises(PTypeError, match="Invalid type for field ARecord.x, was str"):
-            _ = r.set(x="2")
-
-    def test_optional_field_with_type_checking(self) -> None:
-        class ARecord(PRecord):
-            x: int | None = field(type=(int, NoneType), default=None)
-
-        r = ARecord()
-        assert repr(r) == "ARecord(x=None)"
-        with raises(PTypeError, match="Invalid type for field ARecord.x, was str"):
-            _ = r.set(x="2")

dycw_utilities-0.132.2/src/utilities/pyrsistent.py

@@ -1,89 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, TypeVar, dataclass_transform, overload
-
-from pyrsistent import PRecord as _PRecord
-from pyrsistent import field as _field
-from pyrsistent._field_common import (
-    PFIELD_NO_FACTORY,
-    PFIELD_NO_INITIAL,
-    PFIELD_NO_INVARIANT,
-    PFIELD_NO_SERIALIZER,
-    PFIELD_NO_TYPE,
-)
-
-if TYPE_CHECKING:
-    from collections.abc import Callable
-
-    from utilities.types import TypeLike
-
-
-_T = TypeVar("_T")
-_U = TypeVar("_U")
-
-
-@overload
-def field(
-    *,
-    type: type[_T],
-    invariant: Callable[[Any], tuple[bool, Any]] = ...,
-    default: Any = ...,
-    mandatory: bool = ...,
-    factory: Callable[[_U], _U] = ...,
-    serializer: Callable[[Any, Any], Any] = ...,
-) -> _T: ...
-@overload
-def field(
-    *,
-    type: tuple[type[_T]],
-    invariant: Callable[[Any], tuple[bool, Any]] = ...,
-    default: Any = ...,
-    mandatory: bool = ...,
-    factory: Callable[[_U], _U] = ...,
-    serializer: Callable[[Any, Any], Any] = ...,
-) -> _T: ...
-@overload
-def field(
-    *,
-    type: tuple[type[_T], type[_U]],
-    invariant: Callable[[Any], tuple[bool, Any]] = ...,
-    default: Any = ...,
-    mandatory: bool = ...,
-    factory: Callable[[_U], _U] = ...,
-    serializer: Callable[[Any, Any], Any] = ...,
-) -> _T | _U: ...
-@overload
-def field(
-    *,
-    type: tuple[Any, ...] = ...,
-    invariant: Callable[[Any], tuple[bool, Any]] = ...,
-    default: Any = ...,
-    mandatory: bool = ...,
-    factory: Callable[[_U], _U] = ...,
-    serializer: Callable[[Any, Any], Any] = ...,
-) -> Any: ...
-def field(
-    *,
-    type: TypeLike[_T] = PFIELD_NO_TYPE,  # noqa: A002
-    invariant: Callable[[Any], tuple[bool, Any]] = PFIELD_NO_INVARIANT,
-    default: Any = PFIELD_NO_INITIAL,
-    mandatory: bool = False,
-    factory: Callable[[_U], _U] = PFIELD_NO_FACTORY,
-    serializer: Callable[[Any, Any], Any] = PFIELD_NO_SERIALIZER,
-) -> Any:
-    """Field specification factory for :py:class:`PRecord`."""
-    return _field(
-        type=type,
-        invariant=invariant,
-        initial=default,
-        mandatory=mandatory,
-        factory=factory,
-        serializer=serializer,
-    )
-
-
-@dataclass_transform(kw_only_default=True, field_specifiers=(field,))
-class PRecord(_PRecord): ...
-
-
-__all__ = ["PRecord", "field"]