/laguinho-cli

Interface de linha de comando (CLI) para publicar e recuperar dados no laguinho-api

Primary LanguagePythonMIT LicenseMIT

Laguinho API chat on Discord

LaguinhoAPI Logo

Assim como o Laguinho da UFCG é (era) o ponto mais central da universidade, esta API centralizará dados para pesquisas e aplicações.

O que é o Laguinho

Desenvolvedores e pesquisadores podem utilizar o laguinho para compartilhar e consumir diferentes tipos de dados, com o objetivo de auxiliar o desenvolvimento de aplicações ou de pesquisas.

O laguinho é composto por 3 componentes:

Use a interface Web para encontrar novos conjuntos de dados (datasets), favoritar os melhores e compartilhar outros com a comunidade, além disso, crie seu perfil e encontre pessoas com perfis semelhantes.

A CLI é executada no terminal e é uma das formas de interagir com o Laguinho para quem tem familiariade, principalmente desenvolvedores.

A API é responsável por receber todas as requisições dos outros componentes e permitir o registro e obtenção dos conjuntos de dados.

Use o Laguinho para:

  • Compartilhar dados para pesquisas.
  • Favoritar os seus datasets preferidos.
  • Ter diversas informações centralizadas.
  • Utilizar o que a comunidade compartilhou em seus projetos e pesquisas.
  • Encontrar pessoas que estão trabalhando com dados semelhantes.

Como contribuir

Os dados são abertos e todos podem contribuir com mais dados e endpoints. Veja mais detalhes no CONTRIBUTING.md e se joga no laguinho com a gente!

Preparando o ambiente

Este projeto é feito utilizando Python 3, você precisa tê-lo instalado na sua máquina.

Para rodarmos as dependências de banco de dados e servidores externos, utilizamos Docker e Docker Compose, caso ainda não tenha instalado na sua máquina, esse tutorial ajuda a instalar o docker e esse tutorial ajuda a instalar o docker-compose, mas lembre-se que qualquer dúvida no processo de instalação, sempre tem alguém no discord pra ajudar!

Quer implementar alguma nova funcionalidade ou corrigir algum bug? Pode ir dando uma olhada nas issues abertas pra saber no que estamos trabalhando ou se preferir pode abrir sua própria caso queira corrigir ou adicionar algo novo!

Qualquer dúvida é só procurar a gente via discord ou pelas issues mesmo!

OBS: Esse ainda é um projeto em desenvolvimento, para acompanhar melhor, tudo começou com esta issue, a partir dela você consegue chegar em toda a discussão sobre a API