Dev.Util.Collections 1.2.2

Dev.Util.Collections

High-performance collection and dictionary manipulation utilities for the Dev.Util ecosystem. Optimized for large datasets and complex data structures.

📦 Installation

dotnet add package Dev.Util.Collections

✨ Features

• 📖 Safe Dictionary Access: Avoid KeyNotFoundException with smart defaults.
• 📄 Pagination: Convert any IEnumerable into a metadata-rich PagedList<T>.
• 📦 Batching/Chunking: Split large collections for efficient batch processing.
• 🌳 Tree Traversal: Recursively flatten nested structures with a single line.
• 🎲 Randomization: Shuffle lists or pick random elements with ease.
• ⛓️ Fluent Lists: Chainable modification methods (AddRangeFluent, etc).

🛠 Usage Examples

1. Paginated Results (API Ready)

Perfect for returning data to front-end grids with metadata.

using Dev.Util.Collections;

var rawData = dbContext.Users.AsEnumerable();

// Returns PagedList<T> with TotalPages, TotalCount, HasNextPage etc.
var paged = rawData.ToPagedList(pageIndex: 1, pageSize: 20);

Console.WriteLine($"Showing page {paged.PageIndex} of {paged.TotalPages}");

2. High-Capacity Batching

Processes large collections in smaller, manageable chunks (ideal for DB imports).

using Dev.Util.Collections;

var largeList = Enumerable.Range(1, 10000);

foreach (var batch in largeList.Batch(100))
{
    // batch is IEnumerable<int> with 100 items
    await SaveToDatabase(batch);
}

3. Safe Dictionary Interaction

Eliminate repetitive ContainsKey checks.

using Dev.Util.Collections;

var settings = new Dictionary<string, string> { ["Theme"] = "Dark" };

// Safe Get
string theme = settings.GetValueOrDefault("Theme", "Light"); // "Dark"
string mode = settings.GetValueOrDefault("Mode", "Simple"); // "Simple"

// Fluent Add if not exists
settings.AddIfNotNull("Language", "EN");

4. Recursive Traversal

Flatten complex hierarchies like File Systems or UI TreeViews.

using Dev.Util.Collections;

var allNodes = rootCategory.Traverse(c => c.SubCategories);

foreach(var node in allNodes) {
    // Process every nested category flatly
}

5. Randomization & Selection

Utility methods for UI or testing.

using Dev.Util.Collections;

var winners = users.PickRandom(3); // Pick 3 random users
users.Shuffle(); // Randomize the entire list in-place