ft/support escaping trailing backslashes

.github/workflows/build.yml

@@ -4,30 +4,30 @@ on:
   push:
     branches: [ master ]
   pull_request:
-  workflow_dispatch:  # Allows manual triggering
+  workflow_dispatch:
 
 jobs:
   build-and-test:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
 
-      - name: Use .NET 8 SDK
+      - name: Use .NET 9 SDK
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: 8.0.x
+          dotnet-version: 9.x
 
       - name: Restore dependencies
-        run: dotnet restore ./src/**/*.csproj
+        run: dotnet restore 
 
       - name: Build all projects
-        run: dotnet build ./src/**/*.csproj -c Release --no-restore
+        run: dotnet build --no-restore
 
       - name: Run tests with code coverage
-        run: dotnet test dotenv.net.sln /p:CollectCoverage=true /p:CoverletOutputFormat=lcov /p:CoverletOutput=./coverage/
+        run: dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=lcov /p:CoverletOutput=./coverage/
 
       - name: Upload coverage to Coveralls
         uses: coverallsapp/github-action@v1.1.2
         with:
           github-token: ${{ github.token }}
-          path-to-lcov: ${{ github.workspace }}/tests/dotenv.net.Tests/coverage/coverage.info
+          path-to-lcov: ${{ github.workspace }}/src/dotenv.net.Tests/coverage/coverage.info

dotenv.net.sln

@@ -1,33 +1,24 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
+Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 2013
 VisualStudioVersion = 12.0.0.0
 MinimumVisualStudioVersion = 10.0.0.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "dotenv.net", "src\dotenv.net/dotenv.net.csproj", "{92FD0370-AEB1-4154-8C9F-D5FF30CABCF8}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "dotenv.net", "src\dotenv.net\dotenv.net.csproj", "{ABC30C21-62C1-4DF5-B352-4D33BCDD9845}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "dotenv.net.Tests", "tests\dotenv.net.Tests\dotenv.net.Tests.csproj", "{A03D81EE-4F67-4521-932A-0B9B5BE50F72}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Tests", "tests", "{1CEC83AC-9E34-4320-AECE-F0F52FE70538}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "dotenv.net.Tests", "src\dotenv.net.Tests\dotenv.net.Tests.csproj", "{FC5ED4B3-DFDC-45E9-889C-847433F08E0E}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
 		Release|Any CPU = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{92FD0370-AEB1-4154-8C9F-D5FF30CABCF8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{92FD0370-AEB1-4154-8C9F-D5FF30CABCF8}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{92FD0370-AEB1-4154-8C9F-D5FF30CABCF8}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{92FD0370-AEB1-4154-8C9F-D5FF30CABCF8}.Release|Any CPU.Build.0 = Release|Any CPU
-		{A03D81EE-4F67-4521-932A-0B9B5BE50F72}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{A03D81EE-4F67-4521-932A-0B9B5BE50F72}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{A03D81EE-4F67-4521-932A-0B9B5BE50F72}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{A03D81EE-4F67-4521-932A-0B9B5BE50F72}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-	GlobalSection(NestedProjects) = preSolution
-		{A03D81EE-4F67-4521-932A-0B9B5BE50F72} = {1CEC83AC-9E34-4320-AECE-F0F52FE70538}
+		{ABC30C21-62C1-4DF5-B352-4D33BCDD9845}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{ABC30C21-62C1-4DF5-B352-4D33BCDD9845}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{ABC30C21-62C1-4DF5-B352-4D33BCDD9845}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{ABC30C21-62C1-4DF5-B352-4D33BCDD9845}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FC5ED4B3-DFDC-45E9-889C-847433F08E0E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FC5ED4B3-DFDC-45E9-889C-847433F08E0E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FC5ED4B3-DFDC-45E9-889C-847433F08E0E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FC5ED4B3-DFDC-45E9-889C-847433F08E0E}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 EndGlobal

src/dotenv.net.Tests/.env

@@ -0,0 +1,15 @@
+lower_case_key=world
+# this is a comment
+DOUBLE_QUOTES="double"
+SINGLE_QUOTES='single'
+BOOLEAN=true   
+NUMERIC=34.56
+  DB_DATABASE= laravel  
+DOTTED.KEY =spaced value 
+=ValueWithNoKey
+KeyWithNoValue=
+DOUBLE_QUOTE_EVEN_MORE_LINES="this
+is
+\"a
+multi-line
+  value"

src/dotenv.net.Tests/DotEnvOptionsTests.cs

@@ -0,0 +1,160 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Shouldly;
+using Xunit;
+
+namespace dotenv.net.Tests;
+
+public class DotEnvOptionsTests
+{
+    [Fact]
+    public void Constructor_WithNullEnvFilePaths_ShouldUseDefaultPath()
+    {
+        var options = new DotEnvOptions(envFilePaths: null);
+        options.EnvFilePaths.ShouldBe([DotEnvOptions.DefaultEnvFileName]);
+    }
+
+    [Fact]
+    public void Constructor_WithEmptyEnvFilePaths_ShouldUseDefaultPath()
+    {
+        var emptyPaths = new List<string>();
+        var options = new DotEnvOptions(envFilePaths: emptyPaths);
+        options.EnvFilePaths.ShouldBe([DotEnvOptions.DefaultEnvFileName]);
+    }
+
+    [Fact]
+    public void Constructor_WithNullEncoding_ShouldUseUtf8()
+    {
+        var options = new DotEnvOptions(encoding: null);
+        options.Encoding.ShouldBe(Encoding.UTF8);
+    }
+
+    [Fact]
+    public void WithEncoding_WithNullEncoding_ShouldUseUtf8()
+    {
+        var options = new DotEnvOptions();
+        options.WithEncoding(null!);
+        options.Encoding.ShouldBe(Encoding.UTF8);
+    }
+
+    [Fact]
+    public void WithEnvFiles_WithNullParams_ShouldUseDefaultPath()
+    {
+        var options = new DotEnvOptions();
+        options.WithEnvFiles(null!);
+        options.EnvFilePaths.ShouldBe([DotEnvOptions.DefaultEnvFileName]);
+    }
+
+    [Fact]
+    public void WithEnvFiles_WithEmptyParams_ShouldUseDefaultPath()
+    {
+        var options = new DotEnvOptions();
+        options.WithEnvFiles(Array.Empty<string>());
+        options.EnvFilePaths.ShouldBe([DotEnvOptions.DefaultEnvFileName]);
+    }
+
+    [Fact]
+    public void WithProbeForEnv_WithNegativeProbeLevels_ShouldUseDefaultProbeDepth()
+    {
+        var options = new DotEnvOptions();
+        options.WithProbeForEnv(-1);
+        options.ProbeLevelsToSearch.ShouldBe(DotEnvOptions.DefaultProbeAscendLimit);
+    }
+
+    [Fact]
+    public void WithoutProbeForEnv_ShouldResetProbeLevelsToDefault()
+    {
+        var options = new DotEnvOptions().WithProbeForEnv(10);
+        options.WithoutProbeForEnv();
+        options.ProbeForEnv.ShouldBeFalse();
+        options.ProbeLevelsToSearch.ShouldBe(DotEnvOptions.DefaultProbeAscendLimit);
+    }
+
+    [Fact]
+    public void WithDefaultEncoding_ShouldResetToUtf8()
+    {
+        var options = new DotEnvOptions().WithEncoding(Encoding.ASCII);
+        options.WithDefaultEncoding();
+        options.Encoding.ShouldBe(Encoding.UTF8);
+    }
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public void WithExceptions_ShouldSetIgnoreExceptionsCorrectly(bool initialValue)
+    {
+        var options = new DotEnvOptions(ignoreExceptions: initialValue);
+        options.WithExceptions();
+        options.IgnoreExceptions.ShouldBeFalse();
+    }
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public void WithoutExceptions_ShouldSetIgnoreExceptionsCorrectly(bool initialValue)
+    {
+        var options = new DotEnvOptions(ignoreExceptions: initialValue);
+        options.WithoutExceptions();
+        options.IgnoreExceptions.ShouldBeTrue();
+    }
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public void WithOverwriteExistingVars_ShouldSetOverwriteCorrectly(bool initialValue)
+    {
+        var options = new DotEnvOptions(overwriteExistingVars: initialValue);
+        options.WithOverwriteExistingVars();
+        options.OverwriteExistingVars.ShouldBeTrue();
+    }
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public void WithoutOverwriteExistingVars_ShouldSetOverwriteCorrectly(bool initialValue)
+    {
+        var options = new DotEnvOptions(overwriteExistingVars: initialValue);
+        options.WithoutOverwriteExistingVars();
+        options.OverwriteExistingVars.ShouldBeFalse();
+    }
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public void WithTrimValues_ShouldSetTrimValuesCorrectly(bool initialValue)
+    {
+        var options = new DotEnvOptions(trimValues: initialValue);
+        options.WithTrimValues();
+        options.TrimValues.ShouldBeTrue();
+    }
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public void WithoutTrimValues_ShouldSetTrimValuesCorrectly(bool initialValue)
+    {
+        var options = new DotEnvOptions(trimValues: initialValue);
+        options.WithoutTrimValues();
+        options.TrimValues.ShouldBeFalse();
+    }
+
+    [Fact]
+    public void Read_ComplexExistingEnv_ShouldExtractValidValues()
+    {
+        var values = DotEnv.Fluent()
+            .WithTrimValues()
+            .WithProbeForEnv()
+            .Read();
+
+        values.ShouldContainKeyAndValue("lower_case_key", "world");
+        values.ShouldContainKeyAndValue("DOUBLE_QUOTES", "double");
+        values.ShouldContainKeyAndValue("SINGLE_QUOTES", "single");
+        values.ShouldContainKeyAndValue("BOOLEAN", "true");
+        values.ShouldContainKeyAndValue("NUMERIC", "34.56");
+        values.ShouldContainKeyAndValue("DOTTED.KEY", "spaced value");
+        values.ShouldContainKeyAndValue("KeyWithNoValue", string.Empty);
+        values.ShouldContainKeyAndValue("DOUBLE_QUOTE_EVEN_MORE_LINES",
+            $"""this{Environment.NewLine}is{Environment.NewLine}"a{Environment.NewLine}multi-line{Environment.NewLine}  value""");
+    }
+}

src/dotenv.net.Tests/DotEnvTests.cs

@@ -0,0 +1,25 @@
+using System;
+using Shouldly;
+using Xunit;
+
+namespace dotenv.net.Tests;
+
+public class DotEnvTests
+{
+    [Fact]
+    public void Read_ComplexExistingEnv_ShouldExtractValidValues()
+    {
+        var options = new DotEnvOptions(trimValues: true, probeForEnv: true, probeLevelsToSearch: 5);
+        var values = DotEnv.Read(options);
+
+        values.ShouldContainKeyAndValue("lower_case_key", "world");
+        values.ShouldContainKeyAndValue("DOUBLE_QUOTES", "double");
+        values.ShouldContainKeyAndValue("SINGLE_QUOTES", "single");
+        values.ShouldContainKeyAndValue("BOOLEAN", "true");
+        values.ShouldContainKeyAndValue("NUMERIC", "34.56");
+        values.ShouldContainKeyAndValue("DOTTED.KEY", "spaced value");
+        values.ShouldContainKeyAndValue("KeyWithNoValue", string.Empty);
+        values.ShouldContainKeyAndValue("DOUBLE_QUOTE_EVEN_MORE_LINES",
+            $"""this{Environment.NewLine}is{Environment.NewLine}"a{Environment.NewLine}multi-line{Environment.NewLine}  value""");
+    }
+}