Encamina.Enmarcha.Core 8.1.3-preview-07

Core

Core is a project that primarily contains cross-cutting utilities that can be used in a wide variety of projects. Among them, there are utilities related to Uris, Strings, Attributes, JSON handling, and more.

Setup

Nuget package

First, install NuGet. Then, install Encamina.Enmarcha.Core from the package manager console:

PM> Install-Package Encamina.Enmarcha.Core

.NET CLI:

First, install .NET CLI. Then, install Encamina.Enmarcha.Core from the .NET CLI:

dotnet add package Encamina.Enmarcha.Core

How to use

Below are some of the most important utilities. It is not a complete list of all functionalities.

JsonUtils

JsonUtils contains a collection of static methods that provide utilities for JSON handling.

string json = "{\"Name\":\"John\",\"Age\":30,\"City\":\"Valencia\"}";

var deserializedObject = JsonUtils.DeserializeAnonymousType(json, new { Name = string.Empty, Age = 0, City = string.Empty });

The above code deserializes a string into an anonymous type, eliminating the need to create a class.

SdkVersionUtils

SdkVersionUtils is an utility class for the version information of the current assembly.

var version = SdkVersionUtils.GetSdkVersion("Program SDK Version: ", Assembly.GetAssembly(typeof(Program)));
// Program SDK Version: 6.0.3-16

UriExtensions

UriExtensions is an extension methods class for handling Uris.

var uri = new Uri("https://www.enmarcha.net/");

var newUri = uri.Append("acme", "products");
// newUri => https://www.enmarcha.net/acme/products

StringExtensions

StringExtensions is an extension methods class for handling strings.

var email = "enmarcha@email.com";

var isValidEmail = email.IsValidEmail();
// true

ObjectExtensions

ObjectExtensions is an extension methods class for handling objects.

var data = new { Name = "Siul", Age = 43, City = "Adarrefnop" };

var dictionary = data.ToPropertyDictionary();
// {Name, Siul}
// {Age, 43}
// {City, Adarrefnop}

IListExtensions

IListExtensions is an extension methods class for handling IList<T>.

IList<string> values = GetValues(); // Foo, Bar
var newNewValues = new[] { "FooBar", "BarFoo" };

values.AddRange(newNewValues);
// values =>  Foo, Bar, FooBar, BarFoo

IDictionaryExtensions

IDictionaryExtensions is an extension methods class for handling IDictionary<TKey, TValue>.

IDictionary<int, string> dictionary1 = new Dictionary<int, string>() { { 1, "one" }, { 2, "two" }, };

IDictionary<int, string> dictionary2 = new Dictionary<int, string>() { { 3, "three" }, { 4, "four" }, };

dictionary1.Merge(dictionary2);
// {1, one}
// {2, two}
// {3, three}
// {4, four}

ICollectionExtensions

ICollectionExtensions is an extension methods class for handling ICollection<T>.

ICollection<string> values = GetValues(); // Foo, Bar
var newNewValues = new[] { "FooBar", "BarFoo" };

values.AddRange(newNewValues);
// values =>  Foo, Bar, FooBar, BarFoo

EnumExtensions

EnumExtensions is an extension methods class for handling Enum types.

public enum TransportType
{
    [Description("Transport by Airplane")]
    Airplane,

    [Description("Transport by Car")]
    Car,

    [Description("Transport by Train")]
    Train,

    [Description("Transport by Bus")]
    Bus,

    [Description("Transport by Bicycle")]
    Bicycle
}

// ...

var currentTransport = TransportType.Airplane;

var airplaneDescription = currentTransport.GetEnumDescription();
// airplaneDescription => Transport by Airplane

CultureInfoExtensions

CultureInfoExtensions is an extension methods class for handling CultureInfo.

var currentCulture = new CultureInfo("es-MX");
var newCulture = new CultureInfo("es");

bool matches = currentCulture.MatchesWith(newCulture);
// matches => true

UriAttribute

UriAttribute provides 'Uri' validation.

public class MyClass
{
    [Uri(AllowsNull = false)]
    public Uri Uri { get; set; }
}

There are more extension methods, classes with extension methods, attributes, among others, available.