{"id":26607267,"url":"https://github.com/addok/addok-csv","last_synced_at":"2025-07-12T23:34:22.296Z","repository":{"id":62559770,"uuid":"49506701","full_name":"addok/addok-csv","owner":"addok","description":"Addok plugin for handling CSV files","archived":false,"fork":false,"pushed_at":"2022-10-22T11:14:27.000Z","size":35,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-09T20:52:02.968Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"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/addok.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":"2016-01-12T14:50:57.000Z","updated_at":"2024-11-07T16:58:02.000Z","dependencies_parsed_at":"2022-11-03T12:45:25.274Z","dependency_job_id":null,"html_url":"https://github.com/addok/addok-csv","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/addok/addok-csv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addok%2Faddok-csv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addok%2Faddok-csv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addok%2Faddok-csv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addok%2Faddok-csv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/addok","download_url":"https://codeload.github.com/addok/addok-csv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/addok%2Faddok-csv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265068574,"owners_count":23706486,"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":[],"created_at":"2025-03-23T22:40:33.321Z","updated_at":"2025-07-12T23:34:22.280Z","avatar_url":"https://github.com/addok.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Addok plugin add CSV geocoding endpoints\n\n## Install\n\n    pip install addok-csv\n\n## API\n\n**Warning: this plugin will not work when running `addok serve`, you need either\ngunicorn or uWSGI (see [falcon-multipart issue](https://github.com/yohanboniface/falcon-multipart/issues/1)).**\n\nThis plugin adds the following endpoints:\n\n\n### /search/csv/\n\nBatch geocode a csv file.\n\n#### Parameters\n\n- **data**: the CSV file to be processed\n- **columns** (multiple): the columns, ordered, to be used for geocoding; if no\n  column is given, all columns will be used\n- **encoding** (optional): encoding of the file (you can also specify a `charset` in the\n  file mimetype), such as 'utf-8' or 'iso-8859-1' (default to 'utf-8-sig')\n- **delimiter** (optional): CSV delimiter (`,` or `;`); if not given, we try to\n  guess\n- **with_bom**: if true, and if the encoding if utf-8, the returned CSV will contain\n  a BOM (for Excel users…)\n- `lat` and `lon` parameters (optionals), like filters, can be used to\n  define columns names that contain latitude and longitude\n  values, for adding a preference center in the geocoding of each row\n\n#### Examples\n\n    http -f POST http://localhost:7878/search/csv/ columns='voie' columns='ville' data@path/to/file.csv\n    http -f POST http://localhost:7878/search/csv/ columns='rue' postcode='code postal' data@path/to/file.csv\n\n### /reverse/csv/\n\nBatch reverse geocode a csv file.\n\n#### Parameters\n\n- **data**: the CSV file to be processed; must contain columns `latitude` (or `lat`) and\n  `longitude` (or `lon` or `lng`)\n- **encoding** (optional): encoding of the file (you can also specify a `charset` in the\n  file mimetype), such as 'utf-8' or 'iso-8859-1' (default to 'utf-8-sig')\n- **delimiter** (optional): CSV delimiter (`,` or `;`); if not given, we try to\n  guess\n\n\nAny filter can be passed as `key=value` querystring, where `key` is the filter\nname and `value` is the column name containing the filter value for each row.\nFor example, if there is a column \"code_insee\" and we want to use it for\n\"citycode\" filtering, we would pass `citycode=code_insee` as query string\nparameter.\n\n## Config\n\n- CSV_ENCODING: default encoding to open CSV files (default: 'utf-8-sig')\n- CSV_EXTRA_FIELDS: list of field names to be added to the results rows\n  (default: names of the registered `FIELDS`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddok%2Faddok-csv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faddok%2Faddok-csv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddok%2Faddok-csv/lists"}