Sufficit.Utils 1.26.507.131

<h1> Sufficit.Utils <a href="https://github.com/sufficit"><img src="https://avatars.githubusercontent.com/u/66928451?s=200&v=4" alt="Sufficit Logo" width="80" align="right"></a> </h1>

📖 About the Project

Sufficit.Utils is a general-purpose utility library that complements Sufficit.Base. It contains a collection of higher-level helper classes, extension methods, and specialized tools that solve common problems encountered during development.

While Sufficit.Base provides foundational interfaces and models, Sufficit.Utils offers concrete implementations and shortcuts to accelerate development tasks such as reflection, serialization, and complex data manipulation.

✨ Key Features

• Advanced extension methods for collections, strings, and objects.
• Helper classes for serialization (e.g., System.Text.Json wrappers).
• Reflection and type-manipulation utilities.
• Tools for handling common application patterns and logic.

🚀 Getting Started

This project is a class library. The recommended way to use it is by installing the NuGet package into your project.

📦 NuGet Package

Install the package via the .NET CLI or the NuGet Package Manager Console.

.NET CLI:

dotnet add package Sufficit.Utils

Package Manager Console:

Install-Package Sufficit.Utils

Note for Developers: The code samples below use 4-space indentation rather than fenced code blocks (```). This is intentional to prevent rendering issues in certain environments and ensure the raw text can be copied cleanly.

🛠️ Usage

After installing the package, you can use its extension methods and classes by importing the relevant namespaces.

Example of using a collection extension method:

using Sufficit.Utils.Extensions;

public void ProcessData()
{
    IEnumerable<string> myCollection = new[] { "one", "two", null, "three", "" };

    // The ForEachNotNull extension allows iterating only over non-null/non-empty items
    myCollection.ForEachNotNull(item => 
    {
        Console.WriteLine($"Processing item: {item}");
    });

    // Output:
    // Processing item: one
    // Processing item: two
    // Processing item: three
}

🤝 Contributing

Contributions are greatly appreciated. Please follow the standard fork and pull request workflow.

📄 License

Distributed under the MIT License. See LICENSE for more information.

📧 Contact

Sufficit - contato@sufficit.com.br

Project Link: https://github.com/sufficit/sufficit-utils