splurge-dsv 2025.1.3__py3-none-any.whl → 2025.1.5__py3-none-any.whl

splurge_dsv/__init__.py

@@ -44,7 +44,7 @@ from splurge_dsv.resource_manager import (
 from splurge_dsv.string_tokenizer import StringTokenizer
 from splurge_dsv.text_file_helper import TextFileHelper
 
-__version__ = "2025.1.3"
+__version__ = "2025.1.5"
 __author__ = "Jim Schilling"
 __license__ = "MIT"
 

splurge_dsv/__main__.py

@@ -2,14 +2,14 @@
 Command-line interface entry point for splurge-dsv.
 
 This module serves as the entry point when running the package as a module.
-It imports and calls the main CLI function from the cli module.
+It imports and calls the run_cli function from the cli module.
 """
 
 # Standard library imports
 import sys
 
 # Local imports
-from splurge_dsv.cli import main
+from splurge_dsv.cli import run_cli
 
 if __name__ == "__main__":
-    sys.exit(main())
+    sys.exit(run_cli())

splurge_dsv/cli.py

@@ -13,10 +13,12 @@ Please preserve this header and all related material when sharing!
 
 # Standard library imports
 import argparse
+import json
 import sys
 from pathlib import Path
 
 # Local imports
+from splurge_dsv import __version__
 from splurge_dsv.dsv_helper import DsvHelper
 from splurge_dsv.exceptions import SplurgeDsvError
 
@@ -56,7 +58,14 @@ Examples:
 
     parser.add_argument("--chunk-size", type=int, default=500, help="Chunk size for streaming (default: 500)")
 
-    parser.add_argument("--version", action="version", version="%(prog)s 2025.1.3")
+    parser.add_argument(
+        "--output-format",
+        choices=["table", "json", "ndjson"],
+        default="table",
+        help="Output format for results (default: table)",
+    )
+
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
 
     return parser.parse_args()
 
@@ -90,8 +99,25 @@ def print_results(rows: list[list[str]], delimiter: str) -> None:
                 print("-" * (sum(max_widths) + len(max_widths) * 3 - 1))
 
 
-def main() -> int:
-    """Main entry point for the command-line interface."""
+def run_cli() -> int:
+    """Run the command-line interface for DSV file parsing.
+
+    This function serves as the main entry point for the splurge-dsv CLI tool.
+    It parses command-line arguments, validates the input file, and processes
+    DSV files according to the specified options. Supports both regular parsing
+    and streaming modes for large files.
+
+    Returns:
+        int: Exit code indicating success or failure:
+            - 0: Success
+            - 1: Generic error (file not found, parsing error, etc.)
+            - 2: Invalid arguments
+            - 130: Operation interrupted (Ctrl+C)
+
+    Raises:
+        SystemExit: Terminates the program with the appropriate exit code.
+            This is handled internally and should not be caught by callers.
+    """
     try:
         args = parse_arguments()
 
@@ -107,7 +133,8 @@ def main() -> int:
 
         # Parse the file
         if args.stream:
-            print(f"Streaming file '{args.file_path}' with delimiter '{args.delimiter}'...")
+            if args.output_format != "json":
+                print(f"Streaming file '{args.file_path}' with delimiter '{args.delimiter}'...")
             chunk_count = 0
             total_rows = 0
 
@@ -124,13 +151,21 @@ def main() -> int:
             ):
                 chunk_count += 1
                 total_rows += len(chunk)
-                print(f"Chunk {chunk_count}: {len(chunk)} rows")
-                print_results(chunk, args.delimiter)
-                print()
-
-            print(f"Total: {total_rows} rows in {chunk_count} chunks")
+                if args.output_format == "json":
+                    print(json.dumps(chunk, ensure_ascii=False))
+                elif args.output_format == "ndjson":
+                    for row in chunk:
+                        print(json.dumps(row, ensure_ascii=False))
+                else:
+                    print(f"Chunk {chunk_count}: {len(chunk)} rows")
+                    print_results(chunk, args.delimiter)
+                    print()
+
+            if args.output_format not in ["json", "ndjson"]:
+                print(f"Total: {total_rows} rows in {chunk_count} chunks")
         else:
-            print(f"Parsing file '{args.file_path}' with delimiter '{args.delimiter}'...")
+            if args.output_format not in ["json", "ndjson"]:
+                print(f"Parsing file '{args.file_path}' with delimiter '{args.delimiter}'...")
             rows = DsvHelper.parse_file(
                 file_path,
                 delimiter=args.delimiter,
@@ -142,8 +177,14 @@ def main() -> int:
                 skip_footer_rows=args.skip_footer,
             )
 
-            print(f"Parsed {len(rows)} rows")
-            print_results(rows, args.delimiter)
+            if args.output_format == "json":
+                print(json.dumps(rows, ensure_ascii=False))
+            elif args.output_format == "ndjson":
+                for row in rows:
+                    print(json.dumps(row, ensure_ascii=False))
+            else:
+                print(f"Parsed {len(rows)} rows")
+                print_results(rows, args.delimiter)
 
         return 0
 

{splurge_dsv-2025.1.3.dist-info → splurge_dsv-2025.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: splurge-dsv
-Version: 2025.1.3
+Version: 2025.1.5
 Summary: A utility library for working with DSV (Delimited String Values) files
 Author: Jim Schilling
 License-Expression: MIT
@@ -29,6 +29,11 @@ Dynamic: license-file
 
 # splurge-dsv
 
+[![PyPI version](https://badge.fury.io/py/splurge-dsv.svg)](https://pypi.org/project/splurge-dsv/)
+[![Python versions](https://img.shields.io/pypi/pyversions/splurge-dsv.svg)](https://pypi.org/project/splurge-dsv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Coverage](https://img.shields.io/badge/coverage-96%25-brightgreen.svg)](https://github.com/jim-schilling/splurge-dsv)
+
 A robust Python library for parsing and processing delimited-separated value (DSV) files with advanced features for data validation, streaming, and error handling.
 
 ## Features
@@ -243,97 +248,17 @@ The project follows strict coding standards:
 
 ## Changelog
 
-### 2025.1.3 (2025-09-03)
-
-#### 🔧 Maintenance & Consistency
-- **Version Alignment**: Bumped `__version__` and CLI `--version` to `2025.1.3` to match `pyproject.toml`.
-- **CLI Path Validation**: Centralized validation using `PathValidator.validate_path(...)` for consistent error handling.
-- **Type Correctness**: Fixed `PathValidator._is_valid_windows_drive_pattern` to return `bool` explicitly.
-- **Docs Alignment**: Updated README coverage claims to reflect the `>=85%` coverage gate configured in CI.
-
-### 2025.1.2 (2025-09-02)
-
-#### 🧪 Comprehensive End-to-End Testing
-- **Complete E2E Test Suite**: Implemented 25 comprehensive end-to-end workflow tests covering all major CLI functionality
-- **Real CLI Execution**: Tests run actual `splurge-dsv` commands with real files, not just mocked components
-- **Workflow Coverage**: Tests cover CSV/TSV parsing, file operations, data processing, error handling, and performance scenarios
-- **Cross-Platform Compatibility**: Handles Windows-specific encoding issues and platform differences gracefully
-- **Performance Testing**: Large file processing tests (1,000+ and 10,000+ rows) with streaming and chunking validation
-
-#### 📊 Test Coverage Improvements
-- **Integration Testing**: Added real file system operations and complete pipeline validation
-
-#### 🔄 Test Categories
-- **CLI Workflows**: 19 tests covering basic parsing, custom delimiters, header/footer skipping, streaming, and error scenarios
-- **Error Handling**: 3 tests for invalid arguments, missing parameters, and CLI error conditions
-- **Integration Scenarios**: 3 tests for data analysis, transformation, and multi-format workflows
-
-#### 📚 Documentation & Examples
-- **E2E Testing Guide**: Created comprehensive documentation (`docs/e2e_testing_coverage.md`) explaining test coverage and usage
-- **Real-World Examples**: Tests serve as practical examples of library usage patterns
-- **Error Scenario Coverage**: Comprehensive testing of edge cases and failure conditions
-
-### 2025.1.1 (2025-08-XX)
-
-#### 🔧 Code Quality Improvements
-- **Refactored Complex Regex Logic**: Extracted Windows drive letter validation logic from `_check_dangerous_characters` into a dedicated `_is_valid_windows_drive_pattern` helper method in `PathValidator` for better readability and maintainability
-- **Exception Handling Consistency**: Fixed inconsistency in `ResourceManager.acquire()` method to properly re-raise `NotImplementedError` without wrapping it in `SplurgeResourceAcquisitionError`
-- **Import Organization**: Moved all imports to the top of modules across the entire codebase for better code structure and PEP 8 compliance
-
-#### 🧪 Testing Enhancements
-- **Public API Focus**: Removed all tests that validated private implementation details, focusing exclusively on public API behavior validation
-- **Comprehensive Resource Manager Tests**: Added extensive test suite for `ResourceManager` module covering all public methods, edge cases, error scenarios, and context manager behavior
-- **Bookend Logic Clarification**: Updated and corrected all tests related to `StringTokenizer.remove_bookends` to properly reflect its single-character, symmetric bookend matching behavior
-- **Path Validation Test Clarity**: Clarified test expectations and comments for Windows drive-relative paths (e.g., "C:file.txt") to reflect the validator's intentionally strict security design
-
-#### 🐛 Bug Fixes
-- **Test Reliability**: Fixed failing tests in `ResourceManager` context manager scenarios by properly handling file truncation and line ending normalization
-- **Ruff Compliance**: Resolved all linting warnings including unused variables and imports
-
-#### 📚 Documentation Updates
-- **Method Documentation**: Updated `ResourceManager.acquire()` docstring to include `NotImplementedError` in the Raises section
-- **Test Comments**: Enhanced test documentation with clearer explanations of expected behaviors and edge cases
-
-### 2025.1.0 (2025-08-25)
-
-#### 🎉 Major Features
-- **Complete DSV Parser**: Full-featured delimited-separated value parser with support for CSV, TSV, and custom delimiters
-- **Streaming Support**: Memory-efficient streaming for large files with configurable chunk sizes
-- **Advanced Parsing Options**: Bookend removal, whitespace handling, and encoding support
-- **Header/Footer Skipping**: Skip specified numbers of rows from start or end of files
-
-#### 🛡️ Security Enhancements
-- **Path Validation System**: Comprehensive file path security validation with traversal attack prevention
-- **File Permission Checks**: Automatic file accessibility and permission validation
-- **Encoding Validation**: Robust encoding error detection and handling
-
-#### 🔧 Core Components
-- **DsvHelper**: Main DSV parsing class with parse, parses, parse_file, and parse_stream methods
-- **TextFileHelper**: Utility class for text file operations (line counting, preview, reading, streaming)
-- **PathValidator**: Security-focused path validation utilities
-- **ResourceManager**: Context managers for safe resource handling
-- **StringTokenizer**: Core string parsing functionality
-
-#### 🧪 Testing & Quality
-- **Comprehensive Test Suite**: 250+ tests with 85%+ coverage gate
-- **Cross-Platform Testing**: Tested on Windows, Linux, and macOS
-- **Type Safety**: Full type annotations throughout the codebase
-- **Error Handling**: Custom exception hierarchy with detailed error messages
-
-#### 📚 Documentation
-- **Complete API Documentation**: Google-style docstrings for all public methods
-- **Usage Examples**: Comprehensive examples for all major features
-- **Error Documentation**: Detailed error handling documentation
-
-#### 🚀 Performance
-- **Memory Efficiency**: Streaming support for large files
-- **Optimized Parsing**: Efficient string tokenization and processing
-- **Resource Management**: Automatic cleanup and resource management
+See the [CHANGELOG](CHANGELOG.md) for full release notes.
 
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## More Documentation
+
+- Detailed docs: [docs/README-details.md](docs/README-details.md)
+- E2E testing coverage: [docs/e2e_testing_coverage.md](docs/e2e_testing_coverage.md)
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

{splurge_dsv-2025.1.3.dist-info → splurge_dsv-2025.1.5.dist-info}/RECORD

@@ -1,14 +1,14 @@
-splurge_dsv/__init__.py,sha256=YaY3yCQF5bNVO76yaITvqggFOg3QkpkY3CjtkkLf-C8,2415
-splurge_dsv/__main__.py,sha256=RkXcU3P3tHpFa6iGJfx8sAZ4aUcz6z7TIN_1q_5N9xE,354
-splurge_dsv/cli.py,sha256=hFchXI5DdLTpfdOgvh0Unq_nvsN8YNzJg86DgygdLrg,5866
+splurge_dsv/__init__.py,sha256=cqq1MreFbu8ib04OyzkydhLc6ZpJSnc3jyMqoEouABo,2415
+splurge_dsv/__main__.py,sha256=CX8zVMaK6vaaCaC396FyXA1E_-jqKz4zh3CVW8mGKac,359
+splurge_dsv/cli.py,sha256=QLFdb22MSpQF3iXwxdEhETYWTup9y2pGfT6Vt3TzKuA,7612
 splurge_dsv/dsv_helper.py,sha256=VRq2ejx6y-JBtFKJdAaK-GD4V0eoxZZfmoX0I3CSbDI,9428
 splurge_dsv/exceptions.py,sha256=cu9Jd2pGhy7GBbbngH6zs0lfZzLp_OvGwbnsG5khp80,3035
 splurge_dsv/path_validator.py,sha256=RuRFjtHWE1Z5-DlSBBZMoHJegQEFYEQ0HJgN7ndre2k,9969
 splurge_dsv/resource_manager.py,sha256=g4igv1hhJdPtw4A1P-WdaNKcYMfEGCtZ4xaU4ynVbKw,12045
 splurge_dsv/string_tokenizer.py,sha256=wBKWdi68rreTqf3RF-8Oxh1nz6QdnbOyWflw2x8pGWY,4022
 splurge_dsv/text_file_helper.py,sha256=vdhEv9uK0hsNXvTO5SoWwFsI9fPkhdIUXuaJs80DVDA,13573
-splurge_dsv-2025.1.3.dist-info/licenses/LICENSE,sha256=fPgtg-tIFHinQvJH0arRfv50AuxikD5eHw6rrPy2A5w,1091
-splurge_dsv-2025.1.3.dist-info/METADATA,sha256=yKp4mvzuf18nvn2gD6iDBokkVHMqTiX5tfpYuqWtWk8,14298
-splurge_dsv-2025.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-splurge_dsv-2025.1.3.dist-info/top_level.txt,sha256=D6Si3FTfpRYqH7kzM7tSQAyaKbbraO6UPLpcqcY4XXM,12
-splurge_dsv-2025.1.3.dist-info/RECORD,,
+splurge_dsv-2025.1.5.dist-info/licenses/LICENSE,sha256=fPgtg-tIFHinQvJH0arRfv50AuxikD5eHw6rrPy2A5w,1091
+splurge_dsv-2025.1.5.dist-info/METADATA,sha256=-dWt2wSfflEcg7KWeftltEFaNEve5Mdwxx3MZ9SRFAQ,9023
+splurge_dsv-2025.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+splurge_dsv-2025.1.5.dist-info/top_level.txt,sha256=D6Si3FTfpRYqH7kzM7tSQAyaKbbraO6UPLpcqcY4XXM,12
+splurge_dsv-2025.1.5.dist-info/RECORD,,