{"id":16514940,"url":"https://github.com/eiri/taon","last_synced_at":"2026-04-29T17:32:15.480Z","repository":{"id":57550658,"uuid":"138109071","full_name":"eiri/taon","owner":"eiri","description":"Show JSON as a table.","archived":false,"fork":false,"pushed_at":"2026-04-13T22:53:17.000Z","size":112,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-14T00:35:55.563Z","etag":null,"topics":["ascii-table","cli","command-line","json"],"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/eiri.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-06-21T02:26:00.000Z","updated_at":"2026-04-13T22:53:20.000Z","dependencies_parsed_at":"2024-05-31T00:46:59.497Z","dependency_job_id":"e7dad505-75e3-462f-b290-4f20f3370058","html_url":"https://github.com/eiri/taon","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/eiri/taon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eiri%2Ftaon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eiri%2Ftaon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eiri%2Ftaon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eiri%2Ftaon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eiri","download_url":"https://codeload.github.com/eiri/taon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eiri%2Ftaon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32436614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T17:26:39.753Z","status":"ssl_error","status_checked_at":"2026-04-29T17:25:53.857Z","response_time":110,"last_error":"SSL_read: 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":["ascii-table","cli","command-line","json"],"created_at":"2024-10-11T16:14:30.293Z","updated_at":"2026-04-29T17:32:15.475Z","avatar_url":"https://github.com/eiri.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# taon\n[![CI Status](https://github.com/eiri/taon/actions/workflows/ci.yaml/badge.svg)](https://github.com/eiri/taon/actions/workflows/ci.yaml)\n[![release](https://img.shields.io/github/release/eiri/taon/all.svg)](https://github.com/eiri/taon/releases)\n[![Go Report Card](https://goreportcard.com/badge/github.com/eiri/taon)](https://goreportcard.com/report/github.com/eiri/taon)\n[![pkg.go.dev](https://pkg.go.dev/badge/github.com/eiri/taon)](https://pkg.go.dev/github.com/eiri/taon)\n\nTransform JSON into ASCII table\n\n## Installation\n\n### MacOS\n\nInstall using [Homebrew](https://brew.sh/).\n\nTap `eiri/tap` with `brew tap eiri/tap` and then run `brew install taon --cask` or just run `brew install eiri/tap/taon`. To update run `brew update` and then `brew upgrade taon`.\n\n### Linux and Windows\n\nSince `taon` is just a single binary [download the latest release](https://github.com/eiri/taon/releases) and place it in your `$PATH`.\n\n### Build from source\n\n`go install github.com/eiri/taon@latest`\n\n## Usage\n\n### Reading\n\nRead a JSON array from a file:\n\n```bash\n$ taon pkg/taon/testdata/example.json\n+-------+-------+--------+-----+---------------------+\n| bool  | count | number | seq | word                |\n+-------+-------+--------+-----+---------------------+\n| false | 0001  | 779    | 1   | electrophototherapy |\n| true  | 0002  | 700    | 2   | twatterlight        |\n| false | 0003  | 310    | 3   | phlebograph         |\n| false | 0004  | 742    | 4   | Ervipiame           |\n| false | 0005  | 841    | 5   | annexational        |\n| true  | 0006  | 352    | 6   | unjewel             |\n| true  | 0007  | 852    | 7   | Anglic              |\n| true  | 0008  | 818    | 8   | alliable            |\n| true  | 0009  | 822    | 9   | seraphism           |\n| true  | 0010  | 822    | 10  | congenialize        |\n| false | 0011  | 549    | 11  | phu                 |\n| false | 0012  | 777    | 12  | vial                |\n+-------+-------+--------+-----+---------------------+\n```\n\nor from a cURL output:\n\n```bash\n$ curl -s https://github.com/eiri/taon/blob/main/pkg/taon/testdata/example.json | taon\n+-------+-------+--------+-----+---------------------+\n| bool  | count | number | seq | word                |\n+-------+-------+--------+-----+---------------------+\n| false | 0001  | 779    | 1   | electrophototherapy |\n| true  | 0002  | 700    | 2   | twatterlight        |\n| false | 0003  | 310    | 3   | phlebograph         |\n| false | 0004  | 742    | 4   | Ervipiame           |\n| false | 0005  | 841    | 5   | annexational        |\n| true  | 0006  | 352    | 6   | unjewel             |\n| true  | 0007  | 852    | 7   | Anglic              |\n| true  | 0008  | 818    | 8   | alliable            |\n| true  | 0009  | 822    | 9   | seraphism           |\n| true  | 0010  | 822    | 10  | congenialize        |\n| false | 0011  | 549    | 11  | phu                 |\n| false | 0012  | 777    | 12  | vial                |\n+-------+-------+--------+-----+---------------------+\n```\n\n_Note: By default `taon` sorts columns alphabetically by a name to preserve order's stability. To explicitly define the order of the columns use `--columns` flag with comma separated list of the names_\n\n### Reading JSON objects\n\nFor objects `taon` builds a table with `keys` and `values` columns, instead of trying to present each object's key as a column.\n\nRows are sorted by key or printed in the order defined with `--columns` flag, same as the columns when reading JSON arrays.\n\n```bash\n$ jq '.[0]' pkg/taon/testdata/example.json | taon\n+--------+---------------------+\n| keys   | values              |\n+--------+---------------------+\n| bool   | false               |\n| count  | 0001                |\n| number | 779                 |\n| seq    | 1                   |\n| word   | electrophototherapy |\n+--------+---------------------+\n```\n\n### Filtering\n\nFilter columns to a given list in the specified order:\n\n```bash\n$ taon -c seq,word,bool pkg/taon/testdata/example.json\n+-----+---------------------+-------+\n| seq | word                | bool  |\n+-----+---------------------+-------+\n| 1   | electrophototherapy | false |\n| 2   | twatterlight        | true  |\n| 3   | phlebograph         | false |\n| 4   | Ervipiame           | false |\n| 5   | annexational        | false |\n| 6   | unjewel             | true  |\n| 7   | Anglic              | true  |\n| 8   | alliable            | true  |\n| 9   | seraphism           | true  |\n| 10  | congenialize        | true  |\n| 11  | phu                 | false |\n| 12  | vial                | false |\n+-----+---------------------+-------+\n\n$ jq '.[0]' pkg/taon/testdata/example.json | taon -c seq,word,bool\n+------+---------------------+\n| keys | values              |\n+------+---------------------+\n| seq  | 1                   |\n| word | electrophototherapy |\n| bool | false               |\n+------+---------------------+\n```\n\n### Markdown\n\nPrint a table as markdown:\n\n```bash\n$ taon --columns seq,word,bool --markdown pkg/taon/testdata/example.json\n| seq | word                | bool  |\n|-----|---------------------|-------|\n| 1   | electrophototherapy | false |\n| 2   | twatterlight        | true  |\n| 3   | phlebograph         | false |\n| 4   | Ervipiame           | false |\n| 5   | annexational        | false |\n| 6   | unjewel             | true  |\n| 7   | Anglic              | true  |\n| 8   | alliable            | true  |\n| 9   | seraphism           | true  |\n| 10  | congenialize        | true  |\n| 11  | phu                 | false |\n| 12  | vial                | false |\n\n$ jq '.[0]' pkg/taon/testdata/example.json | taon --columns seq,word,bool --markdown\n| keys | values              |\n|------|---------------------|\n| seq  | 1                   |\n| word | electrophototherapy |\n| bool | false               |\n```\n\n### Limitations\n\n`taon` only works with objects or arrays of objects, passing in an array of arbitrary data will return an error.\n\n## Help\n\n```bash\n$ taon --help\nTransform JSON into ASCII table\n\nUsage: taon [flags] [file]\n\nFlags:\n  -c, --columns=COL1,COL2  List of columns to display\n  -m, --markdown           Print as markdown table\n  -h, --help               Show help\n      --version            Show application version\n\nArgs:\n  \u003cfile\u003e                   Path to file to read, stdin when missing\n```\n\n## Licence\n\n[MIT](https://github.com/eiri/taon/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feiri%2Ftaon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feiri%2Ftaon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feiri%2Ftaon/lists"}