This package is a required project of the "Full Stack Web Developer" nanodegree at Udacity. The main objectives of this practice include building a web application, 'Catalog App', using Python-Flask library, implementing CRUD functions in the application based on a REST architecture, using OAuth to provide secure and user-specific user experience, applying skillsets such as html, css, sql, etc. There are three Python code files writen in Python 2.7.13.
- The 'database_setupi.py' creates and configurates a database 'itemcats.db' using SQLAlchemy library;
- The 'itempop.py' can poplulate the database with some starting data. *This is optional as the one can populate the database manually through the application.
- The 'itemcat.py' uses multiple libraries, such as Flask, SQLAlchemy, Oauth2, to setup the application server side.
The 'Catalog App' will:
- Display all current categories with the latest added items at '/home' page.
- Display all the items available for certain category at the category page.
- Display specific information an item at the item page.
- Allow user loging. After logging in, a user can add, update, or delete item information. *Users will be able to modify only those items that they themselves have created.
- Provide JSON endpoints at '/home/JSON'--catagories, '/catitems/<cat_name>/int:cat_id/items/JSON'--items in a catagory, and '/catitems/<cat_name>/<item_name>/int:item_id/JSON'--item info.
The program is developed in a virtual machine of Ubuntu 16.04.2 environment. It has not been tested in other systems. To use the program, you need to:
- install and set up GIT, Virtual Box, and Vagrant(Please open port 8000 for the application)
- set up a command line terminal to run Python
- install sqlalchemy, flask, and Oauth2.0
- run the database_setupi.py in the command line
- *(optional) run itempop.py in the command line if you want prepopulate the database
- run itemcat.py in the command line
- view the application in a browser at 'http://localhost:8000/home'
MIT