DEV Community: Junior Porfirio

Brincando com GenFu .NET Core

Junior Porfirio — Mon, 20 Jul 2020 14:36:38 +0000

Fala pessoal, muitas vezes necessitamos criar massa de dados para nossos testes, como não queremos reinventar a roda e fazer isto manualmente, procuramos uma biblioteca que faça isto por nós.
Existem vários pacotes excelentes para esse propósito, uma das minhas preferidas o é o GenFu.

GenFu é uma excelente biblioteca para geração de massa de dados, na qual, você pode preencher propriedades de sua classe de forma dinamica e muito simples, fazendo o bom uso do padrão de projeto Builder.

Instalando o GenFu.

O GenFu é compativel com O .NET 4.5, .NET 4.6 e .NETStardard 1.6 ou superior.

Install-Package GenFu

.NET Core

dotnet add package GenFu

Utilizando GenFu

Existem 2 configurações bem simples e rápidas para geração de dados utilizando o GenFu que são:

var reuniao = A.New<Reuniao>();
var reunioes = A.ListOf<Reuniao>(20);

A primeira cria uma nova instancia com dados da classe Reuniao, e a segunda linha cria uma coleção de 20 registros da classe Reuniao com dados, veja os dados gerados abaixo:

Como vocês podem perceber foi gerada a lista com 20 registros de Reunião, porém, elas estão com dados um pouco distante da realidade, e nós queremos que nossos dados estejam o mais proxímos possível do real, para isto, o GenFu, possuí, um Setup bem fácil e fluente que nos possibilita realizar a configuração das suas propriedades, veja o exemplo abaixo das configurações em 2 métodos:

*Atenção: Está configuração de Setup deve ser feita antes de chamar os métodos New ou ListOf do GenFu, para que ele possa utilizar está configuração: * ;)

Como vocês podem visualizar na imagem acima, os registros foram criados baseados nas configurações pré definidas, de maneira bem legal e simples, possibilitando a criação de valores, como nomes, e-mails, telefones, redes sociais, outras coleções e muito mais !!!

Customizando GenFu

Uma outra coisa bacana que o GenFu oferece, é a possibilidade de customizar configurações de forma bem simples, utilizando o nome da propriedade como base para o uso do método Filler. Veja abaixo um exemplo, no qual estamos customizando a geração de dados de WebSites.

Como podemos visualizar acima, nós definimos as tags, website, site, web, webaddress, url com chaves para geração de dados, e no método GetValue nós já utilizamos um padrão de geração de dominios existente e adicionamos o https e www.
Para aplicar essa configuração basta, informar a seguinte configuração:

A.Default().FillerManager.RegisterFiller(new WebsiteFiller());

Ao Executar nossos testes, podemos perceber que foi preenchido corretamente o Filler personalizado que definimos.

Conclusão

O GenFu é um excelente package que pode te auxiliar a geração de dados seja para seus testes ou aplicação que deseje realizar validação de massa de dados de forma simples e rápida, com uma linguagem simples e fluente.

Não deixe de ver nas referências o código fonte dos códigos demonstrados neste post.

Abraços !!

Referências

juniorporfirio / GenFu-Example

MisterJames / GenFu

GenFu is a library you can use to generate realistic test data. It is composed of several property fillers that can populate commonly named properties through reflection using an internal database of values or randomly created data. You can override any of the fillers, give GenFu hints on how to fill them.

GenFu

http://genfu.io/

GenFu is a library you can use to generate realistic test data. It is composed of several property fillers that can populate commonly named properties through reflection using an internal database of values or randomly created data. You can override any of the fillers, give GenFu hints on how to fill them.

GenFu is all about smartly building up objects to use for test and prototype data. It will walk your object graph and fill in the properties on your type with realistic looking data.

Use GenFu's static methods to new up new objects for testing, design-time data or seeding a database.

GenFu runs on AspNetCore50 and can run anywhere core can run.

Installation

GenFu is on NuGet so you can easily add it to your project from the Package Manager Console:

install-package GenFu

Example Usage

Let's say you have a Person class like so:

    class Person
    {

…

View on GitHub

Documentação Swagger .NET Core com VS Code

Junior Porfirio — Thu, 16 Jul 2020 11:57:07 +0000

Sempre que necessitamos consumir uma API RESTFul a primeira coisa que nos vem a cabeça ?

Será que existe uma documentação.

Consumir APIs RESTFul sem uma documentação é como um cego sem seu cão guia, ficamos literalmente perdidos, não desejamos passar por essa situação e também sejamos responsáveis de sempre pensar nos consumidores das APIs RESTFul que desenvolvemos, incluindo uma documentação.

Para isto apresento para vocês o Swagger, que resolve esse problema de documentação de APIs de forma muito simples e rápida.

O Swagger é um package Open Source desenvolvedo em meados de 2010 com o objetivo de facilitar a documentação de APIs RESTFul,com ela será possível:

visualizar a documentação em uma página dos recursos.
testar todos os recursos nos respectivos verbos(GET,POST, PUT, PATCH, DELETE)
configurar autorização destes recursos de forma visual.
testar todos os recursos e seus respectivos verbos sem a necessidade do uso do famoso POSTMAN :).

Criando um Projeto

Para isto vamos criar um novo projeto no Visual Studio Code utilizando o seguinte comando no terminal.

dotnet new sln -o “SwaggerExample”

Criar um projeto WebApi

dotnet new webapi -o “SwaggerWebApi”

Agora vamos associar o projeto Web Api a Soluction com o seguinte comando.

dotnet sln add src/SwaggerWebApi/SwaggerWebApi.csproj

Instalando o Package

Vamos instalar o package Swashbuckle no projeto WebApi.

dotnet add package Swashbuckle.AspNetCore

Configurando o Swagger

Após a instalação do package Swashbuckle, vamos configurar o Swagger para isto, precisamos abrir o arquivo Startup.cs.

Como vocês podem perceber é possivel informar várias informações para sua documentação, como por exemplo, a versão de sua Api, titulo, descrição, e os dados de contato, tudo isto será exibido na página de documentação de sua aplicação.

Agora iremos incluir as configurações no mesmo arquivo Startup.cs no método Configure, nela será possível realizar as configurações de endpoint da documentação.

Com apenas essas simples configurações já será possível acessar a página de documentação Swagger, para isto, basta acessar “/swagger” na sua aplicação.

Incluindo comentários de código no Swagger

Como vocês podem perceber, podemos melhorar ainda mais a nossa documentação aproveitando os comentários da aplicação fazendo o uso do summary, e exibindo na nossa página do Swagger.

Agora precisamos configurar nosso projeto para gerar essa documentação durante o build, para isto, vamos editar o arquivo SwaggerWebApi.csproj, incluindo a configuração GenerateDocumentationFile, conforme arquivo abaixo:

Para que o Swagger possa entender as documentações geradas em um arquivo durante o build, precisamos informar ao Swagger este arquivo, conforme o exemplo abaixo:

Agora sim, ao acessar o endpoint da documentação do Swagger é visualizado os comentários informados nas Actions do Projeto.

Conclusão

Como podemos perceber é bem simples a configuração do Swagger e nos dá o poder de utilizar junto com os comentários da aplicação .NET, distribuir essa documentação através de um endpoint padrão, dando a possibilidade de chamar os recursos através da página.

Sempre que necessitar criar uma aplicação Api RESTFul, a configuração do Swagger se torna obrigatória.

Referências

https://docs.microsoft.com/pt-br/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-3.1&tabs=visual-studio

DEV Community: Junior Porfirio

Brincando com GenFu .NET Core

Instalando o GenFu.

Utilizando GenFu

Customizando GenFu

Conclusão

Referências

juniorporfirio / GenFu-Example

MisterJames / GenFu

GenFu

Installation

Example Usage

Documentação Swagger .NET Core com VS Code

Criando um Projeto

Instalando o Package

Configurando o Swagger

Incluindo comentários de código no Swagger

Conclusão

Referências

juniorporfirio / Swagger-Example

Example who configure Swagger using Visual Studio Code

Swagger-Example