From 1af9fb2410a1884ce5504fe9a6b07837456e88c7 Mon Sep 17 00:00:00 2001 From: Emmanuel Viennet Date: Mon, 12 Jul 2021 22:53:35 +0200 Subject: [PATCH] doc pour python 3 --- README.md | 51 ++++++++++----------------------------------------- 1 file changed, 10 insertions(+), 41 deletions(-) diff --git a/README.md b/README.md index f3694dcc..4d149d03 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ Documentation utilisateur: 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. + - 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 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)