sj-t / the_book Goto Github PK

This is a book-searching web app. Like the description, it can search books and give you some info about books.

Main Features

• Search books by its title, author or ISBN.
• Display information about the book like cover, title, author, ISBN, publisher, publication date, description.
• Add to shelf: users can add the book to their collection after login.
• Give ratings: users can add ratings to the books after login.

Technologies

• Flask framework.
• Sqlite database locally and postgres database on server.

Defects

• If you update the ratings you gave, the average ratings won't update.
• The books on the shelf cannot be deleted.
• Reset password part hasn't been implemented.
• The book detail page on deployed web app cannot hide excess text in the description.(While it works fine locally)

https://desolate-shelf-39908.herokuapp.com/

• I use dataset of books as books' info stored in my database. This is the dataset source: https://www.kaggle.com/austinreese/goodreads-books . Due to free postgres database limit on heroku, I only uploaded 7000 rows of book data. If you run it locally, it should contains around 50,000 rows of data. The only difference between the web app at local and heroku is number of search results.

• Create a new folder, change directory into that new folder
• git clone <repoURL>

• Change directory to the repository just cloned.

• Point Flask to your application:

  macOS/Linux: export FLASK_APP=main.py

  Windows: set FLASK_APP=main.py

• Run the flask application:

  flask run

• Open the web app Go http://localhost:5000 in your browser.

• Quit the web app Press CTRL+C in terminal

• FLASK blog tutorial by Corey Schafer: https://www.youtube.com/playlist?list=PL-osiE80TeTs4UjLw5MM6OjgkjFeUxCYH
• Goodreads Books - 31 Features by Austin Reese: https://www.kaggle.com/austinreese/goodreads-books
• 5 star rating with css and html by hongde_he: https://codepen.io/hesguru/pen/BaybqXv
• Five Methods for Five-Star Ratings by Alfred Genkin: https://css-tricks.com/five-methods-for-five-star-ratings/