{"id":50897844,"url":"https://github.com/tangtony/webcsv","last_synced_at":"2026-07-22T07:01:15.157Z","repository":{"id":64304901,"uuid":"162929125","full_name":"tangtony/webcsv","owner":"tangtony","description":"Serve your CSV file as a queryable database over HTTP","archived":false,"fork":false,"pushed_at":"2024-12-12T20:04:05.000Z","size":25,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-12T21:18:43.150Z","etag":null,"topics":["csv","go","http","json","query","rest","sqlite"],"latest_commit_sha":null,"homepage":null,"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/tangtony.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}},"created_at":"2018-12-23T22:46:51.000Z","updated_at":"2024-12-12T20:04:03.000Z","dependencies_parsed_at":"2023-01-15T10:15:15.698Z","dependency_job_id":null,"html_url":"https://github.com/tangtony/webcsv","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/tangtony/webcsv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangtony%2Fwebcsv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangtony%2Fwebcsv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangtony%2Fwebcsv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangtony%2Fwebcsv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tangtony","download_url":"https://codeload.github.com/tangtony/webcsv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangtony%2Fwebcsv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35751644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-22T02:00:06.236Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","go","http","json","query","rest","sqlite"],"created_at":"2026-06-16T01:31:30.082Z","updated_at":"2026-07-22T07:01:15.149Z","avatar_url":"https://github.com/tangtony.png","language":"Go","funding_links":[],"categories":["go"],"sub_categories":[],"readme":"# webcsv\n\nwebcsv is an application that automatically converts your CSV file into a SQLite database and provides an HTTP interface that allows you to run basic queries against the SQLite database and returns results in JSON format.\n\nwebcsv was designed to allow quick and easy integration of CSV datasets into your web stack.\n\n## Installation\n\nDownload the latest binary from the [Releases](https://github.com/tangtony/webcsv/releases) page or pull the latest Docker image from [Docker Hub](https://cloud.docker.com/repository/docker/tangtony/webcsv).\n\n## Usage\n```\nUsage: webcsv [options]\n```\n\nRun `webcsv` with the following options to provide information about your CSV. Options can be provided via environment variables or command-line. If both are provided, the command-line value takes precedence.\n\n### Options\n```\n  --delimiter       The data separator used in the CSV file (default: ',') [$DELIMITER]\n  --field-count     The number of fields/columns in the CSV file [$FIELD_COUNT]\n  --file            The path to the CSV file [$FILE]\n  --has-header      Whether the csv file has a header (default: true) [$HAS_HEADER]\n  --header          A custom header to use for the data [$HEADER]\n  --indicies        Headers to create indicies for [$INDICIES]\n  --parse-numbers   Whether or not to parse JSON strings into numbers [$PARSE_NUMBERS]\n```\n\nNOTE: When using an escaped delimiter such as a tab, it must be specified as follows:\n`--delimiter=$'\\t'`\n\n### Querying\n```\nhttp://localhost:8080?field=value\n```\n\nBy default, `webcsv` starts a web server at port 8080 and querying for data is done at the root via query parameters where the key is the field/column that you want to match on and the value is the row value.\n\n### Example\n\nBelow is an simple usage example of `webcsv`. \n\nAssume we want to serve [example.csv](example.csv):\n```\nfirstName,lastName,email,phoneNumber\nJohn,Doe,john@doe.com,0123456789\nJane,Doe,jane@doe.com,9876543210\n```\n\nThe application can then be started with the following command:\n```\n./webcsv --file=example.csv\n```\n\nOnce the application has been started, we can query for data as follows:\n```\nGET http://localhost:8080/?firstname=John\n[\n    {\n        \"firstname\": \"John\",\n        \"lastname\": \"Doe\"\n    }\n]\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n\n## Contributing\n\n1. Fork it (\u003chttps://github.com/tangtony/webcsv/fork\u003e)\n2. Create your feature branch (`git checkout -b feature/my-awesome-feature`)\n3. Commit your changes (`git commit -am 'Add awesome feature'`)\n4. Push to the branch (`git push origin feature/my-awesome-feature`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangtony%2Fwebcsv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftangtony%2Fwebcsv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangtony%2Fwebcsv/lists"}