📝 Nomes Populares do Brasil

Aplicação Ruby para uso no terminal que permite acesso à estatísticas de nomes populares no Brasil, com dados do IBGE.

✅ Funcionalidades

• Ranking dos nomes mais comuns em uma determinada Unidade Federativa (UF)
• Ranking dos nomes mais comuns em uma determinada cidade
• Rankings dos nomes separados por gênero
• Frequência do uso de um nome ao longo dos anos

🎲 Rodando o App no Terminal

Antes de começar, você vai precisar estar conectado à internet e ter instalado em sua máquina:

• Ruby versão: 2.7.2

Para instalar o ruby, você pode usar o comando (no Linux):

sudo apt-get install ruby

• Clone este repositório

git clone <https://github.com/leticiaoliveira5/nomes-ibge>

Ou, se não tiver o Git instalado, faça o download manualmente.

• Acesse a pasta do projeto no terminal/cmd

cd nomes-ibge
bundle install

• Roda a aplicação no terminal com

ruby nomes_brasil.rb

💎 Gems utilizadas

• Activesupport - ferramentas do rails
• Faraday - para lidar com requisições http
• Rspec - para testar o código
• Terminal-table - para criar as tabelas exibidas no terminal
• VCR - para guardar as requests HTTP dos testes

📡 Fontes

• API de Localidades: https://servicodados.ibge.gov.br/api/docs/localidades?versao=1
• API de Nomes: https://servicodados.ibge.gov.br/api/docs/nomes?versao=2
• CSV com dados da população: https://campus-code.s3-sa-east-1.amazonaws.com/treinadev/populacao_2019.csv

🎉 Developer

/leticiaoliveira5