{"id":19946093,"url":"https://github.com/quantco/tabulardelta","last_synced_at":"2026-03-14T12:45:10.919Z","repository":{"id":253138835,"uuid":"841949870","full_name":"Quantco/tabulardelta","owner":"Quantco","description":"Simplify table comparisons.","archived":false,"fork":false,"pushed_at":"2025-04-01T09:48:54.000Z","size":590,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-07T18:43:09.210Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Quantco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-13T11:20:01.000Z","updated_at":"2025-03-07T12:56:49.000Z","dependencies_parsed_at":"2024-11-13T00:28:45.721Z","dependency_job_id":"56dd8212-03ba-4400-84ab-aa5eaa30b2d8","html_url":"https://github.com/Quantco/tabulardelta","commit_stats":null,"previous_names":["quantco/tabulardelta"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quantco%2Ftabulardelta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quantco%2Ftabulardelta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quantco%2Ftabulardelta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quantco%2Ftabulardelta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Quantco","download_url":"https://codeload.github.com/Quantco/tabulardelta/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252216099,"owners_count":21713099,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T00:28:16.672Z","updated_at":"2026-03-14T12:45:10.891Z","avatar_url":"https://github.com/Quantco.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TabularDelta\n\n[![CI](https://img.shields.io/github/actions/workflow/status/quantco/tabulardelta/ci.yml?style=flat-square\u0026branch=main)](https://github.com/quantco/tabulardelta/actions/workflows/ci.yml)\n[![Documentation](https://img.shields.io/badge/docs-latest-success?branch=main\u0026style=flat-square)](https://tabulardelta.readthedocs.io/en/latest/)\n[![pypi-version](https://img.shields.io/pypi/v/tabulardelta.svg?logo=pypi\u0026logoColor=white\u0026style=flat-square)](https://pypi.org/project/tabulardelta)\n[![python-version](https://img.shields.io/pypi/pyversions/tabulardelta?logoColor=white\u0026logo=python\u0026style=flat-square)](https://pypi.org/project/tabulardelta)\n\nTabularDelta helps to automate and simplify the often tedious and manual process of comparing relational data.\n\nThe so-called TabularDelta protocol defines a representation of the differences between two tables.\n\"Comparators\" are used to generate such a representation from two table objects. The exchangeability of the comparators allows for varying table input formats like SQL tables or Pandas DataFrames.\n\"Formatters\" allow to present the differences in different output formats depending on the desired usecase.\nThe flexibility in the output format allows to find small deviations in largely similar tables or provide an overview of more structural changes.\n\n## Usage example\n\nThis snippet will report the differences of two CSV files.\nYou can execute it directly in [test_docs_examples.py](tests/test_docs_examples.py).\n\n```python\nimport pandas as pd\nfrom tabulardelta import PandasComparator, DetailedTextFormatter\n\ndf_old = pd.read_csv(\"week24.csv\", index_col=[0, 1])\ndf_new = pd.read_csv(\"week25.csv\", index_col=[0, 1])\n\ndelta = PandasComparator().compare(df_old, df_new)\nprint(DetailedTextFormatter().format(delta))\n```\n\nTo compare two tables, first select a comparator that supports the table format. Now select any formatter that best suits your use case to obtain a visualization of the result.\n\nTo find more examples and get started, please visit the [documentation](https://tabulardelta.readthedocs.io/en/latest/).\n\n## Development\n\nThis project is managed by [pixi](https://pixi.sh).\nYou can install the package in development mode using:\n\n```bash\ngit clone https://github.com/quantco/tabulardelta\ncd tabulardelta\n\npixi run pre-commit-install\npixi run postinstall\n```\n\n## Testing\n\n- Make sure docker is installed\n- Make sure `ODBC Driver 17 for SQL Server` is installed\n  - See [Download ODBC Driver for SQL Server](https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16)\n  - This may require setting the `ODBCSYSINI` environment variable to the path of msodbcsql17\n- Run `pixi run test`\n\nSetting up the MsSql docker container may take a while, but it will be cached for future runs as long as you keep it running.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquantco%2Ftabulardelta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquantco%2Ftabulardelta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquantco%2Ftabulardelta/lists"}