Style Guide For Python Code

Bắt đầu từ đầu
                                        

    should be used in preference to using a backslash for line continuation.

    Make sure to indent the continued line appropriately.  The preferred place

    to break around a binary operator is *after* the operator, not before it.

    Some examples:

    class Rectangle(Blob):

        def __init__(self, width, height,

                     color='black', emphasis=None, highlight=0):

            if (width == 0 and height == 0 and

                color == 'red' and emphasis == 'strong' or

                highlight > 100):

                raise ValueError("sorry, you lose")

            if width == 0 and height == 0 and (color == 'red' or

                                               emphasis is None):

                raise ValueError("I don't think so -- values are %s, %s" %

                                 (width, height))

            Blob.__init__(self, width, height,

                          color, emphasis, highlight)

  Blank Lines

    Separate top-level function and class definitions with two blank lines.

    Method definitions inside a class are separated by a single blank line.

    Extra blank lines may be used (sparingly) to separate groups of related

    functions.  Blank lines may be omitted between a bunch of related

    one-liners (e.g. a set of dummy implementations).

    Use blank lines in functions, sparingly, to indicate logical sections.

    Python accepts the control-L (i.e. ^L) form feed character as whitespace;

    Many tools treat these characters as page separators, so you may use them

    to separate pages of related sections of your file.  Note, some editors

    and web-based code viewers may not recognize control-L as a form feed

    and will show another glyph in its place.

  Encodings (PEP 263)

    Code in the core Python distribution should always use the ASCII or

    Latin-1 encoding (a.k.a. ISO-8859-1).  For Python 3.0 and beyond,

    UTF-8 is preferred over Latin-1, see PEP 3120.

    Files using ASCII should not have a coding cookie.  Latin-1 (or

    UTF-8) should only be used when a comment or docstring needs to

    mention an author name that requires Latin-1; otherwise, using

    \x, \u or \U escapes is the preferred way to include non-ASCII

    data in string literals.

    For Python 3.0 and beyond, the following policy is prescribed for

Docstring ConventionsNơi câu chuyện tồn tại. Hãy khám phá bây giờ