Sources/Développement

A savoir :

Si vous voulez consulter les sources d’APSC, c’est à dire le code source, restez sur cette page et suivez cette documentation. Si vous ne savez pas ce qu’est un code source et que vous voulez simplement installer l’application, ne lisez pas la suite …

J’ai mis en place un dépôt SVN pour le projet, voilà ce qu’il faut savoir avant de commencer à déployer le dépôt en question (enfin si vous êtes intéressés) …

Préparation :

Le logiciel est développé avec le langage Python, en version 3. Pour le fonctionnement de l’application, les modules suivants sont employés (et doivent de même être installés) :

–> Attention les utilisateurs sous Windows sont invités à installer aussi Poppler … de même que les utilisateurs sous MacOSX (–> Poppler pour MacOSX) doivent installer Poppler à la place de pdf2image.

Avant d’installer les modules, assurez-vous que Python 3 est bien installé (attention il faut installer Pyhon 3.6 ou 3.7 … mais pas la version 3.8, et encore moins une version 2.7 !). De même il faudra installer Subversion et Pip3 (voir ici ou ici ou ici ou ici ou encore ici).

Installation des modules complémentaires :

Une fois Subversion et Pip3 installés, nous allons nous occuper des modules … pour cela nous le ferons avec Pip3, voici la procédure sous GNU/Linux à partir d’un terminal (dans l’ordre ; installation de pyqt5, numpy, pillow, pdfkit, xlrd et pdf2image) :

pip3 install PyQt5 numpy Pillow pdfkit xlrd pdf2image

Pour les utilisateurs sous Windows, voir ici … ou ceux sous MacOSX, voir ici (ou ici). Attention sous MacOSX, pdf2image n’est pas installable avec pip3, il faut installer Poppler, comme précisé ici.

Déploiement et mise à jour du dépôt SVN d’APSC :

La version stable :

svn checkout svn://laginette.com/trunk apsc_version_stable

Avec cette commande un dossier apsc_version_stable va être crée dans votre votre répertoire utilisateur. Ce dossier va contenir toute l’arborescence d’APSC en version stable. Attention si un nom d’utilisateur vous est demandé, entrez : usersvn … et le mot de passe est : Use37a411m (cet utilisateur n’a que des droits en lecture sur le dépôt SVN).

La version de développement :

svn checkout svn://laginette.com/branches/1.6.0 apsc_version_developpement

Avec cette commande un dossier apsc_version_developpement va être crée dans votre votre répertoire utilisateur. Ce dossier va contenir toute l’arborescence d’APSC en version 1.6.0 ; il s’agit de la version de développement. Attention si un nom d’utilisateur vous est demandé, entrez : usersvn … et le mot de passe est : Use37a411m (cet utilisateur n’a que des droits en lecture sur le dépôt SVN).

Déploiement, mise à jour et exécution de la version de développement du dépôt SVN d’APSC :

La suite n’est valable que sous GNU/Linux ; il faudra adapter si vous êtes sous Windows ou MacOSX.

Pour mettre à niveau, entrez la commande suivante (qui ne sera à faire que la première fois) :

svn checkout svn://laginette.com/branches/1.6.0 apsc_version_developpement

Avec cette commande un dossier apsc_version_developpement va être crée dans votre votre répertoire utilisateur. Ce dossier va contenir toute l’arborescence d’APSC en version 1.6.0 ; il s’agit de la version de développement. Attention si un nom d’utilisateur vous est demandé, entrez : usersvn … et le mot de passe est : Use37a411m (cet utilisateur n’a que des droits en lecture sur le dépôt SVN).

A partir de là vous êtes invité à créer un fichier texte contenant ceci (là aussi ce n’est valable que sous GNU/Linux … il faudra adapter si vous êtes sous Windows ou MacOSX) :

#!/bin/sh
cd ~/apsc_version_developpement
svn up
python3 apsc_gui.py

Nommez ce fichier : apsc_svn.sh (avec l’extension .sh) … et enregistrez-le dans votre répertoire utilisateur (à la racine de votre répertoire utilisateur !).

A partir de là (et tant que le répertoire apsc_version_developpement et le fichier apsc_svn.sh sont présents dans votre répertoire utilisateur) … vous pourrez, chaque fois que vous le désirez, vérifier si d’éventuels changements ont eu lieu dans la version de développement … et exécuter APSC version développement du dépôt SVN, pour cela passez cette commande (à partir de votre répertoire utilisateur) :

sh apsc_svn.sh