tha-utils-helper 0.1.0__tar.gz

tha_utils_helper-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/

tha_utils_helper-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish-testpypi:
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install hatchling build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    needs: publish-testpypi
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install hatchling build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

tha_utils_helper-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/

tha_utils_helper-0.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: tha-utils-helper
+Version: 0.1.0
+Summary: A Tabular Helper utility library with general-purpose helpers for the tha-* ecosystem.
+License: MIT
+Keywords: chunks,helpers,list,utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# tha-utils-helper
+
+[![CI](https://github.com/tha-guy-nate/tha-utils-helper/actions/workflows/ci.yml/badge.svg)](https://github.com/tha-guy-nate/tha-utils-helper/actions/workflows/ci.yml)
+
+A small Python utility library with general-purpose helpers for the `tha-*` ecosystem. No dependencies, no classes — just functions.
+
+## Install
+
+```bash
+pip install tha-utils-helper
+```
+
+## Quick start
+
+```python
+from tha_utils_helper import chunk_list
+
+chunk_list([1, 2, 3, 4, 5], 2)
+# [[1, 2], [3, 4], [5]]
+```
+
+## API
+
+### `chunk_list(lst, size)`
+
+```python
+chunk_list(lst: list[T], size: int) -> list[list[T]]
+```
+
+Splits `lst` into consecutive chunks of `size`. The final chunk may be smaller if the list doesn't divide evenly. Raises `ValueError` if `size < 1`.
+
+```python
+chunk_list([1, 2, 3, 4, 5], 2)   # [[1, 2], [3, 4], [5]]
+chunk_list([1, 2, 3], 3)          # [[1, 2, 3]]
+chunk_list([], 5)                  # []
+```
+
+## License
+
+MIT

tha_utils_helper-0.1.0/README.md

@@ -0,0 +1,40 @@
+# tha-utils-helper
+
+[![CI](https://github.com/tha-guy-nate/tha-utils-helper/actions/workflows/ci.yml/badge.svg)](https://github.com/tha-guy-nate/tha-utils-helper/actions/workflows/ci.yml)
+
+A small Python utility library with general-purpose helpers for the `tha-*` ecosystem. No dependencies, no classes — just functions.
+
+## Install
+
+```bash
+pip install tha-utils-helper
+```
+
+## Quick start
+
+```python
+from tha_utils_helper import chunk_list
+
+chunk_list([1, 2, 3, 4, 5], 2)
+# [[1, 2], [3, 4], [5]]
+```
+
+## API
+
+### `chunk_list(lst, size)`
+
+```python
+chunk_list(lst: list[T], size: int) -> list[list[T]]
+```
+
+Splits `lst` into consecutive chunks of `size`. The final chunk may be smaller if the list doesn't divide evenly. Raises `ValueError` if `size < 1`.
+
+```python
+chunk_list([1, 2, 3, 4, 5], 2)   # [[1, 2], [3, 4], [5]]
+chunk_list([1, 2, 3], 3)          # [[1, 2, 3]]
+chunk_list([], 5)                  # []
+```
+
+## License
+
+MIT

tha_utils_helper-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "tha-utils-helper"
+version = "0.1.0"
+description = "A Tabular Helper utility library with general-purpose helpers for the tha-* ecosystem."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["utilities", "helpers", "list", "chunks"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff", "mypy"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tha_utils_helper"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.mypy]
+strict = true

tha_utils_helper-0.1.0/src/tha_utils_helper/__init__.py

@@ -0,0 +1,6 @@
+"""tha-utils-helper: general-purpose utility functions for the tha-* ecosystem."""
+
+from .utils import chunk_list
+
+__version__ = "0.1.0"
+__all__ = ["chunk_list"]

tha_utils_helper-0.1.0/src/tha_utils_helper/utils.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from typing import TypeVar
+
+T = TypeVar("T")
+
+
+def chunk_list(lst: list[T], size: int) -> list[list[T]]:
+    if size < 1:
+        raise ValueError("size must be >= 1")
+    return [lst[i : i + size] for i in range(0, len(lst), size)]

tha_utils_helper-0.1.0/tests/test_utils.py

@@ -0,0 +1,42 @@
+import pytest
+
+from tha_utils_helper import chunk_list
+
+
+def test_chunk_even_split() -> None:
+    assert chunk_list([1, 2, 3, 4], 2) == [[1, 2], [3, 4]]
+
+
+def test_chunk_uneven_split() -> None:
+    assert chunk_list([1, 2, 3, 4, 5], 2) == [[1, 2], [3, 4], [5]]
+
+
+def test_chunk_size_larger_than_list() -> None:
+    assert chunk_list([1, 2], 10) == [[1, 2]]
+
+
+def test_chunk_size_equals_list() -> None:
+    assert chunk_list([1, 2, 3], 3) == [[1, 2, 3]]
+
+
+def test_chunk_size_one() -> None:
+    assert chunk_list([1, 2, 3], 1) == [[1], [2], [3]]
+
+
+def test_chunk_empty_list() -> None:
+    assert chunk_list([], 5) == []
+
+
+def test_chunk_size_zero_raises() -> None:
+    with pytest.raises(ValueError):
+        chunk_list([1, 2, 3], 0)
+
+
+def test_chunk_size_negative_raises() -> None:
+    with pytest.raises(ValueError):
+        chunk_list([1, 2, 3], -1)
+
+
+def test_chunk_preserves_types() -> None:
+    result = chunk_list(["a", "b", "c"], 2)
+    assert result == [["a", "b"], ["c"]]