Skip to content
Mock online library catalog that allows end users to check the availability of books. Full CRUD admin accessible to superusers.
JavaScript CSS Python HTML Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
catalog
locallibrary
loclib
staticfiles
templates/registration
.gitignore
LICENSE
Procfile
README.md
manage.py
requirements.txt
runtime.txt

README.md

Django Local Library

Mock online library catalog access platform that allows the end user to see books the library carries and their availability. The end user cannot check out books online.

Demo

A superuser/admin can access the Admin platform (/admin) to add new authors and books. Login: admin password: Qaz2Wsx#Edc

The main features that have currently been implemented are:

  • There are models for books, book copies, genre, language and authors.
  • Users can view list and detail information for books and authors.
  • Admin users can create and manage models. The admin has been optimised (the basic registration is present in admin.py, but commented out).
  • Librarians can renew reserved books.

Local Library Model

Fixes/Features being worked on:

  1. Improve the UI for all devices.
  2. Fix 500 error when accessing "All Borrowed" (/catalog/borrowed/). Works locally but not on Heroku, related to static files, see Heroku doc.

Quick Start

Make sure you're in the root directory where requirements.txt is located and set this up within a Python virtual environment.

python3 -m venv anyenvname # any name your want, all lowercase, no spaces or special characters
source anyenvname/bin/activate
pip3 install -r requirements.txt
python3 manage.py makemigrations
python3 manage.py migrate
python3 manage.py collectstatic
python3 manage.py test # run the standard tests, all should pass
python3 manage.py createsuperuser # create a superuser & password that you will use for Admin log in. 
python3 manage.py runserver

Admin: http://127.0.0.1:8000/admin/ - Log in and create new entries, after adding, make sure you see them on the main page: http://127.0.0.1:8000.

Deploy

Follow insturctions for deploying Django apps on the hosting service (Heroku's instructions).

You can’t perform that action at this time.