diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml index 869d942..30f8ab0 100644 --- a/.github/workflows/publish.yaml +++ b/.github/workflows/publish.yaml @@ -15,7 +15,7 @@ jobs: runs-on: ubuntu-latest env: - CS_PROJECT_PATH: 'CSM Foundation Core/CSM Foundation Core.csproj' + CS_PROJECT_PATH: 'csharp_extension/CSharp Extension/CSharp Extension.csproj' steps: - name: 🔄 Checkout repo diff --git a/.github/workflows/run_unit_tests.yaml b/.github/workflows/run_unit_tests.yaml index 9b8c63b..215d263 100644 --- a/.github/workflows/run_unit_tests.yaml +++ b/.github/workflows/run_unit_tests.yaml @@ -33,12 +33,15 @@ jobs: ${{ runner.os }}-nuget- - name: Restore dependencies + working-directory: csharp_extension run: dotnet restore - name: Build solution + working-directory: csharp_extension run: | dotnet build --no-restore --configuration Release - name: Run tests + working-directory: csharp_extension run: | dotnet test --no-build --configuration Release --verbosity normal diff --git a/.github/workflows/version_update_check.yaml b/.github/workflows/version_update_check.yaml index 4e08d6a..63796ee 100644 --- a/.github/workflows/version_update_check.yaml +++ b/.github/workflows/version_update_check.yaml @@ -19,7 +19,7 @@ jobs: - name: Define project path id: config run: | - echo 'project_path="CSM Foundation Core/CSM Foundation Core.csproj"' >> $GITHUB_OUTPUT + echo 'project_path="csharp_extension/CSharp Extension/CSharp Extension.csproj"' >> $GITHUB_OUTPUT - name: Get version from PR branch id: pr_version diff --git a/.markdownlint.json b/.markdownlint.json new file mode 100644 index 0000000..e76b7d9 --- /dev/null +++ b/.markdownlint.json @@ -0,0 +1,6 @@ +{ + "line-length": false, + "MD024": { + "siblings_only": true + } +} \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index ca4406e..0000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,77 +0,0 @@ -# CSM Foundation Core CHANGELOG - -## [1.2.3] - 27.08-2025 - -### Added - -#### [SystemUtils] - -- Added a new method (GetEnv) that gets and returns the current system runtime environment scope. - -### Fixed - -### Changed - -#### Dependencies - -| Package | Previous Version | New Version | -|:----------------------------------------|:----------------:|:---------------:| -| | | | - -### Removed - -## [1.2.2] - 13.08-2025 - -### Added - -- [XSystem] a generic base CSM framework exception for the integrated exception management. - -### Fixed - -### Changed - -#### Dependencies - -| Package | Previous Version | New Version | -|:----------------------------------------|:----------------:|:---------------:| -| | | | - -### Removed - -- [IException] interface "subject" property got removed to use native .Net Excetion class Message property. - -## [1.2.1] - 13.08-2025 - -### Added - -- [SystemUtils] class that handles easier the way that env vars can be handled. - -### Fixed - -### Changed - -#### Dependencies - -| Package | Previous Version | New Version | -|:----------------------------------------|:----------------:|:---------------:| -| | | | - -### Removed - -## [1.1.1] - 06.08-2025 - -### Added - -- [ConsoleUtils] class was added to handle better console printing information. - -### Fixed - -### Changed - -#### Dependencies - -| Package | Previous Version | New Version | -|:----------------------------------------|:----------------:|:---------------:| -| | | | - -### Removed diff --git a/README.md b/README.md index 271e4fb..7c5dd09 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,13 @@ -# csm_foundation_core -A .Net package to handle core utilities and tools for CSM Solutions development, improving development experience and standards. +# *CSharp Extension* + +A repository for a framweork extension package. Framweork extensions are CSM shaped utilities and tools for frameworks and languages used during development. + +[Changelog](./csharp_extension/CHANGELOG.md) + +## **Installation** + +> dotnet nuget add source --name "github" --username {*GITHUB.USR*} --password {*GITHUB.PAT*} "" + +* GITHUB.USR: It's your github user account. + +* GITHUB.PAT: It's a generated personal access token, go to *Settings* > *Developer Settings* > *Personal access tokens*, create a **Classic** type access token and provide at minimum **Read:Packages** permission. diff --git a/.editorconfig b/csharp_extension/.editorconfig similarity index 100% rename from .editorconfig rename to csharp_extension/.editorconfig diff --git a/.gitignore b/csharp_extension/.gitignore similarity index 100% rename from .gitignore rename to csharp_extension/.gitignore diff --git a/csharp_extension/CHANGELOG.md b/csharp_extension/CHANGELOG.md new file mode 100644 index 0000000..c80090f --- /dev/null +++ b/csharp_extension/CHANGELOG.md @@ -0,0 +1,105 @@ +# *CSharp Extension* + +Here you will be able to see and identify changes along each package delivered version. + +## **[1.2.4] (30.09-2026)** + +### **Enhancements** + +Content that were added. + +- Added [ScalarValues] enumerator to handle specific dynamic typing operations on business entities. + +### **Improvements** + +Improvements made on already existing content. + +- Organizeed structure along errors, common and abstractions on their specific scope. + +## **[1.2.3] (06.08-2025)** + +### **Enhancements** + +Content that were added. + +- [SystemUtils] Added a new method (GetEnv) that gets and returns the current system runtime environment scope. + +### **Improvements** + +Improvements made on already existing content. + +### **Patches** + +Fixes for bugs or problems detected. + +### **Upgrades** + +| Package | Old Version | New Version | Comments | +|:----------------------------------------|:----------------:|:---------------:| :------- | +| | | | | + +## **[1.2.2] (06.08-2025)** + +### **Enhancements** + +Content that were added. + +- [XSystem] a generic base CSM framework exception for the integrated exception management. + +### **Improvements** + +Improvements made on already existing content. + +### **Patches** + +Fixes for bugs or problems detected. + +### **Upgrades** + +| Package | Old Version | New Version | Comments | +|:----------------------------------------|:----------------:|:---------------:| :------- | +| | | | | + +## **[1.2.1] (06.08-2025)** + +### **Enhancements** + +Content that were added. + +- [SystemUtils] class that handles easier the way that env vars can be handled. + +### **Improvements** + +Improvements made on already existing content. + +### **Patches** + +Fixes for bugs or problems detected. + +### **Upgrades** + +| Package | Old Version | New Version | Comments | +|:----------------------------------------|:----------------:|:---------------:| :------- | +| | | | | + +## **[1.1.1] (06.08-2025)** + +### **Enhancements** + +Content that were added. + +- [ConsoleUtils] class was added to handle better console printing information. + +### **Improvements** + +Improvements made on already existing content. + +### **Patches** + +Fixes for bugs or problems detected. + +### **Upgrades** + +| Package | Old Version | New Version | Comments | +|:----------------------------------------|:----------------:|:---------------:| :------- | +| | | | | diff --git a/CSM Foundation Core.sln b/csharp_extension/CSharp Extension.sln similarity index 59% rename from CSM Foundation Core.sln rename to csharp_extension/CSharp Extension.sln index 01bb2e7..0a5aa5f 100644 --- a/CSM Foundation Core.sln +++ b/csharp_extension/CSharp Extension.sln @@ -3,15 +3,15 @@ Microsoft Visual Studio Solution File, Format Version 12.00 # Visual Studio Version 18 VisualStudioVersion = 18.0.11222.15 MinimumVisualStudioVersion = 10.0.40219.1 -Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CSM Foundation Core", "CSM Foundation Core\CSM Foundation Core.csproj", "{E39161C8-353E-40B7-B1E0-ED3E17DCC51F}" -EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{8EC462FD-D22E-90A8-E5CE-7E832BA40C5D}" ProjectSection(SolutionItems) = preProject .editorconfig = .editorconfig .gitignore = .gitignore EndProjectSection EndProject -Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Unit Tests", "CSM Foundation Core.UnitTests\Unit Tests.csproj", "{A64FDEEE-0D9E-4311-A8F1-92F389F0285D}" +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CSharp Extension", "CSharp Extension\CSharp Extension.csproj", "{C58A7E28-31DC-ACB9-135E-48E7BF59E92F}" +EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Unit Tests", "Unit Tests\Unit Tests.csproj", "{CBAAFF94-19D9-CA27-EB09-AC83990DFBC8}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution @@ -19,14 +19,14 @@ Global Release|Any CPU = Release|Any CPU EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution - {E39161C8-353E-40B7-B1E0-ED3E17DCC51F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU - {E39161C8-353E-40B7-B1E0-ED3E17DCC51F}.Debug|Any CPU.Build.0 = Debug|Any CPU - {E39161C8-353E-40B7-B1E0-ED3E17DCC51F}.Release|Any CPU.ActiveCfg = Release|Any CPU - {E39161C8-353E-40B7-B1E0-ED3E17DCC51F}.Release|Any CPU.Build.0 = Release|Any CPU - {A64FDEEE-0D9E-4311-A8F1-92F389F0285D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU - {A64FDEEE-0D9E-4311-A8F1-92F389F0285D}.Debug|Any CPU.Build.0 = Debug|Any CPU - {A64FDEEE-0D9E-4311-A8F1-92F389F0285D}.Release|Any CPU.ActiveCfg = Release|Any CPU - {A64FDEEE-0D9E-4311-A8F1-92F389F0285D}.Release|Any CPU.Build.0 = Release|Any CPU + {C58A7E28-31DC-ACB9-135E-48E7BF59E92F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {C58A7E28-31DC-ACB9-135E-48E7BF59E92F}.Debug|Any CPU.Build.0 = Debug|Any CPU + {C58A7E28-31DC-ACB9-135E-48E7BF59E92F}.Release|Any CPU.ActiveCfg = Release|Any CPU + {C58A7E28-31DC-ACB9-135E-48E7BF59E92F}.Release|Any CPU.Build.0 = Release|Any CPU + {CBAAFF94-19D9-CA27-EB09-AC83990DFBC8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {CBAAFF94-19D9-CA27-EB09-AC83990DFBC8}.Debug|Any CPU.Build.0 = Debug|Any CPU + {CBAAFF94-19D9-CA27-EB09-AC83990DFBC8}.Release|Any CPU.ActiveCfg = Release|Any CPU + {CBAAFF94-19D9-CA27-EB09-AC83990DFBC8}.Release|Any CPU.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE diff --git a/CSM Foundation Core/CHANGELOG.md b/csharp_extension/CSharp Extension/CHANGELOG.md similarity index 100% rename from CSM Foundation Core/CHANGELOG.md rename to csharp_extension/CSharp Extension/CHANGELOG.md diff --git a/CSM Foundation Core/CSM Foundation Core.csproj b/csharp_extension/CSharp Extension/CSharp Extension.csproj similarity index 72% rename from CSM Foundation Core/CSM Foundation Core.csproj rename to csharp_extension/CSharp Extension/CSharp Extension.csproj index 7cb5de5..6a041b4 100644 --- a/CSM Foundation Core/CSM Foundation Core.csproj +++ b/csharp_extension/CSharp Extension/CSharp Extension.csproj @@ -2,12 +2,12 @@ net8.0 - CSM_Foundation_Core - CSM.Foundation.Core - 4.0.0 + CSharp_Extension + csm.extension + 1.2.4 Renato Urrea Cosmos (CSM) - https://github.com/Cosmos-CSM/csm_foundation_core + https://github.com/Cosmos-CSM/fe_csharp enable enable true diff --git a/CSM Foundation Core/Abstractions/Bases/ObjectBase.cs b/csharp_extension/CSharp Extension/Common/Abstractions/Bases/ObjectBase.cs similarity index 98% rename from CSM Foundation Core/Abstractions/Bases/ObjectBase.cs rename to csharp_extension/CSharp Extension/Common/Abstractions/Bases/ObjectBase.cs index 2635ed1..90847fd 100644 --- a/CSM Foundation Core/Abstractions/Bases/ObjectBase.cs +++ b/csharp_extension/CSharp Extension/Common/Abstractions/Bases/ObjectBase.cs @@ -2,7 +2,7 @@ using System.Text.Json; using System.Text.Json.Serialization; -namespace CSM_Foundation_Core.Abstractions.Bases; +namespace CSM_Foundation_Core.Common.Abstractions.Bases; /// /// Represents an inheritance link between datasource objects diff --git a/CSM Foundation Core/Abstractions/Interfaces/IDisposer.cs b/csharp_extension/CSharp Extension/Common/Abstractions/Interfaces/IDisposer.cs similarity index 95% rename from CSM Foundation Core/Abstractions/Interfaces/IDisposer.cs rename to csharp_extension/CSharp Extension/Common/Abstractions/Interfaces/IDisposer.cs index bc4d384..0861d96 100644 --- a/CSM Foundation Core/Abstractions/Interfaces/IDisposer.cs +++ b/csharp_extension/CSharp Extension/Common/Abstractions/Interfaces/IDisposer.cs @@ -1,4 +1,4 @@ -namespace CSM_Foundation_Core.Abstractions.Interfaces; +namespace CSM_Foundation_Core.Common.Abstractions.Interfaces; /// /// Represents a disposition manager wich stores objects in their context to be disposed at the end of a process. diff --git a/csharp_extension/CSharp Extension/Common/Enums/ScalarValues.cs b/csharp_extension/CSharp Extension/Common/Enums/ScalarValues.cs new file mode 100644 index 0000000..ce3f823 --- /dev/null +++ b/csharp_extension/CSharp Extension/Common/Enums/ScalarValues.cs @@ -0,0 +1,28 @@ +namespace CSM_Foundation_Core.Common.Enums; + + +/// +/// Represents scalar valuees for operations. +/// +public enum ScalarValues { + + /// + /// Double precision floating point number. + /// + DOUBLE, + + /// + /// Integer number. + /// + INT, + + /// + /// String value. + /// + STRING, + + /// + /// Boolean value. + /// + BOOL, +} diff --git a/CSM Foundation Core/Core/Extensions/DateTimeExtensions.cs b/csharp_extension/CSharp Extension/Common/Extensions/DateTimeExtensions.cs similarity index 100% rename from CSM Foundation Core/Core/Extensions/DateTimeExtensions.cs rename to csharp_extension/CSharp Extension/Common/Extensions/DateTimeExtensions.cs diff --git a/CSM Foundation Core/Core/Extensions/EnumerableExtension.cs b/csharp_extension/CSharp Extension/Common/Extensions/EnumerableExtension.cs similarity index 100% rename from CSM Foundation Core/Core/Extensions/EnumerableExtension.cs rename to csharp_extension/CSharp Extension/Common/Extensions/EnumerableExtension.cs diff --git a/CSM Foundation Core/Core/Utils/ConsoleUtils.cs b/csharp_extension/CSharp Extension/Common/Utils/ConsoleUtils.cs similarity index 100% rename from CSM Foundation Core/Core/Utils/ConsoleUtils.cs rename to csharp_extension/CSharp Extension/Common/Utils/ConsoleUtils.cs diff --git a/CSM Foundation Core/Core/Utils/FileUtils.cs b/csharp_extension/CSharp Extension/Common/Utils/FileUtils.cs similarity index 100% rename from CSM Foundation Core/Core/Utils/FileUtils.cs rename to csharp_extension/CSharp Extension/Common/Utils/FileUtils.cs diff --git a/CSM Foundation Core/Core/Utils/ObjectUtils.cs b/csharp_extension/CSharp Extension/Common/Utils/ObjectUtils.cs similarity index 100% rename from CSM Foundation Core/Core/Utils/ObjectUtils.cs rename to csharp_extension/CSharp Extension/Common/Utils/ObjectUtils.cs diff --git a/CSM Foundation Core/Core/Utils/RandomUtils.cs b/csharp_extension/CSharp Extension/Common/Utils/RandomUtils.cs similarity index 100% rename from CSM Foundation Core/Core/Utils/RandomUtils.cs rename to csharp_extension/CSharp Extension/Common/Utils/RandomUtils.cs diff --git a/CSM Foundation Core/Core/Utils/SystemUtils.cs b/csharp_extension/CSharp Extension/Common/Utils/SystemUtils.cs similarity index 100% rename from CSM Foundation Core/Core/Utils/SystemUtils.cs rename to csharp_extension/CSharp Extension/Common/Utils/SystemUtils.cs diff --git a/CSM Foundation Core/Constants.cs b/csharp_extension/CSharp Extension/Constants.cs similarity index 100% rename from CSM Foundation Core/Constants.cs rename to csharp_extension/CSharp Extension/Constants.cs diff --git a/CSM Foundation Core/Convertion/Abstractions/Bases/ConverterBase.cs b/csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterBase.cs similarity index 98% rename from CSM Foundation Core/Convertion/Abstractions/Bases/ConverterBase.cs rename to csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterBase.cs index 98a7ead..3fd46f1 100644 --- a/CSM Foundation Core/Convertion/Abstractions/Bases/ConverterBase.cs +++ b/csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterBase.cs @@ -2,7 +2,6 @@ using System.Text.Json.Serialization; using CSM_Foundation_Core.Convertion.Abstractions.Interfaces; -using CSM_Foundation_Core.Core.Errors; namespace CSM_Foundation_Core.Convertion.Abstractions.Bases; diff --git a/CSM Foundation Core/Core/Errors/ConverterBaseError.cs b/csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterBaseError.cs similarity index 91% rename from CSM Foundation Core/Core/Errors/ConverterBaseError.cs rename to csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterBaseError.cs index 747db29..72066a2 100644 --- a/CSM Foundation Core/Core/Errors/ConverterBaseError.cs +++ b/csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterBaseError.cs @@ -1,8 +1,7 @@ -using CSM_Foundation_Core.Convertion.Abstractions.Bases; -using CSM_Foundation_Core.Convertion.Abstractions.Interfaces; +using CSM_Foundation_Core.Convertion.Abstractions.Interfaces; using CSM_Foundation_Core.Errors.Abstractions.Bases; -namespace CSM_Foundation_Core.Core.Errors; +namespace CSM_Foundation_Core.Convertion.Abstractions.Bases; /// /// Exception situations enumerator. diff --git a/CSM Foundation Core/Convertion/Abstractions/Bases/ConverterVariantBase.cs b/csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterVariantBase.cs similarity index 100% rename from CSM Foundation Core/Convertion/Abstractions/Bases/ConverterVariantBase.cs rename to csharp_extension/CSharp Extension/Convertion/Abstractions/Bases/ConverterVariantBase.cs diff --git a/CSM Foundation Core/Convertion/Abstractions/Interfaces/IConverter.cs b/csharp_extension/CSharp Extension/Convertion/Abstractions/Interfaces/IConverter.cs similarity index 100% rename from CSM Foundation Core/Convertion/Abstractions/Interfaces/IConverter.cs rename to csharp_extension/CSharp Extension/Convertion/Abstractions/Interfaces/IConverter.cs diff --git a/CSM Foundation Core/Convertion/Abstractions/Interfaces/IConverterVariant.cs b/csharp_extension/CSharp Extension/Convertion/Abstractions/Interfaces/IConverterVariant.cs similarity index 100% rename from CSM Foundation Core/Convertion/Abstractions/Interfaces/IConverterVariant.cs rename to csharp_extension/CSharp Extension/Convertion/Abstractions/Interfaces/IConverterVariant.cs diff --git a/CSM Foundation Core/Errors/Abstractions/Bases/ErrorBase.cs b/csharp_extension/CSharp Extension/Errors/Abstractions/Bases/ErrorBase.cs similarity index 100% rename from CSM Foundation Core/Errors/Abstractions/Bases/ErrorBase.cs rename to csharp_extension/CSharp Extension/Errors/Abstractions/Bases/ErrorBase.cs diff --git a/CSM Foundation Core/Errors/Abstractions/Interfaces/IError.cs b/csharp_extension/CSharp Extension/Errors/Abstractions/Interfaces/IError.cs similarity index 100% rename from CSM Foundation Core/Errors/Abstractions/Interfaces/IError.cs rename to csharp_extension/CSharp Extension/Errors/Abstractions/Interfaces/IError.cs diff --git a/CSM Foundation Core/Errors/Models/ErrorFeedback.cs b/csharp_extension/CSharp Extension/Errors/Models/ErrorFeedback.cs similarity index 100% rename from CSM Foundation Core/Errors/Models/ErrorFeedback.cs rename to csharp_extension/CSharp Extension/Errors/Models/ErrorFeedback.cs diff --git a/CSM Foundation Core/Core/Errors/SystemError.cs b/csharp_extension/CSharp Extension/Errors/SystemError.cs similarity index 96% rename from CSM Foundation Core/Core/Errors/SystemError.cs rename to csharp_extension/CSharp Extension/Errors/SystemError.cs index 87ef5d4..ee7ee75 100644 --- a/CSM Foundation Core/Core/Errors/SystemError.cs +++ b/csharp_extension/CSharp Extension/Errors/SystemError.cs @@ -1,7 +1,7 @@ using CSM_Foundation_Core.Errors.Abstractions.Bases; using CSM_Foundation_Core.Errors.Models; -namespace CSM_Foundation_Core.Core.Errors; +namespace CSM_Foundation_Core.Errors; /// diff --git a/CSM Foundation Core.UnitTests/Unit Tests.csproj b/csharp_extension/Unit Tests/Unit Tests.csproj similarity index 89% rename from CSM Foundation Core.UnitTests/Unit Tests.csproj rename to csharp_extension/Unit Tests/Unit Tests.csproj index 777c6cd..06bdefc 100644 --- a/CSM Foundation Core.UnitTests/Unit Tests.csproj +++ b/csharp_extension/Unit Tests/Unit Tests.csproj @@ -16,7 +16,7 @@ - + diff --git a/CSM Foundation Core.UnitTests/Utils/SystemUtils_UnitTests.cs b/csharp_extension/Unit Tests/Utils/SystemUtils_UnitTests.cs similarity index 100% rename from CSM Foundation Core.UnitTests/Utils/SystemUtils_UnitTests.cs rename to csharp_extension/Unit Tests/Utils/SystemUtils_UnitTests.cs