csvsmith 0.7.0__tar.gz → 0.7.2__tar.gz

csvsmith-0.7.2/PKG-INFO

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: csvsmith
+Version: 0.7.2
+Summary: Small CSV utilities: row deduplication, classification, row filtering, and CLI helpers.
+Author-email: Eiichi YAMAMOTO <info@yeiichi.com>
+License: MIT License
+        
+        Copyright (c) 2026 Eiichi YAMAMOTO 
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/yeiichi/csvsmith
+Project-URL: Repository, https://github.com/yeiichi/csvsmith
+Project-URL: Documentation, https://csvsmith.readthedocs.io/en/latest/
+Keywords: csv,deduplication,data-filtering,file-organization,filtering
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: openpyxl>=3.1
+Dynamic: license-file
+
+csvsmith
+========
+
+.. image:: https://img.shields.io/pypi/v/csvsmith.svg
+   :target: https://pypi.org/project/csvsmith/
+   :alt: PyPI version
+
+.. image:: https://img.shields.io/pypi/pyversions/csvsmith.svg
+   :target: https://pypi.org/project/csvsmith/
+   :alt: Supported Python versions
+
+.. image:: https://img.shields.io/pypi/l/csvsmith.svg
+   :target: https://opensource.org/licenses/
+   :alt: License
+
+.. image:: https://img.shields.io/badge/docs-Read%20the%20Docs-blue.svg
+   :target: https://csvsmith.readthedocs.io/en/latest/
+   :alt: Documentation
+
+Small, focused CSV utilities for common data wrangling tasks.
+
+``csvsmith`` provides a handful of practical tools for working with CSV
+files, including cleaning numeric values, filtering rows, deduplicating
+records, classifying files, converting Excel spreadsheets to CSV, moving
+files by suffix, and finding matches inside CSV content.
+
+Documentation
+-------------
+
+Read the full documentation at:
+
+https://csvsmith.readthedocs.io/en/latest/
+
+Features
+--------
+
+- Clean numeric strings into normalized values
+- Filter CSV rows by substring matching
+- Deduplicate row data and generate reports
+- Classify CSV files into folders based on headers/signatures
+- Convert Excel workbooks to CSV
+- Move files by suffix
+- Find matching values inside CSV files
+- Use the tools either from Python or from the command line
+
+Installation
+------------
+
+Install the package in your environment as usual for your project setup.
+
+Example:
+
+.. code-block:: console
+
+   pip install csvsmith
+
+If you are developing locally, install it in editable mode from the project
+root:
+
+.. code-block:: console
+
+   pip install -e .
+
+Quick start
+-----------
+
+You can use the library from Python:
+
+.. code-block:: python
+
+   from csvsmith import (
+       clean_numeric,
+       dedupe_with_report,
+       excel_to_csv,
+       find_matches_in_csv,
+       move_by_suffix,
+   )
+
+   print(clean_numeric("1,234.56"))
+
+Or use the command-line interface:
+
+.. code-block:: console
+
+   csvsmith --help
+
+Command-line usage
+------------------
+
+The package provides a CLI with several subcommands.
+
+Clean numeric values:
+
+.. code-block:: console
+
+   csvsmith clean-numeric "1,234.56" --sep "," --decimal "."
+
+Filter rows in a CSV:
+
+.. code-block:: console
+
+   csvsmith drop-rows input.csv notes spam --case-insensitive --drop-header
+
+Deduplicate rows:
+
+.. code-block:: console
+
+   csvsmith dedupe input.csv -o out.csv --subset id --keep first
+
+Classify CSV files:
+
+.. code-block:: console
+
+   csvsmith classify src_dir dst_dir --mode relaxed --match subset --auto --dry-run
+
+Convert Excel to CSV:
+
+.. code-block:: console
+
+   csvsmith excel2csv input.xlsx
+
+Move files by suffix:
+
+.. code-block:: console
+
+   csvsmith move-files src_dir dst_dir --suffixes .csv,.pdf
+
+Find matches in a CSV:
+
+.. code-block:: console
+
+   csvsmith find-matches input.csv target --ignore-case --ignore-whitespace
+
+Find matches in a CSV
+---------------------
+
+``find_matches_in_csv`` searches a CSV file for a target value and returns
+match records containing coordinates and row context information.
+
+Python API:
+
+.. code-block:: python
+
+   from csvsmith import find_matches_in_csv
+
+   results = find_matches_in_csv("input.csv", "target")
+
+CLI:
+
+.. code-block:: console
+
+   csvsmith find-matches input.csv target
+
+Options:
+
+- ``--ignore-case``: ignore case while matching
+- ``--ignore-whitespace``: ignore whitespace while matching
+- ``--no-nfkc``: disable NFKC normalization
+
+If matches are found, the CLI prints formatted JSON. If no matches are found,
+it prints a simple message.
+
+Other Python APIs
+-----------------
+
+The package also exposes a few other helper functions and classes from its
+top-level API.
+
+Numeric and row tools:
+
+.. code-block:: python
+
+   from csvsmith import (
+       clean_numeric,
+       count_duplicates_sorted,
+       add_row_digest,
+       find_duplicate_rows,
+       dedupe_with_report,
+       read_csv_rows,
+       write_csv_rows,
+   )
+
+CSV classification and filtering:
+
+.. code-block:: python
+
+   from csvsmith import CSVClassifier, DropRowsBySubstring, CSVCleaner
+
+File and conversion helpers:
+
+.. code-block:: python
+
+   from csvsmith import excel_to_csv, move_by_suffix
+
+String comparison utilities:
+
+.. code-block:: python
+
+   from csvsmith import StringDistance, Relation, Result, analyze_pair
+
+Project structure
+-----------------
+
+The code is organized into two main areas:
+
+- ``csvsmith.tools`` for higher-level CSV workflows
+- ``csvsmith.utils`` for reusable utility helpers
+
+Testing
+-------
+
+Run the test suite with your preferred Python test runner.
+
+Example:
+
+.. code-block:: console
+
+   pytest
+
+License
+-------
+
+See the project license for details.

csvsmith-0.7.2/README.rst

@@ -0,0 +1,223 @@
+csvsmith
+========
+
+.. image:: https://img.shields.io/pypi/v/csvsmith.svg
+   :target: https://pypi.org/project/csvsmith/
+   :alt: PyPI version
+
+.. image:: https://img.shields.io/pypi/pyversions/csvsmith.svg
+   :target: https://pypi.org/project/csvsmith/
+   :alt: Supported Python versions
+
+.. image:: https://img.shields.io/pypi/l/csvsmith.svg
+   :target: https://opensource.org/licenses/
+   :alt: License
+
+.. image:: https://img.shields.io/badge/docs-Read%20the%20Docs-blue.svg
+   :target: https://csvsmith.readthedocs.io/en/latest/
+   :alt: Documentation
+
+Small, focused CSV utilities for common data wrangling tasks.
+
+``csvsmith`` provides a handful of practical tools for working with CSV
+files, including cleaning numeric values, filtering rows, deduplicating
+records, classifying files, converting Excel spreadsheets to CSV, moving
+files by suffix, and finding matches inside CSV content.
+
+Documentation
+-------------
+
+Read the full documentation at:
+
+https://csvsmith.readthedocs.io/en/latest/
+
+Features
+--------
+
+- Clean numeric strings into normalized values
+- Filter CSV rows by substring matching
+- Deduplicate row data and generate reports
+- Classify CSV files into folders based on headers/signatures
+- Convert Excel workbooks to CSV
+- Move files by suffix
+- Find matching values inside CSV files
+- Use the tools either from Python or from the command line
+
+Installation
+------------
+
+Install the package in your environment as usual for your project setup.
+
+Example:
+
+.. code-block:: console
+
+   pip install csvsmith
+
+If you are developing locally, install it in editable mode from the project
+root:
+
+.. code-block:: console
+
+   pip install -e .
+
+Quick start
+-----------
+
+You can use the library from Python:
+
+.. code-block:: python
+
+   from csvsmith import (
+       clean_numeric,
+       dedupe_with_report,
+       excel_to_csv,
+       find_matches_in_csv,
+       move_by_suffix,
+   )
+
+   print(clean_numeric("1,234.56"))
+
+Or use the command-line interface:
+
+.. code-block:: console
+
+   csvsmith --help
+
+Command-line usage
+------------------
+
+The package provides a CLI with several subcommands.
+
+Clean numeric values:
+
+.. code-block:: console
+
+   csvsmith clean-numeric "1,234.56" --sep "," --decimal "."
+
+Filter rows in a CSV:
+
+.. code-block:: console
+
+   csvsmith drop-rows input.csv notes spam --case-insensitive --drop-header
+
+Deduplicate rows:
+
+.. code-block:: console
+
+   csvsmith dedupe input.csv -o out.csv --subset id --keep first
+
+Classify CSV files:
+
+.. code-block:: console
+
+   csvsmith classify src_dir dst_dir --mode relaxed --match subset --auto --dry-run
+
+Convert Excel to CSV:
+
+.. code-block:: console
+
+   csvsmith excel2csv input.xlsx
+
+Move files by suffix:
+
+.. code-block:: console
+
+   csvsmith move-files src_dir dst_dir --suffixes .csv,.pdf
+
+Find matches in a CSV:
+
+.. code-block:: console
+
+   csvsmith find-matches input.csv target --ignore-case --ignore-whitespace
+
+Find matches in a CSV
+---------------------
+
+``find_matches_in_csv`` searches a CSV file for a target value and returns
+match records containing coordinates and row context information.
+
+Python API:
+
+.. code-block:: python
+
+   from csvsmith import find_matches_in_csv
+
+   results = find_matches_in_csv("input.csv", "target")
+
+CLI:
+
+.. code-block:: console
+
+   csvsmith find-matches input.csv target
+
+Options:
+
+- ``--ignore-case``: ignore case while matching
+- ``--ignore-whitespace``: ignore whitespace while matching
+- ``--no-nfkc``: disable NFKC normalization
+
+If matches are found, the CLI prints formatted JSON. If no matches are found,
+it prints a simple message.
+
+Other Python APIs
+-----------------
+
+The package also exposes a few other helper functions and classes from its
+top-level API.
+
+Numeric and row tools:
+
+.. code-block:: python
+
+   from csvsmith import (
+       clean_numeric,
+       count_duplicates_sorted,
+       add_row_digest,
+       find_duplicate_rows,
+       dedupe_with_report,
+       read_csv_rows,
+       write_csv_rows,
+   )
+
+CSV classification and filtering:
+
+.. code-block:: python
+
+   from csvsmith import CSVClassifier, DropRowsBySubstring, CSVCleaner
+
+File and conversion helpers:
+
+.. code-block:: python
+
+   from csvsmith import excel_to_csv, move_by_suffix
+
+String comparison utilities:
+
+.. code-block:: python
+
+   from csvsmith import StringDistance, Relation, Result, analyze_pair
+
+Project structure
+-----------------
+
+The code is organized into two main areas:
+
+- ``csvsmith.tools`` for higher-level CSV workflows
+- ``csvsmith.utils`` for reusable utility helpers
+
+Testing
+-------
+
+Run the test suite with your preferred Python test runner.
+
+Example:
+
+.. code-block:: console
+
+   pytest
+
+License
+-------
+
+See the project license for details.

{csvsmith-0.7.0 → csvsmith-0.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "csvsmith"
-version = "0.7.0"
+version = "0.7.2"
 description = "Small CSV utilities: row deduplication, classification, row filtering, and CLI helpers."
 readme = "README.rst"
 requires-python = ">=3.10"
@@ -38,6 +38,7 @@ dependencies = [
 [project.urls]
 Homepage = "https://github.com/yeiichi/csvsmith"
 Repository = "https://github.com/yeiichi/csvsmith"
+Documentation = "https://csvsmith.readthedocs.io/en/latest/"
 
 [project.scripts]
 csvsmith = "csvsmith.cli:main"

{csvsmith-0.7.0 → csvsmith-0.7.2}/src/csvsmith/__init__.py

@@ -31,24 +31,25 @@ Submodules:
 - csvsmith.cli (CLI entrypoint)
 """
 
-__version__ = "0.7.0"
+__version__ = "0.7.2"
 
-from .tools.clean_numeric import clean_numeric
+from .tools.classify import CSVClassifier
+from .tools.excel2csv import excel_to_csv
+from .tools.filter_rows import DropRowsBySubstring
+from .tools.find_matches_in_csv import find_matches_in_csv
+from .tools.move_files import move_by_suffix
 from .tools.row_dedup import (
     add_row_digest,
     find_duplicate_rows,
     dedupe_with_report,
 )
+from .utils.clean_numeric import clean_numeric
+from .utils.distance import StringDistance, Relation, Result, analyze_pair
 from .utils.io import (
     count_duplicates_sorted,
     read_csv_rows,
     write_csv_rows,
 )
-from .tools.classify import CSVClassifier
-from .tools.filter_rows import DropRowsBySubstring, CSVCleaner
-from .tools.excel2csv import excel_to_csv
-from .tools.move_files import move_by_suffix
-from .utils.distance import StringDistance, Relation, Result, analyze_pair
 
 __all__ = [
     "count_duplicates_sorted",
@@ -61,6 +62,7 @@ __all__ = [
     "DropRowsBySubstring",
     "excel_to_csv",
     "move_by_suffix",
+    "find_matches_in_csv",
     "StringDistance",
     "Relation",
     "Result",

{csvsmith-0.7.0 → csvsmith-0.7.2}/src/csvsmith/cli.py

@@ -9,7 +9,7 @@ from typing import Optional, Sequence
 from . import __version__
 from .tools.classify import CSVClassifier
 from .tools.excel2csv import excel_to_csv
-from .tools.clean_numeric import clean_numeric
+from .utils.clean_numeric import clean_numeric
 from .tools.filter_rows import DropRowsBySubstring
 from .tools.move_files import move_by_suffix, normalize_suffixes
 from .tools.row_dedup import (