1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/django-fmd_ynh.git synced 2024-09-03 18:26:27 +02:00
Find a file
JensDiemer e0e4a265ac Project update
* Cache CI `.cache` path
* Run Safety check in CI
* Use https://install.python-poetry.org
* remove flynt
* Update django settings
* Bugfix tox config
* Update/Bugfix YunoHost scripts
* Update tests
2022-10-04 10:21:59 +02:00
.github Project update 2022-10-04 10:21:59 +02:00
conf Project update 2022-10-04 10:21:59 +02:00
doc Update DESCRIPTION.md 2022-08-10 19:02:47 +02:00
scripts Project update 2022-10-04 10:21:59 +02:00
tests Project update 2022-10-04 10:21:59 +02:00
.editorconfig Project update 2022-10-04 10:21:59 +02:00
.flake8 init 2022-07-11 20:34:24 +02:00
.gitignore Project update 2022-10-04 10:21:59 +02:00
check_process check_process: setup_private=0 2022-07-12 19:10:43 +02:00
config_panel.toml Project update 2022-10-04 10:21:59 +02:00
LICENSE init 2022-07-11 20:34:24 +02:00
local_test.py Project update 2022-10-04 10:21:59 +02:00
Makefile Project update 2022-10-04 10:21:59 +02:00
manifest.json Project update 2022-10-04 10:21:59 +02:00
poetry.lock Project update 2022-10-04 10:21:59 +02:00
pyproject.toml Project update 2022-10-04 10:21:59 +02:00
README.md Auto-update README 2022-08-10 19:03:15 +02:00
README_fr.md Auto-update README 2022-08-10 19:03:15 +02:00
test_requirements.sh init 2022-07-11 20:34:24 +02:00

django-fmd for YunoHost

Integration level Working status Maintenance status
Install django-fmd with YunoHost

Lire ce readme en français.

This package allows you to install django-fmd quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

Find My Device Server implemented in Python using Django. Usable for the Andorid App FindMyDevice by Nnulide:

Get FindMyDevice on F-Droid

pytest YunoHost apps package linter Coverage Status on codecov.io

django-fmd @ PyPi Python Versions License GPL V3+

Pull requests welcome ;)

This package for YunoHost used django-yunohost-integration

Shipped version: 0.3.2~ynh1

Disclaimers / important information

Settings and upgrades

Almost everything related to django-fmd's configuration is handled in a "../conf/settings.py" file. You can edit the file /opt/yunohost/django-fmd/local_settings.py to enable or disable features.

Test sending emails:

ssh admin@yourdomain.tld
root@yunohost:~# cd /opt/yunohost/django-fmd/
root@yunohost:/opt/yunohost/django-fmd# source venv/bin/activate
(venv) root@yunohost:/opt/yunohost/django-fmd# ./manage.py sendtestemail --admins

Background info: Error mails are send to all settings.ADMINS. By default the YunoHost admin is inserted here. To check current ADMINS run:

(venv) root@yunohost:/opt/yunohost/django-fmd# ./manage.py sendtestemail --admins

If you prefere to send error emails to a extrnal email address, just do something like this:

echo "ADMINS = (('Your Name', 'example@domain.tld'),)" >> /opt/yunohost/django-fmd/local_settings.py

To check the effective settings, run this:

(venv) root@yunohost:/opt/yunohost/django-fmd# ./manage.py diffsettings

Miscellaneous

SSO authentication

SSOwat is fully supported via django-yunohost-integration:

  • First user ($YNH_APP_ARG_ADMIN) will be created as Django's super user
  • All new users will be created as normal users
  • Login via SSO is fully supported
  • User Email, First / Last name will be updated from SSO data

Yunohost developer commands

To remove call e.g.:

sudo yunohost app remove django-fmd

Backup / remove / restore cycle, e.g.:

yunohost backup create --apps django-fmd
yunohost backup list
archives:
  - django-fmd-pre-upgrade1
  - 20201223-163434
yunohost app remove django-fmd
yunohost backup restore 20201223-163434 --apps django-fmd

Debug installation, e.g.:

root@yunohost:~# ls -la /var/www/django-fmd/
total 18
drwxr-xr-x 4 root root 4 Dec  8 08:36 .
drwxr-xr-x 6 root root 6 Dec  8 08:36 ..
drwxr-xr-x 2 root root 2 Dec  8 08:36 media
drwxr-xr-x 7 root root 8 Dec  8 08:40 static

root@yunohost:~# ls -la /opt/yunohost/django-fmd/
total 58
drwxr-xr-x 5 django-fmd django-fmd   11 Dec  8 08:39 .
drwxr-xr-x 3 root        root           3 Dec  8 08:36 ..
-rw-r--r-- 1 django-fmd django-fmd  460 Dec  8 08:39 gunicorn.conf.py
-rw-r--r-- 1 django-fmd django-fmd    0 Dec  8 08:39 local_settings.py
-rwxr-xr-x 1 django-fmd django-fmd  274 Dec  8 08:39 manage.py
-rw-r--r-- 1 django-fmd django-fmd  171 Dec  8 08:39 secret.txt
drwxr-xr-x 6 django-fmd django-fmd    6 Dec  8 08:37 venv
-rw-r--r-- 1 django-fmd django-fmd  115 Dec  8 08:39 wsgi.py
-rw-r--r-- 1 django-fmd django-fmd 4737 Dec  8 08:39 settings.py

root@yunohost:~# cd /opt/yunohost/django-fmd/
root@yunohost:/opt/yunohost/django-fmd# source venv/bin/activate
(venv) root@yunohost:/opt/yunohost/django-fmd# ./manage.py check
django-fmd v0.8.2 (Django v2.2.17)
DJANGO_SETTINGS_MODULE='settings'
PROJECT_PATH:/opt/yunohost/django-fmd/venv/lib/python3.7/site-packages
BASE_PATH:/opt/yunohost/django-fmd
System check identified no issues (0 silenced).

root@yunohost:~# tail -f /var/log/django-fmd/django-fmd.log
root@yunohost:~# cat /etc/systemd/system/django-fmd.service

root@yunohost:~# systemctl reload-or-restart django-fmd
root@yunohost:~# journalctl --unit=django-fmd --follow

local test

For quicker developing of django-fmd in the context of YunoHost app, it's possible to run the Django developer server with the settings and urls made for YunoHost installation.

e.g.:

~$ git clone https://github.com/YunoHost-Apps/django-fmd_ynh.git
~$ cd django-fmd_ynh/
~/django-fmd_ynh$ make
install-poetry         install or update poetry
install                install django-fmd via poetry
update                 update the sources and installation
local-test             Run local_test.py to run django-fmd_ynh locally
~/django-fmd_ynh$ make install-poetry
~/django-fmd_ynh$ make install
~/django-fmd_ynh$ make local-test

Notes:

  • SQlite database will be used
  • A super user with username test and password test is created
  • The page is available under http://127.0.0.1:8000/app_path/

Documentation and resources

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/django-fmd_ynh/tree/testing --debug
or
sudo yunohost app upgrade django-fmd -u https://github.com/YunoHost-Apps/django-fmd_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps