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.
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.
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)
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:**
- recodage pages gestion utilisateurs avec SQLAlchemy.
- migration bases `SCUUSERS`vers `SCO8USERS`
- raccorder page "entreprises".
- tests
## 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
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.
apt-get install python3-dev
apt-get install python3-venv
Création d'un environnement:
python3 -m venv venv
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
### 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)