Metadata-Version: 2.1
Name: django-help-me
Version: 0.1.10
Summary: An app for providing a simple Help Desk & FAQ for users.
Home-page: https://github.com/renderbox/django-help-me/
Author: Grant Viklund, Mackenzie Camisa
Author-email: renderbox@example.com
License: MIT license
Keywords: django,app
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Requires-Dist: Django (<3.2,>=3.1)
Requires-Dist: django-autoslug
Requires-Dist: django-multiselectfield
Requires-Dist: django-crispy-forms
Requires-Dist: django-user-agents
Provides-Extra: build
Requires-Dist: setuptools ; extra == 'build'
Requires-Dist: wheel ; extra == 'build'
Requires-Dist: twine ; extra == 'build'
Requires-Dist: m2r ; extra == 'build'
Provides-Extra: dev
Requires-Dist: django-extensions ; extra == 'dev'
Requires-Dist: django-allauth ; extra == 'dev'
Requires-Dist: dj-database-url ; extra == 'dev'
Requires-Dist: psycopg2-binary ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'
Requires-Dist: djangorestframework ; extra == 'dev'
Requires-Dist: pyyaml ; extra == 'dev'
Requires-Dist: ua-parser ; extra == 'dev'
Requires-Dist: user-agents ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: coverage ; extra == 'docs'
Requires-Dist: Sphinx ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
Requires-Dist: recommonmark ; extra == 'docs'
Requires-Dist: rstcheck ; extra == 'docs'
Provides-Extra: prod
Provides-Extra: test



.. image:: https://github.com/renderbox/django-help-me/workflows/Help%20Me%20CI/badge.svg
   :target: https://github.com/renderbox/django-help-me/workflows/Help%20Me%20CI/badge.svg
   :alt: Help Me CI



.. image:: https://github.com/renderbox/django-help-me/workflows/Help%20Me%20Develop/badge.svg?branch=develop
   :target: https://github.com/renderbox/django-help-me/workflows/Help%20Me%20Develop/badge.svg?branch=develop
   :alt: Help Me Develop


Help Me
=======

A simple app for providing a simple help desk for users.

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

.. code-block:: shell

   > 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):

.. code-block:: shell

   > 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)

.. code-block:: shell

   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:

.. code-block:: shell

   > 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...

.. code-block:: shell

   > ./manage.py migrate

Create your superuser account...

.. code-block:: shell

   > ./manage.py createsuperuser

Optionally load fixtures...

.. code-block:: shell

   > ./manage.py loaddata developer

run the Django project normally with 

.. code-block:: shell

   > ./manage.py runserver


