grind-t-toolkit 0.1.0__py3-none-any.whl

grind_t_toolkit-0.1.0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.3
+Name: grind-t-toolkit
+Version: 0.1.0
+Summary: Natural problem solver's toolkit
+Author: grind-t
+Author-email: grind-t <grindt.gd@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# grind-t-toolkit
+
+Natural problem solver's toolkit.
+Python port of [`@grind-t/toolkit`](https://github.com/grind-t/toolkit).
+
+## Installation
+
+```sh
+uv add grind-t-toolkit
+```
+
+## Structure
+
+Utilities are grouped into category subpackages, mirroring the subpath exports
+of the TypeScript package:
+
+```python
+from toolkit.array import ...
+from toolkit.string import ...
+```
+
+Tests live in `tests/<category>/test_<name>.py`. Tests that hit external
+services are marked with `@pytest.mark.e2e`.
+
+## Development
+
+| Task | Command |
+| --- | --- |
+| Format | `uv run ruff format` |
+| Lint | `uv run ruff check --fix` |
+| Type check | `uv run ty check` |
+| Unit tests | `uv run pytest -m "not e2e"` |
+| E2E tests | `uv run pytest -m e2e` |
+| All tests | `uv run pytest` |
+| Build | `uv build` |

grind_t_toolkit-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+toolkit/__init__.py,sha256=juqd9PbXs4yg45zMJ7BHAOPQjb7sgEbWE9InBtGZhfo,24
+toolkit/boolean/__init__.py,sha256=swfBG2Ka2U9DswRtGxl3rXxUQLL-PZ7ad4YRkKW4gw8,49
+toolkit/boolean/ensure.py,sha256=m_6_GZPRvf702uVQHnY1t70xqf7COaKG5tPBWrcdUtY,448
+toolkit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+grind_t_toolkit-0.1.0.dist-info/WHEEL,sha256=y6e-a5KI2W-qDAJKfh9Xr81bin8NgUdfWgz3VSXXpe4,80
+grind_t_toolkit-0.1.0.dist-info/METADATA,sha256=nsY_cbEbOFHRQ_la9jliRW11lcz7uktmsCQqLC_eiCU,1015
+grind_t_toolkit-0.1.0.dist-info/RECORD,,

grind_t_toolkit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.9
+Root-Is-Purelib: true
+Tag: py3-none-any

toolkit/__init__.py

@@ -0,0 +1 @@
+__all__: list[str] = []

toolkit/boolean/__init__.py

@@ -0,0 +1,3 @@
+from .ensure import ensure
+
+__all__ = ["ensure"]

toolkit/boolean/ensure.py

@@ -0,0 +1,15 @@
+from typing import TypeVar
+
+T = TypeVar("T")
+
+
+def ensure(value: T | None, message: str = "Expected value to be truthy") -> T:
+    """Return ``value`` if it is truthy, otherwise raise ``ValueError``.
+
+    Unlike ``assert``, the check is not stripped when Python runs with ``-O``.
+    The return type drops ``None``, so the result can be used without extra
+    narrowing.
+    """
+    if not value:
+        raise ValueError(message)
+    return value