https://wiki.phobos-net.fr/ 2026-05-09T22:24:07+00:00 https://wiki.phobos-net.fr/ https://wiki.phobos-net.fr/lib/tpl/dokuwiki/images/favicon.ico text/html 2025-02-27T15:25:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/sphinx/introduction?rev=1740669954&do=diff dev python sphinx documentation Sphinx : Générer de la documentation Sphinx est un programme dédié à la génération de tout type de documentation associée à un projet: * La documentation de référence du code (documentation des modules, classes et APIs); * les tutoriaux (documentation à objectifs pédagogiques); text/html 2023-12-02T09:13:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/core/type_chaines_de_caracteres?rev=1701508391&do=diff dev python caracteres :TODO_DOCUPDATE: Python: Les chaînes de caractères En python caractère et chaîne de caractères sont des objets de type str. Les chaînes de caractères sont des objets immuables: une fois crées elles ne peuvent plus être modifiées. Les méthodes permettant d'altérer les chaînes retournent donc un nouvel objet str. text/html 2023-01-03T23:29:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/documentation_du_code?rev=1672788575&do=diff dev python code documentation :TODO_DOCUPDATE: Python : Génération de la documentation La documentation embarquée dans le code (les docstrings) peut être extraite et mise en forme par le module pydoc. Les conventions d'écriture des docstring sont abordées dans la PEP 257. Les annotations de types (type hinting) participent également à la lisibilité et la documentation du code. text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/bonnes-pratiques?rev=1612216289&do=diff Bonnes pratiques Duck typing La l'oie du canard: If it looks like a duck and quacks like a duck, it must be a duck. Dans la majorité des cas il importe peu que l'objet soit une instance d'un type particulier, on cherche à savoir s'il a le bon comportement. On privilégiera donc l'emploie de text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/manipulation-de-fichiers?rev=1612216289&do=diff dev python fichier file Manipulation des fichiers en python Pour manipuler aisément les fichiers il faut avoir abordé 3 notions: * l'encodage * l'itération * le context manager Écrire du texte dans un fichier Pour lire et écrire du texte dans les fichiers, il faut spécifier correctement l'encodage. L'objet fichier est créé avec la fonction built-in open(), il se chargera d'encoder/décoder les caractères en fonction de l'encodage choisit: text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/start?rev=1612216289&do=diff dev python Python: introduction Quelques notes à propos des spécificités du langage Python basées sur mes écueils. Python a été conçu avec l'objectif d'être lisible, compréhensible faciitant son accès et les échanges de codes. Les choix de conceptions ont été guidés par pragmatisme et non par dogmatisme. text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/jupyter-notebook/start?rev=1612216289&do=diff dev python jupyter Jupyter notebook Le nom Jupyter vient de la contraction des 3 principaux langages utilisés dans le domaine de la data science: Julia, Python et R. L'extension d'un fichier notebook produit par Jupyter est .pynb pour IPython NoteBook, ancien nom du projet Jupyter. text/html 2025-08-31T09:10:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/flask-sqlalchemy/activer-contraintes-fk-sqlite-avec-flask-sqlachemy?rev=1756631453&do=diff dev python web flask sqlalchemy flas-sqlachemy Flask-SQLAlchemy : Forcer la vérification des contraintes sur une base SQLite3 Notes concernant l'activation des contraintes sur clé étrangère (FK) sur les bases de type SQLite3 utilisées en backend via Flask-SQLAlchemy. Problématique Une contrainte de type text/html 2025-07-22T15:31:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/flask-sqlalchemy/relation_agregation?rev=1753198299&do=diff dev python sql sqlalchemy relation Flask-SQLAlchemy : Définir une relation d'agrégation La relation d'agrégation est une forme particulière de relation one-to-many. C'est une composition sans appartenance : la suppression d'une instance de la classe regroupant les agrégats n'entraine pas la suppression des agrégats. text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/debogage?rev=1612216289&do=diff dev python debug debogage Outils de débogage avec python Outils d'analyse statique Analysent le script/module et détectent les anomalies * pylint * pychecker * pyflakes * pep8 * flake8 * mypy: outil standard d'analyse statique du typage pyflakes pyflakes est un outil simple capable de détecter les erreurs de syntaxe, les fautes de frappe notamment dans les noms de variables, les imports manquants ou inutilisés. Il peut être intégré à l'EDI notamment à Vim :) text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/gestion-des-arguments?rev=1612216289&do=diff dev python argument option Python: Gestion des arguments d'appel de script Le module argparse fait partit de la bibliothèque standard python. Il contient tout ce qu'il faut pour gérer les arguments passés au script via la ligne de commande. Il remplace l'ancien module optparse text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/gestion-des-bibliotheques?rev=1612216289&do=diff dev python paquetage bibliotheque package library Gestion des bibliothèques avec pip Les nombreuses bibliothèques Python sont centralisées et accessibles sur un dépôt en ligne répondant au doux nom de PyPI (Python Package Index). Les opérations de téléchargement, d'installation, de mises à jour ou de suppression des bibliothèques se font via l'outil text/html 2021-11-28T13:27:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/pip?rev=1638106066&do=diff dev python pip pip pip est un outil de gestion des bibliothèques externes Python. Il permet: * Installer les bibliothèques et les dépendances. * Mettre à jour/downgrader les versions. * Facilite le déploiement d'une application en générant un listing des bibliothèques utilisées et leurs versions text/html 2023-11-29T15:08:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/core/listes?rev=1701270506&do=diff dev python liste Les listes en python Une liste est un ensemble ordonné d'objets. On parle de structure de données de type séquence car chaque élément est accessible via son index. La liste peut être vue comme une généralisation des chaînes de caractères : là où la chaîne est une séquence de caractères, la liste peut contenir des valeurs de tous types : n’importe quelle valeur peut être contenue dans une liste. text/html 2023-05-29T13:01:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/core/litteraux?rev=1685365314&do=diff dev python Les littéraux En Python, le littéral désigne la notation utilisée pour définir une valeur constante sur un type de base comme la chaîne de caractères (str), la suite d'octets (bytes) et même les valeurs numériques. Pour les chaînes de caractères, le littéral est introduit par un préfixe (stringprefix) et encadré par des guillemets simples, doubles ou triples. text/html 2026-04-05T08:09:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/architecture_projet_flask?rev=1775376548&do=diff dev python flask web api Flask :TODO_DOCUPDATE: Flask n'impose aucune arborescence, selon les besoins on peut opter pour une application monolithique ou modulaire. Application monolithique Pour les petit projets, les tests ou les tutoriaux, on utilise généralement un simple module Python qui se charge d' instancier directement l'objet Flask. Cette approche monolithique permet de coder rapidement une preuve de concept (PoC), un prototype par exemple. text/html 2026-04-05T12:55:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/definir_commande_cli?rev=1775393751&do=diff dev python flask cli commande Flask : Définir une commande CLI Le framework Flask s'appuie sur le paquetage Python Click pour la gestion de la ligne de commande. On utilise les décorateurs pour déclarer une commande. Ci-dessous un exemple simple de commande sans argument : from flask import Flask app = Flask(__name__) @app.cli.command("version") def version(): """Show application version.""" print("0.0.1") text/html 2025-07-27T09:26:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/demarrer_application?rev=1753608365&do=diff dev python framework flask Flask : Démarrer l'application depuis la CLI La commande flask permet notamment d'exécuter l'application sur un serveur de développement intégré au framework ou de démarrer un shell interactif dans le contexte de l'application. Par défaut la commande tente d'importer un module ou un paquetage nommé text/html 2026-04-10T08:22:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/routage?rev=1775809342&do=diff dev python flask routes Flask : routage A propos des routes Définir une URL ayant un sens pour l'utilisateur est préférable en général. Les deux URL ci-dessous peuvent produire le même résultat : * <https://www.example.com/script?action=33257> * <https://www.example.com/create/user> Dans le second cas, on peut directement comprendre le sens de l'action à la lecture de l' text/html 2021-02-01T21:51:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/pygtk/agencement-widgets?rev=1612216289&do=diff dev pygtk widget conteneur Agencer les widgets Pour organiser les différents composants de l'interface graphique (widgets) PyGTK propose un système de boites (box) qui sont des conteneurs invisibles à l’intérieur desquels on insère les widgets. Il existe deux familles: les conteneurs verticaux et les horizontaux. Dans un conteneur horizontal, les objets insérés sont placés les un à la suite des autres en file indienne. Dans un conteneur vertical, les objets seront disposés verticalement les un… text/html 2025-08-03T10:43:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.phobos-net.fr/doku.php/dev/python/flask/flask-sqlalchemy/relation_one-to-many?rev=1754217789&do=diff dev python flask orm db sqlalchemy :TODO_DOCUPDATE: Flask-SQLAlchemy : relation one-to-many Quelques notes à propos de l'implémentation d'une relation un à plusieurs (one to many) avec l'extension Flask-SQLAlchemy. Pour illustrer le concept on prend un exemple rudimentaire : MCD via diagramme UML