Flask-Scaffold let's you scaffold a MySQL or PostgreSQL driven Web Application with Flask and Angularjs. It will create views,models and templates for a given Resource along with API endpoints and Unit tests.
Features include
- Python 3 Support
- RESTFUL JSON API
- Unit Testing with python Unit tests
- End 2 End testing with Protractor
- Continous Integration with Travis-CI
###Demo
###Installation
Please ensure that development libraries for PostgreSQL are installed.
####Step 1:Clone the project to your application folder.
git clone [email protected]:Leo-g/Flask-Scaffold.git YourAppFolderName && cd YourAppFolderName
####Step 2: Install the requirements and add your Database configuration details.
pip install -r requirements.txt
vim config.py
#Fill in your database username, password, name, host etc
For a list of supported fields please see https://github.com/Leo-g/Flask-Scaffold/wiki/Fields
vim scaffold/blog.yaml
posts:
- title:string
- body:text
- author:string
- creation_date:date
- published:boolean
comments:
- author:string
- body:text
- author_url:url
- created_on:date
- approved:boolean
authors:
- name:string
- profile:text
- url:url
python scaffold.py scaffold/blog.yaml
python db.py db init
python db.py db migrate
python db.py db upgrade
python run.py
**You should be able to see the web dashboard at http://localhost:5000
To configure your application with nginx and uwsgi configuration see the wiki ###Tests
####For E2E testing with protractor Installation instructions for protractor are in the wiki
protractor app/templates/<module_name>/conf.js
####For unit testing with python Unit tests
python app/<module_name>/test_<module_name>.py
####For testing multiple modules bash tests.bash
###API
API calls can be made to the following URL
Note: This example is for a Post module
HTTP Method | URL | Results |
---|---|---|
GET | http://localhost:5000/api/v1/posts.json | Returns a list of all Posts |
POST | http://localhost:5000/api/v1/posts.json | Creates a New Post |
GET | http://localhost:5000/api/v1/posts/1.json | Returns details for the a single Post |
PATCH | http://localhost:5000/api/v1/posts/1.json | Update a Post |
DELETE | http://localhost:8001/api/v1/posts/1.json | Delete a Post |
The JSON format follows the spec at jsonapi.org and a sample is available in the sample.json file
For details on how the API is built read http://techarena51.com/index.php/buidling-a-database-driven-restful-json-api-in-python-3-with-flask-flask-restful-and-sqlalchemy/
###Directory Structure Project-Folder |-- config.py |--run.py |--requirements.txt |__ /venv |-- db.py |__ /scaffold |-- scaffold.py |-- tests.bash #Tests for all modules |__ app/ |-- init.py +-- module-1 |-- init.py |-- models.py |-- test_module-1.py # Unit Tests for module 1 |-- views.py +-- module-2 |-- init.py |-- models.py |-- test_module-2.py # Unit Tests for module 2 |-- views.py |__ templates |-- index.html +-- static |-- js |-- css |-- images +-- module-1 |-- _form.html |-- index.html |-- add.html |-- update.html |-- controller.js +-- module-2 |-- _form.html |-- index.html |-- add.html |-- update.html |-- controller.js