Merge pull request #22 from I-RzR-I/feature/AddSmallImprovements

Fix enums extensions. Add new methods in TExtensions.

.gitignore

@@ -270,4 +270,6 @@ Report/
 coverage.*
 
 # Certificates
-*.pfx
+*.pfx
+
+*.ncrunchsolution

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2023 RzR
+Copyright (c) 2022-2024 RzR
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

docs/CHANGELOG.md

@@ -90,4 +90,8 @@
 ### **v.1.0.13.8399** 
 -> Add excel column name generator `GetExcelColumnName`.<br />
 -> Adjust method modifier for `GetDuplicates`.<br />
--> Fix tests.
+-> Fix tests.
+
+### **v.1.0.14.6517** 
+-> Fix some enums extensions.<br />
+-> Add new methods (`AppendTo`, `GetPropertiesInfoFromSource`) in 'TExtensions'.

src/DomainCommonExtensions/CommonExtensions/TExtensions.cs

@@ -18,12 +18,17 @@
 
 using DomainCommonExtensions.DataTypeExtensions;
 using System;
+using System.Collections.Generic;
 using System.IO;
+using System.Linq;
+using System.Reflection;
 using System.Runtime.Serialization;
 using System.Runtime.Serialization.Formatters.Binary;
 using System.Xml;
 using CodeSource;
 
+#pragma warning disable SCS0007
+
 #endregion
 
 namespace DomainCommonExtensions.CommonExtensions
@@ -144,5 +149,41 @@ public static XmlDocument SerializeToXmlDoc<T>(this T source, string rootName =
 
             return doc;
         }
+
+        ///-------------------------------------------------------------------------------------------------
+        /// <summary>A T extension method that appends to.</summary>
+        /// <remarks></remarks>
+        /// <typeparam name="T">Generic type parameter.</typeparam>
+        /// <param name="first">The first to act on.</param>
+        /// <param name="items">A variable-length parameters list containing items.</param>
+        /// <returns>A T[].</returns>
+        ///=================================================================================================
+        public static T[] AppendTo<T>(this T first, params T[] items)
+        {
+            var result = new T[items.Length + 1];
+            result[0] = first;
+            items.CopyTo(result, 1);
+
+            return result;
+        }
+
+        ///-------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     A TSource extension method that gets properties information from source.
+        /// </summary>
+        /// <remarks></remarks>
+        /// <typeparam name="TSource">Type of the source.</typeparam>
+        /// <param name="source">.</param>
+        /// <returns>The properties information from source.</returns>
+        ///=================================================================================================
+        public static IList<PropertyInfo> GetPropertiesInfoFromSource<TSource>(this TSource source) where TSource : class
+        {
+            try
+            {
+                return typeof(TSource).GetProperties()
+                    .ToList();
+            }
+            catch { return null; }
+        }
     }
 }

src/DomainCommonExtensions/DataTypeExtensions/EnumExtensions.cs

@@ -57,7 +57,7 @@ public static Dictionary<int, string> GetEnumDefinition(this Type enumType)
         /// <typeparam name="T"></typeparam>
         /// <param name="value"></param>
         /// <returns></returns>
-        public static string GetEnumMemberValue<T>(this T value) where T : struct, IConvertible
+        public static string GetEnumMemberValue<T>(this T value) where T : struct, Enum, IConvertible
         {
             var element = typeof(T).GetTypeInfo().DeclaredMembers
                 .SingleOrDefault(x => x.Name == value.ToString(CultureInfo.InvariantCulture));
@@ -73,7 +73,7 @@ public static string GetEnumMemberValue<T>(this T value) where T : struct, IConv
         /// <typeparam name="T"></typeparam>
         /// <param name="str"></param>
         /// <returns></returns>
-        public static T ToEnumMemberValue<T>(this string str)
+        public static T ToEnumMemberValue<T>(this string str) where T : struct, Enum, IConvertible
         {
             var enumType = typeof(T);
             foreach (var name in Enum.GetNames(enumType))
@@ -96,7 +96,7 @@ public static T ToEnumMemberValue<T>(this string str)
         /// <returns></returns>
         /// <typeparam name="T"></typeparam>
         /// <remarks></remarks>
-        public static int ToInt<T>(this T source) where T : IConvertible
+        public static int ToInt<T>(this T source) where T : Enum, IConvertible
         {
             if (!typeof(T).IsEnum)
                 throw new ArgumentException("T must be an enumerated type");
@@ -111,7 +111,7 @@ public static int ToInt<T>(this T source) where T : IConvertible
         /// <returns></returns>
         /// <typeparam name="T"></typeparam>
         /// <remarks></remarks>
-        public static string ToString<T>(this T source) where T : IConvertible
+        public static string ToString<T>(this T source) where T : Enum, IConvertible
         {
             if (!typeof(T).IsEnum)
                 throw new ArgumentException("T must be an enumerated type");
@@ -145,7 +145,7 @@ public static string GetDescription(this Enum value, bool returnEmpty = false)
         /// <returns></returns>
         /// <typeparam name="T"></typeparam>
         /// <remarks></remarks>
-        public static T GetEnumValue<T>(this string str) where T : struct, IConvertible
+        public static T GetEnumValue<T>(this string str) where T : struct, Enum, IConvertible
         {
             if (!typeof(T).IsEnum) throw new Exception("T must be an Enumeration type.");
             var val = ((T[])Enum.GetValues(typeof(T)))[0];
@@ -167,7 +167,7 @@ public static T GetEnumValue<T>(this string str) where T : struct, IConvertible
         /// <returns></returns>
         /// <typeparam name="T"></typeparam>
         /// <remarks></remarks>
-        public static T GetEnumValue<T>(this int intValue) where T : struct, IConvertible
+        public static T GetEnumValue<T>(this int intValue) where T : struct, Enum, IConvertible
         {
             if (!typeof(T).IsEnum) throw new Exception("T must be an Enumeration type.");
             var val = ((T[])Enum.GetValues(typeof(T)))[0];

src/shared/GeneralAssemblyInfo.cs

@@ -29,7 +29,7 @@
 
 [assembly: AssemblyCompany("RzR ®")]
 [assembly: AssemblyProduct("Common data type extensions")]
-[assembly: AssemblyCopyright("Copyright © 2022-2023 RzR All rights reserved.")]
+[assembly: AssemblyCopyright("Copyright © 2022-2024 RzR All rights reserved.")]
 [assembly: AssemblyTrademark("® RzR™")]
 [assembly:
     AssemblyDescription(
@@ -47,6 +47,6 @@
 [assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.MainAssembly)]
 #endif
 
-[assembly: AssemblyVersion("1.0.13.8399")]
-[assembly: AssemblyFileVersion("1.0.13.8399")]
-[assembly: AssemblyInformationalVersion("1.0.13.8399")]
+[assembly: AssemblyVersion("1.0.14.6517")]
+[assembly: AssemblyFileVersion("1.0.14.6517")]
+[assembly: AssemblyInformationalVersion("1.0.14.6517")]