Taskcamp

This software is used for educational and demonstrative purposes. It's a simple project management tool powered by Django Framework

Install
Development
Testing
- Run tests
- Run tests with coverage

Features:

Class-Based Views approach
Login, Sign Up, Recover (LoginView, FormView, UserCreationForm, PasswordResetForm, LogoutView, PasswordResetView, PasswordResetDoneView, PasswordResetConfirmView, PasswordResetCompleteView)
Custom Extended User model (AbstractUser, BaseUserManager, UserManager)
Permissions and Groups (LoginRequiredMixin, PermissionRequiredMixin)
Simple CRUD views (ListView, DetailView, CreateView, UpdateView, DeleteView)
File uploading
Statistics (TemplateView, View, Q, F, Count, FloatField, Cast, Case, When, Sum, Avg)
Forms (Form, ModelForm)
Admin page (ModelAdmin, TabularInline)
Template and layouts (include templates, blocks, custom 500, 404, 403 handlers)
Router urls (include, namespace, params)
Caching (memcached)
Async workers with celery
Localization and internationalization (with pluralization)
Timezone support (pytz)
Markdown syntax, Status highlight (Template tags)
DB router (master, slave)
Unittests with coverage
Uwsgi (with static and media serving)
Docker and docker-compose
kubernetes deploy

Components:

Database PostgreSQL
Cache memcached
Application server uWSGI
Task queue Celery
Message Broker RabbitMQ
Localization gettext
Markup language Markdown
Template Engine Jinja2
Debugging, profiling and optimizing Django Debug Toolbar

Install

Types of installation

Bare metal
Docker
Docker-compose
Kubernetes

Bare metal install

install python3 and create virtual env

python3 -m venv venv
source venv/bin/activate

install requirements

pip install -r requirements.txt

put django secret key into file .env generate DJANGO_SECRET_KEY

echo DJANGO_SECRET_KEY=\'$(python3 -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())')\'  >> .env

or just create test

echo DJANGO_SECRET_KEY=test_secret_key  >> .env

add connection data to .env file

>.env << __EOF__
RABBITMQ_HOST=192.168.10.1
RABBITMQ_PORT=5673
RABBITMQ_DEFAULT_USER=admin
RABBITMQ_DEFAULT_PASS=adminsecret
RABBITMQ_DEFAULT_VHOST=celery

POSTGRES_HOST=192.168.10.1
POSTGRES_PORT=5434
POSTGRES_DB=taskcamp
POSTGRES_USER=taskcamp
POSTGRES_PASSWORD=secret

MEMCACHED_LOCATION=192.168.10.1:11214

EMAIL_HOST=192.168.10.1
EMAIL_PORT=1025
__EOF__

# if you need a debug be enabled
>>.env << __EOF__
DJANGO_DEBUG=True
__EOF__

#if you need to keep celery results 
>>.env << __EOF__
REDIS_RESULTS_BACKEND=redis://192.168.10.1:6380/0
__EOF__

create and run postgresql, memcached, mailcatcher and rabbitmq instance (if needed)

docker run -d --name taskcamp-postgres --hostname taskcamp-postgres \
    -p 5434:5432 --env-file .env postgres:13-alpine
    
docker run -d -p 11214:11211 --name taskcamp-memcached memcached:alpine

docker run -d -p 15673:15672 -p 5673:5672 \
  --name taskcamp-rabbit --hostname taskcamp-rabbit \
  --env-file .env rabbitmq:3.8.14-management-alpine

docker run -d -p 1080:1080 -p 1025:1025 \
 --name taskcamp-mailcatcher iliadmitriev/mailcatcher

# if you enabled REDIS_RESULTS_BACKEND to store celery results
docker run -d --name taskcamp-redis --hostname taskcamp-redis \
 -p 6380:6379 redis:alpine

export variables from .env file

export $(cat .env | xargs)

create a db (run migrations)

python3 manage.py migrate --no-input

compile messages

python3 manage.py compilemessages -i venv

create superuser

python3 manage.py createsuperuser

Docker install

Prepare

create .env file

>.env << __EOF__
RABBITMQ_HOST=taskcamp-rabbitmq
RABBITMQ_PORT=5672
RABBITMQ_DEFAULT_USER=admin
RABBITMQ_DEFAULT_PASS=adminsecret
RABBITMQ_DEFAULT_VHOST=celery

POSTGRES_HOST=taskcamp-postgres
POSTGRES_PORT=5432
POSTGRES_DB=taskcamp
POSTGRES_USER=taskcamp
POSTGRES_PASSWORD=secret

MEMCACHED_LOCATION=taskcamp-memcached:11211
REDIS_RESULTS_BACKEND=redis://taskcamp-redis:6379/0

EMAIL_HOST=taskcamp-mail
EMAIL_PORT=1025
__EOF__

create network taskcamp-network

docker network create taskcamp-network

create docker containers (this is just an example, you shouldn't run in production like this)

docker run -d --name taskcamp-postgres --hostname taskcamp-postgres \
    --env-file .env --network taskcamp-network postgres:13-alpine
    
docker run -d --name taskcamp-memcached --hostname taskcamp-memcached \
    --network taskcamp-network memcached:alpine

docker run -d \
  --name taskcamp-rabbitmq --hostname taskcamp-rabbitmq \
  --env-file .env --network taskcamp-network \
  rabbitmq:3.8.14-management-alpine

docker run -d --name taskcamp-mail --hostname taskcamp-mail \
  --network taskcamp-network -p 1080:1080 iliadmitriev/mailcatcher
 
docker run -d --name taskcamp-redis --hostname taskcamp-redis \
  --network taskcamp-network redis:alpine

Build and run

build docker image taskcamp-python

docker build -t taskcamp-python -f Dockerfile ./

run django web application

docker run -p 8000:8000 --env-file=.env -d --name=taskcamp-django \
  --hostname=taskcamp-django --network taskcamp-network taskcamp-python

run celery

docker run --env-file=.env -d --name=taskcamp-celery --hostname=taskcamp-celery \
   --network taskcamp-network taskcamp-python python3 -m celery -A worker worker

apply migrations

docker run --env-file=.env --rm -ti --network taskcamp-network taskcamp-python \
    python3 manage.py migrate

create superuser

docker run --env-file=.env --rm -ti --network taskcamp-network taskcamp-python \
    python3 manage.py createsuperuser

Clean up

docker rm -f $(docker ps --filter name=^taskcamp -a -q)
docker network rm taskcamp-network
docker rmi taskcamp-python

Docker-compose install

create .env environment variables file

>.env << __EOF__
RABBITMQ_HOST=taskcamp-rabbitmq
RABBITMQ_PORT=5672
RABBITMQ_DEFAULT_USER=admin
RABBITMQ_DEFAULT_PASS=adminsecret
RABBITMQ_DEFAULT_VHOST=celery

POSTGRES_HOST=taskcamp-postgres
POSTGRES_PORT=5432
POSTGRES_DB=taskcamp
POSTGRES_USER=taskcamp
POSTGRES_PASSWORD=secret

MEMCACHED_LOCATION=taskcamp-memcached:11211
REDIS_RESULTS_BACKEND=redis://taskcamp-redis:6379/0

EMAIL_HOST=taskcamp-mail
EMAIL_PORT=1025
__EOF__

start docker-compose services

docker-compose up -d

apply migrations

docker-compose exec django python3 manage.py migrate

create superuser

docker-compose exec django python3 manage.py createsuperuser

load test data if needed

cat data.json | docker-compose exec -T django python3 manage.py loaddata --format=json -

Docker-compose clean up

docker-compose down --rmi all --volumes

Development

set environment variables

DJANGO_DEBUG=True

make migrations and migrate

python3 manage.py makemigrations
python3 manage.py migrate

make messages

python3 manage.py makemessages -a -i venv
python3 manage.py compilemessages -i venv

python3 manage.py runserver 0:8000

run celery for emails and other async tasks

python3 -m celery -A worker worker
# or
celery -A worker worker

run celery for emails and other async tasks

python3 -m celery -A worker worker
# or
celery -A worker worker

with log level and queue

celery -A worker worker -l INFO -Q email

Testing

Run tests

run all tests

python3 manage.py test

run with keeping db in case of test fails

python3 manage.py test --keepdb

run all tests with details

python3 manage.py test --verbosity=2

Run tests with coverage

run with coverage

coverage run manage.py test --verbosity=2

print report with missing lines and fail with error in case it's not fully covered

coverage report -m --fail-under=100

simple project management tool for educational purposes

Related tags

Overview

Taskcamp

Install

Bare metal install

Docker install

Prepare

Build and run

Clean up

Docker-compose install

Development

Testing

Run tests

Run tests with coverage

Owner

Ilia Dmitriev

This "I P L Team Project" is developed by Prasanta Kumar Mohanty using Python with Django web framework, HTML & CSS.

A reusable Django model field for storing ad-hoc JSON data

Intellicards-backend - A Django project bootstrapped with django-admin startproject mysite

scaffold django rest apis like a champion 🚀

Media-Management with Grappelli

Store model history and view/revert changes from admin site.

Use heroicons in your Django and Jinja templates.

django-idom allows Django to integrate with IDOM

Django app for handling the server headers required for Cross-Origin Resource Sharing (CORS)

GameStop clone with Django

🔃 A simple implementation of STOMP with Django

The friendly PIL fork (Python Imaging Library)

Auto-detecting the n+1 queries problem in Python

Django With VueJS Blog App

Social Media Network Focuses On Data Security And Being Community Driven Web App

A Django backed for PostgreSQL using Psycopg 3

ProjectManagementWebsite - Project management website for CMSC495 built using the Django stack

Fully reponsive Chat Application built with django, javascript, materialUi, bootstrap4, html and css.

A simple E-commerce shop made with Django and Bulma

Notes-Django: an advanced project to save notes in Django. where users are able to Create, Read, Update and Delete their notes.