passive-experiment-csv-header-preview 0.1.0__tar.gz

passive_experiment_csv_header_preview-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Passive Experiment (Chad Darcy)
+
+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.

passive_experiment_csv_header_preview-0.1.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: passive-experiment-csv-header-preview
+Version: 0.1.0
+Summary: Preview ASCII header renames and collisions before using CSV Cleanup. Offline Python, original names visible; no file writes.
+License-Expression: MIT
+Project-URL: CSV Cleanup Kit, https://passiveexperiment.gumroad.com/l/osmloi?utm_source=pypi&utm_medium=sample&utm_campaign=mkt10-csv-cleanup-kit
+Keywords: csv,data-cleaning,cli
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# CSV header preview
+
+Preview the header-renaming step from the CSV Cleanup Kit before touching any CSV data. The script shows original and proposed ASCII snake_case names by position, including duplicate suffixes. Python 3.10+ only; no dependencies, account, network or file writes.
+
+```sh
+python3 csv_header_preview.py ' Client Name ' 'Client-Name' '名'
+```
+
+This fictional example proposes `client_name`, `client_name_2` and `column`. Non-Latin text, accents, punctuation and currency distinctions can be lost; compare every proposal with the original. Renaming does not prove compatibility with any receiving system. The sample accepts header strings only. It does not read CSVs, clean cells, remove duplicates, convert dates, neutralize formulas or validate financial records.
+
+The code is a bounded sample of the existing reviewed tool's header logic, created with AI assistance and checked with fictional cases. No outcome, security or compatibility guarantee; do not pass personal/client data in a public example or support request. This is not the paid kit or a hosted service.
+
+The optional [CSV Cleanup Kit](https://passiveexperiment.gumroad.com/l/osmloi?utm_source=github&utm_medium=sample&utm_campaign=mkt10-csv-cleanup-kit) is USD9 on Gumroad and includes the full offline cleanup script, JSON change report, fictional before/after exercise and printable Plan/Check/Handoff sheets in A4/US Letter. The paid kit retains its single-business licence; no worksheet or paid archive is included here. This is the seller's sample and paid offer, not independent endorsement or verified demand.
+
+Released under the MIT licence (see LICENSE). The licence covers this sample only, not the paid kit.

passive_experiment_csv_header_preview-0.1.0/README.md

@@ -0,0 +1,15 @@
+# CSV header preview
+
+Preview the header-renaming step from the CSV Cleanup Kit before touching any CSV data. The script shows original and proposed ASCII snake_case names by position, including duplicate suffixes. Python 3.10+ only; no dependencies, account, network or file writes.
+
+```sh
+python3 csv_header_preview.py ' Client Name ' 'Client-Name' '名'
+```
+
+This fictional example proposes `client_name`, `client_name_2` and `column`. Non-Latin text, accents, punctuation and currency distinctions can be lost; compare every proposal with the original. Renaming does not prove compatibility with any receiving system. The sample accepts header strings only. It does not read CSVs, clean cells, remove duplicates, convert dates, neutralize formulas or validate financial records.
+
+The code is a bounded sample of the existing reviewed tool's header logic, created with AI assistance and checked with fictional cases. No outcome, security or compatibility guarantee; do not pass personal/client data in a public example or support request. This is not the paid kit or a hosted service.
+
+The optional [CSV Cleanup Kit](https://passiveexperiment.gumroad.com/l/osmloi?utm_source=github&utm_medium=sample&utm_campaign=mkt10-csv-cleanup-kit) is USD9 on Gumroad and includes the full offline cleanup script, JSON change report, fictional before/after exercise and printable Plan/Check/Handoff sheets in A4/US Letter. The paid kit retains its single-business licence; no worksheet or paid archive is included here. This is the seller's sample and paid offer, not independent endorsement or verified demand.
+
+Released under the MIT licence (see LICENSE). The licence covers this sample only, not the paid kit.

passive_experiment_csv_header_preview-0.1.0/csv_header_preview.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python3
+"""Preview CSV Cleanup's ASCII header renaming without reading or writing files."""
+from __future__ import annotations
+
+import argparse
+import json
+import re
+
+
+def snake(header: str) -> str:
+    text = re.sub(r"[^0-9a-zA-Z]+", "_", header.strip()).strip("_").lower()
+    return text or "column"
+
+
+def preview_headers(headers: list[str]) -> list[dict[str, str | int]]:
+    """Return original/proposed names by position; never change caller data."""
+    names: set[str] = set()
+    result = []
+    for position, raw in enumerate(headers, start=1):
+        name, n = snake(raw), 2
+        while name in names:
+            name, n = f"{snake(raw)}_{n}", n + 1
+        names.add(name)
+        result.append({"position": position, "original": raw, "proposed": name})
+    return result
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("headers", nargs="+", help="Quote each literal header as one argument")
+    args = parser.parse_args(argv)
+    print(json.dumps({"warning": "ASCII renaming can lose accents, non-Latin text and currency distinctions; review every proposed name. No CSV or data cells were read or changed.", "headers": preview_headers(args.headers)}, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

passive_experiment_csv_header_preview-0.1.0/passive_experiment_csv_header_preview.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: passive-experiment-csv-header-preview
+Version: 0.1.0
+Summary: Preview ASCII header renames and collisions before using CSV Cleanup. Offline Python, original names visible; no file writes.
+License-Expression: MIT
+Project-URL: CSV Cleanup Kit, https://passiveexperiment.gumroad.com/l/osmloi?utm_source=pypi&utm_medium=sample&utm_campaign=mkt10-csv-cleanup-kit
+Keywords: csv,data-cleaning,cli
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# CSV header preview
+
+Preview the header-renaming step from the CSV Cleanup Kit before touching any CSV data. The script shows original and proposed ASCII snake_case names by position, including duplicate suffixes. Python 3.10+ only; no dependencies, account, network or file writes.
+
+```sh
+python3 csv_header_preview.py ' Client Name ' 'Client-Name' '名'
+```
+
+This fictional example proposes `client_name`, `client_name_2` and `column`. Non-Latin text, accents, punctuation and currency distinctions can be lost; compare every proposal with the original. Renaming does not prove compatibility with any receiving system. The sample accepts header strings only. It does not read CSVs, clean cells, remove duplicates, convert dates, neutralize formulas or validate financial records.
+
+The code is a bounded sample of the existing reviewed tool's header logic, created with AI assistance and checked with fictional cases. No outcome, security or compatibility guarantee; do not pass personal/client data in a public example or support request. This is not the paid kit or a hosted service.
+
+The optional [CSV Cleanup Kit](https://passiveexperiment.gumroad.com/l/osmloi?utm_source=github&utm_medium=sample&utm_campaign=mkt10-csv-cleanup-kit) is USD9 on Gumroad and includes the full offline cleanup script, JSON change report, fictional before/after exercise and printable Plan/Check/Handoff sheets in A4/US Letter. The paid kit retains its single-business licence; no worksheet or paid archive is included here. This is the seller's sample and paid offer, not independent endorsement or verified demand.
+
+Released under the MIT licence (see LICENSE). The licence covers this sample only, not the paid kit.

passive_experiment_csv_header_preview-0.1.0/passive_experiment_csv_header_preview.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+csv_header_preview.py
+pyproject.toml
+passive_experiment_csv_header_preview.egg-info/PKG-INFO
+passive_experiment_csv_header_preview.egg-info/SOURCES.txt
+passive_experiment_csv_header_preview.egg-info/dependency_links.txt
+passive_experiment_csv_header_preview.egg-info/entry_points.txt
+passive_experiment_csv_header_preview.egg-info/top_level.txt
+tests/test_csv_header_preview.py

passive_experiment_csv_header_preview-0.1.0/passive_experiment_csv_header_preview.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

passive_experiment_csv_header_preview-0.1.0/passive_experiment_csv_header_preview.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+csv-header-preview = csv_header_preview:main

passive_experiment_csv_header_preview-0.1.0/passive_experiment_csv_header_preview.egg-info/top_level.txt

@@ -0,0 +1 @@
+csv_header_preview

passive_experiment_csv_header_preview-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "passive-experiment-csv-header-preview"
+version = "0.1.0"
+description = "Preview ASCII header renames and collisions before using CSV Cleanup. Offline Python, original names visible; no file writes."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = []
+keywords = ["csv", "data-cleaning", "cli"]
+
+[project.urls]
+"CSV Cleanup Kit" = "https://passiveexperiment.gumroad.com/l/osmloi?utm_source=pypi&utm_medium=sample&utm_campaign=mkt10-csv-cleanup-kit"
+
+[project.scripts]
+csv-header-preview = "csv_header_preview:main"
+
+[tool.setuptools]
+py-modules = ["csv_header_preview"]

passive_experiment_csv_header_preview-0.1.0/setup.cfg

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

passive_experiment_csv_header_preview-0.1.0/tests/test_csv_header_preview.py

@@ -0,0 +1,50 @@
+import importlib.util
+import io
+import json
+import contextlib
+import unittest
+from pathlib import Path
+
+spec = importlib.util.spec_from_file_location('header_sample', Path(__file__).resolve().parents[1] / 'csv_header_preview.py')
+module = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(module)
+
+class HeaderPreviewTests(unittest.TestCase):
+    def test_cli_runs_without_writing_files(self):
+        import subprocess
+        import sys
+        import tempfile
+        with tempfile.TemporaryDirectory() as directory:
+            result = subprocess.run([sys.executable, str(Path(module.__file__).resolve()), ' A ', 'a'], cwd=directory, text=True, capture_output=True, check=True)
+            self.assertEqual(json.loads(result.stdout)['headers'][1]['proposed'], 'a_2')
+            self.assertEqual(list(Path(directory).iterdir()), [])
+
+    def test_collision_order_matches_existing_tool(self):
+        values = ['a', 'a', 'a_2', 'a', ' A ']
+        original = values.copy()
+        actual = module.preview_headers(values)
+        self.assertEqual([x['proposed'] for x in actual], ['a', 'a_2', 'a_2_2', 'a_3', 'a_4'])
+        self.assertEqual([x['original'] for x in actual], original)
+        self.assertEqual(values, original)
+        self.assertEqual([x['position'] for x in actual], [1, 2, 3, 4, 5])
+
+    def test_lossy_and_empty_names_are_visible(self):
+        result = module.preview_headers(['', '名', 'é', 'USD $', 'USD €'])
+        self.assertEqual([x['proposed'] for x in result], ['column', 'column_2', 'column_3', 'usd', 'usd_2'])
+        self.assertEqual(result[1]['original'], '名')
+
+    def test_cli_valid_json_and_warning(self):
+        stream = io.StringIO()
+        with contextlib.redirect_stdout(stream):
+            self.assertEqual(module.main([' Client Name ', 'Client-Name']), 0)
+        result = json.loads(stream.getvalue())
+        self.assertIn('can lose', result['warning'])
+        self.assertEqual(result['headers'][1]['proposed'], 'client_name_2')
+
+    def test_cli_requires_headers(self):
+        with contextlib.redirect_stderr(io.StringIO()), self.assertRaises(SystemExit) as error:
+            module.main([])
+        self.assertEqual(error.exception.code, 2)
+
+if __name__ == '__main__':
+    unittest.main()