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

With Django Hijack, admins can log in and work on behalf of other users without having to know their credentials.

A slick ORM cache with automatic granular event-driven invalidation.

Simple tagging for django

Quick example of a todo list application using Django and HTMX

Streamlining Django forms to provide all the wins of single-page-applications without the pain.

A simple demonstration of integrating a sentiment analysis tool in a django project

Django Rest Framework + React application.

Django-shared-app-isolated-databases-example - Django - Shared App & Isolated Databases

Django Audit is a simple Django app that tracks and logs requests to your application.

Django React Project Setup

Inject an ID into every log message from a Django request. ASGI compatible, integrates with Sentry, and works with Celery

A Powerful HTML white space remover for Django

A simple page with paypal payment and confiramtion in django

Blog focused on skills enhancement and knowledge sharing. Tech Stack's: Vue.js, Django and Django-Ninja

AUES Student Management System Developed for laboratory works №9 Purpose using Python (Django).

Django-static-site - A simple content site framework that harnesses the power of Django without the hassle

Drf-stripe-subscription - An out-of-box Django REST framework solution for payment and subscription management using Stripe

An orgizational tool to keep track of tasks/projects and the time spent on them.

Application made in Django to generate random passwords as based on certain criteria .

Coltrane - A simple content site framework that harnesses the power of Django without the hassle.