Table Contract Diff
Compare CSV contracts with explicit reviewed column mappings, preserving raw schema changes and reporting approval rules without exposing row values.
The problem it solves
Table Contract Diff Table Contract Diff compares two CSV files as data contracts without copying cell values into its reports.
Who Table Contract Diff is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with CSV, schema, data quality who want the documented v1.2.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Compare CSV contracts with explicit reviewed column mappings, preserving raw schema changes and reporting approval rules without exposing row values.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.2.0
Capabilities below come from the current project README and release documentation.
Table Contract Diff compares two CSV files as data contracts without copying cell values into its reports.
It detects added, removed, reordered, renamed, type-shifted, and newly nullable columns; delimiter changes; malformed-row changes; and deterministic schema fingerprints. Optional schema exports contain structural counts and maximum lengths but no cell values.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
- CSV
Changelog
Release notes from the canonical v1.2.0 source tag.
- Add explicit one-to-one removed-to-added column mappings with required explanations and aligned structural comparison.
- Retain original changes and breaking-change evidence; mapped type/nullability changes and expected-schema violations remain independently reviewable.
- Add expected-schema validation, exact approved-change rules, locale parsing profiles and a value-free HTML comparison.
- Added regression coverage for the audited behavior and invalid inputs.
- Added value-free CSV profiling with inferred types, nullability, dialect, row evidence, and hashes.
- Added contract comparison for columns, types, order, nullability, malformed rows, and rename candidates.
- Added JSON, Markdown, and portable schema output plus CI breaking-change behavior.
Quick start
The shortest documented path into the current release.
Before running these source commands, download the v1.2.0 source archive, extract it, and open a terminal in the extracted project folder containing README.md. Follow the tagged README for required runtimes and any platform-specific setup.
python -m pip install .
table-contract-diff previous.csv current.csv --output contract-review.md
table-contract-diff previous.csv current.csv --format json --fail-breakingCurrent limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- Version 1 accepts UTF-8 CSV-family files with comma, semicolon, tab, or pipe delimiters.
- Inference samples the complete valid input but cannot know business meaning or whether a change is acceptable.
- Rename candidates are suggestions based on header similarity and inferred type; they are never applied automatically.
- Dates use ISO-style parsing. Locale-specific numbers and dates may be classified as text.
- Input files remain unchanged; there is no network access, upload, telemetry, spreadsheet execution, or formula evaluation.
Python 3.10+ on Windows, macOS, and Linux. Current release: v1.2.0. Pull requests are reviewed. MIT licensed.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
No privacy behavior beyond the current repository documentation is claimed. Review the source, security policy, and input/output behavior before using sensitive material.
License and release
Table Contract Diff is published under MIT. The current cataloged release is v1.2.0, published 2026-10-15.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Table Contract Diff v1.2.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical GitHub release tag. Fingerprint: e6be2e4c9c984df6.