diff --git a/README.txt b/README.txt index 32c858a..41cde78 100644 --- a/README.txt +++ b/README.txt @@ -1,4 +1,4 @@ -Updated 3 February 2023 +Updated 2 May 2023 Troggle is an application for caving expedition data management, originally created for use on Cambridge University Caving Club (CUCC)expeditions @@ -21,7 +21,9 @@ http://expo.survex.com/handbook/computing/onlinesystems.html Troggle setup ============= -0. read the very extensive online documentation and stop reading this README. +0. read the very extensive online documentation and stop reading this README... +well, come back to this README after you have read the HTML pages. Not everything has been transferred. + http://expo.survex.com/handbook/troggle/troglaptop.html http://expo.survex.com/handbook/troggle/serverconfig.html http://expo.survex.com/handbook/troggle/trogdangoup.html diff --git a/_deploy/wsl/localsettingsWSL.py b/_deploy/wsl/localsettingsWSL.py index 8308c6e..42a2a1c 100644 --- a/_deploy/wsl/localsettingsWSL.py +++ b/_deploy/wsl/localsettingsWSL.py @@ -52,11 +52,10 @@ TEMPLATE_PATH = TROGGLE_PATH / "templates" MEDIA_ROOT = TROGGLE_PATH / "media" JSLIB_ROOT = TROGGLE_PATH / "media" / "jslib" # used for CaveViewer JS utility -# FILES = Path('/mnt/d/expofiles/') EXPOFILES = REPOS_ROOT_PATH / "expofiles" SCANS_ROOT = EXPOFILES / "surveyscans" -PHOTOS_ROOT = EXPOFILES / "photos" +PHOTOS_ROOT = Path("/mnt/d/EXPO/PHOTOS") PHOTOS_YEAR = "2023" NOTABLECAVESHREFS = ["290", "291", "264", "258", "204", "359", "76", "107"] @@ -95,7 +94,7 @@ SURVEXPORT = "survexport" # for parsing .3d files and producing .pos files DBSQLITE = { "default": { "ENGINE": "django.db.backends.sqlite3", # 'postgresql_psycopg2', 'mysql', 'sqlite3' or 'oracle'. - "NAME": "/home/philip/p11d5/troggle.sqlite", + "NAME": "/home/philip/p11d4/troggle.sqlite", # 'NAME' : ':memory:', "USER": "expo", # Not used with sqlite3. "PASSWORD": "sekrit", # Not used with sqlite3. diff --git a/deprecations.txt b/deprecations.txt index 4da520e..638aa68 100644 --- a/deprecations.txt +++ b/deprecations.txt @@ -1,2 +1,2 @@ -/home/philip/p11d3/lib/python3.11/site-packages/django/conf/__init__.py:267: RemovedInDjango50Warning: The USE_L10N setting is deprecated. Starting with Django 5.0, localized formatting of data will always be enabled. For example Django will display numbers and dates using the format of the current locale. +/home/philip/p11d4/lib/python3.11/site-packages/django/conf/__init__.py:267: RemovedInDjango50Warning: The USE_L10N setting is deprecated. Starting with Django 5.0, localized formatting of data will always be enabled. For example Django will display numbers and dates using the format of the current locale. warnings.warn(USE_L10N_DEPRECATED_MSG, RemovedInDjango50Warning) diff --git a/export/os-trog.sh b/export/os-trog.sh new file mode 100644 index 0000000..c6ff0e0 --- /dev/null +++ b/export/os-trog.sh @@ -0,0 +1,70 @@ +#!/bin/bash +# Run this in a terminal in the troggle directory: 'bash os-trog.sh' +# On WSL, do Shift-click in the file explorer on the troggle folder to open a Linux command line +# 'Open Linux shell here' +echo 'Run this in a terminal in the troggle directory: "bash venv-trog.sh"' +cat /etc/os-release +# Expects an Ubuntu 22.04 relatively clean install. + +#sudo apt install python-is-python3 -y +python --version : ensure python is an alias for python3 not python2.7 +sudo apt update -y +sudo apt dist-upgrade -y +sudo apt autoremove -y +sudo apt install sqlite3 -y +sudo apt install python3-pip -y + +# this installs a shed-load of other stuff: binutils etc.sudo apt install survex-aven +sudo apt install git openssh-client -y +# On a clean debian 11 (bullseye) installation with Xfce & ssh, + + #on ubuntu 20.04: + #Package sftp is not available, but is referred to by another package. + #This may mean that the package is missing, has been obsoleted, or + #is only available from another source + #E: Package 'sftp' has no installation candidate + + +# On Ubuntu 20.04, with python10, the pip install fails. +# So you need to get the pip from source +# sudo curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10 +# but really you should be using 22.04 +# and also, isf using debian, +# sudo python3.10 -m pip install -U virtualenv + +# as debian does not install everything that ubuntu does, you need: +# sudo useradd expo +# sudo usermod -a -G sudo expo # to put expo in sudoers group, re-login required + +# default since 22.04 +# sudo apt install python3.10 +# sudo apt install python3.10-venv -y +# sudo apt install python3.10-dev -y +# sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1 + +# sudo apt install mariadb-server -y +# sudo apt install libmariadb-dev -y + +sudo python -m pip install --upgrade pip + +sudo apt install sftp -y + + +# Go to https://expo.survex.com/handbook/troggle/troglaptop.html#dbtools +# sudo service mysql start + +echo '### git config --global user.email "you@example.com" +echo '### git config --global user.name "Your Name" + +echo '###' +echo '### Currently set version of python' +python --version + +echo '###' +echo '### Now YOU have to configure the git settings for YOURSELF (not "expo")' + +echo '###' +echo '### NOW INSTALLING tunnel and therion, go and have a cup of tea. Or a 3-course meal.' +echo '###' +sudo apt install tunnelx therion -y + diff --git a/export/venv-trog.sh b/export/venv-trog.sh new file mode 100644 index 0000000..a47ab87 --- /dev/null +++ b/export/venv-trog.sh @@ -0,0 +1,172 @@ +#!/bin/bash +# footled lots to make this work with python 3.10 & 3.11 and WSL1 and WSL2 on Ubuntu 22.04 +# Run this in a terminal in the troggle directory: 'bash venv-trog.sh' +echo '-- Run this in a terminal in the real troggle directory: "bash venv-trog.sh"' + +# Expects an Ubuntu 22.04 relatively clean install. +# If you have not already installed these on your clean Ubuntu install DO THIS FIRST +# use the script os-trog.sh + +# If you are using Debian, then stick with the default version of python +# If you are using Ubuntu, then it is easy to use a later version of python, e.g. 3.11 + + +# NOW we set up troggle +PYTHON=python3.11 +VENAME=p11d3 # python3.x and django 3.2 +echo "** You are logged in as `id -u -n`" +echo "The 50MB pip cache will be in /home/`id -u -n`/.cache/" +echo "The 150MB venv will created in /home/`id -u -n`/$VENAME/" +TROGDIR=$(cd $(dirname $0) && pwd) +echo "-- Troggle folder (this script location): ${TROGDIR}" + +if [ -d requirements.txt ]; then + echo "-- No requirements.txt found. Copy it from your most recent installation." + exit 1 +fi +echo ## Using requirements.txt : +cat requirements.txt +echo ## + + +$PYTHON --version + +# NOTE that when using a later or earlier verison of python, you MUST also +# use the allowed version of Pillow, see https://pillow.readthedocs.io/en/latest/installation.html + +# NOW set up link from expo user folder +# needed for WSL2 +echo Creating links from Linux filesystem user +# These links only need making once, for many venv +cd ~ + +if [ ! -d $VENAME ]; then + echo "## Creating venv $VENAME. (If this fails with a pip error, you need to ensure you have python3.11-venv installed and/or use a Ubuntu window)" + $PYTHON -m venv $VENAME +else + echo "## /$VENAME/ already exists ! Delete it first." + exit 1 +fi + + # Activate the virtual env and see what the default packages are +echo "### Activating $VENAME" + +cd $VENAME +echo "-- now in: ${PWD}" +source bin/activate +echo "### Activated." + # update local version of pip, more recent than OS version + # debian bullseye installs pip 20.3.4 which barfs, we want >22.0.3 + + # update local version of setuptools, more recent than OS version, needed for packages without wheels + +echo "### installing later version of pip inside $VENAME" +$PYTHON -m pip install --upgrade pip +$PYTHON -m pip install --upgrade setuptools + +PIP=pip + +$PIP list > original-pip.list +$PIP freeze >original.txt + +# we are in /home/$USER/$VENAME/ +ln -s ${TROGDIR} troggle +ln -s ${TROGDIR}/../expoweb expoweb +ln -s ${TROGDIR}/../loser loser +ln -s ${TROGDIR}/../drawings drawings + +# fudge for philip's machine +if [ -d ${TROGDIR}/../expofiles ]; then + ln -s ${TROGDIR}/../expofiles expofiles +else + if [ ! -d /mnt/f/expofiles ]; then + sudo mkdir /mnt/f + sudo mount -t drvfs F: /mnt/f + else + ln -s /mnt/f/expofiles expofiles + fi +fi + +echo "### Setting file permissions.. may take a while.." +git config --global --add safe.directory '*' +sudo chmod -r 0777 * + +echo "### links to expoweb, troggle etc. complete:" +ls -tla +echo "###" +echo "### now installing ${TROGDIR}/requirements.txt" +echo "###" + +# NOW THERE IS A PERMISSIONS FAILURE THAT DIDN'T HAPPEN BEFORE +# seen on wsl2 as well as wsl1 +# which ALSO ruins EXISTING permissions ! +# Guessing it is to do with pip not liking non-standard py 3.11 installation on Ubuntu 22.04 + +$PIP install -r ${TROGDIR}/requirements.txt +echo '### install from requirements.txt completed.' +echo '### ' + +$PIP freeze > requirements.txt +# so that we can track requirements more easily with git +# because we do not install these with pip, but they are listed by the freeze command +# Now find out what we actually installed by subtracting the stuff venv installed anyway +sort original.txt > 1 +sort requirements.txt >2 +comm -3 1 2 --check-order | awk '{ print $1}'>fresh-requirements.txt +rm 1 +rm 2 + +cp requirements.txt requirements-$VENAME.txt +cp requirements-$VENAME.txt troggle/requirements-$VENAME.txt + +$PIP list > installed-pip.list +$PIP list -o > installed-pip-o.list + +REQ=installation-record +mkdir $REQ +mv requirements-$VENAME.txt $REQ +mv original.txt $REQ +mv requirements.txt $REQ +mv original-pip.list $REQ +mv installed-pip.list $REQ +mv installed-pip-o.list $REQ +cp fresh-requirements.txt ../requirements.txt +mv fresh-requirements.txt $REQ +cp troggle/`basename "$0"` $REQ + + +$PYTHON --version +python --version +echo "Django version:`django-admin --version`" + +echo "### Now do + '[sudo service mysql start]' + '[sudo service mariadb restart]' + '[sudo mysql_secure_installation]' + 'cd ~/$VENAME' + 'source bin/activate' + 'cd troggle' + 'django-admin' + 'python manage.py check' +## this tests if you have set up ssh correcting. Refer to documentation https://expo.survex.com/handbook/computing/keyexchange.html +## you need to follow the Linux instructions. + 'ssh expo@expo.survex.com' + +## the next tests will fail unless ~/expofiles is set correctly to a folder on your machine +## the tests may ALSO fail because of ssh and permissions errors +# Ran 85 tests in 83.492s +# FAILED (failures=5) +## So you will need to run +$sudo chown -Rhv philip:philip ~/$VENAME (if your username is philip) +# and then REBOOT (or at least, exit WSL and terminate and restart WSL) +# because this chmod only takes effect then. + + 'python manage.py test -v 2' + './pre-run.sh' (runs the tests again) + + 'python databaseReset.py reset $VENAME' + 'python manage.py runserver 0.0.0.0:8000 (and allow access when the firewall window pops up)' + " +if [ ! -d /mnt/f/expofiles ]; then +echo '### No valid expofiles directory. Fix this before any tests will work. +fi \ No newline at end of file diff --git a/requirements-p10d3.txt b/requirements-p10d3.txt deleted file mode 100644 index e69de29..0000000 diff --git a/requirements-p11d32.txt b/requirements-p11d32.txt deleted file mode 100644 index e69de29..0000000 diff --git a/requirements-p11d4.txt b/requirements-p11d4.txt new file mode 100644 index 0000000..4f24dad --- /dev/null +++ b/requirements-p11d4.txt @@ -0,0 +1,16 @@ +asgiref==3.6.0 +black==23.1.0 +click==8.1.3 +coverage==7.1.0 +Django==4.2 +docutils==0.19 +isort==5.12.0 +mypy-extensions==1.0.0 +packaging==23.0 +pathspec==0.11.0 +Pillow==9.4.0 +platformdirs==3.0.0 +pytz==2022.7 +ruff==0.0.245 +sqlparse==0.4.3 +Unidecode==1.3.6 diff --git a/requirements.txt b/requirements.txt index c304f0f..4f24dad 100644 --- a/requirements.txt +++ b/requirements.txt @@ -2,7 +2,7 @@ asgiref==3.6.0 black==23.1.0 click==8.1.3 coverage==7.1.0 -Django==4.2b1 +Django==4.2 docutils==0.19 isort==5.12.0 mypy-extensions==1.0.0 @@ -14,5 +14,3 @@ pytz==2022.7 ruff==0.0.245 sqlparse==0.4.3 Unidecode==1.3.6 -docutils==0.19 - diff --git a/venv-trog.sh b/venv-trog.sh index a47ab87..2767570 100644 --- a/venv-trog.sh +++ b/venv-trog.sh @@ -3,17 +3,16 @@ # Run this in a terminal in the troggle directory: 'bash venv-trog.sh' echo '-- Run this in a terminal in the real troggle directory: "bash venv-trog.sh"' -# Expects an Ubuntu 22.04 relatively clean install. +# Expects an Ubuntu 22.04 (or 20.04) relatively clean install. # If you have not already installed these on your clean Ubuntu install DO THIS FIRST # use the script os-trog.sh # If you are using Debian, then stick with the default version of python # If you are using Ubuntu, then it is easy to use a later version of python, e.g. 3.11 - # NOW we set up troggle PYTHON=python3.11 -VENAME=p11d3 # python3.x and django 3.2 +VENAME=p11d4 # python3.x and django 4.2 echo "** You are logged in as `id -u -n`" echo "The 50MB pip cache will be in /home/`id -u -n`/.cache/" echo "The 150MB venv will created in /home/`id -u -n`/$VENAME/" @@ -21,14 +20,13 @@ TROGDIR=$(cd $(dirname $0) && pwd) echo "-- Troggle folder (this script location): ${TROGDIR}" if [ -d requirements.txt ]; then - echo "-- No requirements.txt found. Copy it from your most recent installation." + echo "-- No requirements.txt found. You should be in the /troggle/ folder. Copy it from your most recent installation." exit 1 fi echo ## Using requirements.txt : cat requirements.txt echo ## - $PYTHON --version # NOTE that when using a later or earlier verison of python, you MUST also @@ -79,17 +77,17 @@ ln -s ${TROGDIR}/../drawings drawings if [ -d ${TROGDIR}/../expofiles ]; then ln -s ${TROGDIR}/../expofiles expofiles else - if [ ! -d /mnt/f/expofiles ]; then - sudo mkdir /mnt/f - sudo mount -t drvfs F: /mnt/f + if [ ! -d /mnt/d/expofiles ]; then + sudo mkdir /mnt/d + sudo mount -t drvfs D: /mnt/d else - ln -s /mnt/f/expofiles expofiles + ln -s /mnt/d/expofiles expofiles fi fi echo "### Setting file permissions.. may take a while.." git config --global --add safe.directory '*' -sudo chmod -r 0777 * +sudo chmod -R 777 * echo "### links to expoweb, troggle etc. complete:" ls -tla @@ -154,8 +152,7 @@ echo "### Now do ## the next tests will fail unless ~/expofiles is set correctly to a folder on your machine ## the tests may ALSO fail because of ssh and permissions errors -# Ran 85 tests in 83.492s -# FAILED (failures=5) + ## So you will need to run $sudo chown -Rhv philip:philip ~/$VENAME (if your username is philip) # and then REBOOT (or at least, exit WSL and terminate and restart WSL) @@ -167,6 +164,6 @@ $sudo chown -Rhv philip:philip ~/$VENAME (if your username is philip) 'python databaseReset.py reset $VENAME' 'python manage.py runserver 0.0.0.0:8000 (and allow access when the firewall window pops up)' " -if [ ! -d /mnt/f/expofiles ]; then -echo '### No valid expofiles directory. Fix this before any tests will work. +if [ ! -d /mnt/d/expofiles ]; then +echo '### No valid expofiles directory on /mnt/d . Fix this before any tests will work. fi \ No newline at end of file