Update docs & tests for Python 2.7/3.3+ and Django 1.7+

This commit is contained in:
Ross Poulton 2015-12-16 10:35:00 +11:00
parent 6187b0568c
commit 9c249a818b
5 changed files with 26 additions and 35 deletions

View File

@ -1,10 +1,13 @@
language: python
python:
- "2.7"
- "3.3"
- "3.4"
- "3.5"
env:
- DJANGO=1.5.10
- DJANGO=1.6.7
- DJANGO=1.7
- DJANGO=1.7.11
- DJANGO=1.8.7
- DJANGO=1.9
install:
- pip install argparse
- pip install -q Django==$DJANGO

View File

@ -1,10 +1,10 @@
django-helpdesk - A Django powered ticket tracker for small enterprise.
django-helpdesk - A Django powered ticket tracker for small businesses.
=======================================================================
.. image:: https://travis-ci.org/rossp/django-helpdesk.png?branch=master
:target: https://travis-ci.org/rossp/django-helpdesk
Copyright 2009-11 Jutda and Ross Poulton. All Rights Reserved. See LICENSE for details.
Copyright 2009- Ross Poulton and contributors. All Rights Reserved. See LICENSE for details.
django-helpdesk was formerly known as Jutda Helpdesk, named after the
company who originally created it. As of January 2011 the name has been
@ -25,14 +25,13 @@ LICENSE.3RDPARTY for license terms for included packages.
Dependencies (pre-flight checklist)
-----------------------------------
1. Python 2.6+
2. Django (1.4 or newer)
3. South for database migrations (highly recommended, but not required). Download from http://south.aeracode.org/
4. An existing WORKING Django project with database etc. If you
1. Python 2.7 or 3.3+ (3.3 support is new, please let us know how it goes)
2. Django (1.7 or newer, preferably 1.9)
3. An existing WORKING Django project with database etc. If you
cannot log into the Admin, you won't get this product working.
5. `pip install django-bootstrap-form` and add `bootstrapform` to `settings.INSTALLED_APPS`
6. `pip install django-markdown-deux` and add `markdown_deux` to `settings.INSTALLED_APPS`
7. `pip install email-reply-parser` to get smart email reply handling
4. `pip install django-bootstrap-form` and add `bootstrapform` to `settings.INSTALLED_APPS`
5. `pip install django-markdown-deux` and add `markdown_deux` to `settings.INSTALLED_APPS`
6. `pip install email-reply-parser` to get smart email reply handling
**NOTE REGARDING SQLITE AND SEARCHING:**
If you use sqlite as your database, the search function will not work as
@ -60,25 +59,15 @@ commands.
Fresh Django Installations
--------------------------
If you're on a brand new Django installation, make sure you do a ``syncdb``
If you're on a brand new Django installation, make sure you do a ``migrate``
**before** adding ``helpdesk`` to your ``INSTALLED_APPS``. This will avoid
errors with trying to create User settings.
Upgrading from previous versions
--------------------------------
We highly recommend that you use South (available
from http://south.aeracode.org/) to assist with management of database schema
changes.
If you are upgrading from a previous version that did NOT use South for
migrations (i.e. prior to April 2011) then you will need to 'fake' the first
migration::
python manage.py migrate helpdesk 0001 --fake
If you are upgrading from a previous version of django-helpdesk that DID use
South, simply download an up to date version of the code base (eg by using
If you are upgrading from a previous version of django-helpdesk that used
migrations, get an up to date version of the code base (eg by using
`git pull` or `pip install --upgrade django-helpdesk`) then migrate the database::
python manage.py migrate helpdesk --db-dry-run # DB untouched
@ -87,6 +76,9 @@ South, simply download an up to date version of the code base (eg by using
Lastly, restart your web server software (eg Apache) or FastCGI instance, to
ensure the latest changes are in use.
If you are using django-helpdesk pre-migrations (ie pre-2011) then you're
on your own, sorry.
You can continue to the 'Initial Configuration' area, if needed.
Installation

View File

@ -46,7 +46,7 @@ Please include tests in the ``tests/`` folder when committing code changes.
Database schema changes
-----------------------
As well as making your normal code changes to ``models.py``, please generate a South migration file and commit it with your code. You will want to use a command similar to the following::
As well as making your normal code changes to ``models.py``, please generate a Django migration file and commit it with your code. You will want to use a command similar to the following::
./manage.py migrate helpdesk --auto [migration_name]

View File

@ -70,8 +70,7 @@ django-helpdesk is released under the BSD license, however it packages 3rd party
Dependencies
------------
1. Python 2.5+
2. Django (1.3 or newer)
3. South for database migrations (highly recommended, but not required). Download from http://south.aeracode.org/
4. An existing **working** Django project with database etc. If you cannot log into the Admin, you won't get this product working! This means you **must** run `syncdb` **before** you add ``helpdesk`` to your ``INSTALLED_APPS``.
1. Python 2.7+ (or 3.3+)
2. Django (1.7 or newer)
3. An existing **working** Django project with database etc. If you cannot log into the Admin, you won't get this product working! This means you **must** run `syncdb` **before** you add ``helpdesk`` to your ``INSTALLED_APPS``.

View File

@ -38,7 +38,6 @@ Adding To Your Django Project
'django.contrib.sites',
'django.contrib.admin', # Required for helpdesk admin/maintenance
'django.contrib.humanize', # Required for elapsed time formatting
'south', # Highly recommended to make database migrations simpler in Django < 1.7
'markdown_deux', # Required for Knowledgebase item formatting
'bootstrapform', # Required for nicer formatting of forms with the default templates
'helpdesk', # This is us!
@ -54,11 +53,9 @@ Adding To Your Django Project
This line will have to come *after* any other lines in your urls.py such as those used by the Django admin.
3. Create the required database tables. I'd suggest using *South*, however the following will work::
3. Create the required database tables.
./manage.py syncdb
Then migrate using South / Django 1.7+ migrations::
Migrate using Django migrations::
./manage.py migrate helpdesk