{"id":21315400,"url":"https://github.com/j0nimost/kafa","last_synced_at":"2026-05-20T03:33:46.525Z","repository":{"id":197926424,"uuid":"699667473","full_name":"j0nimost/Kafa","owner":"j0nimost","description":"A fast easy to use csv,tsv file parser","archived":false,"fork":false,"pushed_at":"2023-11-21T04:45:36.000Z","size":171,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-15T08:34:26.748Z","etag":null,"topics":["csv","dotnet","rfc-4180","tsv"],"latest_commit_sha":null,"homepage":"","language":"C#","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/j0nimost.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}},"created_at":"2023-10-03T05:11:10.000Z","updated_at":"2024-04-03T08:58:49.000Z","dependencies_parsed_at":"2023-10-03T16:25:20.622Z","dependency_job_id":"f99e32f0-74c9-4359-8f9c-cb1791b148a0","html_url":"https://github.com/j0nimost/Kafa","commit_stats":null,"previous_names":["j0nimost/kafa"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0nimost%2FKafa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0nimost%2FKafa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0nimost%2FKafa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0nimost%2FKafa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j0nimost","download_url":"https://codeload.github.com/j0nimost/Kafa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243791601,"owners_count":20348480,"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":["csv","dotnet","rfc-4180","tsv"],"created_at":"2024-11-21T18:19:50.628Z","updated_at":"2026-05-20T03:33:41.480Z","avatar_url":"https://github.com/j0nimost.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kafa\nA fast easy to use csv,tsv file parser. It has a low memory footprint with alot of optimizations to be done.\n\nKafa is also RFC-4180 Compliant [docs](https://www.rfc-editor.org/rfc/rfc4180)\n\n![Build Status](https://github.com/j0nimost/Kafa/actions/workflows/dotnet.yml/badge.svg)\n\n🚧 UNDER ACTIVE DEVELOPMENT 🚧\n### How To Read\nThere are two options;\n- `RowEnumerable`\n- `IEnumerable\u003cT\u003e`\n\n#### `RowEnumerable`\nFor fast performance with minimal over head the RowEnumerable allows you to iterate over the CSV rows yourself.\nExample:\n```c#\n       var stream = new MemoryStream(Encoding.UTF8.GetBytes(sampleCSV));\n\n       using var rows = Kafa.Read(stream);\n       int rowCount =0, colCount = 0;\n       foreach (var row in rows)\n       {\n           foreach (var col in row.Cols)\n           {\n               Debug.WriteLine(col.ToString());\n               colCount++;\n           }\n           rowCount++;\n       }\n```\n\nThis offers you the granular control over each element. The API offers a list of extension Methods for the `Col` struct which allows\nyou to Parse to any given type; `ParseInt()`, `ParseLong()`, `ParseFloat()`, `ParseDateTime()` etc.\n\nExample:\n```c#\n       var stream = new MemoryStream(Encoding.UTF8.GetBytes(sampleCSV));\n\n       using var rows = Kafa.Read(stream);\n       int sum =0;\n       foreach (var row in rows)\n       {\n            foreach (var col in row.Cols)\n            {\n                sum += col.ParseInt();\n            }\n       }\n```\n\nTo also make it easier you can jump to a specific Row and Col\n\nExample:\n```c#\n        var stream = new MemoryStream(Encoding.UTF8.GetBytes(sampleCSV));\n\n        using var rows = Kafa.Read(stream);\n\n        var result = rows[0].Cols[0].ToString();\n            // or\n        var result2 = rows[new Index(0)].Cols[new Index(0)].ToString();\n            // or\n        var result3 = row[0].Cols[\"date\"].ToString(); // read Column by Name\n```\n#### `IEnumerable\u003cT\u003e`\nUnderstanding that many users want a simple easy to use experience the library allows\nyou to parse directly into a type.\n\nExample:\n```c#\n       var stream = new MemoryStream(Encoding.UTF8.GetBytes(data));\n       var result = await Kafa.ReadAsync\u003cCsvData\u003e(stream);\n```\nTo make it easier to parse a file Kafa offers an Attribute Type that can match a column name or the column index.\n\nExample: \n```c#\n       class CSVDataWithAttributes\n       {\n           [KafaColumn(\"date\")]\n           public DateTime Date { get; set; }\n           [KafaColumn(1)]\n           public double Open { get; set; }\n           [KafaColumn(2)]\n           public double High { get; set; }\n           [KafaColumn(3)]\n           public double Low { get; set; }\n           [KafaColumn(4)]\n           public double Close { get; set; }\n           [KafaColumn(5)]\n           public int Volume { get; set; }\n           [KafaColumn(\"name\")]\n           public string Name { get; set; }\n       }\n```\n### How To Write\nYou can Write to;\n- `IBufferWriter\u003cbyte\u003e`\n- `ReadOnlySpan\u003cbyte\u003e`\n- `Stream`\n- `File`\n\n\nBehind the curtains Kafa is using `KafaPooledWriter` a pooled IBufferWriter to write to, unless explicitly provided a custom one using \n`Write\u003cT\u003e(IBufferWriter\u003cbyte\u003e bufferWriter, List\u003cT\u003e entities, KafaOptions options = null)` Method.\n\n```c#\n            var csvs = new List\u003cCsvData\u003e()\n            {\n                new CsvData{ Date = DateTime.Parse(\"10/10/2023 4:08:38 PM\"), Open=12.45, Close=12.99, High=13.00, Low=12.1, Name=\"AMZN\", Volume=1233435512},\n                new CsvData{ Date = DateTime.Parse(\"10/10/2023 4:08:38 PM\"), Open=12.45, Close=12.99, High=13.00, Low=12.1, Name=\"AMZN\", Volume=1233435512}\n            };    \n            // get a ReadOnlySpan\u003cbytes\u003e\n            var spanOfbytes = await Kafa.Write\u003cCsvData\u003e(csvs);\n            string result = Encoding.UTF8.GetString(spanOfbytes);    \n\n            // or \n            // write to an Stream    \n            using var stream = await Kafa.WriteToStreamAsync\u003cCsvData\u003e(csvs);  \n\n            // or \n            // Write to a IBufferWriter\u003cbyte\u003e for zero allocation writes    \n            var arrayWriter = new ArrayBufferWriter\u003cbyte\u003e();\n            Kafa.Write\u003cCsvData\u003e(arrayWriter, csvs);\n            var str = Encoding.UTF8.GetString(arrayWriter.WrittenSpan);    \n            \n            // or\n            // write directly to a file    \n            await Kafa.WriteToFileAsync\u003cCsvData\u003e(csvs,@\"C:\\Users\\ADMIN\\Documents\");\n\n```\nBoth writing and reading support Attributes\n### Support\nOnly .Net Core 7 and \u003e\n### Author\nJohn Nyingi\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0nimost%2Fkafa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj0nimost%2Fkafa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0nimost%2Fkafa/lists"}