minimindslab-csv-normalize 0.1.0__py3-none-any.whl

minimindslab_csv_normalize/__init__.py

@@ -0,0 +1,6 @@
+"""MiniMindsLab CSV Normalize."""
+
+from .core import normalize_csv
+
+__all__ = ["normalize_csv"]
+__version__ = "0.1.0"

minimindslab_csv_normalize/__main__.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+import argparse
+import sys
+
+from .core import normalize_csv
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="Normalize small CSV text deterministically.")
+    parser.add_argument("--input", "-i", help="Path to input CSV file. If omitted, read from stdin.")
+    parser.add_argument("--no-sort-headers", action="store_true", help="Preserve original header order.")
+    parser.add_argument("--newline", choices=["lf", "crlf"], default="lf", help="Output newline style.")
+    return parser
+
+
+def main() -> int:
+    parser = build_parser()
+    args = parser.parse_args()
+
+    if args.input:
+        with open(args.input, "r", encoding="utf-8", newline="") as f:
+            text = f.read()
+    else:
+        text = sys.stdin.read()
+
+    nl = "\n" if args.newline == "lf" else "\r\n"
+    result = normalize_csv(text, sort_headers=not args.no_sort_headers, newline=nl)
+    sys.stdout.write(result)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

minimindslab_csv_normalize/core.py

@@ -0,0 +1,60 @@
+"""Core CSV normalization logic."""
+
+from __future__ import annotations
+
+import csv
+import io
+from typing import List
+
+
+def _normalize_newlines(text: str) -> str:
+    return text.replace("\r\n", "\n").replace("\r", "\n")
+
+
+def normalize_csv(text: str, *, sort_headers: bool = True, newline: str = "\n") -> str:
+    """Normalize CSV text into stable output.
+
+    - Normalizes line endings in input.
+    - Trims leading/trailing whitespace for all cells.
+    - Optionally sorts headers alphabetically for deterministic column order.
+    - Emits output with a consistent newline and trailing newline when non-empty.
+    """
+    if not isinstance(text, str):
+        raise TypeError("text must be a str")
+    if newline not in {"\n", "\r\n"}:
+        raise ValueError("newline must be '\\n' or '\\r\\n'")
+
+    src = _normalize_newlines(text)
+    if src.strip() == "":
+        return ""
+
+    reader = csv.reader(io.StringIO(src))
+    rows: List[List[str]] = [[cell.strip() for cell in row] for row in reader]
+    if not rows:
+        return ""
+
+    header = rows[0]
+    data = rows[1:]
+
+    if sort_headers:
+        indices = sorted(range(len(header)), key=lambda i: (header[i], i))
+        header = [header[i] for i in indices]
+
+        def reorder(row: List[str]) -> List[str]:
+            padded = row + [""] * (len(indices) - len(row))
+            return [padded[i] if i < len(padded) else "" for i in indices]
+
+        data = [reorder(r) for r in data]
+    else:
+        data = [r + [""] * (len(header) - len(r)) if len(r) < len(header) else r[: len(header)] for r in data]
+
+    output = io.StringIO()
+    writer = csv.writer(output, lineterminator="\n")
+    writer.writerow(header)
+    for row in data:
+        writer.writerow(row)
+
+    rendered = output.getvalue()
+    if newline != "\n":
+        rendered = rendered.replace("\n", newline)
+    return rendered

minimindslab_csv_normalize-0.1.0.dist-info/METADATA

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: minimindslab-csv-normalize
+Version: 0.1.0
+Summary: Normalize small CSV text into stable, comparison-friendly output with controllable header ordering, trimming, and line endings.
+Author: MiniMindsLab
+License: MIT
+Keywords: csv,normalize,deterministic,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# MiniMindsLab CSV Normalize
+
+Deterministically normalize small CSV text for stable diffs, tests, and reviews.
+
+## Features
+
+- Trims surrounding whitespace in headers and cell values.
+- Normalizes mixed line endings to `\n`.
+- Optional stable header sorting.
+- Deterministic output for identical logical input.
+- Library API and CLI.
+
+## Library Usage
+
+```python
+from minimindslab_csv_normalize import normalize_csv
+
+raw = " Name , Age \r\n Alice , 30 \r\n"
+out = normalize_csv(raw)
+print(out)
+# Age,Name\n30,Alice\n
+# Keep original header order
+out2 = normalize_csv(raw, sort_headers=False)
+print(out2)
+# Name,Age\nAlice,30\n
+```
+
+## CLI Usage
+
+From stdin:
+
+```bash
+echo " Name , Age \r\n Alice , 30 " | miniminds-csv-normalize
+```
+
+From file:
+
+```bash
+miniminds-csv-normalize --input sample.csv
+```
+
+Disable header sorting:
+
+```bash
+miniminds-csv-normalize --no-sort-headers --input sample.csv
+```

minimindslab_csv_normalize-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+minimindslab_csv_normalize/__init__.py,sha256=NTaAKSAYJX86qDiTPiOhtodrql4AFiPfin4Pvnb23HM,118
+minimindslab_csv_normalize/__main__.py,sha256=c43g7QNibxIQpGSUiQ37NovlNSyW-OJWNRZA9WcaBnA,1048
+minimindslab_csv_normalize/core.py,sha256=XRDggK_dvAdZ9NSubZhSmzIRkScGYZD18Y05RI3DoAw,1862
+minimindslab_csv_normalize-0.1.0.dist-info/licenses/LICENSE,sha256=9SsHAp-rmsco8evLbp-_802okWchTYdG-RZx5d3yddM,1069
+minimindslab_csv_normalize-0.1.0.dist-info/METADATA,sha256=3FynG_S_bsa8CY_r77Uj-XISBQx6tANoVyNLI1tvXJI,1671
+minimindslab_csv_normalize-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+minimindslab_csv_normalize-0.1.0.dist-info/entry_points.txt,sha256=9fmnYOanrvC7dY8vQvlPvbgR3evbNmsK3nZzl3mYlL0,85
+minimindslab_csv_normalize-0.1.0.dist-info/top_level.txt,sha256=7ZG7hVBklhOY-TikYB-yne_tFjNPC4cutVSIVkHrZOg,27
+minimindslab_csv_normalize-0.1.0.dist-info/RECORD,,

minimindslab_csv_normalize-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

minimindslab_csv_normalize-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+miniminds-csv-normalize = minimindslab_csv_normalize.__main__:main

minimindslab_csv_normalize-0.1.0.dist-info/licenses/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_normalize-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+minimindslab_csv_normalize