Updating Surge Fork of CsvHelper

.editorconfig

@@ -8,3 +8,118 @@ indent_style = tab
 end_of_line = crlf
 trim_trailing_whitespace = true
 insert_final_newline = true
+csharp_indent_labels = one_less_than_current
+csharp_space_around_binary_operators = before_and_after
+csharp_using_directive_placement = outside_namespace:silent
+csharp_prefer_simple_using_statement = true:suggestion
+csharp_prefer_braces = true:silent
+csharp_style_namespace_declarations = file_scoped:warning
+csharp_style_expression_bodied_methods = false:silent
+csharp_style_expression_bodied_constructors = false:silent
+csharp_style_expression_bodied_operators = false:silent
+csharp_style_expression_bodied_properties = true:silent
+csharp_style_expression_bodied_indexers = true:silent
+csharp_style_expression_bodied_accessors = true:silent
+csharp_style_expression_bodied_lambdas = true:silent
+csharp_style_expression_bodied_local_functions = false:silent
+csharp_style_throw_expression = true:suggestion
+csharp_style_prefer_null_check_over_type_check = true:suggestion
+csharp_prefer_simple_default_expression = true:suggestion
+csharp_style_prefer_local_over_anonymous_function = true:suggestion
+csharp_style_prefer_index_operator = true:suggestion
+csharp_style_prefer_range_operator = true:suggestion
+csharp_style_implicit_object_creation_when_type_is_apparent = true:suggestion
+csharp_style_prefer_tuple_swap = true:suggestion
+csharp_style_inlined_variable_declaration = true:suggestion
+csharp_style_deconstructed_variable_declaration = true:suggestion
+csharp_style_unused_value_assignment_preference = discard_variable:suggestion
+csharp_style_unused_value_expression_statement_preference = discard_variable:silent
+csharp_style_var_for_built_in_types = true:silent
+csharp_style_var_when_type_is_apparent = true:silent
+csharp_style_var_elsewhere = true:silent
+csharp_style_prefer_method_group_conversion = true:silent
+csharp_style_prefer_top_level_statements = true:silent
+csharp_style_prefer_utf8_string_literals = true:suggestion
+csharp_prefer_static_local_function = true:suggestion
+csharp_style_allow_embedded_statements_on_same_line_experimental = true:suggestion
+csharp_style_allow_blank_lines_between_consecutive_braces_experimental = true:silent
+csharp_style_allow_blank_line_after_colon_in_constructor_initializer_experimental = true:suggestion
+csharp_style_prefer_primary_constructors = true:suggestion
+
+[*.yml]
+indent_style = space
+indent_size = 2
+
+[*.{cs,vb}]
+dotnet_style_operator_placement_when_wrapping = beginning_of_line
+tab_width = 4
+indent_size = 4
+end_of_line = crlf
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
+dotnet_style_prefer_auto_properties = true:silent
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_prefer_simplified_boolean_expressions = true:suggestion
+dotnet_style_prefer_conditional_expression_over_assignment = true:silent
+dotnet_style_prefer_conditional_expression_over_return = true:silent
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
+dotnet_style_prefer_compound_assignment = true:suggestion
+dotnet_style_prefer_simplified_interpolation = true:suggestion
+dotnet_style_namespace_match_folder = true:suggestion
+dotnet_style_readonly_field = true:suggestion
+[*.{cs,vb}]
+#### Naming styles ####
+
+# Naming rules
+
+dotnet_naming_rule.interface_should_be_begins_with_i.severity = suggestion
+dotnet_naming_rule.interface_should_be_begins_with_i.symbols = interface
+dotnet_naming_rule.interface_should_be_begins_with_i.style = begins_with_i
+
+dotnet_naming_rule.types_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.types_should_be_pascal_case.symbols = types
+dotnet_naming_rule.types_should_be_pascal_case.style = pascal_case
+
+dotnet_naming_rule.non_field_members_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.non_field_members_should_be_pascal_case.symbols = non_field_members
+dotnet_naming_rule.non_field_members_should_be_pascal_case.style = pascal_case
+
+# Symbol specifications
+
+dotnet_naming_symbols.interface.applicable_kinds = interface
+dotnet_naming_symbols.interface.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+dotnet_naming_symbols.interface.required_modifiers = 
+
+dotnet_naming_symbols.types.applicable_kinds = class, struct, interface, enum
+dotnet_naming_symbols.types.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+dotnet_naming_symbols.types.required_modifiers = 
+
+dotnet_naming_symbols.non_field_members.applicable_kinds = property, event, method
+dotnet_naming_symbols.non_field_members.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+dotnet_naming_symbols.non_field_members.required_modifiers = 
+
+# Naming styles
+
+dotnet_naming_style.begins_with_i.required_prefix = I
+dotnet_naming_style.begins_with_i.required_suffix = 
+dotnet_naming_style.begins_with_i.word_separator = 
+dotnet_naming_style.begins_with_i.capitalization = pascal_case
+
+dotnet_naming_style.pascal_case.required_prefix = 
+dotnet_naming_style.pascal_case.required_suffix = 
+dotnet_naming_style.pascal_case.word_separator = 
+dotnet_naming_style.pascal_case.capitalization = pascal_case
+
+dotnet_naming_style.pascal_case.required_prefix = 
+dotnet_naming_style.pascal_case.required_suffix = 
+dotnet_naming_style.pascal_case.word_separator = 
+dotnet_naming_style.pascal_case.capitalization = pascal_case
+dotnet_style_predefined_type_for_locals_parameters_members = true:silent
+dotnet_style_predefined_type_for_member_access = true:silent
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:silent
+dotnet_style_allow_multiple_blank_lines_experimental = true:suggestion
+dotnet_style_allow_statement_immediately_after_block_experimental = true:suggestion

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [JoshClose]
+open_collective: [csvhelper]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -11,11 +11,7 @@ assignees: ''
 A clear and concise description of what the bug is.
 
 **To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+Provide a small working example that shows the issue.
 
 **Expected behavior**
 A clear and concise description of what you expected to happen.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,12 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions
+    url: https://stackoverflow.com/questions/tagged/csvhelper
+    about: All questions should be directed to StackOverflow.
+           Please only submit a question if no one has been able to answer your question on StackOverflow. 
+           I have very limited time to work on this project, and would prefer to use that time for bugs and features.
+           Thanks.
+  - name: Unanswered Questions
+    url: https://github.com/JoshClose/CsvHelper/discussions?discussions_q=category%3AQ%26A
+    about: If StackOverflow has failed you, you can ask a question on the disucssions board.
+           Please add a link to your StackOverflow question so we can answer it in both places.

.github/workflows/ci.yaml

@@ -0,0 +1,20 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  ci:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with: 
+          fetch-depth: 0
+      - name: Setup .NET Core
+        uses: actions/setup-dotnet@v4
+      - name: Display .NET Version
+        run: dotnet --version
+      - name: Restore
+        run: dotnet restore
+      - name: Build
+        run: dotnet build --configuration Release --no-restore
+      - name: Test
+        run: dotnet test --configuration Release --no-restore --no-build

.github/workflows/git-version.yaml

@@ -0,0 +1,33 @@
+name: Check Git Version
+on: 
+  workflow_dispatch:
+jobs:
+  git-version:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with: 
+          fetch-depth: 0
+      - name: Check Git Semantic Version
+        id: gitversion
+        uses: PaulHatch/semantic-version@v5.3.0
+        with:
+          tag_prefix: ""
+      - name: Output Version Info
+        run: |
+          echo "major: ${{ steps.gitversion.outputs.major }}"
+          echo "minor: ${{ steps.gitversion.outputs.minor }}"
+          echo "patch: ${{ steps.gitversion.outputs.patch }}"
+          echo "increment: ${{ steps.gitversion.outputs.increment }}"
+          echo "version_type: ${{ steps.gitversion.outputs.version_type }}"
+          echo "version: ${{ steps.gitversion.outputs.version }}"
+          echo "version_tag: ${{ steps.gitversion.outputs.version_tag }}"
+          echo "changed: ${{ steps.gitversion.outputs.changed }}"
+          echo "is_tagged: ${{ steps.gitversion.outputs.is_tagged }}"
+          echo "authors: ${{ steps.gitversion.outputs.authors }}"
+          echo "current_commit: ${{ steps.gitversion.outputs.current_commit }}"
+          echo "previous_commit: ${{ steps.gitversion.outputs.previous_commit }}"
+          echo "previous_version: ${{ steps.gitversion.outputs.previous_version }}"
+          echo "debug_output: ${{ steps.gitversion.outputs.debug_output }}"
+

.github/workflows/publish.yaml

@@ -0,0 +1,33 @@
+name: Publish NuGet Package
+on: 
+  workflow_dispatch:
+jobs:
+  publish:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with: 
+          fetch-depth: 0
+      - name: Setup Git Semantic Version
+        id: gitversion
+        uses: PaulHatch/semantic-version@v5.3.0 # https://github.com/marketplace/actions/git-semantic-version
+        with:
+          tag_prefix: ""
+      - name: Setup .NET Core
+        uses: actions/setup-dotnet@v4
+      - name: Display .NET Version
+        run: dotnet --version
+      - name: Create NuGet Package
+        run: >
+          dotnet pack src/CsvHelper
+          --configuration Release
+          -o output
+          -p:AssemblyVersion=${{ steps.gitversion.outputs.major }}.0.0.0
+          -p:FileVersion=${{ steps.gitversion.outputs.version }}.${{ github.run_number }}
+          -p:InformationalVersion=${{ steps.gitversion.outputs.version }}
+          -p:PackageVersion=${{ steps.gitversion.outputs.version }}
+      - name: Display Output
+        run: dir output
+      - name: Publish NuGet Package
+        run: dotnet nuget push output/CsvHelper.${{ steps.gitversion.outputs.version }}.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.NUGET_API_KEY }}

.gitignore

@@ -1,9 +1,12 @@
 .vs/
 bin/
 obj/
-_NCrunch_*/
+*NCrunch*/
 artifacts/
 .tmp/
+cache/
+.idea/
 
 *.user
 *.psess
+*.log

CsvHelper.sln

@@ -1,20 +1,26 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.29411.108
+# Visual Studio Version 17
+VisualStudioVersion = 17.8.34330.188
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{6445B2A3-9E05-4ABF-AE2E-C875773B277A}"
 	ProjectSection(SolutionItems) = preProject
 		.editorconfig = .editorconfig
 		.gitignore = .gitignore
+		build-docs.cmd = build-docs.cmd
+		CsvHelper.sln.licenseheader = CsvHelper.sln.licenseheader
+		.github\FUNDING.yml = .github\FUNDING.yml
+		GitVersion.yml = GitVersion.yml
 		README.markdown = README.markdown
 	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CsvHelper", "src\CsvHelper\CsvHelper.csproj", "{ECF9E2A8-3592-4DA4-9FAB-BFA56AD44B9C}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CsvHelper.Tests", "tests\CsvHelper.Tests\CsvHelper.Tests.csproj", "{6859ECD8-81AE-4E74-A926-5726AAD7EE81}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "_build", "build\_build.csproj", "{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CsvHelper.Website", "src\CsvHelper.Website\CsvHelper.Website.csproj", "{3E59CA52-D248-4CBB-BB06-270FA942C4B8}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CsvHelper.Benchmarks", "performance\CsvHelper.Benchmarks\CsvHelper.Benchmarks.csproj", "{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -70,16 +76,46 @@ Global
 		{6859ECD8-81AE-4E74-A926-5726AAD7EE81}.Release|x64.Build.0 = Release|Any CPU
 		{6859ECD8-81AE-4E74-A926-5726AAD7EE81}.Release|x86.ActiveCfg = Release|Any CPU
 		{6859ECD8-81AE-4E74-A926-5726AAD7EE81}.Release|x86.Build.0 = Release|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Debug|ARM.ActiveCfg = Debug|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Release|ARM.ActiveCfg = Release|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Release|x64.ActiveCfg = Release|Any CPU
-		{B0E9C5E1-8A40-4BF7-AF08-6A6E179446A5}.Release|x86.ActiveCfg = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|ARM.ActiveCfg = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|ARM.Build.0 = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|x64.Build.0 = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Debug|x86.Build.0 = Debug|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|ARM.ActiveCfg = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|ARM.Build.0 = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|Mixed Platforms.Build.0 = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|x64.ActiveCfg = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|x64.Build.0 = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|x86.ActiveCfg = Release|Any CPU
+		{3E59CA52-D248-4CBB-BB06-270FA942C4B8}.Release|x86.Build.0 = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|ARM.ActiveCfg = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|ARM.Build.0 = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|x64.Build.0 = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Debug|x86.Build.0 = Debug|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|ARM.ActiveCfg = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|ARM.Build.0 = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|Mixed Platforms.Build.0 = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|x64.ActiveCfg = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|x64.Build.0 = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|x86.ActiveCfg = Release|Any CPU
+		{4DAB88D4-56B0-C42A-25BB-3E5BBCBB5F1B}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

CsvHelper.sln.licenseheader

@@ -0,0 +1,32 @@
+extensions: designer.cs generated.cs
+extensions: .cs .cpp .h
+// Copyright 2009-2024 Josh Close
+// This file is a part of CsvHelper and is dual licensed under MS-PL and Apache 2.0.
+// See LICENSE.txt for details or visit http://www.opensource.org/licenses/ms-pl.html for MS-PL and http://opensource.org/licenses/Apache-2.0 for Apache 2.0.
+// https://github.com/JoshClose/CsvHelper
+extensions: .aspx .ascx
+<%-- 
+Copyright 2009-2024 Josh Close
+This file is a part of CsvHelper and is dual licensed under MS-PL and Apache 2.0.
+See LICENSE.txt for details or visit http://www.opensource.org/licenses/ms-pl.html for MS-PL and http://opensource.org/licenses/Apache-2.0 for Apache 2.0.
+https://github.com/JoshClose/CsvHelper
+--%>
+extensions: .vb
+' Copyright 2009-2024 Josh Close
+' This file is a part of CsvHelper and is dual licensed under MS-PL and Apache 2.0.
+' See LICENSE.txt for details or visit http://www.opensource.org/licenses/ms-pl.html for MS-PL and http://opensource.org/licenses/Apache-2.0 for Apache 2.0.
+' https://github.com/JoshClose/CsvHelper
+extensions:  .xml .config .xsd
+<!--
+Copyright 2009-2024 Josh Close
+This file is a part of CsvHelper and is dual licensed under MS-PL and Apache 2.0.
+See LICENSE.txt for details or visit http://www.opensource.org/licenses/ms-pl.html for MS-PL and http://opensource.org/licenses/Apache-2.0 for Apache 2.0.
+https://github.com/JoshClose/CsvHelper
+-->
+extenions: .tt
+<#
+// Copyright 2009-2024 Josh Close
+// This file is a part of CsvHelper and is dual licensed under MS-PL and Apache 2.0.
+// See LICENSE.txt for details or visit http://www.opensource.org/licenses/ms-pl.html for MS-PL and http://opensource.org/licenses/Apache-2.0 for Apache 2.0.
+// https://github.com/JoshClose/CsvHelper
+#>

CsvHelper.v3.ncrunchsolution

@@ -1,6 +1,8 @@
 <SolutionConfiguration>
   <Settings>
-    <AllowParallelTestExecution>False</AllowParallelTestExecution>
+    <AllowParallelTestExecution>True</AllowParallelTestExecution>
+    <InstrumentationMode>Optimised</InstrumentationMode>
+    <RdiConfigured>True</RdiConfigured>
     <SolutionConfigured>True</SolutionConfigured>
   </Settings>
 </SolutionConfiguration>