Neste artigo, vamos explorar como implementar testes de integração utilizando as bibliotecas Testcontainers, FastEndpoints.Testing, xUnit e Shouldly no nosso projeto e-DNE, uma API RESTful desenvolvida em .NET com FastEndpoints para consulta de endereços via CEP, integrada a um banco de dados PostgreSQL. O código fonte completo deste projeto está disponível no GitHub: Correios.DneBasico

Nesta terceira e última parte da série sobre a estrutura da base de dados e-DNE dos Correios, iremos finalizar com a criação de uma API RESTful para expor os dados importados. Para isso, continuaremos com o projeto que iniciamos na parte 1 e parte 2, onde criamos o importador dos dados do DNE Básico. Nele adicionaremos um projeto de API que utilizará o DbContext para consultar os dados e expô-los através de endpoints RESTful. A API será construída utilizando o FastEndpoints e a library Gridify para facilitar a paginação, ordenação e filtragem dos dados. Iniciaremos agora com a criação do projeto da API.

Nesta segunda parte iremos continuar a explorar a estrutura da base de dados e-DNE dos Correios, focando na criação das tabelas com os dados dos arquivos TXT. Coninuaremos de onde paramos na parte 1 e iniciaremos com o criação do projeto de importação, seguindo pelo mapeamento das classes para os arquivos TXT que serão lidos pelo CSVHelper e salvos no banco pelo EF Core.

Nesta série de artigos, exploraremos a estrutura da base de CEPs dos Correios, conhecida como e-DNE (Endereçamento Nacional Eletrônico). Dividiremos o conteúdo em três partes para facilitar a compreensão e implementação. Na primeira parte, abordaremos a estrutura dos CEPs e a base de dados e-DNE e criaremos as classes C# representando a estrutura dos dados. Na segunda parte implementaremos a leitura dos arquivos TXT e a persistência dos dados em um banco de dados PostgreSQL. Na terceira e última parte, criaremos uma API utilizando FastEndpoints para consultar os dados importados.

Iniciei há alguns poucos anos um processo de exploração alternativa para encontrar maneiras de desenvolvimento alternativas aos tradicionais Controllers do ASP.NET Core no desenvolvimento de APIs. Explorei o Minimal API por um tempo, porém, não me senti completamente confortável com ele. A cada novo projeto, o processo de configuração e estruturação da API me parecia muito repetitivo e trabalhoso sendo necesssária a configuração manual de diversos aspectos, como rotas, validação de modelos, tratamento de erros, registro dos endpoints, CQRS, Repositórios, entre outros. Foi então que, em meados de 2022, descobri o FastEndpoints, uma biblioteca que nos direciona para a utilização do padrão REPR (Request-Endpoint-Response).