Gaiato.Net.Network 1.0.14

Gaiato.Net.Network

Descrição

Gaiato.Net.Network é um pacote NuGet que fornece uma maneira simples e eficiente de consultar APIS públicas como por exemplo, para obter o endereço IP externo de uma máquina utilizando o ipify.

O pacote foi desenvolvido seguindo os princípios de Clean Code e SOLID, garantindo flexibilidade, testabilidade e manutenibilidade. É compatível com projetos .NET 7 ou superior.

Recursos

• Obtenção do endereço IP externo com apenas uma chamada assíncrona.
• Integração fácil com HttpClient e injeção de dependência.
• Testado e validado com testes unitários.
• Código otimizado para performance e confiabilidade.

Instalação

Para instalar o pacote, utilize o seguinte comando no terminal:

dotnet add package Gaiato.Net.Network

Ou adicione diretamente via o Gerenciador de Pacotes NuGet do Visual Studio, buscando por Gaiato.Net.Network.

Uso

Configuração no Startup ou Program.cs

Adicione o serviço ao contêiner de injeção de dependência utilizando o método de extensão incluído:

using Microsoft.Extensions.DependencyInjection;
using Gaiato.Net.Network;

var services = new ServiceCollection();
services.AddExternalIpService();

var serviceProvider = services.BuildServiceProvider();
var ipService = serviceProvider.GetRequiredService<IExternalIpService>();

var externalIp = await ipService.GetExternalIpAsync();
Console.WriteLine($"Seu IP externo é: {externalIp}");

Injeção em Serviços

Você também pode injetar o serviço diretamente em suas classes:

public class MyService
{
    private readonly IExternalIpService _externalIpService;

    public MyService(IExternalIpService externalIpService)
    {
        _externalIpService = externalIpService;
    }

    public async Task LogExternalIpAsync()
    {
        var ip = await _externalIpService.GetExternalIpAsync();
        Console.WriteLine($"Endereço IP externo: {ip}");
    }
}

Estrutura do Projeto

├── Gaiato.Net.Network/
│   ├── Gaiato.Net.Network.csproj
│   ├── ExternalIpService.cs
│   ├── IExternalIpService.cs
│   ├── ServiceCollectionExtensions.cs
├── .github/
│   └── workflows/
│       └── publish-nuget.yml
├── README.md

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para ajudar com:

• Reportar problemas ou sugerir melhorias na aba Issues.
• Fazer um fork do repositório e enviar pull requests.
• Melhorar a documentação ou adicionar novos testes.

Passo a Passo para Contribuir

1. Faça um fork do repositório.
2. Crie uma nova branch para sua funcionalidade ou correção:

   git checkout -b minha-nova-funcionalidade
   

3. Faça suas alterações e commit:

   git commit -m "Adicionei minha nova funcionalidade"
   

4. Envie para sua branch:

   git push origin minha-nova-funcionalidade
   

5. Abra um pull request no GitHub.

Licença

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.

Referências

• ipify API
• NuGet.org

Status do Build

O processo de publicação é automatizado utilizando GitHub Actions. Ao enviar um commit para a branch main ou criar uma tag no formato v1.0.0, o pacote será automaticamente publicado no NuGet.

Projeto Gaiato.Net

• Site
• YouTube
• X (Twitter)
• Linkedin
• Discord

#SejaGaiato