test: Add test project

CPlugin.Net.sln

@@ -7,6 +7,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CPlugin.Net.Attributes", "s
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CPlugin.Net", "src\Core\CPlugin.Net.csproj", "{116B353F-FC68-4412-8A2D-34DA0BE88060}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CPlugin.Net.Tests", "tests\CPlugin.Net\CPlugin.Net.Tests.csproj", "{2F9DE570-146C-44E3-BF2F-14CFA5C3803F}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Example.Contracts", "samples\Contracts\Example.Contracts.csproj", "{BBDE7F3C-2A41-40B6-B609-839D09676D0E}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Example.ConsoleApp", "samples\HostApplications\ConsoleApp\Example.ConsoleApp.csproj", "{3E943746-09CD-430E-9BBF-67DBBF9F5CEF}"
@@ -23,11 +25,25 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Example.AppointmentPlugin",
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Example.PersonPlugin", "samples\Plugins\PersonPlugin\Example.PersonPlugin.csproj", "{18534944-583B-4924-AC5B-E0655FD92AAC}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestProject.JsonPlugin", "tests\Plugins\TestProject.JsonPlugin\TestProject.JsonPlugin.csproj", "{0F27C776-F284-4C94-86C9-0FF089245E13}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestProject.OldJsonPlugin", "tests\Plugins\TestProject.OldJsonPlugin\TestProject.OldJsonPlugin.csproj", "{BCE8FA91-AF31-49DD-BED8-E60A46915400}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestProject.WebPlugin", "tests\Plugins\TestProject.WebPlugin\TestProject.WebPlugin.csproj", "{C6EC1C5D-15E7-44BD-8E03-8CF9A033DE25}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestProject.HelloPlugin", "tests\Plugins\TestProject.HelloPlugin\TestProject.HelloPlugin.csproj", "{E2373A36-6D3E-44DE-99FF-4CC019E05D06}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestProject.Contracts", "tests\TestProject.Contracts\TestProject.Contracts.csproj", "{FEE1E508-3313-4C7A-A7E6-5EBA8D47D3FD}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestProject.PluginHost", "tests\TestProject.PluginHost\TestProject.PluginHost.csproj", "{0BCD3305-F0D5-43E6-B879-EEF0827558A8}"
+EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{DA150C23-F1A9-42CF-899C-6C4E6B940E72}"
 	ProjectSection(SolutionItems) = preProject
 		Directory.Build.props = Directory.Build.props
 		samples\Plugins\Directory.Build.props = samples\Plugins\Directory.Build.props
+		tests\Plugins\Directory.Build.props = tests\Plugins\Directory.Build.props
 		Directory.Packages.props = Directory.Packages.props
+		tests\CPlugin.Net\PluginProjectRef.targets = tests\CPlugin.Net\PluginProjectRef.targets
 	EndProjectSection
 EndProject
 Global
@@ -44,6 +60,10 @@ Global
 		{116B353F-FC68-4412-8A2D-34DA0BE88060}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{116B353F-FC68-4412-8A2D-34DA0BE88060}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{116B353F-FC68-4412-8A2D-34DA0BE88060}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2F9DE570-146C-44E3-BF2F-14CFA5C3803F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2F9DE570-146C-44E3-BF2F-14CFA5C3803F}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2F9DE570-146C-44E3-BF2F-14CFA5C3803F}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2F9DE570-146C-44E3-BF2F-14CFA5C3803F}.Release|Any CPU.Build.0 = Release|Any CPU
 		{BBDE7F3C-2A41-40B6-B609-839D09676D0E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{BBDE7F3C-2A41-40B6-B609-839D09676D0E}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{BBDE7F3C-2A41-40B6-B609-839D09676D0E}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -56,6 +76,10 @@ Global
 		{C221B4F0-857F-4380-B5AD-E4B2BBA65622}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{C221B4F0-857F-4380-B5AD-E4B2BBA65622}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{C221B4F0-857F-4380-B5AD-E4B2BBA65622}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F66A1430-3F32-4E25-8966-54D502D216DE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F66A1430-3F32-4E25-8966-54D502D216DE}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F66A1430-3F32-4E25-8966-54D502D216DE}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F66A1430-3F32-4E25-8966-54D502D216DE}.Release|Any CPU.Build.0 = Release|Any CPU
 		{C5B8EF73-7DB5-441F-AE38-0988751A896B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{C5B8EF73-7DB5-441F-AE38-0988751A896B}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{C5B8EF73-7DB5-441F-AE38-0988751A896B}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -72,10 +96,30 @@ Global
 		{18534944-583B-4924-AC5B-E0655FD92AAC}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{18534944-583B-4924-AC5B-E0655FD92AAC}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{18534944-583B-4924-AC5B-E0655FD92AAC}.Release|Any CPU.Build.0 = Release|Any CPU
-		{F66A1430-3F32-4E25-8966-54D502D216DE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{F66A1430-3F32-4E25-8966-54D502D216DE}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{F66A1430-3F32-4E25-8966-54D502D216DE}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{F66A1430-3F32-4E25-8966-54D502D216DE}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0F27C776-F284-4C94-86C9-0FF089245E13}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0F27C776-F284-4C94-86C9-0FF089245E13}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0F27C776-F284-4C94-86C9-0FF089245E13}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0F27C776-F284-4C94-86C9-0FF089245E13}.Release|Any CPU.Build.0 = Release|Any CPU
+		{BCE8FA91-AF31-49DD-BED8-E60A46915400}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{BCE8FA91-AF31-49DD-BED8-E60A46915400}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{BCE8FA91-AF31-49DD-BED8-E60A46915400}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{BCE8FA91-AF31-49DD-BED8-E60A46915400}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C6EC1C5D-15E7-44BD-8E03-8CF9A033DE25}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C6EC1C5D-15E7-44BD-8E03-8CF9A033DE25}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C6EC1C5D-15E7-44BD-8E03-8CF9A033DE25}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C6EC1C5D-15E7-44BD-8E03-8CF9A033DE25}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E2373A36-6D3E-44DE-99FF-4CC019E05D06}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E2373A36-6D3E-44DE-99FF-4CC019E05D06}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E2373A36-6D3E-44DE-99FF-4CC019E05D06}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E2373A36-6D3E-44DE-99FF-4CC019E05D06}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FEE1E508-3313-4C7A-A7E6-5EBA8D47D3FD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FEE1E508-3313-4C7A-A7E6-5EBA8D47D3FD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FEE1E508-3313-4C7A-A7E6-5EBA8D47D3FD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FEE1E508-3313-4C7A-A7E6-5EBA8D47D3FD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0BCD3305-F0D5-43E6-B879-EEF0827558A8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0BCD3305-F0D5-43E6-B879-EEF0827558A8}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0BCD3305-F0D5-43E6-B879-EEF0827558A8}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0BCD3305-F0D5-43E6-B879-EEF0827558A8}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

Directory.Build.props

@@ -5,6 +5,6 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>disable</Nullable>
     <GenerateDocumentationFile>True</GenerateDocumentationFile>
-    <NoWarn>1591</NoWarn>
+    <NoWarn>1591;NU1903</NoWarn>
   </PropertyGroup>
 </Project>

Directory.Packages.props

@@ -10,6 +10,7 @@
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="6.5.0" />
     <PackageVersion Include="SimpleResults.AspNetCore" Version="1.0.0" />
     <PackageVersion Include="DotEnv.Core" Version="3.0.0" />
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="7.0.3" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.1.0" />
     <PackageVersion Include="FluentAssertions" Version="6.10.0" />
     <PackageVersion Include="NUnit" Version="3.13.3" />

src/Core/Configuration/CPluginEnvConfiguration.cs

@@ -14,6 +14,8 @@ namespace CPlugin.Net;
 /// </remarks>
 public class CPluginEnvConfiguration : CPluginConfigurationBase
 {
+    private static readonly string[] s_separator = { " ", "\t", "\r\n", "\n", "\r" };
+
     /// <summary>
     ///  Initializes a new instance of the <see cref="CPluginEnvConfiguration"/> class.
     /// </summary>
@@ -27,7 +29,7 @@ public override IEnumerable<string> GetPluginFiles()
             return Enumerable.Empty<string>();
 
         var pluginFiles = retrievedValue
-            .Split(" ")
+            .Split(s_separator, StringSplitOptions.None)
             .Where(pluginFile => !string.IsNullOrWhiteSpace(pluginFile))
             .Select(GetPluginPath);
 

tests/CPlugin.Net/Attributes/PluginAttributeTestCases.cs

@@ -0,0 +1,18 @@
+namespace CPlugin.Net.Tests.Attributes;
+
+public class PluginAttributeTestCases : IEnumerable
+{
+    public IEnumerator GetEnumerator()
+    {
+        yield return typeof(IExample);
+        yield return typeof(ExampleBase);
+        yield return typeof(AbstractExample);
+        yield return typeof(EnumExample);
+        yield return typeof(int);
+    }
+}
+
+public interface IExample { }
+public abstract class ExampleBase { }
+public abstract class AbstractExample : IExample { }
+public enum EnumExample { }

tests/CPlugin.Net/Attributes/PluginAttributeTests.cs

@@ -0,0 +1,50 @@
+namespace CPlugin.Net.Tests.Attributes;
+
+public class PluginAttributeTests
+{
+    [Test]
+    public void Constructor_WhenArgumentIsNull_ShouldThrowArgumentNullException()
+    {
+        // Arrange
+        Type pluginType = default;
+
+        // Act
+        Action act = () =>
+        {
+            var attr = new PluginAttribute(pluginType);
+        };
+
+        // Assert
+        act.Should().Throw<ArgumentNullException>();
+    }
+
+    [TestCaseSource(typeof(PluginAttributeTestCases))]
+    public void Constructor_WhenTypeIsNotInstantiable_ShouldThrowArgumentException(Type pluginType)
+    {
+        // Act
+        Action act = () =>
+        {
+            var attr = new PluginAttribute(pluginType);
+        };
+
+        // Assert
+        act.Should()
+           .Throw<ArgumentException>()
+           .WithParameterName(nameof(pluginType));
+    }
+
+    [Test]
+    public void Constructor_WhenTypeIsInstantiable_ShouldNotThrowException()
+    {
+        // Arrange
+        Type expected = typeof(Example);
+
+        // Act
+        var actual = new PluginAttribute(expected);
+
+        // Assert
+        actual.PluginType.Should().Be(expected);
+    }
+
+    private class Example { }
+}

tests/CPlugin.Net/CPlugin.Net.Tests.csproj

@@ -0,0 +1,41 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <RootNamespace>CPlugin.Net.Tests</RootNamespace>
+    <IsPackable>false</IsPackable>
+    <IsTestProject>true</IsTestProject>
+    <NoDefaultLaunchSettingsFile>true</NoDefaultLaunchSettingsFile>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="DotEnv.Core" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" />
+    <PackageReference Include="FluentAssertions" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" />
+    <PackageReference Include="NUnit" />
+    <PackageReference Include="NUnit3TestAdapter" />
+    <PackageReference Include="NUnit.Analyzers" />
+    <PackageReference Include="coverlet.msbuild">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <!-- 
+      These references were added only so that all plugin projects could be compiled. 
+      Especially when done from the command line interface (CLI) with dotnet test.
+    -->
+    <PluginProjectReference Include="..\Plugins\TestProject.HelloPlugin\TestProject.HelloPlugin.csproj" />
+    <PluginProjectReference Include="..\Plugins\TestProject.JsonPlugin\TestProject.JsonPlugin.csproj" />
+    <PluginProjectReference Include="..\Plugins\TestProject.OldJsonPlugin\TestProject.OldJsonPlugin.csproj" />
+    <PluginProjectReference Include="..\Plugins\TestProject.WebPlugin\TestProject.WebPlugin.csproj" />
+    <!-- End -->
+
+    <ProjectReference Include="..\TestProject.Contracts\TestProject.Contracts.csproj" />
+    <ProjectReference Include="..\TestProject.PluginHost\TestProject.PluginHost.csproj" />
+  </ItemGroup>
+
+  <Import Project="PluginProjectRef.targets" />
+
+</Project>

tests/CPlugin.Net/Core/CPluginEnvConfigurationTests.cs

@@ -0,0 +1,126 @@
+namespace CPlugin.Net.Tests.Core;
+
+public class CPluginEnvConfigurationTests
+{
+    private class EnvConfigurationTestCases : IEnumerable
+    {
+        public IEnumerator GetEnumerator()
+        {
+            yield return "   TestProject.JsonPlugin.dll   TestProject.OldJsonPlugin.dll   TestProject.WebPlugin.dll   ";
+            yield return $"{'\t'} TestProject.JsonPlugin.dll{'\t'}TestProject.OldJsonPlugin.dll{'\t'}TestProject.WebPlugin.dll{'\t'}";
+            yield return $"{'\n'} TestProject.JsonPlugin.dll{'\n'}TestProject.OldJsonPlugin.dll{'\n'}TestProject.WebPlugin.dll{'\n'}";
+            yield return $"{'\r'} TestProject.JsonPlugin.dll{'\r'}TestProject.OldJsonPlugin.dll{'\r'}TestProject.WebPlugin.dll{'\r'}";
+            yield return $"{"\r\n"} TestProject.JsonPlugin.dll{"\r\n"}TestProject.OldJsonPlugin.dll{"\r\n"}TestProject.WebPlugin.dll{"\r\n"}";
+
+            yield return
+            """
+            TestProject.JsonPlugin.dll
+            TestProject.OldJsonPlugin.dll
+            TestProject.WebPlugin.dll
+            """;
+
+            yield return
+            """
+               TestProject.JsonPlugin.dll
+               TestProject.OldJsonPlugin.dll
+               TestProject.WebPlugin.dll
+            """;
+
+            yield return
+            $"""
+            {'\t'}{'\t'}   TestProject.JsonPlugin.dll
+            {'\t'}{'\t'}   TestProject.OldJsonPlugin.dll
+            {'\t'}{'\t'}   TestProject.WebPlugin.dll
+            """;
+        }
+    }
+
+    [TestCaseSource(typeof(EnvConfigurationTestCases))]
+    public void GetPluginFiles_WhenPluginFilesArePresent_ShouldReturnsFullPaths(string pluginFiles)
+    {
+        // Arrange
+        Environment.SetEnvironmentVariable("PLUGINS", pluginFiles);
+        var envConfiguration = new CPluginEnvConfiguration();
+        var basePath = AppContext.BaseDirectory;
+        var expectedPaths = new[]
+        {
+            Path.Combine(basePath, "plugins", "TestProject.JsonPlugin", "TestProject.JsonPlugin.dll"),
+            Path.Combine(basePath, "plugins", "TestProject.OldJsonPlugin", "TestProject.OldJsonPlugin.dll"),
+            Path.Combine(basePath, "plugins", "TestProject.WebPlugin", "TestProject.WebPlugin.dll")
+        };
+
+        // Act
+        var actual = envConfiguration.GetPluginFiles().ToList();
+
+        // Assert
+        actual.Should().BeEquivalentTo(expectedPaths);
+    }
+
+    [Test]
+    public void GetPluginFiles_WhenPluginFilesAreObtainedFromEnvFile_ShouldReturnsFullPaths()
+    {
+        // Arrange
+        new EnvLoader()
+            .AllowOverwriteExistingVars()
+            .EnableFileNotFoundException()
+            .SetBasePath("./Resources")
+            .Load();
+        var envConfiguration = new CPluginEnvConfiguration();
+        var basePath = AppContext.BaseDirectory;
+        var expectedPaths = new[]
+        {
+            Path.Combine(basePath, "plugins", "TestProject.JsonPlugin", "TestProject.JsonPlugin.dll"),
+            Path.Combine(basePath, "plugins", "TestProject.OldJsonPlugin", "TestProject.OldJsonPlugin.dll"),
+            Path.Combine(basePath, "plugins", "TestProject.WebPlugin", "TestProject.WebPlugin.dll")
+        };
+
+        // Act
+        var actual = envConfiguration.GetPluginFiles().ToList();
+
+        // Assert
+        actual.Should().BeEquivalentTo(expectedPaths);
+    }
+
+    [Test]
+    public void GetPluginFiles_WhenPluginFilesAreNotPresent_ShouldReturnsEmptyEnumerable()
+    {
+        // Arrange
+        Environment.SetEnvironmentVariable("PLUGINS", "    ");
+        var envConfiguration = new CPluginEnvConfiguration();
+
+        // Act
+        var actual = envConfiguration.GetPluginFiles().ToList();
+
+        // Assert
+        actual.Should().BeEmpty();
+    }
+
+    [Test]
+    public void GetPluginFiles_WhenPluginsKeyIsNotPresent_ShouldReturnsEmptyEnumerable()
+    {
+        // Arrange
+        // To ensure that the variable is removed.
+        Environment.SetEnvironmentVariable("PLUGINS", default);
+        var envConfiguration = new CPluginEnvConfiguration();
+
+        // Act
+        var actual = envConfiguration.GetPluginFiles().ToList();
+
+        // Assert
+        actual.Should().BeEmpty();
+    }
+
+    [Test]
+    public void GetPluginFiles_WhenPluginFileDoesNotHaveDllExtension_ShouldThrowArgumentException()
+    {
+        // Arrange
+        Environment.SetEnvironmentVariable("PLUGINS", "TestProject.JsonPlugin");
+        var envConfiguration = new CPluginEnvConfiguration();
+
+        // Act
+        Action act = () => envConfiguration.GetPluginFiles().ToList();
+
+        // Assert
+        act.Should().Throw<ArgumentException>();
+    }
+}