同僚のコードをレビューする
同僚から、書いたコードをレビューして本番運用に向けた改善のアドバイスが欲しいと頼まれました。保守性が高く再利用しやすい関数には docstring を付けるのがベストプラクティスだと知っているので、まずは確認として、同僚のすべての関数にこの has_docstring() 関数を使ってみることにしました。
def has_docstring(func):
"""Check to see if the function
`func` has a docstring.
Args:
func (callable): A function.
Returns:
bool
"""
return func.__doc__ is not None
この演習はコースの一部です
Python関数の書き方
実践的なインタラクティブ演習
このサンプルコードを完成させて、この演習に挑戦してみましょう。
# Call has_docstring() on the load_and_plot_data() function
ok = has_docstring(____)
if not ok:
print("load_and_plot_data() doesn't have a docstring!")
else:
print("load_and_plot_data() looks ok")