https://github.com/alesanchezr/microservice-flask-test

https://github.com/alesanchezr/microservice-flask-test

Last synced: 13 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/alesanchezr/microservice-flask-test
• Owner: alesanchezr
• Created: 2020-06-11T04:50:13.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-05-06T20:24:55.000Z (over 3 years ago)
• Last Synced: 2024-10-04T02:21:12.713Z (about 1 month ago)
• Language: Python
• Size: 17.1 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Flask Boilerplate for Profesional Development

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/from-referrer/)

## Features

- Extensive documentation [here](https://github.com/4GeeksAcademy/flask-rest-hello/tree/master/docs).

- Integrated with Pipenv for package managing.

- Fast deloyment to heroku with `$ pipenv run deploy`.

- Use of `.env` file.

- SQLAlchemy integration for database abstraction.

## How to Start the Project?

There is an example API working with an example database. All your application code should be written inside the `./src/` folder.

- src/main.py (it's where your endpoints should be coded)

- src/models.py (your database tables and serialization logic)

- src/utils.py (some reusable classes and functions)

For a more detailed explanation, look for the tutorial inside the `docs` folder.

## Remember to migrate every time you change your models

You have to migrate and upgrade the migrations for every update you make to your models:

```

$ pipenv run migrate (to make the migrations)

$ pipenv run upgrade  (to update your databse with the migrations)

```

# Manual Installation for Ubuntu & Mac

⚠️ Make sure you have `python 3.6+` and `MySQL` installed on your computer and MySQL is running, then run the following commands:

```sh

$ pipenv install (to install pip packages)

$ pipenv run migrate (to create the database)

$ pipenv run start (to start the flask webserver)

```

## Deploy to Heroku

This template is 100% compatible with Heroku[https://www.heroku.com/], just make sure to understand and execute the following steps:

```sh

// Install heroku

$ npm i heroku -g

// Login to heroku on the command line

$ heroku login -i

// Create an application (if you don't have it already)

$ heroku create 

// Commit and push to heroku (commited your changes)

$ git push heroku master

```

:warning: For a more detailed explanation on working with .env variables or the MySQL database [read the full guide](https://github.com/4GeeksAcademy/flask-rest-hello/blob/master/docs/DEPLOY_YOUR_APP.md).