Humanizer, a biblioteca definitiva para manipular strings em .Net

Kleber Silva
Mar 20, 2019 · 3 min read

Image for post
Image for post

Fala galera, quem nunca precisou manipular vários tipos de dados para strings? Pois é, hoje vou apresentar para vocês a biblioteca Humanizer.

Humanizer é uma ótima biblioteca para obter representações legíveis por nós, meros seres humanos para strings, números e datas em .Net. Cortar strings até um certo tamanho ou transformar um TimeSpan em “uma hora” não é mágica. No entanto, tentar fazer todo o trabalho por conta própria levará um tempo que o maravilhoso Humanizer já gastou. Vamos ver alguns casos de uso em que essa biblioteca provou ser de grande ajuda.

Instalação

Abra seu projeto no Solution Explorer no Visual Studio, clique com o botão direito do mouse em References e selecione “Manage NuGet Packages…” para procurar os pacotes do NuGet. Procure por Humanizer e instale este pacote:

Image for post
Image for post
Instalação da versão em português

Após incluir a biblioteca em sua referência de projeto, é hora de colocar a mão na massa e ver do que o Humanizer é capaz de fazer por nós… Show me the code :-)

Trabalhando com DateTime e TimeSpan

Image for post
Image for post
Algumas implementações e suas saídas!

Unidades de Medida Computacionais

Pode ser útil saber o tamanho de um arquivo antes de tentar baixá-lo em uma conexão móvel. No entanto, apenas mostrar o tamanho em bytes pode não ajudar seus usuários. O Humanizer oferece sua própria classe para representar tamanhos de arquivo que podem ser convertidos conforme necessário ou mostrados novamente em um formato legível.

Image for post
Image for post
Medidas Computacionais

Truncando Strings

Muitas vezes precisamos trabalhar com strings longas e adicionar aqueles 3 pontinhos (…) no final para dar a entender que o texto é longo, o método Truncate do Humanizer faz esse trabalho para nós. S2 :-)

Image for post
Image for post

As vezes, você pode precisar adicionar uma regra do vocabulário de singularização/pluralização.

Image for post
Image for post
Incluindo a palavra Homem no Plural e Singular

Quantidades com Humanizer

Como podemos observar temos muitas formas de utilizar essa fantástica biblioteca, abaixo deixo mais alguns exemplos de uso com quantidades.

Image for post
Image for post
Trabalhando com quantidades

Strings e Enum

E claro que temos o bom e velho trabalho com String e Enum.

Image for post
Image for post

Conclusão

O Humanizer é uma ótima ajuda quando você precisa formatar a saída em um formato legível por humanos. Não parece muito, mas é muito seguro quando você usa essa biblioteca, em vez de escrever o código por conta própria. Eu estou apenas arranhando a superfície do Humanizer, passando por algumas tarefas corriqueiras. Há também exemplos de uso no ASP.NET MVC em suas Views.

Espero ter ajudado, aproveita e da uma olhada no Humanizer e agradeça ao autor no Twitter enquanto você está por aqui! Valeu Dev!

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store