A conservative local CSV scanner that flags cells beginning with spreadsheet formula characters and can write a sanitized copy with a leading apostrophe. The original file is never modified.
- ✅ Scans every CSV cell and reports row and column
- ✅ Flags values beginning with =, +, -, or @ after whitespace
- ✅ Can write a separate apostrophe-prefixed sanitized copy
- ✅ Uses Python's CSV parser and preserves table structure
python main.py scan examples/untrusted.csvThe example runs locally; no hosted service or upload is required.
python -m pip install -r requirements.txt
python main.py scan examples/untrusted.csvRun python main.py --help to see all supported options.
- Python 3.10+ standard library (csv)
- Automated tests: unittest
- Local-first processing
csv-formula-guard/
├── main.py
├── requirements.txt
├── tests/test_core.py
├── examples/untrusted.csv
└── assets/illustration.svg
- Core workflow and CLI
- Example input and tests
- Additional report formats
- Continuous integration on supported platforms
Issues and pull requests are welcome. Keep changes focused, document behavior changes, and add tests for new features.
MIT - see LICENSE.