Skip to content
Branch: master
Find file History
Pull request Compare This branch is 308 commits ahead, 40 commits behind udacity:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
catalog
README.md
application.py
catalog.ini
catalog.wsgi
fb_client_secrets.json
g_client_secrets.json
requirements.txt

README.md

Project 3: Item Catalog

by Steven Wooding

Item Catalog project, part of the Udacity Full Stack Web Developer Nanodegree.

What it is and does

Runs a website called Zooma (Zoo Management App) that stores details of animals (the items) in the 6 categories of the animal kingdom. The user can login via Google or Facebook in order to add their own animals. They can specify how many of each animal there is in the zoo and supply a picture of the animal.

The backend code mainly refers to items, while the front talks about animals. Items were used as a requirement from Udacity of the URLs that were required to be functional.

Required Libraries and Dependencies

The project code requires the following software:

  • Python 2.7.x
  • SQLAlchemy 0.8.4 or higher (a Python SQL toolkit)
  • Flask 0.10.1 or higher (a web development microframework)
  • The following Python packages:
    • oauth2client
    • requests
    • httplib2
    • flask-seasurf (a CSRF defence)

You can run the project in a Vagrant managed virtual machine (VM) which includes all the required dependencies (see below for how to run the VM). For this you will need Vagrant and VirtualBox software installed on your system.

Project contents

This project consists for the following files in the catalog directory:

  • application.py - The main Python script that serves the website. If no database is found, one is created and populated by populate_database.py.
  • fb_client_secrets.json - Client secrets for Facebook OAuth login.
  • g_client_secrets.json - Client secrets for Google OAuth login.
  • README.md - This read me file.
  • /catalog - Directory containing the catalog package.
    • /static - Directory containing CSS and Javascript for the website. Includes a copy of the Material Design Lite web framework by Google and JavaScript Cookie, a JavaScript API for handling cookies.
    • /templates - Directory containing the HTML templates for the website, using the Jinja 2 templating language for Python. See next section for more details on contents.
    • __init__.py - Initialises the Flask app and imports the URL routes.
    • auth.py - Handles the login and logout of users using OAuth.
    • connect_to_database.py - Function for connecting to the database.
    • database_setup.py - Defines the database classes and creates an empty database.
    • file_management.py - Functions for handling user uploaded image files.
    • json_endpoint.py - Returns the data in JSON format.
    • populate_database.py - Inserts a selection of animals into the database.
    • views.py - Provides backend code to produce web page views of the data and forms for creating, editing and deleting animals. It also ensures that only the user that added an animal can edit or delete it.
    • xml_generator.py - Returns the data in XML format.

Templates

The /templates directory contains the following files, written in HTML and the Jinja2 templating language:

  • add_item_button.html - Renders a MDL button on a page to add a new item (animal).
  • delete_item.html - Delete animal confirmation page.
  • edit_item.html - Form to edit the details of an animal.
  • homepage.html - The default page, which lists the 10 latest animals that were added.
  • item.html - A page that displays a single animal and its details.
  • items.html - A page that lists the animals belonging to a single category.
  • layout.html - This defines the common layout of the website and is the parent for all the other template pages.
  • login.html - A login page featuring OAuth Goolge+ and Facebook login buttons.
  • my_items.html - A page for displaying the animals you have added to the website.
  • new_item.html - A form for creating a new animal.

How to Run the Project

Download the project zip file to you computer and unzip the file. Or clone this repository to your desktop.

Open the text-based interface for your operating system (e.g. the terminal window in Linux, the command prompt in Windows).

Navigate to the project directory and then enter the vagrant directory.

Bringing the VM up

Bring up the VM with the following command:

vagrant up

The first time you run this command it will take awhile, as the VM image needs to be downloaded.

You can then log into the VM with the following command:

vagrant ssh

More detailed instructions for installing the Vagrant VM can be found here.

Make sure you're in the right place

Once inside the VM, navigate to the tournament directory with this command:

cd /vagrant/catalog

OAuth setup

In order to log in to the web app, you will need to get either a Google+ or Facebook (or both) OAuth app ID and secret. For Google, go to the Google Developers Console and for Facebook, go to Facebook Login.

Once you have your credentials, put the IDs and secrets in the fb_client_secrets.json file for Facebook and g_client_secrets.json for Google.

You will now be able to log in to the app.

Run application.py

On the first run of application.py there will be no database present, so it creates one and populates it with sample data. On the command line do:

python application.py

It then starts a web server that serves the application. To view the application, go to the following address using a browser on the host system:

http://localhost:8000/

You should see the 10 latest animals that were added to the database. Go ahead and explore the web site. To add an animal, you'll need to log in first with either a Google or Facebook account.

Shutting the VM down

When you are finished with the VM, press Ctrl-D to logout of it and shut it down with this command:

vagrant halt

Extra Credit Description

The following features are present to earn an extra credit from Udacity.

XML Endpoint

Database contents can be obtained in XML form by going to http://localhost:8000/catalog.xml. Depending on your browser, you may need to view source of the page to view the XML file. You can do this by right-clicking and selecting View Page Source from the menu.

Images

The Zooma app allows the user to add, edit and delete an image for each animal. An image may either be uploaded to the app or specified with the URL of an image. If an animal has an image associated with, it is displayed to all users.

Cross-site Request Forgery Protection

The app uses the Flask plugin SeaSurf, in order to protect against cross-site request forgery. An addition cookie is stored in the client containing a nonce. When a user logs in, adds, edits or deletes an item, the contents of this cookie is checked to make sure it matches the value on the server. If it does not match or is missing, no change to the database will be made.

Miscellaneous

This README document is based on a template suggested by PhilipCoach in this Udacity forum post.

You can’t perform that action at this time.