あなたが探している一般的なガイドラインは、あなたが引用されたものの中にPEP257に多分あなただけのアクションでそれを見る必要が権利です。
あなたの関数は、1行のドキュメンテーション文字列(「本当に明白な例」)のための良い候補である:あなたは機能が何かをチェックしていると言うなら、それは返すために起こっていることを意味通常
def script_running(self, script):
"""Check if the script is running."""
True
またはFalse
が、あなたが好きなら、あなたはより具体的な可能性:
def script_running(self, script):
"""Return True if the script is running, False otherwise."""
もう一度、すべて1行で。
関数は、その名前(スクリプト)にどのような作品を重視する必要はありませんので、私はおそらく、あなたの関数の名前を変更します。関数名は、関数が何をするかについて、甘くて短く、意味があるものでなければなりません。おそらく、私は行くよ:は、全ての符号化によって疲れている
def check_running(self, script):
"""Return True if the script is running, False otherwise."""
時々関数名-想像力が、あなたは自分のベストを尽くすために、とにかく試してみてください。
は複数行たとえば、私はgoogle guidelinesからドキュメンテーション文字列を借りる:
def fetch_bigtable_rows(big_table, keys, other_silly_variable=None):
"""Fetches rows from a Bigtable.
Retrieves rows pertaining to the given keys from the Table instance
represented by big_table. Silly things may happen if
other_silly_variable is not None.
Args:
big_table: An open Bigtable Table instance.
keys: A sequence of strings representing the key of each table row
to fetch.
other_silly_variable: Another optional variable, that has a much
longer name than the other args, and which does nothing.
Returns:
A dict mapping keys to the corresponding table row data
fetched. Each row is represented as a tuple of strings. For
example:
{'Serak': ('Rigel VII', 'Preparer'),
'Zim': ('Irk', 'Invader'),
'Lrrr': ('Omicron Persei 8', 'Emperor')}
If a key from the keys argument is missing from the dictionary,
then that row was not found in the table.
Raises:
IOError: An error occurred accessing the bigtable.Table object.
"""
これはへの一つの方法かもしれない「その振る舞いを要約し、その引数、戻り値(s)は、副作用を文書化し、発生した例外、および呼び出すことができるときの制限(該当する場合すべて)」。
このexample of pypi projectは、Sphinxと記載されていることをご確認ください。
私の2セント:ガイドラインあなたがしてやるべきではないすべきかについてのアイデアを与えることを意図しているが、彼らはあなたが盲目的に従わなければならない厳格なルールではありません。だから最後にあなたが良いと感じるものを選んでください。
私はドキュメンテーション文字列で行の最大長を打つ程度別の答えに言われているものをクリアしたいと思います。
--------------------------------------------------------------------------------
そして、これがことがあります
PEP8は最後に誰もがこれは80 charachters 80
あるんにもかかわらずに「リミット79文字の最大のすべての行を」を示しています少し長い文が本当に必要な辺の場合:
def my_long_doc_function(arg1, arg2):
"""This docstring is long, it's a little looonger than the 80 charachters
limit.
"""
1行のようなものですdocstringは、本当に明白な場合はの場合はを意味しますが、エディタ(80文字の制限あり)は複数の行にあります。