Tooark 4.0.1

Tooark

Biblioteca com todos os recursos e funcionalidades do Tooark voltadas para projetos .NET.

Instalação

dotnet add package Tooark

O agregador traz todos os pacotes Tooark de uma vez. Instale os pacotes individualmente quando quiser apenas parte deles — a superfície é a mesma.

Configuração

As traduções acompanham o assembly, então não há nada a configurar para elas funcionarem.

Adicione a seguinte linha no seu arquivo Program.cs:

// Importando o namespace necessário
using Tooark.Injections;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();

IConfiguration configuration = new ConfigurationBuilder()
  .Build();

// Nas suas configurações de serviços
services.AddTooarkService(configuration);

Essa única chamada registra Tooark.Dtos, Tooark.Extensions, Tooark.ValueObjects e Tooark.Mediator, e acrescenta Tooark.Securities e Tooark.Observability quando as seções de configuração correspondentes existem.

Onde os manipuladores do mediador são procurados

Sem argumento, no assembly que chamou o AddTooarkService. Numa aplicação de projeto único, é o que você quer e não há nada a fazer.

Numa aplicação em camadas, os manipuladores costumam estar em outro projeto. Informe os assemblies:

services.AddTooarkService(configuration, typeof(MeuHandler).Assembly);

Chamar o AddTooarkMediator depois também funciona, para acrescentar assemblies ou configurar as opções — o registro dos manipuladores não duplica:

using Tooark.Mediator.Injections;

services.AddTooarkService(configuration);
services.AddTooarkMediator(typeof(MeuHandler).Assembly);

Atenção ao chamar o AddTooarkService de dentro de uma biblioteca sua. O assembly procurado é o de quem chama, então seria o da sua biblioteca, e não o da aplicação. Repasse o assembly certo.

Unidade de trabalho

Fica de fora do AddTooarkService, porque depende do tipo do seu contexto do Entity Framework:

using Tooark.Mediator.EntityFrameworkCore.Injections;

services.AddTooarkMediatorUnitOfWork<MeuDbContext>();

Recursos disponíveis

Tooark.Attributes

Descrição: Este pacote fornece atributos personalizados para uso em projetos .NET.

Tooark.AspNetCore

Descrição: Este pacote reúne os recursos que dependem do ASP.NET Core, como a leitura de erros do ModelState.

Tooark.Dtos

Descrição: Este pacote contém objetos de transferência de dados (DTOs) para facilitar a comunicação entre camadas da aplicação.

Tooark.Entities

Descrição: Este pacote define as entidades do domínio utilizadas na aplicação.

Tooark.Enums

Descrição: Este pacote contém definições de enums utilizados em várias partes da aplicação.

Tooark.Exceptions

Descrição: Este pacote fornece exceções personalizadas para uso em projetos .NET.

Tooark.Extensions

Descrição: Este pacote fornece métodos de extensão para tipos e classes comuns do .NET.

Tooark.Notifications

Descrição: Este pacote oferece funcionalidades para gerenciamento de notificações e mensagens na aplicação.

Tooark.Mediator.Abstractions

Descrição: Este pacote fornece contratos base do padrão Mediator para uso em projetos .NET.

Tooark.Mediator

Descrição: Este pacote oferece uma implementação concreta do padrão Mediator, facilitando a comunicação entre componentes da aplicação.

Tooark.Mediator.EntityFrameworkCore

Descrição: Este pacote move a persistência do Entity Framework Core para o pipeline do Mediator, mantendo os handlers livres de SaveChanges.

Tooark.Observability

Descrição: Este pacote fornece ferramentas para monitoramento e observabilidade da aplicação.

Tooark.Securities

Descrição: Este pacote oferece funcionalidades para segurança, incluindo criptografia e autenticação.

Tooark.Utils

Descrição: Este pacote contém utilitários e funções auxiliares para diversas operações.

Tooark.Validations

Descrição: Este pacote fornece funcionalidades de validação para dados e entidades.

Tooark.ValueObjects

Descrição: Este pacote define objetos de valor utilizados na aplicação.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e pull requests no repositório Tooark.

Licença

Este projeto está licenciado sob a licença BSD 3-Clause. Veja o arquivo LICENSE para mais detalhes.