🚀 RAVC

⚙️ CLI/NPM para Conversão de Moedas USD/BRL & Cotação em tempo real.

Biblioteca NPM + CLI

📋 Visão Geral

O RAVC é uma ferramenta de linha de comando (CLI) e NPM que oferece conversão de moedas e monitoramento em tempo real das cotações USD/BRL, com interface interativa e visualmente atrativa.

📦 Instalação Rápida

• COMO INSTALAR NODE JS NO WINDOWS?

# Instalar globalmente
npm i -g ravc         # ✅ Recomendado
npm install -g ravc   # ✅ Completo

🗑️ DESINSTALAR GLOBALMENTE

npm un -g ravc        # ✅ Recomendado  
npm uninstall -g ravc # ✅ Completo
npm remove -g ravc    # ✅ Alternativo

💻 Como Usar

🎮 Modo Interativo (Recomendado)

ravc

Menu completo com todas as funcionalidades

⚡ Comandos Diretos

# Google Finance direto
ravc google
ravc -g

# Banco Central direto  
ravc bacen
ravc -b

# Modo atualização contínua
ravc update
ravc -u

# Ajuda
ravc help
ravc -h

🔄 Modo Atualização Contínua

ravc update

Atualiza automaticamente a cada minuto com logs em tempo real

🎯 Funcionalidades

💱 Conversão de Moedas

• USD → BRL e BRL → USD
• Formatação monetária adequada
• Validação de entrada

📈 Monitoramento

• Variações em tempo real
• Direção (alta/baixa/estável)
• Percentuais de mudança
• Timestamps precisos

📊 Logs e Histórico

• Logs em arquivo .txt legíveis
• Histórico de sessões
• Estatísticas de variação
• Backups em JSON

🔧 Desenvolvimento

📦 Dependências Principais

• playwright - Web scraping
• inquirer - Interface interativa
• boxen - Boxes estilizados
• chalk - Cores no terminal
• figlet - Banner ASCII

🐛 Solução de Problemas

🔍 Debug Mode

# Ativar logs detalhados
DEBUG=1 ravc

# Debug específico do scraping  
DEBUG_SCRAPING=1 ravc

❌ Problemas Comuns

Erro de permissão no NPM:

# Linux/Mac
sudo npm install -g ravc

# Windows (Admin)
npm install -g ravc

Playwright não instalado:

npx playwright install

🏗️ Estrutura do Projeto

ravc/ 🌟
├── 📁 bin/
│   └── 🚀 cli.js
├── 📁 lib/
│   ├── 📁 config/
│   │   ├── ⚙️ app.json
│   │   ├── 🎨 colors.js
│   │   ├── 🔧 logger.json
│   │   ├── 🕷️ scraping.json
│   │   └── 🎭 ui.json
│   ├── 📁 utils/
│   │   ├── 📦 box.js
│   │   ├── 📝 logger.js
│   │   └── 📦 packageInfo.js
│   ├── 💱 converter.js
│   ├── 🏠 index.js
│   ├── 🕷️ scraper.js
│   ├── 🎨 ui.js
│   └── 🔄 updater.js
├── 📄 package.json
└── 📖 README.md

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para detalhes.

✨ Feito com 💚 por RavenaStar

⭐ Dê uma estrela no GitHub!

Star History