{"id":44279216,"url":"https://github.com/uaraven/csql","last_synced_at":"2026-02-10T21:16:53.689Z","repository":{"id":309810289,"uuid":"560193095","full_name":"uaraven/csql","owner":"uaraven","description":"Comma-separated sql. Console app allowing to run SQL queries on CSV-files","archived":false,"fork":false,"pushed_at":"2025-08-13T22:18:38.000Z","size":5711,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-14T00:15:36.335Z","etag":null,"topics":["csv","sql"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/uaraven.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","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}},"created_at":"2022-10-31T23:52:49.000Z","updated_at":"2025-08-13T22:18:40.000Z","dependencies_parsed_at":"2025-08-14T00:15:58.253Z","dependency_job_id":"0e0143f1-b047-4fe3-b270-10cd167f325e","html_url":"https://github.com/uaraven/csql","commit_stats":null,"previous_names":["uaraven/csql"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/uaraven/csql","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uaraven%2Fcsql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uaraven%2Fcsql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uaraven%2Fcsql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uaraven%2Fcsql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uaraven","download_url":"https://codeload.github.com/uaraven/csql/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uaraven%2Fcsql/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29317080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T20:44:44.282Z","status":"ssl_error","status_checked_at":"2026-02-10T20:44:43.393Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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","sql"],"created_at":"2026-02-10T21:16:52.892Z","updated_at":"2026-02-10T21:16:53.678Z","avatar_url":"https://github.com/uaraven.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# csql - Query language for comma-separated values\n\ncsql is a small tool allowing to run SQL queries on CSV files. \n\ncsql is not particularly fast or flexible, it exists solely because at one moment I though \"wouldn't it be nice to run sql queries on csv files\". Of course there's probably a ton of existing ways to do it, but reinventing the wheel is one of my favourite pastimes, so here we go.\n\ncsql supports basic\u003csup\u003e*\u003c/sup\u003e `SELECT` statement features, including:\n\n- Joins\n  - Left, Right, Full, Cross and Inner\n- UNION and UNION ALL\n- LIKE conditions\n- MATCH conditions (like LIKE, but using regular expressions)\n- BETWEEN conditions\n- IN (...list...) conditions\n- Logical operators `AND`, `OR` and `NOT`\n- Aggregate functions and HAVING expression\n- LIMIT and ORDER BY\n- Table and column aliases (`SELECT t.column as col FROM \"Table.csv\" T`)\n- SELECT ... INTO\n\ncsql automatically converts values to integer and float types and nulls. \n\nSee [this document](docs/syntax.md) for detailed description of Csql syntax.\n\n---\n\u003csup\u003e*\u003c/sup\u003e IN (select) is not supported yet in version 0.2.x\n\n\n## Usage\n\nFor interactive mode run `csql` command and the CSQL shell will start.\n\nYou can type SELECT queries or commands. Queries must start with word `select` and terminate with a semicolon (`;`).\n\nSupported commands are:\n   - help - display help message\n   - clear - clear screen\n   - exit - exit csql shell\n   - ls - list files in the current directory\n   - pwd - show current directory\n   - cd - change directory\n   - csv - set CSV parsing options\n   - inspect - inspect a CSV file - print out column names and data types of the first row\n                    \nCSQL can also execute queries passed from the command line\n\n    $ csql -c \"SELECT * FROM file.csv WHERE column = 'value'\" -o result.csv\n\n## Building\n\ncsql is a simple Go project, so it can be built as any other Go application\n\n    $ go test ./...\n    $ go build\n\nOr use `build.sh` script to build for all supported platforms. Results will be placed in the `/bin` folder. \n\n### Changing grammar\n\ncsql uses ANTLR4 parser generator. ANTLR is a Java application and so you will need Java if you changed the grammar.\nRun `antlr/generate.sh` from the project root to build parser from the `Csql.g4` grammar file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuaraven%2Fcsql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuaraven%2Fcsql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuaraven%2Fcsql/lists"}