🚀 GitHub Activity CLI

CLI (Command Line Interface) para visualizar a atividade recente de usuários do GitHub diretamente pelo terminal.

📌 Sobre o projeto

Esta ferramenta permite consultar e exibir, de forma simples e legível, os eventos recentes de qualquer usuário do GitHub utilizando a API pública.

Projeto desenvolvido com foco em aprendizado de:

• Consumo de API
• Manipulação de JSON
• Criação de CLI com Node.js
• Execução de comandos no terminal

---

🌐 URL do Projeto

https://roadmap.sh/projects/github-user-activity

---

⚙️ Instalação e uso

1. Clonar o repositório

git clone https://github.com/SEU_USUARIO/github-activity-cli.git
cd github-activity-cli

---

2. Linkar a CLI globalmente

npm link

---

3. Executar comando

github-activity <username>

---

📌 Exemplo

github-activity kamranahmedse

Saída esperada:

- Pushed 3 commits to user/repo
- Opened a new issue in user/repo
- Starred user/repo

---

⚠️ Tratamento de erros

A aplicação trata cenários como:

• Usuário inexistente
• Falha na requisição à API
• Dados incompletos retornados pela API

---

🛠️ Tecnologias utilizadas

• Node.js
• API pública do GitHub
• Sem uso de bibliotecas externas

---

📚 Aprendizados

Este projeto reforça conceitos fundamentais de backend:

• Entrada de dados via CLI (process.argv)
• Requisições HTTP nativas
• Programação assíncrona (async/await)
• Programação defensiva (tratamento de erros)

---

⚠️ Nota

Até o momento, nos testes realizados, a API do GitHub não retorna a quantidade de commits nos eventos de push.

Por isso, o CLI pode exibir apenas:

• Pushed commits to user/repo

---

👨‍💻 Autor

Marcos Oliveira