Nuget Package Creation - v1.0.0

.github/workflows/build.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       matrix:
         os: [ windows-2022, ubuntu-22.04, macOS-14 ]
-        dotnet-version: [ '3.1.x', '6.0.x', '7.0.x', '8.0.x' ]
+        dotnet-version: [ '3.1.x', '5.0.x', '6.0.x', '7.0.x', '8.0.x', '9.0.x' ]
 
     steps:
     - name: Checkout Repository
@@ -31,14 +31,28 @@ jobs:
       with:
         dotnet-version: ${{ matrix.dotnet-version }}
 
-    - name: Find And Replace Values (App Config)
+    - name: Find And Replace Values (App Settings)
       uses: abhinavminhas/replace-tokens@main
       with:
-        files: '${{ github.workspace }}/QueryDB.Core.Tests/App.config'
+        files: '${{ github.workspace }}/QueryDB.Core.Tests/appsettings.json'
         replacements: '__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }}'
 
-    - name: Build
-      run: dotnet build QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+    - name: Build (${{ matrix.dotnet-version }})
+      shell: bash
+      run: |
+        if [[ "${{ matrix.dotnet-version }}" == "3.1"* ]]; then
+          dotnet build -f netcoreapp3.1 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+        elif [[ "${{ matrix.dotnet-version }}" == "5.0"* ]]; then
+          dotnet build -f net5.0 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+        elif [[ "${{ matrix.dotnet-version }}" == "6.0"* ]]; then
+          dotnet build -f net6.0 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+        elif [[ "${{ matrix.dotnet-version }}" == "7.0"* ]]; then
+          dotnet build -f net7.0 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+        elif [[ "${{ matrix.dotnet-version }}" == "8.0"* ]]; then
+          dotnet build -f net8.0 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+        elif [[ "${{ matrix.dotnet-version }}" == "9.0"* ]]; then
+          dotnet build -f net9.0 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+        fi
 
     - name: Docker Compose (Start - DB Containers)
       if: ${{ (matrix.os == 'ubuntu-22.04') && (matrix.dotnet-version == '3.1.x') }}
@@ -58,9 +72,9 @@ jobs:
       with:
         dbPassword: ${{ secrets.DB_PASSWORD }}
 
-    - name: Test
+    - name: Test (${{ matrix.dotnet-version }})
       if: ${{ (matrix.os == 'ubuntu-22.04') && (matrix.dotnet-version == '3.1.x') }}
-      run: dotnet test --no-build --logger "console;verbosity=detailed" --verbosity normal --configuration Release --filter TestCategory=DB-TESTS
+      run: dotnet test --framework netcoreapp3.1 --no-build --logger "console;verbosity=detailed" --verbosity normal --configuration Release --filter TestCategory=DB-TESTS
 
     - name: Docker Compose (Tear Down - DB Containers)
       if: ${{ (matrix.os == 'ubuntu-22.04') && (matrix.dotnet-version == '3.1.x') && always() }}
@@ -86,14 +100,14 @@ jobs:
       with:
         dotnet-version: ${{ matrix.dotnet-version }}
 
-    - name: Find And Replace Values (App Config)
+    - name: Find And Replace Values (App Settings)
       uses: abhinavminhas/replace-tokens@main
       with:
-        files: '${{ github.workspace }}/QueryDB.Core.Tests/App.config'
+        files: '${{ github.workspace }}/QueryDB.Core.Tests/appsettings.json'
         replacements: '__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }}'
 
-    - name: Build
-      run: dotnet build QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+    - name: Build (${{ matrix.dotnet-version }})
+      run: dotnet build -f netcoreapp3.1 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
 
     - name: Docker Compose (Start - DB Containers)
       uses: ./.github/workflows/docker-compose-start-dbs
@@ -110,8 +124,8 @@ jobs:
       with:
         dbPassword: ${{ secrets.DB_PASSWORD }}
 
-    - name: Test
-      run: dotnet test --no-build --logger "console;verbosity=detailed" --verbosity normal --configuration Release --filter TestCategory=DB-TESTS /p:CollectCoverage=true /p:CoverletOutputFormat=lcov
+    - name: Test (${{ matrix.dotnet-version }})
+      run: dotnet test --framework netcoreapp3.1 --no-build --logger "console;verbosity=detailed" --verbosity normal --configuration Release --filter TestCategory=DB-TESTS /p:CollectCoverage=true /p:CoverletOutputFormat=lcov
 
     - name: Docker Compose (Tear Down - DB Containers)
       if: always()

.github/workflows/coverage.yml

@@ -22,14 +22,14 @@ jobs:
       with:
         dotnet-version: ${{ matrix.dotnet-version }}
 
-    - name: Find And Replace Values (App Config)
+    - name: Find And Replace Values (App Settings)
       uses: abhinavminhas/replace-tokens@main
       with:
-        files: '${{ github.workspace }}/QueryDB.Core.Tests/App.config'
+        files: '${{ github.workspace }}/QueryDB.Core.Tests/appsettings.json'
         replacements: '__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }},__DB_PASSWORD__=${{ secrets.DB_PASSWORD }}'
 
-    - name: Build
-      run: dotnet build QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
+    - name: Build (${{ matrix.dotnet-version }})
+      run: dotnet build -f netcoreapp3.1 QueryDB.Core.Tests/QueryDB.Core.Tests.csproj --configuration Release
 
     - name: Docker Compose (Start - DB Containers)
       uses: ./.github/workflows/docker-compose-start-dbs
@@ -46,8 +46,8 @@ jobs:
       with:
         dbPassword: ${{ secrets.DB_PASSWORD }}
 
-    - name: Test
-      run: dotnet test --no-build --logger "console;verbosity=detailed" --verbosity normal --configuration Release --filter TestCategory=DB-TESTS /p:CollectCoverage=true /p:CoverletOutputFormat=lcov
+    - name: Test (${{ matrix.dotnet-version }})
+      run: dotnet test --framework netcoreapp3.1 --no-build --logger "console;verbosity=detailed" --verbosity normal --configuration Release --filter TestCategory=DB-TESTS /p:CollectCoverage=true /p:CoverletOutputFormat=lcov
 
     - name: Docker Compose (Tear Down - DB Containers)
       uses: ./.github/workflows/docker-compose-teardown-dbs

.github/workflows/publish-nuget-Package.yml

@@ -0,0 +1,32 @@
+name: Publish Nuget Package
+
+env:
+    NUGET_PACKAGE_NAME_VERSION: "QueryDB.1.0.0.nupkg"
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Publish Nuget Package
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ ubuntu-22.04 ]
+        dotnet-version: [ '3.1.x' ]
+
+    steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+
+    - name: Dotnet Version (${{ matrix.dotnet-version }})
+      uses: actions/setup-dotnet@v4
+      with:
+          dotnet-version: '3.1.x'
+
+    - name: Create Package
+      run: dotnet pack --configuration=Release QueryDB/QueryDB.csproj
+
+    - name: Publish Nuget Package
+      run: dotnet nuget push QueryDB/bin/Release/${{ env.NUGET_PACKAGE_NAME_VERSION }} -s https://api.nuget.org/v3/index.json -k ${{ secrets.NUGET_API_KEY }}
+

CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+All notable changes to this project documented here.
+
+## [Released]
+
+## [1.0.0](https://www.nuget.org/packages/QueryDB/1.0.0) - 2025-02-18
+### Added
+- QueryDB framework for simplified querying and executing transactions across multiple database systems.
+    - Retrieve data from database.
+    - Execute database commands.
+    - Execute transactions while maintaining atomicity.

QueryDB.Core.Tests/MSSQLTests.cs

@@ -39,7 +39,7 @@ public void Test_MSSQL_FetchData_Dictionary_SelectQuery()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql);
-            Assert.IsTrue(data.Count == 12);
+            Assert.AreEqual(12, data.Count);
             var agent = data.FirstOrDefault(X => X.ReferenceData["Agent_Name"] == "Benjamin");
             Assert.AreEqual("A009", agent.ReferenceData["Agent_Code"]);
             Assert.AreEqual("Benjamin", agent.ReferenceData["Agent_Name"]);
@@ -55,7 +55,7 @@ public void Test_MSSQL_FetchData_Dictionary_SelectQuery_UpperCaseKeys()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql, upperCaseKeys: true);
-            Assert.IsTrue(data.Count == 12);
+            Assert.AreEqual(12, data.Count);
             var agent = data.FirstOrDefault(X => X.ReferenceData["AGENT_NAME"] == "Benjamin");
             Assert.AreEqual("A009", agent.ReferenceData["AGENT_CODE"]);
             Assert.AreEqual("Benjamin", agent.ReferenceData["AGENT_NAME"]);
@@ -71,7 +71,7 @@ public void Test_MSSQL_FetchData_Dictionary_SelectQuery_Joins()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Join;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var agent = data.FirstOrDefault(X => X.ReferenceData["Agent_Code"] == "A004" && X.ReferenceData["Cust_Code"] == "C00006");
             Assert.AreEqual("A004", agent.ReferenceData["Agent_Code"]);
             Assert.AreEqual("Ivan", agent.ReferenceData["Agent_Name"]);
@@ -89,7 +89,7 @@ public void Test_MSSQL_FetchData_Dictionary_SelectQuery_Joins_UpperCaseKeys()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Join;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql, upperCaseKeys: true);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var agent = data.FirstOrDefault(X => X.ReferenceData["AGENT_CODE"] == "A004" && X.ReferenceData["CUST_CODE"] == "C00006");
             Assert.AreEqual("A004", agent.ReferenceData["AGENT_CODE"]);
             Assert.AreEqual("Ivan", agent.ReferenceData["AGENT_NAME"]);
@@ -107,7 +107,7 @@ public void Test_MSSQL_FetchData_Dictionary_SelectQuery_Aliases()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Alias;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var agent = data.FirstOrDefault(X => X.ReferenceData["Agent_Code"] == "A004" && X.ReferenceData["Cust_Code"] == "C00006");
             Assert.AreEqual("A004", agent.ReferenceData["Agent_Code"]);
             Assert.AreEqual("Ivan", agent.ReferenceData["Agent"]);
@@ -123,7 +123,7 @@ public void Test_MSSQL_FetchData_Dictionary_SelectQuery_Aliases_UpperCaseKeys()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Alias;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql, upperCaseKeys: true);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var agent = data.FirstOrDefault(X => X.ReferenceData["AGENT_CODE"] == "A004" && X.ReferenceData["CUST_CODE"] == "C00006");
             Assert.AreEqual("A004", agent.ReferenceData["AGENT_CODE"]);
             Assert.AreEqual("Ivan", agent.ReferenceData["AGENT"]);
@@ -139,7 +139,7 @@ public void Test_MSSQL_FetchData_Dictionary_DataTypes_Check()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_DataTypes;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData(selectSql);
-            Assert.IsTrue(data.Count == 1);
+            Assert.AreEqual(1, data.Count);
             var dataType = data.FirstOrDefault();
             Assert.AreEqual("9223372036854775807", dataType.ReferenceData["BigInt_Column"]);
             Assert.AreEqual("EjRWeJAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", dataType.ReferenceData["Binary_Column"]);
@@ -182,7 +182,7 @@ public void Test_MSSQL_FetchData_Entity_SelectQuery()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData<Entities.MSSQL.Agents>(selectSql);
-            Assert.IsTrue(data.Count == 12);
+            Assert.AreEqual(12, data.Count);
             var agent = data.FirstOrDefault(X => X.Agent_Name == "Benjamin");
             Assert.AreEqual("A009", agent.Agent_Code);
             Assert.AreEqual("Benjamin", agent.Agent_Name);
@@ -198,7 +198,7 @@ public void Test_MSSQL_FetchData_Entity_SelectQuery_Joins()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Join;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData<Entities.MSSQL.Orders>(selectSql);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var agent = data.FirstOrDefault(X => X.Agent_Code == "A004" && X.Cust_Code == "C00006");
             Assert.AreEqual("A004", agent.Agent_Code);
             Assert.AreEqual("Ivan", agent.Agent_Name);
@@ -209,10 +209,10 @@ public void Test_MSSQL_FetchData_Entity_SelectQuery_Joins()
             Assert.AreEqual((decimal)500.00, agent.Advance_Amount);
             Assert.AreEqual("SOD", agent.Ord_Description);
             // Non Existent Query Data
-            Assert.AreEqual(null, agent.Agent);
-            Assert.AreEqual(null, agent.Agent_Location);
-            Assert.AreEqual(null, agent.Customer);
-            Assert.AreEqual(null, agent.Customer_Location);
+            Assert.IsNull(agent.Agent);
+            Assert.IsNull(agent.Agent_Location);
+            Assert.IsNull(agent.Customer);
+            Assert.IsNull(agent.Customer_Location);
         }
 
         [TestMethod]
@@ -221,7 +221,7 @@ public void Test_MSSQL_FetchData_Entity_SelectQuery_Aliases()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Alias;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData<Entities.MSSQL.Orders>(selectSql);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var agent = data.FirstOrDefault(X => X.Agent_Code == "A004" && X.Cust_Code == "C00006");
             Assert.AreEqual("A004", agent.Agent_Code);
             Assert.AreEqual("Ivan", agent.Agent);
@@ -230,12 +230,12 @@ public void Test_MSSQL_FetchData_Entity_SelectQuery_Aliases()
             Assert.AreEqual("Shilton", agent.Customer);
             Assert.AreEqual("Torento", agent.Customer_Location);
             // Non Existent Query Data
-            Assert.AreEqual(null, agent.Agent_Name);
-            Assert.AreEqual(null, agent.Cust_Name);
+            Assert.IsNull(agent.Agent_Name);
+            Assert.IsNull(agent.Cust_Name);
             Assert.AreEqual(0, agent.Ord_Num);
             Assert.AreEqual(0, agent.Ord_Amount);
             Assert.AreEqual(0, agent.Advance_Amount);
-            Assert.AreEqual(null, agent.Ord_Description);
+            Assert.IsNull(agent.Ord_Description);
         }
 
         [TestMethod]
@@ -244,7 +244,7 @@ public void Test_MSSQL_FetchData_Entity_DataTypes_Check()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_DataTypes;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData<Entities.MSSQL.DataTypes>(selectSql);
-            Assert.IsTrue(data.Count == 1);
+            Assert.AreEqual(1, data.Count);
             var dataType = data.FirstOrDefault();
             Assert.AreEqual(9223372036854775807, dataType.BigInt_Column);
             Assert.AreEqual("EjRWeJAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", ConvertByteArrayToBase64(dataType.Binary_Column));
@@ -283,7 +283,7 @@ public void Test_MSSQL_FetchData_Entity_Strict_Check()
         {
             var selectSql = Queries.MSSQLQueries.TestDB.SelectSql_Strict;
             var data = new DBContext(DB.MSSQL, MSSQLConnectionString).FetchData<Entities.MSSQL.Details>(selectSql, strict: true);
-            Assert.IsTrue(data.Count == 34);
+            Assert.AreEqual(34, data.Count);
             var dataType = data.FirstOrDefault();
             Assert.AreEqual("A003", dataType.Agent_Code);
             Assert.AreEqual("Alex", dataType.Agent);
@@ -375,7 +375,7 @@ public void Test_MSSQL_ExecuteCommand_DML_Queries()
             var rows = dbContext.ExecuteCommand(insertSql);
             Assert.AreEqual(1, rows);
             var data = dbContext.FetchData(verifyDMLExecution);
-            Assert.IsTrue(data.Count == 1);
+            Assert.AreEqual(1, data.Count);
             var agent = data.FirstOrDefault();
             Assert.AreEqual("A020", agent.ReferenceData["Agent_Code"]);
             Assert.AreEqual("John", agent.ReferenceData["Agent_Name"]);
@@ -388,7 +388,7 @@ public void Test_MSSQL_ExecuteCommand_DML_Queries()
             rows = dbContext.ExecuteCommand(updateSql);
             Assert.AreEqual(1, rows);
             data = dbContext.FetchData(verifyDMLExecution);
-            Assert.IsTrue(data.Count == 1);
+            Assert.AreEqual(1, data.Count);
             agent = data.FirstOrDefault();
             Assert.AreEqual("A020", agent.ReferenceData["Agent_Code"]);
             Assert.AreEqual("John", agent.ReferenceData["Agent_Name"]);
@@ -401,7 +401,7 @@ public void Test_MSSQL_ExecuteCommand_DML_Queries()
             rows = dbContext.ExecuteCommand(deleteSql);
             Assert.AreEqual(1, rows);
             data = dbContext.FetchData(verifyDMLExecution);
-            Assert.IsTrue(data.Count == 0);
+            Assert.AreEqual(0, data.Count);
         }
 
         [TestMethod]
@@ -543,7 +543,7 @@ public void Test_MSSQL_ExecuteTransaction_DML_Multiple_Queries()
             var result = dbContext.ExecuteTransaction(statements);
             Assert.IsTrue(result);
             var data = dbContext.FetchData(verifyDMLExecution);
-            Assert.IsTrue(data.Count == 1);
+            Assert.AreEqual(1, data.Count);
             var agent = data.FirstOrDefault();
             Assert.AreEqual("A020", agent.ReferenceData["Agent_Code"]);
             Assert.AreEqual("John", agent.ReferenceData["Agent_Name"]);
@@ -560,7 +560,7 @@ public void Test_MSSQL_ExecuteTransaction_DML_Multiple_Queries()
             result = dbContext.ExecuteTransaction(statements);
             Assert.IsTrue(result);
             data = dbContext.FetchData(verifyDMLExecution);
-            Assert.IsTrue(data.Count == 0);
+            Assert.AreEqual(0, data.Count);
         }
 
         [TestMethod]
@@ -584,7 +584,7 @@ public void Test_MSSQL_ExecuteTransaction_Incomplete_Transaction_Rollback_On_Err
             var result = dbContext.ExecuteTransaction(statements);
             Assert.IsFalse(result);
             var data = dbContext.FetchData(verifyDMLExecution);
-            Assert.IsTrue(data.Count == 0);
+            Assert.AreEqual(0, data.Count);
         }
 
         [TestMethod]