Add source code

.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+
+[*.cs]
+indent_size = 4
+insert_final_newline = true
+trim_trailing_whitespace = true

.gitattributes

@@ -0,0 +1,4 @@
+* text=auto
+
+*.cs text diff=csharp
+*.sln text eol=crlf

.github/CONTRIBUTING.md

@@ -0,0 +1,17 @@
+## Addax - Contributing
+
+<p />
+
+The main contributing rules are:
+
+<p />
+
+- **DO** follow the Microsoft .NET design guidelines[^1]
+- **DO** follow the Microsoft .NET documentation [guidelines](https://github.com/dotnet/dotnet-api-docs/wiki)
+- **DO** give priority to the existing design and style if they differ from the general guidelines
+
+<p />
+
+The [Contribution License Agreement](https://gist.github.com/alexanderkozlenko/c74ea0910f2a088230478cf7db442a4e) (CLA) must be signed before a pull request is merged, which is handled by a CLA bot.
+
+[^1]: "Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries", 3rd Edition, Addison-Wesley Microsoft Technology Series, ISBN-13 978-0135896464

.github/README.md

@@ -0,0 +1,22 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/alexanderkozlenko/addax/main/doc/images/app-128.png" alt="Addax Logo" />
+</p>
+
+## Addax
+
+A high-performance and low-allocating framework to work with tabular data represented as delimiter-separated values. The implementation is based on W3C recommendation "Model for Tabular Data and Metadata on the Web".
+
+|ID|Stable|Preview|
+|:-|:-|:-|
+|Addax.Formats.Tabular|[![NuGet](https://img.shields.io/nuget/v/Addax.Formats.Tabular?style=flat-square)](https://nuget.org/packages/Addax.Formats.Tabular)|[![NuGet](https://img.shields.io/nuget/vpre/Addax.Formats.Tabular?style=flat-square)](https://nuget.org/packages/Addax.Formats.Tabular)|
+
+### Features
+
+- Supports data formatted with various tabular dialects and character encodings.
+- Compatible with applications that have native ahead-of-time (AOT) deployment model.
+- Provides intuitive and extensible API, available in synchronous and asynchronous variants.
+
+### Quick Links
+
+- [Addax - API documentation and examples](https://alexanderkozlenko.github.io/addax)
+- [W3C - Model for Tabular Data and Metadata on the Web](https://w3.org/TR/2015/REC-tabular-data-model-20151217)

.github/cla-signatures.json

@@ -0,0 +1,4 @@
+{
+  "signedContributors": [
+  ]
+}

.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+  - package-ecosystem: "nuget"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"]
+    groups:
+       microsoft:
+          patterns:
+            - "Microsoft.*"
+            - "MSTest.*"

.github/workflows/cla-assistant.yml

@@ -0,0 +1,25 @@
+name: "CLA Assistant"
+on:
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [opened,closed,synchronize]
+permissions:
+  actions: write
+  contents: write
+  pull-requests: write
+  statuses: write
+jobs:
+  CLAAssistant:
+    runs-on: ubuntu-latest
+    steps:
+      - name: "CLA Assistant"
+        if: (github.event.comment.body == 'recheck' || github.event.comment.body == 'I hereby agree with the Contributor License Agreement') || github.event_name == 'pull_request_target'
+        uses: contributor-assistant/[email protected]
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          path-to-signatures: '.github/cla-signatures.json'
+          path-to-document: 'https://gist.github.com/alexanderkozlenko/c74ea0910f2a088230478cf7db442a4e'
+          branch: 'main'
+          allowlist: dependabot[bot]

.github/workflows/codeql.yml

@@ -0,0 +1,27 @@
+name: "CodeQL"
+on:
+  push:
+    branches: [ main ]
+    paths-ignore:
+      - .github
+      - doc
+  pull_request:
+    branches: [ main ]
+  schedule:
+    - cron: '0 0 * * 6'
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+    strategy:
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v3
+    - uses: github/codeql-action/init@v2
+      with:
+        languages: csharp
+    - uses: github/codeql-action/autobuild@v2
+    - uses: github/codeql-action/analyze@v2

.gitignore

@@ -0,0 +1,6 @@
+syntax: glob
+
+.vs/
+.vscode/
+artifacts/
+*.user

Addax.Formats.Tabular.sln

@@ -0,0 +1,61 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.8.34302.71
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{A699582F-219D-47CC-A0A7-E1F7FFCB32E5}"
+	ProjectSection(SolutionItems) = preProject
+		src\.globalconfig = src\.globalconfig
+		src\Directory.Build.props = src\Directory.Build.props
+		src\Directory.Build.targets = src\Directory.Build.targets
+		src\Directory.Compile.props = src\Directory.Compile.props
+		src\Directory.Metadata.props = src\Directory.Metadata.props
+		src\Directory.Packages.props = src\Directory.Packages.props
+		src\Directory.Packaging.props = src\Directory.Packaging.props
+		src\Directory.Packaging.targets = src\Directory.Packaging.targets
+	EndProjectSection
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Addax.Formats.Tabular", "src\Addax.Formats.Tabular\Addax.Formats.Tabular.csproj", "{0E00C13E-13C2-4F58-AD0E-BFAC6A6FDD4B}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Addax.Formats.Tabular.Analyzers.CSharp", "src\Addax.Formats.Tabular.Analyzers.CSharp\Addax.Formats.Tabular.Analyzers.CSharp.csproj", "{65C5A997-C1EE-40EF-930F-D4DACF0AE2C3}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Addax.Formats.Tabular.UnitTests", "src\Addax.Formats.Tabular.UnitTests\Addax.Formats.Tabular.UnitTests.csproj", "{6F3D658E-DF6F-429E-84F4-8A71CA016624}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Addax.Formats.Tabular.Analyzers.CSharp.UnitTests", "src\Addax.Formats.Tabular.Analyzers.CSharp.UnitTests\Addax.Formats.Tabular.Analyzers.CSharp.UnitTests.csproj", "{ABCEAD3B-6CF5-4464-B023-5FD1A9247E42}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Addax.Formats.Tabular.Benchmarks", "src\Addax.Formats.Tabular.Benchmarks\Addax.Formats.Tabular.Benchmarks.csproj", "{4E6A2EB6-8EF9-4288-A1F5-1E35A327E638}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{0E00C13E-13C2-4F58-AD0E-BFAC6A6FDD4B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0E00C13E-13C2-4F58-AD0E-BFAC6A6FDD4B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0E00C13E-13C2-4F58-AD0E-BFAC6A6FDD4B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0E00C13E-13C2-4F58-AD0E-BFAC6A6FDD4B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{65C5A997-C1EE-40EF-930F-D4DACF0AE2C3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{65C5A997-C1EE-40EF-930F-D4DACF0AE2C3}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{65C5A997-C1EE-40EF-930F-D4DACF0AE2C3}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{65C5A997-C1EE-40EF-930F-D4DACF0AE2C3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6F3D658E-DF6F-429E-84F4-8A71CA016624}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6F3D658E-DF6F-429E-84F4-8A71CA016624}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6F3D658E-DF6F-429E-84F4-8A71CA016624}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6F3D658E-DF6F-429E-84F4-8A71CA016624}.Release|Any CPU.Build.0 = Release|Any CPU
+		{ABCEAD3B-6CF5-4464-B023-5FD1A9247E42}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{ABCEAD3B-6CF5-4464-B023-5FD1A9247E42}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{ABCEAD3B-6CF5-4464-B023-5FD1A9247E42}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{ABCEAD3B-6CF5-4464-B023-5FD1A9247E42}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4E6A2EB6-8EF9-4288-A1F5-1E35A327E638}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4E6A2EB6-8EF9-4288-A1F5-1E35A327E638}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4E6A2EB6-8EF9-4288-A1F5-1E35A327E638}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4E6A2EB6-8EF9-4288-A1F5-1E35A327E638}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {C8E40AA6-DDC7-4652-B1FB-EC13694DC46D}
+	EndGlobalSection
+EndGlobal

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Oleksandr Kozlenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

azure-pipelines.yml

@@ -0,0 +1,28 @@
+steps:
+- task: UseDotNet@2
+  inputs:
+    useGlobalJson: true
+- script: >
+    dotnet build $(Build.SourcesDirectory)
+    -p:ContinuousIntegrationBuild=true
+    -c Release
+- script: >
+    dotnet pack $(Build.SourcesDirectory)
+    -p:ContinuousIntegrationBuild=true
+    -c Release
+    -o $(Build.ArtifactStagingDirectory)
+    --no-build
+- script: >
+    dotnet test $(Build.SourcesDirectory)
+    -p:ContinuousIntegrationBuild=true
+    -c Release
+    -l TRX
+    --results-directory $(Common.TestResultsDirectory)
+    --no-build
+- task: PublishTestResults@2
+  inputs:
+    failTaskOnFailedTests: true
+    searchFolder: '$(Common.TestResultsDirectory)'
+    testResultsFiles: '*.trx'
+    testRunner: 'VSTest'
+- publish: '$(Build.ArtifactStagingDirectory)'

doc/api-filter.yml

@@ -0,0 +1,16 @@
+apiRules:
+- exclude:
+    uidRegex: ^System\.Attribute
+    type: member
+- exclude:
+    uidRegex: ^System\.Exception
+    type: member
+- exclude:
+    uidRegex: ^System\.Object
+    type: member
+- exclude:
+    uidRegex: ^System\.ValueType
+    type: member
+- exclude:
+    uidRegex: ^System\.Runtime\.Serialization\.ISerializable
+    type: type

doc/docfx.json

@@ -0,0 +1,52 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../",
+          "files": [
+            "/bin/Addax.Formats.Tabular/Release/*.dll"
+          ]
+        }
+      ],
+      "dest": "api",
+      "filter": "api-filter.yml",
+      "namespaceLayout": "nested"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "topics/**/*.md",
+          "topics/**/*.yml"
+        ]
+      },
+      {
+        "files": [
+          "api/**.yml"
+        ]
+      },
+      {
+        "files": [
+          "index.md",
+          "toc.yml"
+        ]
+      }
+    ],
+    "globalMetadata": {
+      "_appName": "Addax",
+      "_appLogoPath": "images/app-32.png",
+      "_appFaviconPath": "images/app-32.png",
+      "_appFooter": "© Oleksandr Kozlenko",
+      "_enableSearch": true,
+      "_disableContribution": true
+    },
+    "output": ".",
+    "template": [
+      "default",
+      "modern",
+      "template"
+    ]
+  }
+}