A web application that provides a list of items within a variety of categories as well as providing a user registration and authentication system. Registered users will have the ability to post, edit and delete their own items.

(Using $repo to refer to the path of the repository)

1. Install Vagrant and VirtualBox
2. Use the command vagrant ssh to ssh into the VM.
3. In the VM, go to /vagrant/catalog/ and run python populatedb.py to create the database and populate it with tags and items.
4. In /vagrant/catalog/ and run python runserver.py to start the server.
5. In your browser, navigate to http://localhost:5000.
6. Sign in with Google to experience full functionality. Note that the first user you sign in with will be considered the owner of all the items and tags created by populatedb.py. Sign out and sign in with a second user to verify that users cannot change other users' items or tags.

The admin interface can be found at /admin/. This allows the admin to view a table of information about users, and to activate and deactivate users. Deactivated users can no longer add, edit or delete items or tags, whereas activated users can add items and tags, and can edit and delete their own items and tags.

Admin users can also edit and delete any item or category, regardless of ownership.

To make a user into an admin, use the script make_admin.py in $repo/vagrant/catalog/, specifying either revoke or grant and the email address of the relevant user, and then follow the prompts. For example:

vagrant@vagrant-ubuntu-trusty-32:/vagrant/catalog$ python make_admin.py grant example@example.com
Looking for a user with email address: example@example.com
Found the following users:

<User: name='Vikash Example', email='example@example.com', id=2, activated=True, admin=False>

Grant admin privileges? (y/n): y
Admin privileges changed.

<User: name='Bob Example', email='example@example.com', id=2, activated=True, admin=True>

Goodbye

• /catalog.json
  • Shows information on all tags and all items, referenced from 'Items' and 'Tags' keys
• /catalog/items.json
  • Shows only the 'Items' portion of the information in /catalog.json
• /catalog/tags.json
  • Shows only the 'Tags' portion of the information in /catalog.json
• /catalog/tags/view/<tag_name>.json
  • Shows information for the tag with name <tag_name>
• /catalog/items/view/<item_name>-<int:item_id>.json
  • Shows information for the tag with the specified name and id

An atom feed of the latest items can be accessed at /catalog/recent.atom .

• The lines in the Item model creating the automatically populated and updated created_on and updated_on columns relies heavily on this Stackoverflow answer:
  • http://stackoverflow.com/a/12155686
• The Atom feed borrows from the following examples:
  • http://flask.pocoo.org/snippets/10/
  • http://werkzeug.pocoo.org/docs/0.11/contrib/atom/
• The logging feature was created with help from the following tutorials and examples:
  • http://flask.pocoo.org/docs/0.10/quickstart/#logging
  • https://gist.github.com/ibeex/3257877
  • https://docs.python.org/2/howto/logging.html
• The Oauth code takes Udacity code samples as a starting point, but modifed these to use WTForms CSRF features and add other functionality:
  • https://github.com/udacity/ud330/blob/master/Lesson2/step5/project.py
  • https://github.com/udacity/ud330/blob/master/Lesson2/step4/templates/login.html
• The gdisconnect view from the Udacity code samples was used in full:
  • https://github.com/udacity/ud330/blob/master/Lesson2/step6/project.py
• The login_required decorator in the auth_helpers module is based on the example in this tutorial:
  • http://flask.pocoo.org/docs/0.10/patterns/viewdecorators/
• Used Udacity class methods getByID, getIDByEmail and createForID are based on the helper functions getUserInfo, getUserId and createUSer in:
  • https://github.com/udacity/ud330/blob/master/Lesson3/step2Quiz/project.py
• The basic Bootstrap template is adapted from here, as is theme.css:
  • http://getbootstrap.com/examples/theme/
• The form styling is based on this Bootstrap tutorial:
  • http://getbootstrap.com/css/#forms