ドキュメントにおける PEP 8
これまでは、PEP 8 がコードの機能的な部分に与える影響を見てきました。コメントやドキュメントをより読みやすくするためのルールも存在します。この演習では、さまざまな種類のコメントを PEP 8 に準拠した形に修正しましょう。
以下は、pycodestyle によるスタイルチェックの結果です。
my_script.py:2:15: E261 at least two spaces before inline comment
my_script.py:5:16: E262 inline comment should start with '# '
my_script.py:11:1: E265 block comment should start with '# '
my_script.py:13:2: E114 indentation is not a multiple of four (comment)
my_script.py:13:2: E116 unexpected indentation (comment)
この演習はコースの一部です
Python におけるソフトウェアエンジニアリングの原則
演習の手順
pycodestyleの出力結果を参考に、コードのコメントを PEP 8 に準拠した形に修正してください。
実践的なインタラクティブ演習
このサンプルコードを完成させて、この演習に挑戦してみましょう。
def print_phrase(phrase, polite=True, shout=False):
if polite:# It's generally polite to say please
phrase = 'Please ' + phrase
if shout: #All caps looks like a written shout
phrase = phrase.upper() + '!!'
print(phrase)
#Politely ask for help
print_phrase('help me', polite=True)
# Shout about a discovery
print_phrase('eureka', shout=True)