Version imprimable
Bonjour,
quelqu'un connait-il une bibliothèque qui nettoie un code de tous ses commentaires et docstrings ?
L'idée serait d'avoir deux versions de mon projet : l'une allégée pour les utilisateurs non programmeurs, et une autre pour les développeurs avec les commentaires et docstrings.
codes-le ... voilà un bon exo.
On est d'accord, c'est assez facile à coder mais j'ai la flemme.
Côté principe, histoire de montrer que je ne bleuffe pas, il faut faire :
- Repérer les chaînes de caractères car par exemple "#..." ne sera pas un commentaire.
- Trouver ensuite les commentaires, ie #...finDeLigne en dehors des chaînes, et en faisant gaffe aux ligns commençant par un dièse et indiquant qu'il faut lancer Python et aussi l'encodage du fichier.
- Trouver les docstrings, ie debutDeLigneOuPresque"""...""" et debutDeLigneOuPresque'''...''', et leurs versions "raw".
Je "m'auto-réponds" et "auto-chambre" au passage : essayer ceci.
On y trouve http://stackoverflow.com/questions/1...nts-docstrings qui renvoie vers http://code.activestate.com/recipes/576704/ . Je vais tester cette solution.
Salut
Je suis dubitatif quand à l'intérêt de la fabrication de script "nettoyés":
- un langage de script c'est bien parce que lisible et les docstrings rendent la chose encore plus aisée.
- avec des scripts "avec" et "sans" on va être embêté pour diagnostiquer une erreur à la ligne x du module machin: le développeur n'a pas la même chose à la ligne x ou sera obligé de "translater". Beurk!
- en plus il va falloir tester les deux moutures: comment s'assurer que le nettoyage se fait sans erreur?
Ne serait-il pas préférable de ne livrer que les bytes codes?
Options de la ligne de commande:
Python -OO devrait produire un .pyo libre de commentaires ET de docstringsCitation:
-O¶
Turn on basic optimizations. This changes the filename extension for compiled (bytecode) files from .pyc to .pyo. See also PYTHONOPTIMIZE.
-OO¶
Discard docstrings in addition to the -O optimizations
C'est vous qui voyez ;-)
Cordialement
- W
C'est mieux effectivement.
Par contre, pour le "bug tracking", je suis moins convaincu.