Purlin.Community.Toolkit.Common 2.0.21

Purlin.Community.Toolkit.Common

Overview

Purlin.Community.Toolkit.Common is a C# library that provides a collection of useful helper methods, extensions, and other utilities to simplify common programming tasks. This toolkit aims to streamline the development process by offering reusable code snippets that can enhance productivity and maintain code consistency.

Features

• Helper Methods: Purlin.Community.Toolkit.Common includes a wide range of helper methods for various purposes, such as string manipulation, date/time handling, mathematical operations, and more. These methods are designed to be intuitive and efficient, saving you time and effort in your projects.

• Extensions: The toolkit comes with extension methods that enhance the functionality of existing C# types and classes. These extensions allow you to perform additional operations on familiar objects without modifying their original implementation.

• Etc: In addition to the core features, Purlin.Community.Toolkit.Common may also include other miscellaneous utilities and tools that can be useful in different scenarios.

Installation

You can easily install Purlin.Community.Toolkit.Common via NuGet Package Manager. Run the following command in the Package Manager Console:

Install-Package Purlin.Community.Toolkit.Common

Alternatively, you can use the Visual Studio NuGet Package Manager to search for and install the package.

Usage

Once installed, you can start using the toolkit in your C# projects. Simply import the necessary namespaces and access the helper methods and extensions directly.

// Example usage of extension method

using Purlin.Community.Toolkit.Common.Extensions;
using Purlin.Community.Toolkit.Common.Test.Models;

public static List<Person> Items = new()
{
    new Person { Id = 3, Name = "Alice", Age = 30 },
    new Person { Id = 1, Name = "Bob", Age = 25 },
    new Person { Id = 2, Name = "Charlie", Age = 28 }
};


public void OrderIf_ShouldReturnUnorderedCollection_WhenConditionIsFalse()
{
    // Arrange
    var mocker = new Mock<IEnumerable<Person>>();
    mocker.Setup(m => m.GetEnumerator()).Returns(Items.GetEnumerator());

    const bool condition = false;
    int KeySelector(Person item) => item.Id;

    // Act
    var result = mocker.Object.OrderIf(condition, KeySelector).ToList();

    // Assert
    Assert.Equal(3, result[0].Id);
    Assert.Equal(1, result[1].Id);
    Assert.Equal(2, result[2].Id);
}

Contributing

We welcome contributions from the community to improve and expand this toolkit. If you find any issues, have suggestions for new features, or want to contribute code, please check out our Contribution Guidelines for detailed instructions.

License

Purlin.Community.Toolkit.Common is released under the MIT License. Feel free to use this library in both commercial and non-commercial projects.

Contact

For any questions, feedback, or support, you can reach out to our team at support@purlin.com or visit our website at https://www.purlin.com.

Thank you for using Purlin.Community.Toolkit.Common! We hope this library makes your development process smoother and more enjoyable. If you have any questions or need assistance, don't hesitate to contact us. Happy coding!