alexey.petriashev/MicroElements.Collections.Sourcesv1.7.0
✓ Verified.NET Std2.1
MicroElements source only package: Collection extensions: NotNull, Iterate, Execute, WhereNotNull, Materialize, IncludeByWildcardPatterns, ExcludeByWildcardPatterns. Special collections: Cache, TwoLayerCache, PollingCache.
Get Started
$ dotnet add package MicroElements.Collections.SourcesReadme
MicroElements.Collections.Sources
Summary
MicroElements source only package: Collection extensions: NotNull, Iterate, Materialize, IncludeByWildcardPatterns, ExcludeByWildcardPatterns. Special collections: TwoLayerCache.
Extensions
NotNull
Returns not null (empty) enumeration if input is null.
string? GetFirstValue(IEnumerable<string>? optionalValues) =>
optionalValues
.NotNull()
.FirstOrDefault();
Iterate
Iterates values and executes action for each value.
It's like List.ForEach but works with lazy enumerations and does not forces additional allocations.
// Iterates values and outputs to console.
Enumerable
.Range(1, 100_000)
.Iterate(Console.WriteLine);
Materialize
Materializes source enumeration and allows to see intermediate results without changing execute chain. MaterializeDebug is the same as Materialize but works only in Debug mode and does not affect performance for Release builds.
Enumerable
.Range(1, 10)
.Materialize(values => { /*set breakpoint here*/ })
.Iterate(Console.WriteLine);
WildCard
Provides methods for wildcard or glob filtering.
See also: https://en.wikipedia.org/wiki/Glob_(programming).
[Fact]
public void WildcardInclude()
{
string[] values = { "Microsoft.Extension.Logging", "Microsoft.AspNetCore.Hosting", "FluentAssertions", "System.Collections.Generic" };
string[] includePatterns = { "Microsoft.AspNetCore.*", "*.Collections.*" };
string[] result = { "Microsoft.AspNetCore.Hosting", "System.Collections.Generic" };
values.IncludeByWildcardPatterns(includePatterns).Should().BeEquivalentTo(result);
}
[Fact]
public void WildcardExclude()
{
string[] values = { "Microsoft.Extension.Logging", "Microsoft.AspNetCore.Hosting", "FluentAssertions", "System.Collections.Generic" };
string[] excludePatterns = { "Microsoft.AspNetCore.*", "*.Collections.*" };
string[] result = { "Microsoft.Extension.Logging", "FluentAssertions" };
values.ExcludeByWildcardPatterns(excludePatterns).Should().BeEquivalentTo(result);
}