{"id":13752433,"url":"https://github.com/csvspecs/csv-numerics","last_synced_at":"2025-05-09T19:32:08.446Z","repository":{"id":75995153,"uuid":"153617547","full_name":"csvspecs/csv-numerics","owner":"csvspecs","description":"CSV ❤ Numerics Format - Comma-Separated Values (CSV)  Line-by-Line Records with Auto-Converted Numerics (Float Numbers) Encoding Rules - A Modern (Simple) Tabular Data Format incl. Numbers, Comments and More","archived":false,"fork":false,"pushed_at":"2018-10-23T08:48:22.000Z","size":22,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-16T05:31:58.527Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/csvspecs.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-10-18T12:07:28.000Z","updated_at":"2018-10-23T08:48:24.000Z","dependencies_parsed_at":"2024-01-17T15:02:46.728Z","dependency_job_id":"64777a8e-29a9-48cb-8e97-bf6b9d0c313a","html_url":"https://github.com/csvspecs/csv-numerics","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csvspecs%2Fcsv-numerics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csvspecs%2Fcsv-numerics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csvspecs%2Fcsv-numerics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csvspecs%2Fcsv-numerics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/csvspecs","download_url":"https://codeload.github.com/csvspecs/csv-numerics/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253312314,"owners_count":21888618,"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":"2024-08-03T09:01:05.768Z","updated_at":"2025-05-09T19:32:08.124Z","avatar_url":"https://github.com/csvspecs.png","language":null,"readme":"# CSV \u003c3 Numerics Format\n\n_CSV (Line-by-Line) Records with Auto-Converted Numerics (Float Numbers) Encoding Rules - A Modern (Simple) Tabular Data Format incl. Numbers, Comments and More_\n\n\n\n## \"Classic\" Comma-Separated Values (CSV) - Strings, String, Strings. Always. Period.\n\nLet's read:\n\n```\n1,2,3\n\"4\",\"5\",\"6\"\n```\n\nWhat do you expect? In the \"classic\" vanilla format\nthe comma-separated values once read in / parsed\nalways are a list of string values. Period.\n\n``` yaml\n[[\"1\", \"2\", \"3\"],\n [\"4\", \"5\", \"6\"]]\n```\n\n\n## What about Numbers (and Strings Together)? - How? Possible?\n\nGuess, what? There's a popular comma-separated values (CSV)\nconvention / variant / dialect\nthat now has an official specification:\n\nRule 1: Use \"un-quoted\" values for float numbers e.g. `1,2,3` or `1.0, 2.0, 3.0` etc.\n\nRule 2: Use quoted values for \"non-numeric\" strings e.g. `\"4\", \"5\", \"6\"` or `\"Hello, World!\"` etc.\n\n\nExample:\n\n```\n1,2,3\n\"4\",\"5\",\"6\"\n```\n\nreturns / maps to\n\n``` yaml\n[[1.0, 2.0, 3.0],\n [\"4\", \"5\", \"6\"]]\n```\n\nand now has an official name. Let's call it:\n\nCSV \u003c3 Numerics \n\n\n\n\n\n## What about Not A Number (NaN)?\n\nA CSV \u003c3 Numerics reader / parser lets you configure a list of values\nthat get auto-converted to `NaN`, that is, Not A Number.\nExample:\n\n```\n1,2,NAN,#NAN\n```\n\nwith the nan option ` ['NAN', '#NAN']`\nreturns / maps to:\n\n``` yaml\n[[1.0, 2.0, NaN, NaN]]\n```\n\nNote: The Not a Number (NaN) values are \"un-quoted\" values (like numbers)\nin the comma-separated values (CSV) format.\n\n\n\n## What about Comments and Blank Lines and Leading and Trailings (White)spaces?\n\nYes, in CSV \u003c3 Numberics you can use comments (starting with `#`) and blank lines\nand leading and trailing (white)spaces - they all will get skipped and trimmed automatically.\nExample:\n\n``` \n# CSV \u003c3 Numerics\n\n 1  ,   2   ,   3\n\"4\" ,  \"5\"  ,  \"6\"\n```\n\nreturns / maps to\n\n``` yaml\n[[1.0, 2.0, 3.0],\n [\"4\", \"5\", \"6\"]]\n```\n\n\nNote: (White)spaces inside quotes will NOT get trimmed:\n\n```\n  \" 4 \" ,  \" 5 \"   ,\" 6 \"\n```\n\nreturns / maps to\n\n``` yaml\n[[\" 4 \", \" 5 \", \" 6 \"]]\n```\n\n\n\n## What about More Types? Nulls, Booleans, Dates, Times, Arrays, Structs, and so on?\n\nSee alternative CSV formats that include specified encoding rules for more types:\n\n### JSON\n\n- CSV \u003c3 JSON Format, see \u003chttps://github.com/csvspecs/csv-json\u003e\n  - includes Nulls, Booleans, Arrays, Structs, and more\n  - does NOT include Dates\n\n### YAML\n\n- CSV \u003c3 YAML Format, see \u003chttps://github.com/csvspecs/csv-yaml\u003e\n  - includes Nulls, Booleans, Dates, Arrays, Structs, and more\n\n\n\n\n\n## Frequently Asked Questions (FAQ) and Answers\n\n### Q: What's the recommended file type extension for CSV \u003c3 Numerics files?\n\nThe recommended file format for CSV \u003c3 Numerics files is `.csv` :-) or use `.num.csv` (to highlight \nthe fact of the numerics encoding rules).\n\n\n\n\n\n## License\n\nThe CSV \u003c3 Numerics format is dedicated to the public domain.\n\n\n\n## Request for Comments (RFC)\n\nPlease post your comments to the [wwwmake forum](http://groups.google.com/group/wwwmake).\nThanks!\n\n","funding_links":[],"categories":["CSV \u003c3 Numerics"],"sub_categories":["Can I use \\_\\_? (RFC 4180 \"Strict\")"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsvspecs%2Fcsv-numerics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcsvspecs%2Fcsv-numerics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsvspecs%2Fcsv-numerics/lists"}