Added filter functions

src/ZimLabs.CoreLib/ZimLabs.CoreLib/Common/FilterType.cs

@@ -0,0 +1,27 @@
+namespace ZimLabs.CoreLib.Common;
+
+/// <summary>
+/// The different filter types
+/// </summary>
+public enum FilterType
+{
+    /// <summary>
+    /// The value has to contain
+    /// </summary>
+    Contains,
+
+    /// <summary>
+    /// The value has to be equals
+    /// </summary>
+    Equals,
+
+    /// <summary>
+    /// The value has to starts with
+    /// </summary>
+    StartsWith,
+
+    /// <summary>
+    /// The value has to ends with
+    /// </summary>
+    EndsWith
+}

src/ZimLabs.CoreLib/ZimLabs.CoreLib/Core.cs

@@ -1,4 +1,6 @@
 using System.Reflection;
+using ZimLabs.CoreLib.Common;
+using ZimLabs.CoreLib.DataObjects;
 
 namespace ZimLabs.CoreLib;
 
@@ -16,4 +18,22 @@ public static string GetBaseDirPath()
         var assemblyPath = Assembly.GetExecutingAssembly().Location;
         return Path.GetDirectoryName(assemblyPath) ?? "";
     }
+
+    /// <summary>
+    /// Checks if the value matches the desired filter
+    /// </summary>
+    /// <param name="value">The value</param>
+    /// <param name="filter">The filter</param>
+    /// <returns><see langword="true"/> when the filter matches, otherwise <see langword="false"/></returns>
+    public static bool MatchFilter(string value, FilterEntry filter)
+    {
+        return filter.FilterType switch
+        {
+            FilterType.Contains => value.Contains(filter.Value, StringComparison.OrdinalIgnoreCase),
+            FilterType.Equals => value.Equals(filter.Value, StringComparison.OrdinalIgnoreCase),
+            FilterType.StartsWith => value.StartsWith(filter.Value, StringComparison.OrdinalIgnoreCase),
+            FilterType.EndsWith => value.EndsWith(filter.Value, StringComparison.OrdinalIgnoreCase),
+            _ => false
+        };
+    }
 }

src/ZimLabs.CoreLib/ZimLabs.CoreLib/DataObjects/FilterEntry.cs

@@ -0,0 +1,41 @@
+using ZimLabs.CoreLib.Common;
+
+namespace ZimLabs.CoreLib.DataObjects;
+
+/// <summary>
+/// Represents a filter entry
+/// </summary>
+public class FilterEntry
+{
+    /// <summary>
+    /// Gets or sets the value to search for
+    /// </summary>
+    public string Value { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the desired filter
+    /// </summary>
+    public FilterType FilterType { get; set; } = FilterType.Equals;
+
+    /// <summary>
+    /// Gets or sets the original value (with wildcards)
+    /// </summary>
+    public string OriginalValue { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Creates a new empty instance of the <see cref="FilterEntry"/>
+    /// </summary>
+    public FilterEntry() { }
+
+    /// <summary>
+    /// Creates a new instance of the <see cref="FilterEntry"/>
+    /// </summary>
+    /// <param name="value">The value to search for</param>
+    /// <param name="wildcard">The desired wildcard (optional)</param>
+    public FilterEntry(string value, string wildcard = "*")
+    {
+        Value = value.Replace(wildcard, ""); // Remove the wild card
+        FilterType = value.ToFilterType(wildcard);
+        OriginalValue = value;
+    }
+}

src/ZimLabs.CoreLib/ZimLabs.CoreLib/Extensions.cs

@@ -1,4 +1,7 @@
-namespace ZimLabs.CoreLib;
+using ZimLabs.CoreLib.Common;
+using ZimLabs.CoreLib.DataObjects;
+
+namespace ZimLabs.CoreLib;
 
 /// <summary>
 /// Provides several extensions
@@ -44,6 +47,49 @@ public static int ToInt(this string value, int fallback = 0)
     {
         return int.TryParse(value, out var result) ? result : fallback;
     }
+
+    /// <summary>
+    /// Gets the filter type of the specified value
+    /// </summary>
+    /// <param name="value">The value (with wildcards)</param>
+    /// <param name="wildcard">The desired wildcard (optional)</param>
+    /// <returns>The filter type</returns>
+    public static FilterType ToFilterType(this string value, string wildcard = "*")
+    {
+        var start = value.StartsWith(wildcard);
+        var end = value.EndsWith(wildcard);
+
+        return start switch
+        {
+            true when end => FilterType.Contains, // has a wildcard at the start and the end (*Value*)
+            true when !end => FilterType.EndsWith, // has a wildcard at the start (*Value)
+            false when end => FilterType.StartsWith, // has a wildcard at the end (Value*)
+            _ => FilterType.Equals // has no wildcard (Value)
+        };
+    }
+
+    /// <summary>
+    /// Converts the value into a filter entry
+    /// </summary>
+    /// <param name="value">The value (with wildcards)</param>
+    /// <param name="wildcard">The desired wildcard (optional)</param>
+    /// <returns>The filter entry</returns>
+    public static FilterEntry ToFilterEntry(this string value, string wildcard = "*")
+    {
+        return new FilterEntry(value, wildcard);
+    }
+
+    /// <summary>
+    /// Converts the list of value into a list of filter entries
+    /// </summary>
+    /// <param name="values">The list with the values (with wildcard)</param>
+    /// <param name="wildcard">The desired wildcard (optional)</param>
+    /// <returns>The list with the filter</returns>
+    public static List<FilterEntry> ToFilterList(this IEnumerable<string> values, string wildcard = "*")
+    {
+        var tmpList = values.ToList();
+        return tmpList.Any() ? tmpList.Select(s => s.ToFilterEntry(wildcard)).ToList() : new List<FilterEntry>();
+    }
     #endregion
 
     #region Numbers

src/ZimLabs.CoreLib/ZimLabs.CoreLib/ZimLabs.CoreLib.csproj

@@ -12,11 +12,11 @@
     <RepositoryUrl>https://github.com/InvaderZim85/ZimLabs.CoreLib</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     <PackageTags>helper, extensions</PackageTags>
-    <PackageReleaseNotes>Added extension to extract a custom attribute</PackageReleaseNotes>
+    <PackageReleaseNotes>Added filter functions</PackageReleaseNotes>
     <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
-    <AssemblyVersion>2.1.0</AssemblyVersion>
-    <FileVersion>2.1.0</FileVersion>
-    <Version>2.1.0</Version>
+    <AssemblyVersion>2.2.0</AssemblyVersion>
+    <FileVersion>2.2.0</FileVersion>
+    <Version>2.2.0</Version>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <GenerateDocumentationFile>True</GenerateDocumentationFile>
   </PropertyGroup>