minimindslab-csv-headers-align 0.1.0__tar.gz

minimindslab_csv_headers_align-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MiniMindsLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

minimindslab_csv_headers_align-0.1.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: minimindslab-csv-headers-align
+Version: 0.1.0
+Summary: Normalize CSV header order to match a target header list, reordering present columns and optionally identifying missing or extra columns.
+Author: MiniMindsLab
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# MiniMindsLab CSV Headers Align
+
+Normalize CSV header order to match a target header list, reordering present columns and optionally identifying missing or extra columns.
+
+## Install
+
+```bash
+pip install minimindslab-csv-headers-align
+```
+
+## Usage
+
+```python
+from minimindslab_csv_headers_align import align_headers
+
+header = ["id", "name", "email", "legacy"]
+target = ["name", "email", "id", "country"]
+
+result = align_headers(header, target)
+
+print(result.aligned)  # ['name', 'email', 'id']
+print(result.missing)  # ['country']
+print(result.extra)    # ['legacy']
+```
+
+## API
+
+- `align_headers(header_row, target_headers, *, validate=False)`
+  - Returns `AlignmentResult(aligned, missing, extra)`.
+  - `aligned`: present columns in target order.
+  - `missing`: target headers not present in input.
+  - `extra`: input headers not present in target.
+  - If `validate=True`, raises `ValueError` when missing headers exist.
+
+## Notes
+
+- Pure Python standard library only.
+- Inputs are normalized to strings using `str(value)` for non-`None` values, and `""` for `None`.
+- Duplicate values in `target_headers` are deduplicated by first appearance for deterministic behavior.

minimindslab_csv_headers_align-0.1.0/README.md

@@ -0,0 +1,39 @@
+# MiniMindsLab CSV Headers Align
+
+Normalize CSV header order to match a target header list, reordering present columns and optionally identifying missing or extra columns.
+
+## Install
+
+```bash
+pip install minimindslab-csv-headers-align
+```
+
+## Usage
+
+```python
+from minimindslab_csv_headers_align import align_headers
+
+header = ["id", "name", "email", "legacy"]
+target = ["name", "email", "id", "country"]
+
+result = align_headers(header, target)
+
+print(result.aligned)  # ['name', 'email', 'id']
+print(result.missing)  # ['country']
+print(result.extra)    # ['legacy']
+```
+
+## API
+
+- `align_headers(header_row, target_headers, *, validate=False)`
+  - Returns `AlignmentResult(aligned, missing, extra)`.
+  - `aligned`: present columns in target order.
+  - `missing`: target headers not present in input.
+  - `extra`: input headers not present in target.
+  - If `validate=True`, raises `ValueError` when missing headers exist.
+
+## Notes
+
+- Pure Python standard library only.
+- Inputs are normalized to strings using `str(value)` for non-`None` values, and `""` for `None`.
+- Duplicate values in `target_headers` are deduplicated by first appearance for deterministic behavior.

minimindslab_csv_headers_align-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "minimindslab-csv-headers-align"
+version = "0.1.0"
+description = "Normalize CSV header order to match a target header list, reordering present columns and optionally identifying missing or extra columns."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+  { name = "MiniMindsLab" }
+]
+dependencies = []
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

minimindslab_csv_headers_align-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

minimindslab_csv_headers_align-0.1.0/src/minimindslab_csv_headers_align/__init__.py

@@ -0,0 +1,80 @@
+"""MiniMindsLab CSV Headers Align.
+
+Utilities to align CSV header rows against a canonical target header order.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Iterable
+
+
+@dataclass(frozen=True, slots=True)
+class AlignmentResult:
+    """Result of header alignment.
+
+    Attributes:
+        aligned: Input columns that are present in target order.
+        missing: Target columns absent from the input.
+        extra: Input columns absent from target.
+    """
+
+    aligned: list[str]
+    missing: list[str]
+    extra: list[str]
+
+
+def _normalize_value(value: object) -> str:
+    if value is None:
+        return ""
+    return str(value)
+
+
+def _normalize_sequence(values: Iterable[object]) -> list[str]:
+    return [_normalize_value(v) for v in values]
+
+
+def _dedupe_preserve_order(values: list[str]) -> list[str]:
+    seen: set[str] = set()
+    out: list[str] = []
+    for item in values:
+        if item not in seen:
+            seen.add(item)
+            out.append(item)
+    return out
+
+
+def align_headers(
+    header_row: Iterable[object],
+    target_headers: Iterable[object],
+    *,
+    validate: bool = False,
+) -> AlignmentResult:
+    """Align an input header row to target header order.
+
+    Args:
+        header_row: Input header values.
+        target_headers: Canonical target sequence.
+        validate: If True, raise ValueError when missing target headers exist.
+
+    Returns:
+        AlignmentResult with aligned, missing, and extra columns.
+    """
+
+    header_list = _normalize_sequence(header_row)
+    target_list = _dedupe_preserve_order(_normalize_sequence(target_headers))
+
+    header_set = set(header_list)
+    target_set = set(target_list)
+
+    aligned = [col for col in target_list if col in header_set]
+    missing = [col for col in target_list if col not in header_set]
+    extra = [col for col in header_list if col not in target_set]
+
+    if validate and missing:
+        raise ValueError(f"Missing target columns: {missing}")
+
+    return AlignmentResult(aligned=aligned, missing=missing, extra=extra)
+
+
+__all__ = ["AlignmentResult", "align_headers"]

minimindslab_csv_headers_align-0.1.0/src/minimindslab_csv_headers_align.egg-info/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: minimindslab-csv-headers-align
+Version: 0.1.0
+Summary: Normalize CSV header order to match a target header list, reordering present columns and optionally identifying missing or extra columns.
+Author: MiniMindsLab
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# MiniMindsLab CSV Headers Align
+
+Normalize CSV header order to match a target header list, reordering present columns and optionally identifying missing or extra columns.
+
+## Install
+
+```bash
+pip install minimindslab-csv-headers-align
+```
+
+## Usage
+
+```python
+from minimindslab_csv_headers_align import align_headers
+
+header = ["id", "name", "email", "legacy"]
+target = ["name", "email", "id", "country"]
+
+result = align_headers(header, target)
+
+print(result.aligned)  # ['name', 'email', 'id']
+print(result.missing)  # ['country']
+print(result.extra)    # ['legacy']
+```
+
+## API
+
+- `align_headers(header_row, target_headers, *, validate=False)`
+  - Returns `AlignmentResult(aligned, missing, extra)`.
+  - `aligned`: present columns in target order.
+  - `missing`: target headers not present in input.
+  - `extra`: input headers not present in target.
+  - If `validate=True`, raises `ValueError` when missing headers exist.
+
+## Notes
+
+- Pure Python standard library only.
+- Inputs are normalized to strings using `str(value)` for non-`None` values, and `""` for `None`.
+- Duplicate values in `target_headers` are deduplicated by first appearance for deterministic behavior.

minimindslab_csv_headers_align-0.1.0/src/minimindslab_csv_headers_align.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+src/minimindslab_csv_headers_align/__init__.py
+src/minimindslab_csv_headers_align.egg-info/PKG-INFO
+src/minimindslab_csv_headers_align.egg-info/SOURCES.txt
+src/minimindslab_csv_headers_align.egg-info/dependency_links.txt
+src/minimindslab_csv_headers_align.egg-info/top_level.txt
+tests/test_headers_align.py

minimindslab_csv_headers_align-0.1.0/src/minimindslab_csv_headers_align.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

minimindslab_csv_headers_align-0.1.0/src/minimindslab_csv_headers_align.egg-info/top_level.txt

@@ -0,0 +1 @@
+minimindslab_csv_headers_align

minimindslab_csv_headers_align-0.1.0/tests/test_headers_align.py

@@ -0,0 +1,49 @@
+import unittest
+
+from minimindslab_csv_headers_align import AlignmentResult, align_headers
+
+
+class TestHeadersAlign(unittest.TestCase):
+    def test_acceptance_reorders_present_columns_in_target_order(self):
+        header = ["id", "name", "email", "legacy"]
+        target = ["name", "email", "id", "country"]
+        result = align_headers(header, target)
+        self.assertEqual(result.aligned, ["name", "email", "id"])
+
+    def test_acceptance_missing_reported_without_raise_when_validate_false(self):
+        header = ["a", "b"]
+        target = ["a", "b", "c", "d"]
+        result = align_headers(header, target, validate=False)
+        self.assertEqual(result.missing, ["c", "d"])
+
+    def test_acceptance_extra_reported_and_separate(self):
+        header = ["x", "a", "b", "z"]
+        target = ["a", "b", "c"]
+        result = align_headers(header, target)
+        self.assertEqual(result.aligned, ["a", "b"])
+        self.assertEqual(result.extra, ["x", "z"])
+
+    def test_acceptance_non_string_boolean_none_inputs_predictable(self):
+        header = [True, None, 5, "x"]
+        target = ["", "True", "x", "7"]
+        result = align_headers(header, target)
+        self.assertEqual(result.aligned, ["", "True", "x"])
+        self.assertEqual(result.missing, ["7"])
+        self.assertEqual(result.extra, ["5"])
+
+    def test_negative_validate_true_raises_on_missing(self):
+        with self.assertRaises(ValueError):
+            align_headers(["a"], ["a", "b"], validate=True)
+
+    def test_target_deduplicated_deterministically(self):
+        result = align_headers(["a", "b"], ["a", "a", "b", "a"])
+        self.assertEqual(result.aligned, ["a", "b"])
+        self.assertEqual(result.missing, [])
+
+    def test_returns_dataclass_result(self):
+        result = align_headers([], [])
+        self.assertIsInstance(result, AlignmentResult)
+
+
+if __name__ == "__main__":
+    unittest.main()