/warbler

Twitter-like online social networking platform allowing users to post, view, like messages and follow other users.

Primary LanguagePython

Warbler

Warbler Gif

A Twitter clone with a Rithm spin.

Live site

Installation

# make a virtual environment
mkvirtualenv warbler
# install python requirements
pip install -r requirements.txt

# set up database
dropdb warbler_db
createdb warbler_db
flask db upgrade

# The database must be freshly created before doing this command
# If you have already added data, make sure to follow the steps above
# to reset the database.
python seed.py

# start the server!
flask run

Assignment

Try to understand the code. Look through and see what each route is doing. Take a look at the models. See what data you have in your database after running python seed.py.

When you're ready, address the following user stories:

  1. As a user, I want to see a custom 404 page when I try to go to an invalid URL.
  2. As a user, I want to see the location, bio, and my header image on a user's profile page. (Note: these fields already exist in the database, you just have to integrate them into the UI.)
  3. As a user, I want to see other users' bios and header images on the profile cards that appear on the following and follower pages, as well as in search results.
  4. As a user, I want to be able to edit my location, bio, and my header image on my profile edit page.
  5. As a user, I want to see the last 100 warbles only from the users that I am following, and myself rather than warbles from all users.
  6. As a user, I want to be able to "like" a warble.
  7. As a user, I want to be able to see how many warbles I "liked" on my profile page.
  8. (Technical) - Add tests. Test features such as login, making sure you cannot edit someone else profile, etc. There is a sample test file below. You can also check out the testing notes in the python curriculum. To run the tests, pip install green then run green from the root of your project.

Bonus

  1. As a user, I should not have to refresh the page when I like a warble.
  2. As a user, I should not have to refresh the page when I change my bio or name in my profile.
  3. As a user, I should not have to go to a new page to compose a warble (think modals and AJAX here!)
  4. (Technical) - Look for opportunities to refactor! In the templates especially, there are opportunities to DRY up the code.
  5. (Technical) - The application has an n + 1 query issue. Set app.config['SQLALCHEMY_ECHO'] = True and try to fix the issue.

Super Bonus

Fair warning: you won't have time to tackle all of these. Pick one or two that interest you!

  1. As a user, I should be able to send a direct message to another user which is only visible to the two of us.
  2. As a user, I should be able to respond to a direct message sent to me.
  3. As a user, I should be able to block another user, so that they are no longer visible to me and they cannot send me direct messages.
  4. As a user, I should be able to see a list of all of the users I've blocked.
  5. As a user, I should be able to unblock a user I've previously blocked.
  6. As an admin user, I should be able to delete anyone's messages.
  7. As an admin user, I should be able to delete users from the platform.
  8. As an admin user, I should be able to add or revoke admin privileges for any other user.

Appendix: Seeding the DB

In the generator directory you'll see there are some Python files along with some CSVs. The seed.py file reads the CSV data in order to pre-populate the database. If you'd like to generate a new set of fake data, you can run

python generator/create_csvs.py

This will create a new set of fake data with which you can seed your database.

Appendix: Testing

There are at LEAST two bugs in the application, but it's not necessarily obvious where it is (there's a hint at the bottom of the readme). This is why testing is so important!

Let's briefly discuss a couple of things related to tests: how you should test, and what you should test. First, let's talk about the how. You might organize your tests like this:

  • test_user_model.py
  • test_user_views.py
  • test_message_model.py
  • test_message_views.py

In this case, there are four test files: two for testing the models, and two for testing the routes/view-functions.

To run a file containing unittests, you can run the command python -m unittest <name-of-python-file>.

So that's how you should test. But what, exactly, should you be testing? Let's take the above file structure as an example.

For model tests, you can simply verify that models have the attributes you expect, and write tests for any model methods.

For the routing and view function tests, things get a bit more complicated. You should make sure that requests to all the endpoints supported in the views files return valid responses. If certain routes are protected, you should make sure that users who are not authenticated or authorized cannot successfully make those requests. Conversely, if they are authenticated or authorized, they should be able to.

These tests are a bit trickier to write because they require you to make requests in the test, and look through the response in order to verify that the HTML you get back from the server looks correct.

Here are a few different resources for testing your Flask applications.

(If you're still looking for those 🐛🐛, scroll down for soome hints.)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

For one bug, the first step in producing it is searching for yourself while you're logged in.

For another bug, what happens when you go to /users/login when you're already logged in?