Reader is a project that allows anonymous users to view a list of available books on the homepage and search for books based on title, author, or summary. If an anonymous user wants to borrow a book, they are redirected to the login page. Logged-in users can borrow books from the available collection. On the project, admin users have additional privileges to manage authors, books, and renewals.
The app is also tested extensively, making sure most parts of the app behave as expected.
Live link
Follow the link below to view the deployed version of the app
https://reader-production-eb1.up.railway.app/catalog/
The page for logged in users to borrow books.
The admin users have the permission to add books and add authors to the site, they can also renew book instances for the user.
- First clone this repository from Github to your local machine
git clone https://github.com/DanAdewole/LocalLibrary.git
- Change your directory to where you cloned the repository
cd localLibrary
- Create a virtual environment in the localLibrary Directory
python -m venv .\venv
- Activate the virtual environment
venv\scripts\activate
Note: Upon running the command venv\scripts\activate, if this error shows up:
venv\scripts\activate : File C:\Users\Training\Documents\New folder\venv\scripts\Activate.ps1 cannot be loaded because running scripts is
disabled on this system. For more information, see about_Execution_Policies at http://go.microsoft.com/fwlink/?LinkID=135170.
Run this command:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
Then run the command to activate the virtual environment
- Install all the necessary packages
pip install -r requirements.txt
- Make migrations Run the following commands separately to make migrations
python manage.py makemigrations
python manage.py migrate
- Create a new superuser Run the following command to create a new superuser
python manage.py createsuperuser
Update debug settings in the project settings file Go to locallibrary/settings.py and change DEBUG to True
DEBUG = True
- Run the project
python manage.py runserver
This project is under an MIT LICENSE