MaksIT.Core 1.1.0

MaksIT.Core

MaksIT.Core is a collection of helper methods and extensions for .NET projects, designed to simplify common tasks and improve code readability. The library includes extensions for Guid, string, Object, security methods for password hashing, and a base class for creating enumeration types.

Table of Contents

• Installation
• Usage
  • Enumeration
  • Guid Extensions
  • Object Extensions
  • String Extensions
  • Password Hasher
  • DataTable Extensions
  • DateTime Extensions
  • JWT Token Generation and Validation
• Available Methods
  • Enumeration Methods
  • Guid Methods
  • Object Methods
  • String Methods
  • Security Methods
  • DataTable Methods
  • DateTime Methods
  • JWT Methods
• Contributing
• License
• Contact

Installation

To install MaksIT.Core, add the package to your project via NuGet:

dotnet add package MaksIT.Core

Or manually add it to your .csproj file:

<PackageReference Include="MaksIT.Core" Version="1.0.0" />

Usage

Enumeration

The Enumeration base class provides a way to create strongly-typed enums in C#. This is useful for scenarios where you need more functionality than the default enum type.

Example:

public class Status : Enumeration
{
    public static readonly Status Active = new Status(1, "Active");
    public static readonly Status Inactive = new Status(2, "Inactive");

    private Status(int id, string name) : base(id, name) { }
}

// Usage
var activeStatus = Status.FromValue<Status>(1);
Console.WriteLine(activeStatus.Name); // Output: Active

Guid Extensions

The GuidExtensions class contains extensions for working with Guid types.

Example:

Guid guid = Guid.NewGuid();
Guid? nullableGuid = guid.ToNullable();

Object Extensions

The ObjectExtensions class provides extensions for working with objects.

Example:

var person = new { Name = "John", Age = 30 };
string json = person.ToJson();
Console.WriteLine(json); // Output: {"name":"John","age":30}

String Extensions

The StringExtensions class provides a variety of useful string manipulation methods.

Example:

string text = "Hello World";
bool isLike = text.Like("Hello*"); // SQL-like matching
Console.WriteLine(isLike); // Output: True

Password Hasher

The PasswordHasher class provides methods for creating salted hashes and verifying passwords using PBKDF2 with SHA-256. This is essential for securely storing and validating user passwords.

Example:

using MaksIT.Core.Security;

string password = "MySecurePassword123!";

// Hash the password
if (PasswordHasher.TryHashPassword(password, out string? hashedPassword))
{
    Console.WriteLine("Hashed Password: " + hashedPassword);
    // Store hashedPassword securely, e.g., in a database
}
else
{
    Console.WriteLine("Failed to hash password.");
}

// Later, when verifying the password during login
bool isValid = PasswordHasher.VerifyPassword(hashedPassword, password);
Console.WriteLine("Password is valid: " + isValid); // Output: True

DataTable Extensions

The DataTableExtensions class provides useful extensions for working with DataTable objects.

Example:

DataTable dt1 = new DataTable();
dt1.Columns.Add("Id");
dt1.Columns.Add("Name");
dt1.Rows.Add("1", "Alice");
dt1.Rows.Add("2", "Bob");

DataTable dt2 = new DataTable();
dt2.Columns.Add("Id");
dt2.Columns.Add("Name");
dt2.Rows.Add("1", "Alice");
dt2.Rows.Add("3", "Charlie");

int duplicateCount = dt1.DuplicatesCount(dt2); // Count duplicates
Console.WriteLine(duplicateCount); // Output: 1

DataTable distinctRecords = dt1.DistinctRecords(new[] { "Id", "Name" }); // Get distinct records
Console.WriteLine(distinctRecords.Rows.Count); // Output: 2

DateTime Extensions

The DateTimeExtensions class provides a variety of helpful methods for working with DateTime objects, such as adding workdays, finding the end of the month, or determining if a date is a holiday.

Example:

DateTime startDate = new DateTime(2023, 12, 22); // Friday
IHolidayCalendar holidayCalendar = new TestHolidayCalendar(new[] { new DateTime(2023, 12, 25) });

DateTime resultDate = startDate.AddWorkdays(5, holidayCalendar); // Skip weekends and holidays
Console.WriteLine(resultDate); // Output: 2023-12-29

DateTime nextThursday = DateTime.Now.NextWeekday(DayOfWeek.Thursday);
Console.WriteLine(nextThursday); // Output: Date of the next Thursday

JWT Token Generation and Validation

The JwtGenerator class provides methods for generating and validating JWT tokens, as well as generating refresh tokens. This is useful for implementing secure authentication and authorization mechanisms in your applications.

Generate a JWT Token

using MaksIT.Core.Security;

string secret = "your_secret_key";
string issuer = "your_issuer";
string audience = "your_audience";
double expiration = 30; // Token expiration in minutes
string username = "user123";
List<string> roles = new List<string> { "Admin", "User" };

(string token, JWTTokenClaims claims) = JwtGenerator.GenerateToken(secret, issuer, audience, expiration, username, roles);
Console.WriteLine("Generated JWT Token: " + token);

Validate a JWT Token

string tokenToValidate = "your_jwt_token";

JWTTokenClaims? claims = JwtGenerator.ValidateToken(secret, issuer, audience, tokenToValidate);
if (claims != null)
{
    Console.WriteLine($"Username: {claims.Username}");
    Console.WriteLine("Roles: " + string.Join(", ", claims.Roles));
}
else
{
    Console.WriteLine("Invalid token.");
}

Generate a Refresh Token

string refreshToken = JwtGenerator.GenerateRefreshToken();
Console.WriteLine("Generated Refresh Token: " + refreshToken);

Available Methods

Enumeration Methods

• GetAll<T>(): Retrieves all static fields of a given type T that derive from Enumeration.
• Equals(object? obj): Determines whether the specified object is equal to the current object.
• GetHashCode(): Returns the hash code for the current object.
• AbsoluteDifference(Enumeration firstValue, Enumeration secondValue): Computes the absolute difference between two enumeration values.
• FromValue<T>(int value): Retrieves an instance of type T from its integer value.
• FromDisplayName<T>(string displayName): Retrieves an instance of type T from its display name.
• CompareTo(object? other): Compares the current instance with another object of the same type.

Guid Methods

• ToNullable(this Guid id): Converts a Guid to a nullable Guid?. Returns null if the Guid is Guid.Empty.

Object Methods

• ToJson<T>(this T? obj): Converts an object to a JSON string using default serialization options.
• ToJson<T>(this T? obj, List<JsonConverter>? converters): Converts an object to a JSON string using custom converters.

String Methods

• Like(this string? text, string? wildcardedText): Determines if a string matches a given wildcard pattern (SQL LIKE).
• Left(this string s, int count): Returns the left substring of the specified length.
• Right(this string s, int count): Returns the right substring of the specified length.
• Mid(this string s, int index, int count): Returns a substring starting from the specified index with the specified length.
• ToInteger(this string s): Converts a string to an integer, returning zero if conversion fails.
• IsInteger(this string s): Determines whether the string represents an integer.
• Prepend(this StringBuilder sb, string content): Prepends content to the beginning of a StringBuilder.
• ToEnum<T>(this string input): Converts a string to an enum value of type T.
• ToNullableEnum<T>(this string input): Converts a string to a nullable enum value of type T.
• ToNull(this string s): Returns null if the string is empty or whitespace.
• ToLong(this string s): Converts a string to a long, returning a hash code if conversion fails.
• ToNullableLong(this string s): Converts a string to a nullable long, returning null if conversion fails.
• ToInt(this string s): Converts a string to an int, returning a hash code if conversion fails.
• ToNullableInt(this string s): Converts a string to a nullable int, returning null if conversion fails.
• ToDecimal(this string s): Converts a string to a decimal, returning a hash code if conversion fails.
• ToNullableDecimal(this string s): Converts a string to a nullable decimal, returning null if conversion fails.
• ToDouble(this string s): Converts a string to a double, returning a hash code if conversion fails.
• ToNullableDouble(this string s): Converts a string to a nullable double, returning null if conversion fails.
• ToDate(this string s, string[] formats): Converts a string to a DateTime object using specified formats.
• ToDate(this string s): Converts a string to a DateTime object using the default format.
• ToNullableDate(this string s): Converts a string to a nullable DateTime object using the default format.
• ToNullableDate(this string s, string[] formats): Converts a string to a nullable DateTime object using specified formats.
• ToBool(this string s): Converts a string to a boolean.
• ToNullableBool(this string s): Converts a string to a nullable boolean.
• ToGuid(this string text): Converts a string to a Guid.
• ToNullableGuid(this string s): Converts a string to a nullable Guid.
• StringSplit(this string s, char c):

Splits a string by a specified character and trims each resulting element.

• ToTitle(this string s): Converts the first character of the string to uppercase.
• ExtractUrls(this string s): Extracts all URLs from a string.
• Format(this string s, params object[] args): Formats a string using specified arguments.
• Excerpt(this string s, int length = 60): Truncates a string to a specified length, adding ellipses if necessary.
• ToObject<T>(this string s): Deserializes a JSON string into an object of type T.
• ToObject<T>(this string s, List<JsonConverter> converters): Deserializes a JSON string into an object of type T using custom converters.
• IsValidEmail(this string? s): Validates whether the string is a valid email format.
• HtmlToPlainText(this string htmlCode): Converts HTML content to plain text.
• ToCamelCase(this string input): Converts a string to camel case.

DataTable Methods

• DuplicatesCount(this DataTable dt1, DataTable dt2): Counts the number of duplicate rows between two DataTable objects.
• DistinctRecords(this DataTable dt, string[] columns): Returns distinct records based on the specified columns.

DateTime Methods

• AddWorkdays(this DateTime date, int days, IHolidayCalendar holidayCalendar): Adds a specified number of workdays to a date, skipping weekends and holidays.
• NextWeekday(this DateTime start, DayOfWeek day): Finds the next specified weekday from the given date.
• IsEndOfMonth(this DateTime date): Checks if the date is the end of the month.
• IsSameMonth(this DateTime date, DateTime targetDate): Checks if two dates are in the same month and year.
• GetDifferenceInYears(this DateTime startDate, DateTime endDate): Returns the difference in years between two dates.

JWT Methods

• GenerateToken: Generates jwt-token-generation-and-validationa JWT token.
• ValidateToken: Validates a JWT token and extracts claims.
• GenerateRefreshToken: Generates a secure refresh token.

Contributing

Contributions to this project are welcome! Please fork the repository and submit a pull request with your changes. If you encounter any issues or have feature requests, feel free to open an issue on GitHub.

License

This project is licensed under the MIT License. See the full license text below.

MIT License

MIT License

Copyright (c) 2024 Maksym Sadovnychyy (MAKS-IT)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Contact

For any questions or inquiries, please reach out via GitHub or email.