Go to content

Doc-tracing : fouiller une base de code fossile grâce au traçage d'exécution (Luc Sorel-Giffo)

Vous est-il déjà arrivé d'arriver sur un projet préhistorique et de vous sentir démuni·e en fouillant la base de code pour comprendre son organisation et la façon dont les fonctionnalités sont implémentées ? Malgré la doc générée, vous vous perdez sur la route du clic et dans les onglets de votre IDE 😬. Des outils de doc-tracing permettent de tracer l'exécution du code et de la documenter le diplodoc-as-codus : diagramme de séquence, diagramme des composants mobilisés par exemple. À travers différentes démos, je vous présenterai comment l'outil pydoctrace utilise les hooks de l'interpréteur Python pour générer ces diagrammes en apposant un simple décorateur (similaire à une annotation des langages JVM) sur une fonction ou un test fonctionnel. Plan : - utilité et exemples de doc-as-code - mécanismes de traçage d’exécution de code Python - partage de résultats de doc-tracing sur des tests de cas droits et d’erreurs

June 28, 2023