{"id":21710784,"url":"https://github.com/syu-fu/keydiff","last_synced_at":"2025-03-20T17:52:52.543Z","repository":{"id":264423554,"uuid":"893319877","full_name":"Syu-fu/keydiff","owner":"Syu-fu","description":"Keydiff is a tool for comparing structured data based on specified keys. ","archived":false,"fork":false,"pushed_at":"2025-03-12T23:05:13.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T00:18:49.323Z","etag":null,"topics":["cli","cli-app","csv","diff"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Syu-fu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-24T05:38:16.000Z","updated_at":"2025-03-12T23:05:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"808fc9e2-4810-4516-b065-f1a6d019c2eb","html_url":"https://github.com/Syu-fu/keydiff","commit_stats":null,"previous_names":["syu-fu/keydiff"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Syu-fu%2Fkeydiff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Syu-fu%2Fkeydiff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Syu-fu%2Fkeydiff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Syu-fu%2Fkeydiff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Syu-fu","download_url":"https://codeload.github.com/Syu-fu/keydiff/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244666494,"owners_count":20490287,"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":["cli","cli-app","csv","diff"],"created_at":"2024-11-25T23:17:40.518Z","updated_at":"2025-03-20T17:52:52.514Z","avatar_url":"https://github.com/Syu-fu.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# keydiff\n\n[![lint](https://github.com/Syu-fu/keydiff/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/Syu-fu/keydiff/actions/workflows/lint.yml)\n[![check license](https://github.com/Syu-fu/keydiff/actions/workflows/license-check.yml/badge.svg?branch=main)](https://github.com/Syu-fu/keydiff/actions/workflows/license-check.yml)\n[![test](https://github.com/Syu-fu/keydiff/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/Syu-fu/keydiff/actions/workflows/test.yml)\n[![Go Coverage](https://github.com/Syu-fu/keydiff/wiki/coverage.svg)](https://raw.githack.com/wiki/Syu-fu/keydiff/coverage.html)\n\n**keydiff** is a tool for comparing structured data based on specified keys. It allows you to identify differences between datasets quickly and easily. This is especially useful for verifying updates, detecting changes, and ensuring data consistency across files or systems.\n\n## Features\n\n- **Key-based comparison**: Compare datasets using a specific key column.\n- **Simple usage**: Just specify two CSV files and a key column.\n- **Output**: Displays the differences in a human-readable format.\n\n## Installation\n\nThere are two easy ways to install **Keydiff**:\n\n### 1. Install via GitHub Releases\n\nYou can download the latest release from the [GitHub releases page](https://github.com/Syu-fu/keydiff/releases).\n\n- Go to the releases page.\n- Download the appropriate version for your operating system.\n- Extract the archive and place the executable in a directory that’s in your system’s `PATH`.\n\n### 2. Install via Homebrew (macOS/Linux)\n\nIf you're using Homebrew, you can install **Keydiff** directly from the Homebrew repository.\n\n```bash\nbrew install Syu-fu/tap/keydiff\n```\n\nThis will install the latest stable version of **Keydiff**.\n\n### 3. Build from Source\n\nIf you'd like to build **Keydiff** from source, you can clone the repository and run the following commands:\n\n```bash\ngit clone https://github.com/Syu-fu/keydiff.git\ncd keydiff\ngo build\n```\n\nAfter building, you can place the `keydiff` executable in a directory that’s in your system’s `PATH` for easy access from the terminal.\n\n## Usage\n\nTo compare two CSV files based on a specified key column, run the following command:\n\n```bash\nkeydiff \u003coriginal.csv\u003e \u003cmodified.csv\u003e --key 0\n```\n\nBy default, the key column is the first column (index 0), but you can specify a different key column with the `--key` flag.\n\n### Example\n\nLet's say you have the following two CSV files, `original.csv` and `modified.csv`, and you want to compare them using the `name` column (index 1) as the key.\n\n**original.csv**:\n\n```\n1,apple,1.50\n2,banana,1.00\n3,orange,1.25\n```\n\n**modified.csv**:\n\n```\n1,apple,1.50\n2,banana,1.00\n4,grape,1.00\n3,orange,1.25\n```\n\nYou can compare the files using the `name` column (index 1) as the key by running the following command:\n\n```bash\nkeydiff --key 1 original.csv modified.csv\n```\n\n### Output\n\n```\nKey: grape\n+: 4, grape, 1.00\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyu-fu%2Fkeydiff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyu-fu%2Fkeydiff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyu-fu%2Fkeydiff/lists"}