{"id":43750562,"url":"https://github.com/evantbyrne/csvutil","last_synced_at":"2026-02-05T13:11:23.302Z","repository":{"id":57575164,"uuid":"186285001","full_name":"evantbyrne/csvutil","owner":"evantbyrne","description":"Command line utility for transforming CSV files.","archived":false,"fork":false,"pushed_at":"2021-08-05T17:59:05.000Z","size":27,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T17:48:15.119Z","etag":null,"topics":["csv","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evantbyrne.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-05-12T17:37:19.000Z","updated_at":"2021-08-05T17:59:08.000Z","dependencies_parsed_at":"2022-09-26T19:01:52.136Z","dependency_job_id":null,"html_url":"https://github.com/evantbyrne/csvutil","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/evantbyrne/csvutil","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evantbyrne%2Fcsvutil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evantbyrne%2Fcsvutil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evantbyrne%2Fcsvutil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evantbyrne%2Fcsvutil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evantbyrne","download_url":"https://codeload.github.com/evantbyrne/csvutil/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evantbyrne%2Fcsvutil/sbom","scorecard":{"id":385830,"data":{"date":"2025-08-11","repo":{"name":"github.com/evantbyrne/csvutil","commit":"33596869af37d1c5324ee94f7f4d5f77ae335de6"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/21 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.md:0","Info: FSF or OSI recognized license: ISC License: LICENSE.md:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T16:35:21.244Z","repository_id":57575164,"created_at":"2025-08-18T16:35:21.244Z","updated_at":"2025-08-18T16:35:21.244Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29122590,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T10:47:47.471Z","status":"ssl_error","status_checked_at":"2026-02-05T10:45:08.119Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["csv","golang"],"created_at":"2026-02-05T13:11:22.665Z","updated_at":"2026-02-05T13:11:23.294Z","avatar_url":"https://github.com/evantbyrne.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# csvutil\n\nCommand line utility for transforming CSV files.\n\n\n## Design Choices\n\n- Human-readable. Operations and arguments should be easy to remember. There is no shorthand syntax.\n- Safe. External programs that can properly escape shell strings should be able to spawn csvutil processes safely.\n- Not a database. All operations are done in memory and there are no fancy tricks to speed things up.\n\n\n## Install\n\nCsvutil may be installed directly from the source repository on a system with Go 1.16 or higher, and may be done like so:\n\n```\n$ go install github.com/evantbyrne/csvutil@latest\n```\n\n**Note:** The $ at the beginning of newlines in this document represents the bash shell prompt, and is not a part of the actual commands.\n\n\n## Usage\n\n```\n$ csvutil source1.csv --operation1 --operation2 source2.csv --operation1 ...\n```\n\nThere are two types of arguments that may be passed to csvutil:\n\n1. Sources. These are CSV files to read from.\n2. Operations denoted with the `--` prefix. These transform the current source.\n\nUpon success, csvutil prints the resulting CSV data to STDOUT.\n\n\n## Examples\n\nHere are a few examples of working with csvutil.\n\n**Reading files**\n\n```\n$ csvutil user.csv\nusername,id,group_id\nfoo,1,10\nbar,2,\nbaz,3,20\nfour,4,20\nfive,5,\n$ csvutil group.csv\nname,id\nAdmin,10\nModerator,20\n```\n\n**Filtering**\n\n```\n$ csvutil user.csv --where username == baz --or group_id != 20\nusername,id,group_id\nfoo,1,10\nbar,2,\nbaz,3,20\nfive,5,\n```\n\n**Join**\n\n```\n$ csvutil user.csv group.csv --join group_id == id\nusername,id,group_id,name,id\nfoo,1,10,Admin,10\nbaz,3,20,Moderator,20\nfour,4,20,Moderator,20\n```\n\n**Sort and select**\n\n```\n$ csvutil test/user.csv --sort username ALPHA DESC --select id,username\nid,username\n4,four\n1,foo\n5,five\n3,baz\n2,bar\n```\n\n\n## Operations\n\n### Concat\n\nAppends one source onto another.\n\nNo arguments.\n\n```\n$ csvutil foo.csv\nid,name\n1,Foo\n2,Bar\n$ csvutil bar.csv\nid,name\n3,Baz\n$ csvutil foo.csv bar.csv --concat\nid,name\n1,Foo\n2,Bar\n3,Baz\n```\n\n\n### Count\n\nReturns the total number of rows for the current source.\n\nArguments:\n- Column name.\n\n```\n$ csvutil user.csv --count total\ntotal\n5\n```\n\n\n### Distinct\n\nRemoves duplicates from the current source.\n\nArguments:\n- Comma-separated list of columns that must match to be considered duplicate. Use `\"*\"` to compare all columns.\n\n```\n$ csvutil foo.csv\nid,name,group_id\n1,Foo,10\n2,Bar,10\n3,Foo,20\n4,Foo,10\n5,Foobar,20\n1,Baz,20\n$ csvutil foo.csv --distinct name\nid,name,group_id\n1,Foo,10\n2,Bar,10\n5,Foobar,20\n1,Baz,20\n$ csvutil foo.csv --distinct name,group_id\nid,name,group_id\n1,Foo,10\n2,Bar,10\n3,Foo,20\n5,Foobar,20\n1,Baz,20\n```\n\n\n### Except\n\nRemove rows from the previous source if they appear in the current source.\n\nArguments:\n- Comma-separated list of columns that must match to be considered duplicate. Use `\"*\"` to compare all columns.\n\n```\n$ csvutil foo.csv\nid,name\n1,Foo\n2,Bar\n3,Baz\n4,Foobar\n$ csvutil bar.csv\nid,name\n2,Two\n3,Three\n5,Five\n6,Six\n$ csvutil foo.csv bar.csv --except id\nid,name\n1,Foo\n4,Foobar\n```\n\n\n### Join\n\nPerform an inner join on two sources.\n\nArguments:\n- Column from previous source to compare.\n- Operation. Choices: `==`, `!=`\n- Column from the current source to compare.\n\n```\n$ csvutil user.csv\nusername,id,group_id\nfoo,1,10\nbar,2,\nbaz,3,20\nfour,4,20\nfive,5,\n$ csvutil group.csv\nname,id\nAdmin,10\nModerator,20\n$ csvutil user.csv group.csv --join group_id == id\nusername,id,group_id,name,id\nfoo,1,10,Admin,10\nbaz,3,20,Moderator,20\nfour,4,20,Moderator,20\n```\n\n\n### Select\n\nChoose a subset of columns from the current source.\n\nArguments:\n- Comma-separated list of columns to select.\n\n```\n$ csvutil foo.csv\nid,name,group_id\n1,Foo,10\n2,Bar,10\n3,Baz,20\n$ csvutil foo.csv --select name,id\nname,id\nFoo,1\nBar,2\nBaz,3\n```\n\n\n### Sort\n\nReorder the current source.\n\nArguments:\n- Column to compare.\n- Algorithm. Choices: `ALPHA`, `FLOAT`, `INT`\n- Order. Choices: `ASC`, `DESC`\n\n```\n$ csvutil user.csv\nusername,id,group_id\nfoo,1,10\nbar,2,\nbaz,3,20\nfour,4,20\nfive,5,\n$ csvutil user.csv --sort username ALPHA ASC\nusername,id,group_id\nbar,2,\nbaz,3,20\nfive,5,\nfoo,1,10\nfour,4,20\n```\n\nWhen using `FLOAT` and `INT`, values that cannot be converted will be considered lower than values which may be converted, and they will be compared to each other alphabetically. e.g.,\n\n```\n$ csvutil baz.csv\nyear,cost\n10,500\n2,200.10\n2000,50.01\nx,x\n2019,1000.99\ny,z\nz,y\n$ csvutil baz.csv --sort year INT DESC\nyear,cost\n2019,1000.99\n2000,50.01\n10,500\n2,200.10\nz,y\ny,z\nx,x\n```\n\n\n### Values\n\nStrip the header from the current source.\n\n```\n$ csvutil user.csv --count total\ntotal\n5\n$ csvutil user.csv --count total --values\n5\n```\n\n\n### Where\n\nFilter the current source.\n\nArguments:\n- Column name to compare.\n- Operator. Choices: `==`, `!=`, `IN`, `NOT_IN`\n- Value to look for.\n\n```\n$ csvutil user.csv\nusername,id,group_id\nfoo,1,10\nbar,2,\nbaz,3,20\nfour,4,20\nfive,5,\n$ csvutil user.csv --where username == baz --or group_id != 20\nusername,id,group_id\nfoo,1,10\nbar,2,\nbaz,3,20\nfive,5,\n```\n\nThe `IN` and `NOT_IN` operators take column-separated lists of values. e.g.,\n\n```\n$ csvutil user.csv --where id IN 1,3\nusername,id,group_id\nfoo,1,10\nbaz,3,20\n```\n\nOperations may be chained to perform \"and\" conditionals. e.g.,\n\n```\n$ csvutil user.csv --where username != baz --where id != 2\nusername,id,group_id\nfoo,1,10\nfour,4,20\nfive,5,\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevantbyrne%2Fcsvutil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevantbyrne%2Fcsvutil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevantbyrne%2Fcsvutil/lists"}