Forge Miniv1.0.0Feature Complete

Table Contract Diff

Compare CSV schemas and inferred data contracts locally without exposing cell values.

v1.0.0Current release

MITSource license

3Supported platform groups

General UtilitiesCatalog category

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.0.0 behavior.
People who prefer an open-source release with visible limitations, source, and license terms.

Intended result

Compare CSV schemas and inferred data contracts locally without exposing cell values.

This summary is reconciled from the current catalog and repository documentation.

Features in v1.0.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

Quick start

The shortest documented path into the current release.

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-breaking

Current 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.0.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.0.0, published 2026-08-10.

Release and downloads Read the license

Related projects

Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.

Current public release