Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente | |||
python:python3_pour_asr [2018/01/09 09:19] herve ballans |
python:python3_pour_asr [2018/01/09 17:42] (Version actuelle) herve ballans |
||
---|---|---|---|
Ligne 11: | Ligne 11: | ||
#!/usr/bin/env python3 | #!/usr/bin/env python3 | ||
# -*- coding: utf8 -*- | # -*- coding: utf8 -*- | ||
+ | </code> | ||
+ | |||
+ | ===== Documentation ===== | ||
+ | |||
+ | Grace aux docstrings, il est très facile (et recommandé!) de documenter son code : | ||
+ | |||
+ | <code> | ||
+ | def server(): | ||
+ | """Définit les caractéristiques du serveur""" | ||
+ | </code> | ||
+ | |||
+ | L'accès à la documentation peut se faire de 2 manières, soit par la fonction help() : | ||
+ | |||
+ | <code> | ||
+ | help(server) | ||
+ | </code> | ||
+ | |||
+ | soit avec l'attribut //__doc__// | ||
+ | <code> | ||
+ | server.__doc__ | ||
</code> | </code> | ||