grind-t-toolkit 0.1.0__tar.gz

grind_t_toolkit-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,35 @@
+# 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/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "grind-t-toolkit"
+version = "0.1.0"
+description = "Natural problem solver's toolkit"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+
+[[project.authors]]
+name = "grind-t"
+email = "grindt.gd@gmail.com"
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "toolkit"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["--import-mode=importlib"]
+markers = ["e2e: hits external services"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+]
+
+[tool.ty.environment]
+python-version = "3.10"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "ruff>=0.16.10",
+    "ty>=0.0.84",
+]

grind_t_toolkit-0.1.0/pyproject.toml.orig

@@ -0,0 +1,35 @@
+[project]
+name = "grind-t-toolkit"
+version = "0.1.0"
+description = "Natural problem solver's toolkit"
+readme = "README.md"
+authors = [
+    { name = "grind-t", email = "grindt.gd@gmail.com" }
+]
+requires-python = ">=3.10"
+dependencies = []
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "toolkit"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["--import-mode=importlib"]
+markers = ["e2e: hits external services"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ty.environment]
+python-version = "3.10"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "ruff>=0.16.10",
+    "ty>=0.0.84",
+]

grind_t_toolkit-0.1.0/src/toolkit/__init__.py

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

grind_t_toolkit-0.1.0/src/toolkit/boolean/__init__.py

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

grind_t_toolkit-0.1.0/src/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