Django App

App based on Python Django web Framework

Current Apps

• Blog

Setup

1. create virtual env (windows): python -m venv env
2. activate env: .\env\Scripts\activate
3. install requirement: pip install -r requirements.txt
4. create super user: python manage.py createsuperuser
5. do migrations: python manage.py migrate
6. run app: python manage.py runserver

Shell Usage

1. enter db shell: ```python manage.py dbshell``
   • if command doesn't work, make sure sqlie3 exe in path var: https://www.sqlite.org/download.html
   • commands
     • to see tables: .tables
     • see schema: .schema tablename

Tasks

• Setup basic Django project
• add basic blog
• add CRUD features
• add favorite star icon to turn on/off
• add tasks model
• add search feature
• add pagination
• add ckeditor for rich text editing
  • pip install django-ckeditor
  • requires migration after changes and add to settings.py under INSTALLED_APPS
  • add RichTextField to forms
• try crispy forms
• add tests - https://docs.djangoproject.com/en/3.1/internals/contributing/writing-code/unit-tests/
• containerized app with docker/docker-compose
• use github actions .github\workflows\python-app.yml
  • added build status icon
  • made changes to work with both locally and in github actions

Running Tests

1. blog tests: python manage.py test blog

Running using pytest

1. pytest

Docker Practice

Using Dockerfile

1. build : docker build --tag python-django .
2. run: docker run --name djangoapp --publish 8000:8000 python-django
3. apply migration by logging into container: docker exec -it djangoapp /bin/bash

Using Docker Compose

official example

1. build image: docker-compose build
2. run: docker-compose up
3. apply migrations; app = service name specified in yml file:
   • apply migrations:docker-compose exec app python manage.py makemigrations
   • migrate: docker-compose exec app python manage.py migrate
4. to make updates in dev and see changes: docker-compose up --build
5. create superuser: docker-compose exec app python manage.py createsuperuser

Switching to Postgress DB

1. edit compose file to add image; add psycopg2-binary to requirements.txt
2. updated db in: src\web_project\settings.py
3. run docker-compose up
   • in linux, if you get permission denied, run sudo chown -R $USER:$USER .
4. apply migrations
   • apply migrations:docker-compose exec app python manage.py makemigrations
   • migrate: docker-compose exec app python manage.py migrate