dycw-utilities 0.129.10__py3-none-any.whl → 0.175.17__py3-none-any.whl

utilities/importlib.py

@@ -1,7 +1,23 @@
 from __future__ import annotations
 
+import importlib.resources
 from importlib import import_module
 from importlib.util import find_spec
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from utilities.errors import ImpossibleCaseError
+
+if TYPE_CHECKING:
+    from importlib.resources import Anchor
+
+
+def files(*, anchor: Anchor | None = None) -> Path:
+    """Get the path for an anchor."""
+    path = importlib.resources.files(anchor)
+    if isinstance(path, Path):
+        return path
+    raise ImpossibleCaseError(case=[f"{path=}"])  # pragma: no cover
 
 
 def is_valid_import(module: str, /, *, name: str | None = None) -> bool:
@@ -15,4 +31,4 @@ def is_valid_import(module: str, /, *, name: str | None = None) -> bool:
     return hasattr(mod, name)
 
 
-__all__ = ["is_valid_import"]
+__all__ = ["files", "is_valid_import"]

utilities/inflect.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from collections.abc import Sized
+from typing import assert_never, cast
+
+from inflect import Word, engine
+
+_ENGINE = engine()
+
+
+def counted_noun(obj: int | Sized, noun: str, /) -> str:
+    """Construct a counted noun."""
+    match obj:
+        case int() as count:
+            ...
+        case Sized() as sized:
+            count = len(sized)
+        case never:
+            assert_never(never)
+    word = cast("Word", noun)
+    sin_or_plu = _ENGINE.plural_noun(word, count=count)
+    return f"{count} {sin_or_plu}"
+
+
+__all__ = ["counted_noun"]