lawrence-laz / poem Goto Github PK

A selection of useful extension methods to write fluent code.

License: MIT License

C# 100.00%

extension-methods utils utilities csharp dotnet dotnet-standard fluent-design fluent

poem's Introduction

Poem

Poem is a selection of useful extension methods that can be used to write fluent code. All Poem methods return one of the parameters to allow creating a chain of method calls.

Get started

Download from nuget.org:

PS> Install-Package Poem

Start using it right away!

Enumerable
    .Range(1, 4)
    .ForEach(Console.WriteLine); // <-- this comes from Poem!

// Output:
// 1
// 2
// 3

🔴 For more examples look here.

Improvements

Do you have an idea for a fluent extension method that would fit this package?

Great!

You can either:

Fork this repo, add the method and raise a pull request. We will work together to get it merged! 😉
Create an issue explaining the extension method, where and how it would be used. We will work together on designing it and then someone (probably I) will implement the method.

Icon by smashicons.

poem's People

Contributors

Stargazers

Watchers

poem's Issues

StringExtension method ParseEnum

TrimStart and Trim with string overloads

Currently Poem provides .TrimEnd(string) only. But there is the same need for .TrimStart(string) and .Trim(string).

Join strings

Currently dotnet allows to joing string using a simple static method string Join(char separator, params object?[] values).

There should be an extension method on IEnumerable<T> that joins and returns a result.

Sometimes we have a LINQ chain that check's something and we want to execute an action depending on the boolean value the LINQ returns. This could be achieved with something like static bool IfTrue(this bool value, Action action).

Dictionary get or add

Sometimes dictionary is a just a part of a compound structure. In such cases a method like .GetOrAdd(TKey, Func<TVal>) would be useful.

Update documentation with new methods

Sign?

https://docs.microsoft.com/en-us/dotnet/standard/assembly/sign-strong-name

.ToEnumerable<T>() from single object

Foreach over IEnumerable

public static IEnumerable<T> ForEach<T>(this IEnumerable<T> enumerable, Action<T> action)

Set all items on array

There's sometimes a need to set all array values to one specific value. There should be an extension method targeting arrays that does this. Something like:
SetAll<T>(this T[] array, T value)

Add `DirectoryInfo` extensions

GetFilesOrEmpty() - should not throw if DirectoryInfo.Exists == false