doc pour python 3

This commit is contained in:
Emmanuel Viennet 2021-07-12 22:53:35 +02:00
parent 6847bb8fd5
commit 1af9fb2410

View File

@ -12,7 +12,7 @@ Documentation utilisateur: <https://scodoc.org>
N'utiliser que pour les développements et tests, dans le cadre de la migration de Zope vers Flask. N'utiliser que pour les développements et tests, dans le cadre de la migration de Zope vers Flask.
La version ScoDoc8 est basée sur Flask (au lieu de Zope) et sur **python 2.7**. La version ScoDoc8 est basée sur Flask (au lieu de Zope) et sur **python 3.7+**.
Elle ne sera pas mise en production, c'est une version de développement pour le passage à Python 3. Elle ne sera pas mise en production, c'est une version de développement pour le passage à Python 3.
De très nombreux changements sont susceptibles d'affecter l'API, mais on s'efforce à ce que rien De très nombreux changements sont susceptibles d'affecter l'API, mais on s'efforce à ce que rien
@ -20,55 +20,32 @@ ne soit visible des utilisateurs.
## Work in Progress (WIP) ## Work in Progress (WIP)
En général, les commits indiqués "WIP" ne tournent pas. Développement en cours, certaines pages fonctionnent, d'autres pas.
### État actuel (21 juin 21) ### État actuel (13 juillet 21)
- l'ensemble des pages est raccordé, sauf "entreprises" et la gestion des utilisateurs (de ce fait, de nombreuses pages plantent). - passage à l'unicode en cours (E/S à revoir).
- pas d'excel (voir si on réinstalle `pyExcelerator` ou si on migre immédiatement ?), pdf non testé (mais devrait marcher ?). - pas d'excel, pdf non testé (mais devrait marcher ?).
**En cours:** **En cours:**
- recodage pages gestion utilisateurs avec SQLAlchemy. - tests
- migration bases `SCUUSERS`vers `SCO8USERS`
- raccorder page "entreprises".
## Setup (sur Debian 10 / python2.7) ## Setup (sur Debian 10 / python3.7)
Pour les dev, le plus simple est de partir d'une install fonctionnelle de ScoDoc7 sous git, et de changer de branche Pour les dev, le plus simple est de partir d'une install fonctionnelle de ScoDoc7 sous git, et de changer de branche
git checkout ScoDoc8 git checkout ScoDoc8
Puis d'installer Flask comme suit:
virtualenv envsco8
source envsco8/bin/activate
Installation:
apt-get install libcrack2-dev
pip install flask
# et pas mal d'autres paquets
donc utiliser:
pip install -r requirements-2.7.txt
pour régénerer ce fichier:
pip freeze > requirements-2.7.txt
## Setup python3.7
Debian 10 est livré avec Python 3.7. Debian 10 est livré avec Python 3.7.
apt-get install python3-dev apt-get install python3-dev
apt-get install python3-venv apt-get install python3-venv
Création d'un environnement:
python3 -m venv venv python3 -m venv venv
Puis installation de Flask: Puis installation de Flask:
@ -125,14 +102,6 @@ Pour créer un utilisateur "super admin", c'est à dire admin dans tous les dép
flask user-create admin1 SuperAdmin @all flask user-create admin1 SuperAdmin @all
### Bidouilles temporaires
Déconseillé: nstaller le bon vieux `pyExcelerator` dans l'environnement:
(cd /tmp; tar xfz /opt/scodoc/Products/ScoDoc/config/softs/pyExcelerator-0.6.3a.patched.tgz )
(cd /tmp/pyExcelerator-0.6.3a.patched/; python setup.py install)
La gestion des fichiers excel va attendre le passage à Python3.
## Lancement serveur (développement, sur VM Linux) ## Lancement serveur (développement, sur VM Linux)