Troggle is an application for caving expedition data management, originally created for use on Cambridge University Caving Club (CUCC)expeditions and licensed under the GNU Lesser General Public License.

Troggle has been forked into two projects. The original one is maintained by Aron Curtis and is used for Erebus caves. The CUCC variant uses files as the definitive data, not the database and lives at expo.survex.com/troggle.

Troggle setup
==========

Python, Django, and Database setup
-----------------------------------
Troggle requires Django 1.10, and Python 2.7.
Install Django with the following command:

apt-get install python-django  (on debian/ubuntu)

If you want to use MySQL or Postgresql, download and install them. However, you can also use Django with Sqlite3, which is included in Python and thus requires no extra installation.



Troggle itself
-------------
Choose a directory where you will keep troggle, and git clone Troggle into it using the following command:

git clone git://expo.survex.com/~/troggle
or more reliably
git clone ssh://expo@expo.survex.com/home/expo/troggle

Running in development
----------------------
The simplest way to run Troggle in development is through the docker-compose setup
See the docker folder in the repo for details

If you want to work on the source code and be able to commit, your account will need to be added to the troggle project members list. Contact wookey  at wookware dot org to get this set up.

Next, you need to fill in your local settings. Copy either localsettingsubuntu.py or localsettingsserver.py to a new file called localsettings.py. Follow the instructions contained in the file to fill out your settings.


Setting up tables and importing legacy data
------------------------------------------
Run "python databaseReset.py reset" from the troggle directory.

Once troggle is running, you can also log in and then go to "Import / export" data under "admin" on the menu.

Adding a new year/expedition requires adding a column to the
folk/folk.csv table - a year doesn't exist until that is done.


Running a Troggle server
------------------------
For high volume use, Troggle should be run using a web server like apache. However, a quick way to get started is to use the development server built into Django.

To do this, run "python manage.py runserver" from the troggle directory.