Prerequisites

This package makes use of JSON fields so you’ll need Download and install Postgresql. This will change with Django 3.1+ and the universal JSON field.

Installation

It is highly reconmended that you use a Virtual Environment before installing.

To install, just use pip

> pip install django-permafrost

If you plan to use our templates you will need to installe these additional pacakges too (they are included in the ‘dev’ extensions):

> pip install django-crispy-forms django-multiselectfield

For developers

If you haven’t already, you will need to Set up database and user. -Start the postgres server -Open the psql console -In your console run the following db commands (credentials found in settings.py)

CREATE DATABASE helpme;
CREATE USER django WITH PASSWORD 'password';
ALTER ROLE django SET client_encoding TO 'utf8';
ALTER ROLE django SET default_transaction_isolation TO 'read committed';
ALTER ROLE django SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE helpme TO django;

\q #exits the console

We have a pre-build ‘develop’ project we work from included in this repo. It’s very basic and is used for testing in a consistent Django environment.

First, create your virtual environment.

To install the necessary packages for the “develop” project, run the following command from the root of the repo:

> pip install -e .[dev]

This tells pip to install the package in the virtual environment but still keep things editable (by linking the package instead of copying it).

cd into the developer and apply any migrations…

> ./manage.py migrate

Create your superuser account…

> ./manage.py createsuperuser

Optionally load fixtures…

> ./manage.py loaddata developer

run the Django project normally with

> ./manage.py runserver