Skip to content

Latest commit

 

History

History
117 lines (81 loc) · 6.33 KB

05-makewiki.md

File metadata and controls

117 lines (81 loc) · 6.33 KB
Raw

Homework 5: MakeWiki

Purpose (Why should I do this?)

This assignment is designed for you to practice using forms and authentication, as well as writing unit and route tests for your code.

To complete this assignment, you can and should reference your code for Assignment 4: Polls Redux. This assignment is for the most part very similar, and is designed to be a check for understanding.

Scoring is as follows:

Criteria Possible
Login & Logout 10
Signup 10
Wiki Article Creation Form 10
Wiki Article Edit Form 10
Wiki Details Page Test 10
Wiki Details Page Edit Test 10
Wiki Creation Page Test 10
TOTAL 70

Setup

Go to the MakeWiki starter code and clone the repository to your local hard drive. Then, set up a new repository for your application on GitHub.com and execute the following to switch the remote:

$ git remote remove origin
$ git remote add origin git@github.com:USERNAME/REPOSITORY.git

Run the server and take a look at the site: there is a Wiki List page which lists the wiki articles, and a Wiki Detail page which lists specific details about each one.

Part 1: Authentication

In this part, we'll add the login, logout, & signup functionality to the MakeWiki app.

Login & Logout (10 Points)

  1. Add the Django authentication views in django.contrib.auth.urls to the project's URLconf.
  2. Test /accounts/login in your browser -- see if you can log in using username admin and password djangopony.
  3. In base.html, hide the New Page and Log Out buttons for unauthenticated users.
  4. When a user clicks Log Out, they should be logged out of the system, and returned to the homepage.
  5. When a user clicks Log In, they should be navigated to the Login page.
  6. Replace Hello, USERNAME text with the username of the logged-in user, and only show it when the user is logged in.

Signup (10 Points)

  1. Create a new app named accounts. Add it to the INSTALLED_APPS list in settings.py.
  2. Create a view for signing up that extends django.views.generic.CreateView and renders the template contained in registration/signup.html.
  3. In accounts/urls.py, link the SignupView class to a URL named signup.
  4. Add accounts.urls to the project's URLconf.
  5. When a user clicks Sign Up, they should be presented with a form to create an account, and can submit it successfully.

Part 2: Forms

Here we'll flesh out the functionality of the "Create" button, as well as provide an Edit option to edit existing wiki articles.

Wiki Article Creation Form (10 Points)

To add a Create view, complete the following steps in the wiki app:

  1. In views.py, import the ArticleForm class from forms.py. This form enables editing and creating of Article objects in the database.
  2. Create a new view class called ArticleCreateView. Link it to a URL named create.
  3. On GET, render a template to display the ArticleForm instance.
  4. On POST, check if the data in the form is valid.
  • If True, save the data and use the logged-in user as the Article's author. Then, redirect to the Detail View for the newly created Article object.
  • If False, display all the errors in the template, above the form fields.
  1. Instead of hard-coding the path to redirect to, use the reverse function to return the path.

Wiki Article Edit Form (10 Points)

For the Article Detail view, complete the following steps in the wiki app:

  1. In views.py, import the ArticleForm class from forms.py. Edit the ArticleDetailView class as follows:
  2. On GET, render an edit form below the article details.
  3. On POST, check if the data in the form is valid.
  • If True, save the data and use the logged-in user as the Article's author. Then, redirect back to the Detail View.
  • If False, display all the errors in the template, above the form fields.
  1. Instead of hard-coding the path to redirect to, use the reverse function to return the path.
  2. (Stretch Challenge) After successfully editing an Article, use Django Messages to "flash" the user a success message: "REPLACE_WITH_ARTICLE_TITLE has been successfully updated."
  3. (Stretch Challenge) Use the Crispy Forms library in conjunction with Bootstrap to make your forms look even more beautiful and clean (and, well, crisp)!

Part 3: Testing

In this part of the assignment, we'll flex our testing muscles and write some route tests!

Wiki Details Page Test (10 Points)

Write a route test that does the following:

  1. Create an instance of Article and save it to the database. (HINT: You'll need to first create an instance of User to use as the article's author.)
  2. Load the Wiki Details page for that Article's slug.
  3. Verify that the response has a status_code of 200.
  4. Verify that the response's context includes the info for the Article object requested. (HINT: You can use assertContains to check the exact text of the response.)

Wiki Details Page Edit Test (10 Points)

Write a route test that does the following:

  1. Create an instance of Article and save it to the database.
  2. Create a dictionary of key-value pairs containing the post data to be sent via the form. This should include a new article title and description.
  3. Make a POST request to the details page with self.client.post().
  4. Check that we get a 302 status code. (Why 302 and not 200?)
  5. Check that the article object was modified in the test database.

Wiki Creation Page Test (10 Points)

Write a route test that does the following:

  1. Create a dictionary of key-value pairs containing the post data to be sent via the form. This should include an article title and description.
  2. Make a POST request to the Wiki Create page with self.client.post().
  3. Check that we get a 302 status code.
  4. Check that the article object was created in the test database.

Submission

Submit your finished homework using our class submission site.