Gestion de ma collection de jeux vidéos s'inspirant plus que fortement de backloggery.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Olivier DOSSMANN 16deac8849 MàJ de Django 5 months ago
collection Nouvelle page d'accueil suivant HTML5UP.net 1 year ago
.dockerignore Docker - compilation des messages traduits pour l'application 1 year ago
.gitignore Delete useless PyCharm ignore regex from .gitignore file 1 year ago
.gitlab-ci.yml Correction des tests automatiques sous Gitlab 1 year ago
.pre-commit-config.yaml Amélioration de l'environnement de développement 1 year ago
CHANGELOG MàJ du CHANGELOG 1 year ago
Dockerfile Docker - compilation des messages traduits pour l'application 1 year ago
EUPL_v1.2.txt Licence + README créés 1 year ago
LICENCE Licence + README créés 1 year ago
README.md Renommage des consoles en plateformes 1 year ago
TODO MàJ TODO list 1 year ago
dev-requirements.txt Installation de la Django Debug Toolbar pour l'environnement de DEV. 1 year ago
docker-entrypoint.sh Docker - compilation des messages traduits pour l'application 1 year ago
requirements.txt MàJ de Django 5 months ago
uwsgi.ini Dockerfile créé avec mode production et mode développement 1 year ago

README.md

Version 0.1 du 23 août 2017

OpenBackloggery

Logiciel web permettant de :

  • lister sa collection de jeux vidéos
  • connaître sa progression sur chacun des jeux (jamais joué, terminé, complété, etc.)
  • avoir une liste de jeux souhaités
  • savoir à quel jeu nous jouons actuellement
  • garder un historique de quand nous avons acquis le jeu, quand nous l’avons terminé, etc.

Python 3.6 Django 1.11 SQLite 3 django REST framework 3

Installation

Choisissez l’une des méthodes suivantes :

En utilisant pip

Vous devez disposer de pip sur votre machine, par exemple sur Debian/Ubuntu, il suffit de lancer la commande suivante :

sudo apt install python3-pip

Ensuite on utilise les dépendances Python propres au projet :

cd openbackloggery
pip install -r requirements.txt

On génère la base de données et on la rempli :

cd collection
python3 manage.py migrate
python3 manage.py loaddata initial
python3 manage.py createsuperuser --user=superadmin --email=superadmin@domaine.tld

Remplacez superadmin par un identifiant que vous souhaiteriez avoir. Et mettez l’adresse courriel que vous voulez (car pour l’instant l’application n’utilise pas le courriel).

Il ne vous reste plus qu’à lancer l’application :

python3 manage.py runserver

et d’y accéder à l’adresse suivante : http://127.0.0.1:8000/admin/.

Pensez à jouer quand même ! ^_^

En utilisant Docker

Avec Docker nous allons procéder en plusieurs étapes :

Nous appelerons notre image Docker openbackloggery. Nous considéréons que l’application se trouver dans un dossier nommé openbackloggery dans lequel se trouve un fichier Dockerfile.

cd openbackloggery
docker build -t openbackloggery:0.1 .

Actuellement nous utilisons SQLite3 comme base de données car les fonctionnalités et la quantité de données ne requièrent pas un gestionnaire de base de données plus conséquent.

mkdir /openbackloggery_db
docker run -it --rm -v /openbackloggery_db:/opt/apps/db openbackloggery:0.1 python3 manage.py migrate
docker run -it --rm -v /openbackloggery_db:/opt/apps/db openbackloggery:0.1 python3 manage.py loaddata initial

loaddata initial permet de charger quelques données initiales comme une liste de plateformes par exemple.

Adaptez la ligne en remplaçant admin par le nom d’utilisateur que vous voulez et admin@domaine.tld par l’adresse courriel de votre choix (qu’elle existe ou non importe peu pour l’instant car elle n’est pas utilisée).

docker run -it --rm -v /openbackloggery_db:/opt/apps/db openbackloggery:0.1 python3 manage.py createsuperuser --user=admin --email=admin@domaine.tld

Le service se lancera sur le port 8282 et aura pour clé secrète abcdefghijk :

docker run -d -e SECRET_KEY='abcdefghijk' -v /openbackloggery_db:/opt/apps/db -p 8282:8000 openbackloggery:0.1

Veillez à modifier la clé secrète par une chaîne de caractère aléatoire assez longue et parsemée de majuscules, minuscules, ponctuation, etc.

Une fois le conteneur Docker lancé, il suffit d’ouvrir un navigateur Internet et d’y taper l’adresse suivante : http://127.0.0.1:8282/admin/.

Adresses réticulaires disponibles

Les adresses à connaître :

  • ’/admin/’ : Interface d’administration
  • ’/api/v1/’ : Adresse de l’API RESTful
  • ’/api/v1/docs’ : documentation de l’API

Licence

Ce logiciel est concédé sous licence EUPL, version 1.2 uniquement.

Contact

Le projet est disponible sur la forge de Papa Ogre.

Ou alors vous pouvez contacter l’auteur par courriel.