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

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

Flashback is an awesome, retro IRC based app built using Django

Login System Django

It takes time to start a Django Project and make it almost production-ready.

Twitter Bootstrap for Django Form

Mobile Detect is a lightweight Python package for detecting mobile devices (including tablets).

🏭 An easy-to-use implementation of Creation Methods for Django, backed by Faker.

Tutorial para o projeto negros.dev - A Essência do Django

This is django-import-export module that exports data into many formats

🗂️ 🔍 Geospatial Data Management and Search API - Django Apps

Send logs to RabbitMQ from Python/Django.

Django Email Sender

The new Python SDK for Sentry.io

PWA is a simple Django app to develope and deploy a Progressive Web Application.

It's the assignment 1 from the Python 2 course, that requires a ToDoApp with authentication using Django

Book search Django web project that uses requests python library and openlibrary API.

TinyApp - A Python (Django) Full Stack Application for shortening URLs

Full featured redis cache backend for Django.

Add a help desk or knowledge base to your Django project with only a few lines of boilerplate code.

Auth module for Django and GarpixCMS