PowerUp

PowerUp, biblioteca de métodos de extensão para .NET Core

O PowerUp é uma biblioteca de métodos de extensão para .NET Core, adiciona funcionalidades úteis à estrutura.

Download

POWERUPCORE NUGET
PowerUpcore Azure Nuget

O que há de diferente nesta biblioteca?

⏩ Lightweight: o objetivo não é contém métodos 5K, mas apenas ter métodos úteis diários (na minha opinião)
.NET Core Compatible
Unidade testada
100% documentado

Todo o método de extensão é explicado e uma razão de ser fornecida é fornecida na documentação a seguir.

Conteúdo

1. Stringextensões
2. Enumextensões
3. Coleção Extensões
4. Genericextensões
5. Azurextensions

Stringextensões

Isinteger

Simplifique a sintaxe necessária para verificar se o conteúdo da string é um inter.
Por que?
Para remover o código repetitivo

 if ( "42" . IsInteger ( ) )
  Foo ( ) ;

Remover

Remove de uma string o conteúdo da sequência de parâmetros.
Por que?
Para remover o código repetitivo

 "My text" . Remove ( "My" ) // result: " text"
// instead of
"My text" . Replace ( "My" , string . Empty ) ; // result: " text"
  Foo ( ) ;

Formatar

Fornece uma sintaxe mais curta para o formato do método da string.
Por que?
Para tornar o código mais curto

 // .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 ) ;

Towenum <>

Permite converter facilmente um tring em uma enumeração.
Por que?
Para remover o código repetitivo

 private enum TestEnum
{
    Val1 ,
    Val2 ,
    Val3
}

var enumVar = "Val1" . ToEnum < TestEnum > ( ) ; 

Enumextensões

GetDescription <>

Permite obter a descrição legível do valor da enumeração.

 private enum TestEnum
{
    [ Description ( "Value with description" ) ]
    ValWithDesc = 1 ,
    ValNoDesc = 2 ,
    AnotherNoDesc = 3
}
var testObject = TestEnum . ValWithDesc ;
string description = testObject . GetDescription ( ) ; 

Coleção Extensões

Removerman <>

Ajuda a remover mais elementos de uma só vez de uma coleção.
Por que?
Para fornecer um número útil de recursos adicionais às coleções

 sourceList . RemoveRange ( deleteList ) ;

Clone <>

Executa uma cópia profunda uma coleção de objetos iCloneable .

 var testList = _fixture . Create < List < clonableObj > > ( ) ;
var clone = testList . Clone ( ) ;
clone . First ( ) != testList . First ( )

GetLastIndex <>

Recebe o último índice de uma coleção.
Por que?
Para remover o código repetitivo

 sourceList . GetLastIndex ( ) == ( sourceList . Count - 1 ) 

Genericextensões

Throwifnull <>

Lança argumentnullexception se o argumento fornecido for nulo.
Por que?
Para substituir o guarda.argumentNotNull in .Net Core

 objectShouldNotBeNUll . ThrowIfNull ( nameof ( objectShouldNotBeNUll ) ) ;
// Inspired on Microsoft.Practices.EnterpriseLibrary.Common.Utility
Guard . ArgumentNotNull ( objectShouldNotBeNUll , nameof ( objectShouldNotBeNUll ) ) ;

IsNull <> e isNotNull <>

Verifique se um objeto é nulo ou não nulo.
Por que?
Para tornar a sintaxe para verificar o limpador nulo e mais humano

 var someObject = new object ( ) ;
//Before
if ( someObject != null )
  Foo ( ) ;
//PowerUp
if ( someObject . isNull ( ) )
  Foo ( ) ;

Entre <>

Verifique se o valor do objeto está entre o limite inferior e superior.
Por que?
Para simplificar a sintaxe para verificar se um valor OnBject está entre um determinado intervalo

 if ( 5 . Between ( 2 , 8 ) )
  Foo ( ) ;
if ( 7 . Between ( 7 , 12 , BetweenOptions . Inclusive ) )
  Foo ( ) ; 

LogGerextensions

Logthismethod

Permite simplesmente registrar informações sobre o método de chamada.
Por que?
Para evitar código chato e copiar o problema da pasta, o cenário tipical está no início de um método do controlador como:

 [ HttpPut ]
[ Route ( "[action]" ) ]
[ Produces ( "application/json" ) ]
[ ProducesResponseType ( typeof ( Product ) , StatusCodes . Status201Created ) ]
[ ProducesResponseType ( typeof ( string ) , StatusCodes . Status400BadRequest ) ]
public async Task < IActionResult > AddProduct ( [ FromBody ] NewProduct newProduct )
{
    _logger . LogDebug ( $ " { DateTime . UtcNow : dd/MMM/yyyy } | 32: CatalogController.AddProduct()}" ) ;
    if ( ! ModelState . IsValid )
        return BadRequest ( ModelState ) ;
    ....

O método de registro agora pode ser simplesmente:

.. .
public async Task < IActionResult > AddProduct ( [ FromBody ] NewProduct newProduct )
{
    _logger . LogThisMethod ( ) ;
    .. .

É fácil do exemplo ver quanto isso pode reduzir a amostragem do código e a possibilidade de erros

Azurextensions

Redundanteparse

As chaves de acesso ao armazenamento no Azure são usadas em autenticação para acessar a conta de armazenamento.
Ao criar uma conta de armazenamento, você recebe duas chaves de acesso ao armazenamento, ou seja, as teclas de acesso primário e secundário.
Veja mais https://blogs.msdn.microsoft.com/mast/2013/11/06/why-does-an-azure-storage-account-have-two-access-keys/
Por que?
O RedundantParse permite que você se conecte de forma redundante usando a chave primária ou alterne automaticamente para o segundo dia.

< add key = " QueueConnectionString1 " value = " DefaultEndpointsProtocol=https;AccountName=weu########## " />
< add key = " QueueConnectionString2 " value = " DefaultEndpointsProtocol=https;AccountName=weu########## " />
< add key = " QueueReference " value = " myQueueReference " />

 var storageAccount = CloudStorageAccountHelper . RedundantParse (
                    CloudConfigurationManager . GetSetting ( "QueueConnectionString1" ) ,
                    CloudConfigurationManager . GetSetting ( "QueueConnectionString2" ) ) ;
var queueClient = storageAccount . CreateCloudQueueClient ( ) ;
var myQueue = queueClient . GetQueueReference ( ConfigurationManager . AppSettings [ "QueueReference" ] ) ;