kevinbowen777 / django-api-library

Basic django api functionality demo using DRF

django-api-library

• A basic library website & API built with Django 4.2.x & Django REST Framework (DRF) 3.13.x

Table of Contents

• Features
• Installation
• Testing
• API URLs
• Application Demo
• Screenshots
• Reporting Bugs

---

Features

• Application
  • Browseable Web API
  • SwaggerUI & ReDoc API documentation
  • User registration with email verification & social(GitHub) login using django-allauth
  • Bootstrap4 & crispy-forms decorations
  • Customizable user profile pages with bio, profile pic, & country flags
  • For additional links to package resources used in this repository, see the Package Index
• Dev/testing
  • Basic module testing templates
  • Coverage reports in htmlcov directory
  • Debug-toolbar available. See notes in config/settings.py for enabling.
  • Examples of using Factories & pytest fixtures in account app testing
  • shell_plus with IPython via django-extensions package
  • Nox testing sessions for latest Python 3.9, 3.10, 3.11, and 3.12
    • black (nox -s black)
    • Sphinx documentaion generation (nox -s lint)
    • linting
      • flake8
      • flake8-bandit
      • flake8-bugbear
      • flake8-import-order
    • safety(python package vulnerability testing) (nox -s safety)
    • pytest sessions with pytest-cov & pytest-django (coverage run -m pytest)

Installation

• git clone https://github.com/kevinbowen777/django-api-library.git
• cd django-api-library
• Local installation
  • poetry install
  • python manage.py migrate
  • python manage.py createsuperuser
  • python manage.py runserver
• Docker installation
  • docker compose up --build
  • docker compose exec web python manage.py migrate
  • docker compose exec web python manage.py createsuperuser Additional commands:
    • docker compose exec web python manage.py shell_plus (loads Django shell autoloading project models & classes)
    • docker run -it django-start-web bash (CLI access to container)
• Browse to http://127.0.0.1:8000 or http://127.0.0.1:8000/resources/
• Pre-commit:
  • To add the hook, run the following command in the poetry shell:
    • pre-commit install

---

Testing

• docker compose exec web python manage.py test
• coverage run -m pytest
• Nox (includes sessions for black, lint, safety, tests)
  • testing supported for Python 3.9, 3.10, 3.11, 3.12
  • e.g. nox, nox -rs lint-3.11, nox -s tests
    • nox
    • nox -s black-3.12
    • nox -s docs-3.11
    • nox -rs lint-3.9 (Use the 'r' flag to reuse existing session)
    • nox -s safety (will run tests against all Python versions)
    • nox -s tests

---

API URLs

• Log In endpoint: http://127.0.0.1:8000/api/v1/dj-rest-auth/login/
• Log Out endpoint: http://127.0.0.1:8000/api/v1/dj-rest-auth/logout/
• Password reset: http://127.0.0.1:8000/api/v1/dj-rest-auth/password/reset
• Password reset confirmation: http://127.0.0.1:8000/api/v1/dj-rest-auth/password/reset/confirm
• User registration endpoint: http://127.0.0.1:8000/api/v1/dj-rest-auth/registration/
• User list: http://127.0.0.1:8000/api/v1/users/
• User detail: http://127.0.0.1:8000/api/v1/users/1/
• API schema download: http://127.0.0.1:8000/api/schema/
• Redoc API browser: http://127.0.0.1:8000/api/schema/redoc/
• Swagger-UI: http://127.0.0.1:8000/api/schema/swagger-ui/

---

Application Demo

A live application demonstration:

TBD

---

Screenshots

Home

Index

Profile Page

Login Page

Book List View

Swagger-UI

Redoc API page

Menu Bar

Email Address management

---

Reporting Bugs

Visit the Issues page to view currently open bug reports or open a new issue.