https://github.com/lucaleone/powerup
PowerUp is an extension methods library for .Net CORE, it add usefull functionalities so the framework
https://github.com/lucaleone/powerup
core dotnet-core library microsoft net
Last synced: about 1 year ago
JSON representation
PowerUp is an extension methods library for .Net CORE, it add usefull functionalities so the framework
- Host: GitHub
- URL: https://github.com/lucaleone/powerup
- Owner: lucaleone
- License: mit
- Created: 2018-10-29T11:13:28.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-01T15:31:54.000Z (over 7 years ago)
- Last Synced: 2025-03-08T06:19:45.259Z (over 1 year ago)
- Topics: core, dotnet-core, library, microsoft, net
- Language: C#
- Homepage: https://www.nuget.org/packages/PowerupCore
- Size: 160 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PowerUp, extension methods library for .Net CORE
 PowerUp is an extension methods library for .Net CORE, it add usefull functionalities to the framework.
## Download
[PowerupCore Nuget](https://www.nuget.org/packages/PowerupCore)
[PowerupCore Azure Nuget](https://www.nuget.org/packages/PowerupCore.Azure)
## What is different about this library?
⏩ Lightweight: the goal is not to contains 5k methods, but to only have everyday useful methods (in my opinion 😁)
🚀 .Net CORE compatible
🥊 Unit tested
🤓 100% documented
All the extension method are explained and a [Raison d'être](https://en.wikipedia.org/wiki/Raison_d%27%C3%AAtre) is provided in the following documentation.
### Contents
1. [StringExtensions](https://github.com/lucaleone/PowerUp/blob/master/README.md#stringextensions)
2. [EnumExtensions](https://github.com/lucaleone/PowerUp/blob/master/README.md#enumextensions)
3. [CollectionExtensions](https://github.com/lucaleone/PowerUp/blob/master/README.md#collectionextensions)
4. [GenericExtensions](https://github.com/lucaleone/PowerUp/blob/master/README.md#genericextensions)
5. [AzureExtensions](https://github.com/lucaleone/PowerUp/blob/master/README.md#azureextensions)
## StringExtensions
### IsInteger
Simplify the syntax necessary to verify wehather the string content is an inter or not.
__Why?__
To remove repetitive code
```csharp
if("42".IsInteger())
Foo();
```
### Remove
Removes from a string the content of the parameter string.
__Why?__
To remove repetitive code
```csharp
"My text".Remove("My") // result: " text"
// instead of
"My text".Replace("My", string.Empty); // result: " text"
Foo();
```
### Format
Gives a shorter syntax for the string's method _Format_.
__Why?__
To make the code shorter
```csharp
// .net syntax
string.Format("Debug Level: {0} \"{1}\" {3}", DebugLevel.Info, "Everything is awesome!", DateTime.Now);
// PowerUp syntax
"Debug Level: {0} \"{1}\" {3}".Format(DebugLevel.Info, "Everything is awesome!", DateTime.Now);
```
### ToEnum<>
Allows to easily convert a tring to an enum.
__Why?__
To remove repetitive code
```csharp
private enum TestEnum
{
Val1,
Val2,
Val3
}
var enumVar = "Val1".ToEnum();
```
## EnumExtensions
### GetDescription<>
Allows to get the readable description of the enum value.
```csharp
private enum TestEnum
{
[Description("Value with description")]
ValWithDesc = 1,
ValNoDesc = 2,
AnotherNoDesc =3
}
var testObject = TestEnum.ValWithDesc;
string description = testObject.GetDescription();
```
## CollectionExtensions
### RemoveRange<>
Helps to remove more elements at once from a collection.
__Why?__
To provide a usefull addidional features to collections
```csharp
sourceList.RemoveRange(deleteList);
```
### Clone<>
Performs a deep copy frim a collection of _ICloneable_ objects.
```csharp
var testList = _fixture.Create>();
var clone = testList.Clone();
clone.First() != testList.First()
```
### GetLastIndex<>
Gets the last index of a collection.
__Why?__
To remove repetitive code
```csharp
sourceList.GetLastIndex() == (sourceList.Count - 1)
```
## GenericExtensions
### ThrowIfNull<>
Throws ArgumentNullException if the given argument is null.
__Why?__
To replace the Guard.ArgumentNotNull in .net CORE
```csharp
objectShouldNotBeNUll.ThrowIfNull(nameof(objectShouldNotBeNUll));
// Inspired on Microsoft.Practices.EnterpriseLibrary.Common.Utility
Guard.ArgumentNotNull(objectShouldNotBeNUll, nameof(objectShouldNotBeNUll));
```
### IsNull<> and IsNotNull<>
Verify that a object is null or not null.
__Why?__
To make the syntax to verify null cleaner and more human readable
```csharp
var someObject = new object();
//Before
if(someObject!=null)
Foo();
//PowerUp
if(someObject.isNull())
Foo();
```
### Between<>
Verify that the object value is between the lower and upper bound.
__Why?__
To simplify the syntax to verify that an onbject value is between a certain range
```csharp
if(5.Between(2, 8))
Foo();
if(7.Between(7, 12, BetweenOptions.Inclusive))
Foo();
```
## LoggerExtensions
### LogThisMethod
Allows to simply log information about the calling method.
__Why?__
To avoid boring code, and copy paste problem
the tipical scenario is at the beginning of a Controller method like:
```csharp
[HttpPut]
[Route("[action]")]
[Produces("application/json")]
[ProducesResponseType(typeof(Product), StatusCodes.Status201Created)]
[ProducesResponseType(typeof(string), StatusCodes.Status400BadRequest)]
public async Task AddProduct([FromBody] NewProduct newProduct)
{
_logger.LogDebug($"{DateTime.UtcNow:dd/MMM/yyyy} | 32: CatalogController.AddProduct()}");
if (!ModelState.IsValid)
return BadRequest(ModelState);
....
```
the logging method can now be simply:
```csharp
...
public async Task AddProduct([FromBody] NewProduct newProduct)
{
_logger.LogThisMethod();
...
```
It's easy from the example to see how much it can reduce the ammount of code and the possibility of errors
## AzureExtensions
### RedundantParse
The storage access keys in Azure are used in authentication for accessing the storage account.
When you create a storage account you are provided with two storage access keys i.e. Primary and Secondary access keys.
See more https://blogs.msdn.microsoft.com/mast/2013/11/06/why-does-an-azure-storage-account-have-two-access-keys/
__Why?__
__RedundantParse__ allowes you redundantly connect using the primary key or automatically switch to the seconday.
```xml
```
```csharp
var storageAccount = CloudStorageAccountHelper.RedundantParse(
CloudConfigurationManager.GetSetting("QueueConnectionString1"),
CloudConfigurationManager.GetSetting("QueueConnectionString2"));
var queueClient = storageAccount.CreateCloudQueueClient();
var myQueue = queueClient.GetQueueReference(ConfigurationManager.AppSettings["QueueReference"]);
```