Conversor de Moedas

Um conversor de moedas simples e seguro em .NET, que utiliza a API ExchangeRate-API para realizar conversões entre diferentes moedas. O projeto demonstra boas práticas de configuração, uso de User Secrets para proteger a chave da API e leitura de configurações via appsettings.json.

Funcionalidades

• Conversão de valores entre moedas (ex: BRL, USD, EUR, etc.)
• Entrada interativa via terminal
• Mensagens de erro amigáveis
• Armazenamento seguro da chave da API usando User Secrets

Tecnologias Utilizadas

• .NET 9.0
• ExchangeRate-API
• Newtonsoft.Json
• Microsoft.Extensions.Configuration (Json & UserSecrets)

Pré-requisitos

• .NET 9.0 SDK
• Uma chave gratuita da ExchangeRate-API

Configuração do Projeto

1. Clone o repositório:

   git clone https://github.com/bitguardian/conversor-de-moedas.git
   cd conversor-de-moedas

2. Configure sua chave da API com User Secrets:

   Inicialize o gerenciador de segredos:

   dotnet user-secrets init

   Agora armazene sua chave (substitua SUA_CHAVE_AQUI pela sua chave real):

   dotnet user-secrets set "ApiKey" "SUA_CHAVE_AQUI"

3. (Opcional) Edite o arquivo appsettings.json

   • O arquivo já contém a URL base da API, mas você pode alterá-la se necessário.

4. Execute o projeto:

   dotnet run

   O comando dotnet run irá restaurar as dependências, compilar e executar o projeto automaticamente.

Como Usar

1. Ao rodar o programa, siga as instruções no terminal:
   • Informe a moeda de origem (ex: BRL, USD, EUR)
   • Informe a moeda de destino
   • Informe o valor a ser convertido
2. O resultado da conversão será exibido na tela.

Estrutura dos Arquivos

• Program.cs: Código principal do conversor.
• appsettings.json: Configurações da aplicação (URL base da API).
• ConversorDeMoedas.csproj: Arquivo de projeto .NET com dependências.

Segurança

A chave da API é um dado sensível e NUNCA deve ser compartilhada ou enviada para repositórios públicos. Este projeto utiliza o recurso User Secrets do .NET para armazená-la de forma segura fora da pasta do projeto.

Exemplo de Uso

(Valor da cotação é apenas um exemplo)

Bem-vindo ao Conversor de Moedas!
----------------------------------
Digite a moeda de origem (ex: BRL, USD, EUR): BRL
Digite a moeda de destino (ex: USD, BRL, EUR): USD
Digite o valor a ser convertido: 100

----- Resultado -----
100 BRL equivalem a 19.50 USD

Licença

Este projeto é distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.