Outils & programmes du département de génie physique de Polytechnique 
- Installation via PyPI: https://pypi.org/project/polygphys/
pip install polygphys - Documentation sur Read The Docs: https://polygphys.readthedocs.io/en/latest/
- Contributions via Github: https://github.com/ejetzer/polygphys
Prérequis & conseils
La version accessible par pip peut être utilisée telle quelle. Les branches beta et alpha sont en développement actif, et ne devrait être utilisées que
- Si vous avez une bonne idée de la structure du programme;
- Si vous êtes capable de lire et déboguer du Python
- Si vous avez Python d'installé, avec les modules décrits dans
requirements.txt - Si vous pouvez utiliser Git
**Pour toutes questions, svp envoyez un courriel à emile.jetzer@polymtl.ca avec «[gestion-inventaire]» dans le sujet du courriel.
Installation
L'installation de la version stable se fait via pip:
pip install polygphys
Le bon fonctionnement du sous-module polygphys.outils.appareils pourrait demander l'installation de logiciel supplémentaire, selon l'utilisation:
- L'installation des drivers VISA officiels de National Instrument
- L'installation de drivers supplémentaires USB pour pyUSB.
- L'installation séparée de pylablib (selon le système d'exploitation)
- L'installation de drivers Keysight ou Agilent pour cetains adapteurs GPIB sur Windows.
Voir la page de référence de pyVISA pour résoudre les problèmes causés par des drivers manquants.
Développement
Le développement se fait sur les branches alpha et beta en général, parfois sur des branches spécifiques à certaines fonctionnalités. Pour s'en servir et les installer, il faut utiliser git:
git clone https://github.com/ejetzer/polygphys.git
cd polygphys
git checkout alpha
pip install -e .
La branche main est gardée à jour avec la dernière version du programme. Les branches v0 servent à identifier les versions majeures. Si on utilise une version majeure particulière, la commande git checkout v0 permettra d'y accéder, puis git pull origin v0 la mettra à jour. Les versions mineures sont indiquées par des étiquettes de la forme v0.0.0. Le second nombre indique les passes beta et le troisième les passes alpha.
À faire
- Uniformiser et étoffer la documentation du module.
Dans le sous module polygphys.outils.base_de_donnees:
- Filtrer par valeur dans des colonnes
- Permettre l'ajout de colonnes de l'intérieur de l'application
-
Placer la base de données dans son propre répertoire git externe, et automatiquement en faire des sauvegardes - Rendre les programmes exécutables avec un argument en ligne de commande & comme application
- Définir plus adéquatement les bases de données et leurs relations
- Permettre d'ajouter des sections de configuration
- Permettre d'ajouter des champs de configuration
- Rendre le logging plus compatible avec sqlalchemy.
- Retirer les logs sql, utiliser ceux de sqlalchemy à la place.
Dans les sous modules polygphys.laboratoires, polygphys.outils.appareils et polygphys.sst:
- Intégrer les applications externes
- Certificats laser
- PHS8302
En général:
- Compléter la suite de tests
Guide stylistique
Pendant le code, il est important de garder en tête les principes énoncés dans les documents suivants:
- PEP8, le guide stylistique de base pour le développement en Python
En fait, ces principes sont tellement importants que je recommande
d'utiliser le programme
autopep8qui peut formater un fichier automatiquement. - PEP20, le Zen de Python, des principes génériques de développement à favoriser quand c'est possible.
- Sphinx pour les chaines de documentation. Ça rend la compréhension future des programmes beaucoup plus facile. On se remerciera quand on sera vieux!
- Les noms de variables, modules, etc devraient suivre ces conventions.
- Dans la mesure du pratique, les noms de classes, fonctions et variables devraient être en français, de même pour la documentation.
Généralement, on veut aussi structurer les fichiers comme le document exemple.py.
1 maintainer
Metadata
1 maintainer
Release files for polygphys 6.0.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| polygphys-6.0.26.tar.gz | 65.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| polygphys-6.0.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 139.7 kB
Release files / polygphys-6.0.26.tar.gz
| Download URL | polygphys-6.0.26.tar.gz |
|---|---|
| Size | 65.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
94dba4e65dacab3d40f4b25c790cb252c5d3f0e46cd5a1607d026b7a8fd7ad8a
|
|
BLAKE2b-256 checksum How to use checksums |
0434a0e6abb24158ce8c2f3ecc737bf1b66966aadb0726013e014a22678f7a4b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.0
|
Release files / polygphys-6.0.26-py3-none-any.whl
| Download URL | polygphys-6.0.26-py3-none-any.whl |
|---|---|
| Size | 74.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bcfead5d0164a8537b210bd6963e0f726aba865ffb8546a9b06e8960a54e6193
|
|
BLAKE2b-256 checksum How to use checksums |
47343fdd5494b761b34c92d155a2435dc70f238e5905a861e518ffac7cbf8b89
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.0
|
