Je vous avais montré dans le précédent article comment créer une documentation avec Sphinx. Je vais cette fois-ci vous expliquer comment l'utiliser pour documenter le code d'un projet Python. Et comme Sphinx a été créé à l'origine pour rédiger la documentation officielle du langage Python, vous verrez qu'il contient tout …
Github est une forge logicielle très complète, qui fourni plein de services très utiles aux développeurs. On va s'intéresser aujourd'hui à deux d'entre eux : Github Pages et Github Actions.
Github Pages est un petit hébergement Web, fournit gratuitement avec tous les dépôts hébergés sur la plateforme. On peut y stocker …
Sphinx est un outil très complet permettant de générer des documentations riches et bien structurées. Il a originellement été créé pour la documentation du langage Python, et a très vite été utilisé pour documenter de nombreux autres projets.
Il peut être utilisé pour simplement écrire un ouvrage technique (sans rapport …
Je connaissais l'existence de Doctest depuis longtemps, mais je n'avais jamais pris le temps de vraiment m'y intéresser ni de l'utiliser. De toute façon j'utilisais déjà Pytest qui est plus puissant, donc Doctest ne pouvait pas m'être utile pas vrai ? Spoiler alert : j'avais tort !
Doctest est un framework de test …
J'utilise VIM depuis presque une quinzaine d'années maintenant et je n'ai jamais eu envie de changer d'éditeur de texte depuis que je l'ai découvert. Certains trolls diront que c'est par ce que je n'ai jamais réussi à en sortir, mais ils ont tort, je peux le quitter quand je veux …
Quel que soit le langage avec lequel on travaille, le besoin d'une bonne autocomplétion se fait vite sentir dès lors que l'on est amené à travailler sur des programmes de plus de quelques lignes. Le problème, c'est que tous les langages de programmation ne sont pas égaux face à l'autocomplétion …