dycw-utilities 0.149.1__tar.gz → 0.149.2__tar.gz

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.149.1
+Version: 0.149.2
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/pyproject.toml

@@ -102,7 +102,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.149.1"
+version = "0.149.2"
 
 [project.entry-points.pytest11]
 pytest-randomly = "utilities.pytest_plugins.pytest_randomly"
@@ -135,7 +135,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.149.1"
+current_version = "0.149.2"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/src/tests/test_click.py

@@ -20,11 +20,13 @@ from hypothesis.strategies import (
     ip_addresses,
     lists,
     sampled_from,
+    uuids,
 )
 from pytest import mark, param
 
 from utilities.click import (
     CONTEXT_SETTINGS_HELP_OPTION_NAMES,
+    UUID,
     Date,
     DateDelta,
     DateTimeDelta,
@@ -320,6 +322,9 @@ class TestParameters:
             serialize=whenever.TimeDelta.format_common_iso,
             failable=True,
         ),
+        _Case(
+            param=UUID(), name="uuid", strategy=uuids(), serialize=str, failable=True
+        ),
         _Case(
             param=YearMonth(),
             name="year-month",

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/src/tests/test_typed_settings.py

@@ -3,6 +3,7 @@ from dataclasses import dataclass
 from ipaddress import IPv4Address, IPv6Address
 from pathlib import Path
 from typing import Any, ClassVar, assert_never
+from uuid import UUID
 
 import typed_settings
 from hypothesis import given
@@ -13,6 +14,7 @@ from hypothesis.strategies import (
     data,
     ip_addresses,
     tuples,
+    uuids,
 )
 from pytest import mark, param, raises
 from typed_settings import EnvLoader, FileLoader, TomlFormat
@@ -87,6 +89,7 @@ class TestExtendedTSConverter:
         _Case(
             cls=TimeDelta, strategy=time_deltas(), serialize=TimeDelta.format_common_iso
         ),
+        _Case(cls=UUID, strategy=uuids(), serialize=str),
         _Case(
             cls=YearMonth, strategy=year_months(), serialize=YearMonth.format_common_iso
         ),

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.149.1"
+__version__ = "0.149.2"

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/src/utilities/click.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import enum
 import ipaddress
 import pathlib
+import uuid
 from typing import TYPE_CHECKING, TypedDict, assert_never, override
 
 import click
@@ -329,6 +330,32 @@ class TimeDelta(ParamType):
                 assert_never(never)
 
 
+class UUID(ParamType):
+    """A UUID-valued parameter."""
+
+    name = "uuid"
+
+    @override
+    def __repr__(self) -> str:
+        return self.name.upper()
+
+    @override
+    def convert(
+        self, value: uuid.UUID | str, param: Parameter | None, ctx: Context | None
+    ) -> uuid.UUID:
+        """Convert a value into the `UUID` type."""
+        match value:
+            case uuid.UUID():
+                return value
+            case str():
+                try:
+                    return uuid.UUID(value)
+                except ValueError as error:
+                    self.fail(str(error), param, ctx)
+            case _ as never:
+                assert_never(never)
+
+
 class YearMonth(ParamType):
     """A year-month parameter."""
 
@@ -561,6 +588,7 @@ def _make_metavar(param: Parameter, desc: str, /) -> str:
 
 __all__ = [
     "CONTEXT_SETTINGS_HELP_OPTION_NAMES",
+    "UUID",
     "Date",
     "DateDelta",
     "DateTimeDelta",

{dycw_utilities-0.149.1 → dycw_utilities-0.149.2}/src/utilities/typed_settings.py

@@ -7,6 +7,7 @@ from os import environ
 from pathlib import Path
 from re import search
 from typing import TYPE_CHECKING, Any, assert_never, override
+from uuid import UUID
 
 import typed_settings
 from typed_settings import EnvLoader, FileLoader, find
@@ -62,6 +63,7 @@ class ExtendedTSConverter(TSConverter):
             (PlainDateTime, PlainDateTime.parse_common_iso),
             (Time, Time.parse_common_iso),
             (TimeDelta, TimeDelta.parse_common_iso),
+            (UUID, UUID),
             (YearMonth, YearMonth.parse_common_iso),
             (ZonedDateTime, ZonedDateTime.parse_common_iso),
         ]