Discussion :

[IPreferCSharp]

Bonjour,

Aujourd'hui je met un gros coup de décrassage sur un gros projet sur lequel je travail.
J'ai pris aussi un peu de temps pour réorganiser la structure de mon projet. J'ai donc parcouru le web à la recherche des bonnes pratiques et j'ai trouvé quelques ressources intéressantes
https://jeffknupp.com/blog/2013/08/1...the-right-way/
https://github.com/audreyr/cookiecutter-pypackage

Je vois beaucoup de questions de code sur ce forum(Python), mais assez peu finalement sur l’environnement de travail, les outils, la méthodologie et l'organisation autant pour la phase de développement que pour le déploiement.
Je sais que certains points sont bien sur spécifiques au projet, et certains autres sont assez subjectifs (par exemple la stratégie d'organisation des tests unitaires), mais je pense qu'on peu quand même se mettre d'accord sur des bonnes pratiques et sur un template de base.

C'est dans cet optique que je crée ce nouveau thread afin que les gens puisse communiquer sur leurs pratiques et débattre sur les solutions proposées


Voici mon projet réorganisé:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
 
MON_PROJET_REPO
    - binaries/ 
    - docs/ (sphinx)
    - mon_projet/
        - components/ (composants réutilisables)
            - component_1/
                - unit_tests/
                - component_1.py
            - ...
        - locale/
        - mon_projet/
            - truc_1/
                 - unit_tests/
                 - truc_1.py
            - ...
        - main.py
    - icons/ (logo, ...)
    - py_venv/ (virtualenv)
    - requirements/
        - prod.txt
        - test.txt
        - dev.txt
    - scripts/ (innosetup, sphinx, .bat ...)
    - .gitignore
    - .gitmodules
    - .travis.yml
    - HISTORY.md (Historique des changements)
    - license.rtf
    - Makefile
    - MANIFEST.in
    - README.md
    - requirements.txt
    - setup.cfg
    - setup.py
    - tox.ini

Personnellement j'utilise:
Virtualenv + virtualenvwrapper
Innosetup
Git
Sphinx
Tox
Travis / Jenkins

(Je ferai une maj demain pour rajouter quelques détails - c'est l'heure de quitter le boulot )

[wiztricks]

Salut,

Je vois beaucoup de questions de code sur ce forum(Python), mais assez peu finalement sur l’environnement de travail, les outils, la méthodologie et l'organisation autant pour la phase de développement que pour le déploiement.

Côté Python, c'est documenté dans le chapitre Distributing Python Modules de la documentation. Pour les autres outils, on est dans le développement "en général" et la rubrique ad hoc est plutôt ALM (IDE, gestion de configuration,...) et c'est rarement spécifique à Python.

- W

[tyrtamos]

Bonjour,

En ce qui me concerne, voilà comment je m'organise pour mes projets Python graphiques (PyQt):

projet => répertoire du projet

**base => répertoire contenant les données gérées (exemple: une base sqlite)
en production, les données gérées ne peuvent pas être dans le répertoire d'installation du programme!

**programme => répertoire contenant tous les codes du programme
****@documodule => programme perso de documentation et d'inspection des codes python
****aide => répertoire contenant tous les fichiers d'aide écrits en html avec Kompozer
****apropos => répertoire contenant la fenêtre graphique "à propos" du projet
****biblio => répertoire "package" contenant tous les modules généraux, y compris les widgets personnalisés
****build => tous les programmes "exe" créés par cx_freeze
****fenetre1 => répertoire contenant la fenêtre graphique 1
******fenetre1_ui.ui => fichier xml créé par qtdesigner
******fenetre1_ui.bat => fichier bat pour créer la fenêtre python avec pyuic5
******fenetre1_ui.py => fichier python créé par pyuic5 à partir du fichier xml
******fenetre1.py => fichier py de la fenêtre qui importe fenetre1_ui.py
****fenetre2 => répertoire contenant la fenêtre graphique 2
****fenetre3 => répertoire contenant la fenêtre graphique 2
****etc...
****programme1.pyw => code du programme pouvant être appelé directement
****programme1_cx_freeze.bat => lancement du traitement cx_freeze
****programme1_cx_freeze_setup.py => fichier de configuration pour le traitement par cx_freeze
****programme2.pyw
****programme3.pyw
****etc...
****designer.pyw => programme permettant d'appeler le qtdesigner avec les widgets personnalisés du projet

J'utilise eclipse + pydev pour les développements.

Au fur et à mesure de mes développements, j'identifie de nouveaux modules personnels réutilisables que j'intègre dans le répertoire/package biblio quand j'en ai besoin. Ça me consomme un peu plus de temps d'étude à chaque fois, mais ça me permet d'aller plus vite dans les développements suivants. Par exemple, j'ai des modules personnels pour: csv, ini, ftp, disque, zip, pdf, html, etc...

En plus, j'utilise pylint pour déverminer mes codes Python.

Mais je n'ai pas les mêmes contraintes qu'une équipe de développement: je suis tout seul! Il y a donc des choses que je ne fais pas mais que des pros devraient faire => voir les bonnes pratiques professionnelles!