weather.py — Tutorial de instalacao e uso

Este documento explica como instalar, configurar e usar o projeto BH-WEATHER, um programa que roda no terminal e exibe informacoes do tempo em tempo real para Belo Horizonte, MG.

Nao precisa saber programar para seguir este tutorial.

---

O que o programa faz

O projeto se conecta a internet, consulta uma API gratuita de meteorologia e exibe os dados direto no terminal. Voce pode ver:

• temperatura atual
• umidade do ar
• velocidade do vento
• probabilidade de chuva hora a hora
• previsao para os proximos 7 dias

Alem disso, em qualquer tela de consulta voce pode digitar save para salvar os dados exibidos em data/weather.json.

Nao e necessario criar conta nem chave de API. A fonte de dados e o Open-Meteo, um servico publico e gratuito.

---

Estrutura do projeto

BH-WEATHER/
├── main.py                  # ponto de entrada — menu e loop principal
├── README.md
├── clients/
│   └── weather_api.py       # requisicoes HTTP para a Open-Meteo
├── services/
│   └── weather_service.py   # logica de negocio e telas do terminal
├── utils/
│   └── storage.py           # persistencia em data/weather.json
└── data/
    └── weather.json         # gerado automaticamente ao usar save

---

O que voce precisa ter instalado

Antes de comecar, verifique se o seu computador tem o seguinte:

Python 3.8 ou superior

Para checar, abra o terminal e digite:

python --version

Se aparecer algo como Python 3.10.x, esta ok. Se der erro ou aparecer uma versao muito antiga, baixe o Python em: https://www.python.org/downloads/

---

Instalacao

1. Baixe os arquivos

Salve a pasta do projeto no seu computador mantendo a estrutura de diretorios acima.

2. Abra o terminal na pasta raiz do projeto

No Windows:

• Abra o Explorador de Arquivos, navegue ate a pasta
• Clique na barra de endereco, digite cmd e pressione Enter

No Mac/Linux:

• Abra o Terminal
• Digite cd ~/caminho/para/BH-WEATHER e pressione Enter

3. Instale a dependencia

pip install rich

Se o pip nao for reconhecido, tente:

python -m pip install rich

---

Como rodar

Com o terminal aberto na pasta raiz do projeto, execute:

python main.py

O programa vai iniciar e mostrar o menu principal com os comandos disponiveis.

---

Comandos disponiveis

Comando	O que faz
agora	mostra um resumo completo do tempo agora
temperatura	exibe so a temperatura atual
umidade	exibe so a umidade relativa do ar
vento	exibe so a velocidade do vento
chuva	probabilidade de chuva hora a hora no dia
previsao	previsao dos proximos 7 dias
exit	fecha o programa

Dentro de cada tela de consulta:

Comando	O que faz
back	volta ao menu principal
save	salva os dados exibidos em data/weather.json
exit	fecha o programa diretamente

---

Salvando dados com o comando save

Ao digitar save, o programa salva os dados em data/weather.json. O arquivo acumula todos os registros em ordem cronologica. Exemplo:

{
  "salvo_em": "2026-03-30 14:22:41",
  "consulta": "vento",
  "cidade": "Belo Horizonte, MG",
  "dados": {
    "vento_kmh": 17.5
  }
}

---

Erros comuns

"Missing dependency. Run: pip install rich" Execute pip install rich no terminal.

"erro ao buscar dados" Verifique sua conexao com a internet e tente novamente.

"erro ao salvar" Verifique se a pasta do projeto tem permissao de escrita.

"python nao e reconhecido como comando" Tente usar python3, ou reinstale o Python marcando "Add Python to PATH".

---

Alterando a cidade

Abra clients/weather_api.py e edite as tres linhas no topo:

BH_LAT = -19.9167   # latitude da sua cidade
BH_LON = -43.9345   # longitude da sua cidade

E em services/weather_service.py:

CITY = "Belo Horizonte, MG"  # nome que aparece no topo

Para encontrar coordenadas: https://www.latlong.net

---

Informacoes tecnicas

• API: Open-Meteo (https://open-meteo.com) — gratuita, sem autenticacao
• Interface: biblioteca rich
• Historico: data/weather.json — lista de registros com timestamp e dados