CSV Data Processor

A modern, cross-platform Python GUI application for processing and manipulating CSV files according to user needs.

Features

• CSV splitting: Split data by single or multiple field combinations
• Data transformation: Manipulate and transform CSV data as needed
• Flexible field selection: Choose exactly which fields to include in output files
• Field reordering: Customize field order with intuitive up/down controls for consistent output
• Intuitive GUI: Clean, modern interface with real-time feedback
• Memory efficient: Handles large files without loading entire dataset
• Cross-platform: Works on Windows, macOS, and Linux

Quick Start

Download Pre-built Binaries (Recommended)

1. Go to the Releases page

2. Download the latest version for your operating system:

   • Windows: CSV-Data-Processor.exe
   • macOS: CSV-Data-Processor-macOS.zip (extract and run the .app)
   • Linux: Build from source (see below)

3. Run the downloaded executable

Windows Security Warning

If you see "Windows protected your PC" warning:

1. Click "More info" → "Run anyway"
2. Or right-click the .exe → Properties → Check "Unblock" → OK

The executable is not code-signed. See Code Signing Guide for details.

Run from Source

# Clone the repository
git clone https://github.com/czhaoca/csv-data-processor.git
cd csv-data-processor

# Run the application
python main.py

Install as Package

pip install -e .
csv-data-processor

Documentation

• User Guide: Complete usage instructions and tutorials
• Build Instructions: Create standalone executables
• Code Signing Guide: Windows security and distribution
• Architecture: Technical design and architecture
• Project Structure: Codebase organization

Requirements

• Python 3.7+
• tkinter (included with most Python installations)
• No external runtime dependencies

Development

# Install development dependencies
pip install -r requirements.txt

# Generate test data
python examples/generate_test_data.py

# Run tests
python -m pytest tests/

# Code formatting
black src/ tests/

# Build executable
python build_scripts/build_cross_platform.py

Project Structure

csv-data-processor/
├── src/csv_processor/       # Main application package
├── tests/                   # Test suite
├── docs/                    # Documentation
├── examples/                # Sample data and generators
├── build_scripts/           # Build tools and PyInstaller specs
├── .github/workflows/       # CI/CD automation
└── main.py                  # Application entry point

License

MIT License - see LICENSE for details.