Este projeto de API e interface do usuário foi desenvolvido para a disciplina de Desenvolvimento Full Stack Básico do programa de pós-graduação em Desenvolvimento Full Stack da PUC-Rio.
Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas: Git, Node.js e Python. Além disto é bom ter um editor para trabalhar com o código como VSCode
# Clone este repositório
$ git clone https://github.com/eliasmatheus/simple-flask-blog
# Acesse a pasta do projeto no terminal/cmd
$ cd simple-flask-blog/web
# Instale as dependências
$ npm install
# Execute a aplicação em modo de desenvolvimento
$ npm run dev
# A aplicação inciará na porta:5173 - acesse <http://127.0.0.1:5173/>
Abra o http://127.0.0.1:5173/ para acessar a aplicação.
Para rodar o servidor será necessário ter todas as libs python listadas no requirements.txt
instaladas.
Após clonar o repositório, é necessário ir ao diretório raiz, pelo terminal, para poder executar os comandos descritos abaixo.
É fortemente indicado o uso de ambientes virtuais do tipo [virtualenv](https://virtualenpython -m venv .v.pypa.io/en/latest/).
# Em outro terminal, acesse a pasta do projeto no terminal/cmd
$ cd simple-flask-blog/server
# Instale as dependências
$ pip install -r requirements.txt
# Este comando instala as dependências/bibliotecas, descritas no arquivo `requirements.txt`.
# Execute a aplicação
$ flask run --host 0.0.0.0 --port 5000
Em modo de desenvolvimento é recomendado executar utilizando o parâmetro reload, que reiniciará o servidor automaticamente após uma mudança no código fonte.
# Execute a aplicação em modo de desenvolvimento
$ flask run --host 0.0.0.0 --port 5000 --reload
Abra o http://localhost:5000/#/ no navegador para verificar o status da API em execução.
Ao acessar a raiz da API pelo navegador (http://localhost:5002/), você será redirecionado para a documentação da API. Nesta tela você poderá escolher uma das interfaces (Swagger, ReDoc ou RapiDoc) para testar os endpoints da API.