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 … à la place de pdf2image. Les utilisateurs sous MacOS, quant à eux, doivent installer PyMuPDF … à la place de pdf2image. En ce qui concerne le module pynput il faut installer la version 1.6.8 (obligatoirement !).

Avant d’installer les modules, assurez-vous que Python 3 est bien installé (attention il faut installer Pyhon 3.6 ou 3.7 ou 3.8, mais pas 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, pynput [en version 1.6.8] et pdf2image) :

pip3 install PyQt5 numpy Pillow pdfkit xlrd pdf2image pynput==1.6.8

Pour les utilisateurs sous Windows, voir ici … ou ceux sous MacOS, voir ici (ou ici). Attention sous MacOS, pdf2image n’est pas installable avec pip3, il faut installer PyMuPDF.

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

La version de développement :

La suite n’est valable que sous GNU/Linux ; il faudra adapter si vous êtes sous Windows ou MacOS. Pour mettre à niveau (à jour), entrez la commande suivante (qui ne sera à faire que la première fois) :

svn checkout svn://laginette.com/trunk 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 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).

La version stable :

La suite n’est valable que sous GNU/Linux ; il faudra adapter si vous êtes sous Windows ou MacOS. Pour mettre à niveau (à jour), entrez la commande suivante (qui ne sera à faire que la première fois) :

svn checkout svn://laginette.com/branches/2.4.2 apsc_derniere_version_stable

Avec cette commande un dossier apsc_derniere_version_stable va être crée dans votre votre répertoire utilisateur. Ce dossier va contenir toute l’arborescence d’APSC en version 2.4.0 ; il s’agit de la dernière 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).

ATTENTION, si après le checkout, vous avez un message du style :

svn: E155000: ‘/home/user/apsc_derniere_version_stable’ est déjà une copie de travail pour une autre URL

… supprimez le répertoire apsc_derniere_version_stable et ensuite relancez la commande : svn checkout …

Pour démarrer la version stable du dépôt :

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 MacOS) :

#!/bin/sh
cd ~/apsc_derniere_version_stable
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_derniere_version_stable et le fichier apsc_svn.sh sont présents dans votre répertoire utilisateur) … vous pourrez, chaque fois que vous le désirez, lancer la dernière version stable du dépôt SVN, pour cela passez cette commande (à partir de votre répertoire utilisateur) :

sh apsc_svn.sh

Pour démarrer la version de développement du dépôt :

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 MacOS) :

#!/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 la version de développement du dépôt SVN, pour cela passez cette commande (à partir de votre répertoire utilisateur) :

sh apsc_svn.sh