20161209
Python 3 jours d'utilisation nette de Perl
À l'exception de l'alternative au document d'audience, «» »« n'existe que pour «pydoc», et tous les autres commentaires doivent être écrits en «#» [^ 1].
[^ 1]: La source de pydoc elle-même est écrite de cette façon ... À tout le moins, j'aimerais pouvoir spécifier = begin, = end, = cut of perl ...
--Confirmé dans 2.6, 2.7, 3.4 --Dans un sens tactique, il ne considère pas si l'imbrication de fonction ou la classe dans si le bloc est possible.
foo.py
#!/usr/bin/env python
# -*- encoding: utf-8 -*-
'''
about NAME
DESCRIPTION
'''
__author__  = 'bunzaemon'
__version__ = '1.0'
__date__    = '2016/12/09'
x = 42
print (x)
'IGNORED comment'
def foo ():
    # of course ignored
    'DEF: foo'
    'IGNORED comment'
    def bar ():
        'DEF: bar <= IGNORED'
class Clas:
    'CLASS: Clas'
    def __init__ (self):
        'CLASS DEF: __init__'
if 1:
    'IGNORED comment'
    y = 42
    print (y)
    def buz ():
        'DEF: buz'
        def bux ():
            'IGNORED comment'
    class Clas2:
        'CLASS: Clas2'
if 0:
    z = 42
    print (z)
    class Clas3:
        'IGNORED comment'
--ʻU '...' `est inutile => la série 2.6 est de la mousse. [^ 2]
[^ 2]: série 2.6 Si vous n'avez pas à y penser, vous devriez l'ajouter. [^ 3]: Mon futur moi
$ python --version
Python 2.6.6
$ python ./foo.py
42
42
$ pydoc ./foo.py
Help on module foo:
NAME
    foo - about NAME
FILE
    /PATH/TO/foo.py
DESCRIPTION
    DESCRIPTION
CLASSES
    Clas
    Clas2
    class Clas
     |  CLASS: Clas
     |
     |  Methods defined here:
     |
     |  __init__(self)
     |      CLASS DEF: __init__
    class Clas2
     |  CLASS: Clas2
FUNCTIONS
    buz()
        DEF: buz
    foo()
        DEF: foo
DATA
    __author__ = 'bunzaemon'
    __date__ = '2016/12/09'
    __version__ = '1.0'
    x = 42
    y = 42
VERSION
    1.0
DATE
    2016/12/09
AUTHOR
    bunzaemon
        Recommended Posts