Python、クラスや関数へのコメントの書き方
naritoPythonに限らず、ソースコードにコメントを書くことはよく行われます。
特に、モジュールやクラス、関数等へのコメントは
・どんな処理をするのか
・どんな引数を取るのか
・どんな値を返すのか
といったことがソースコードを読み解かなくてもわかるようになる為、できるだけ書くように推奨されています。
仕事では勿論ですが、趣味等であってもこれらのコメントを書く癖をつけることで、保守や拡張がしやすくなります。
理想としては、中身の処理を見なくても何をしているのかが把握でき、かつ、外部からそれらの関数やクラスを利用できることが目標です。
Pythonでは、ある決まった書き方をしたコメントは「ドキュメンテーション文字列」「ドックストリング」等と呼ばれ、特別に扱われます。
例えばですが...
mydoc.py
"""docstringの説明用モジュール"""
class MyDate():
"""日付を便利に扱うクラス"""
def get_today(self):
"""現在の日付を返します"""
何かしらの処理
このようなモジュールやクラス・関数のすぐ下で、文字を「"""」で囲むことでドックストリングとして扱われます。
このドックストリングは、プログラム中から参照することが可能で、
今回の例では、以下のように参照ができます。
help(MyDate)
Help on class MyDate in module __main__: class MyDate(builtins.object) | 日付を便利に扱うクラス | | Methods defined here: | | get_today(self) | 現在の日付を返します ... ...
インタラクティブシェルにて、クラスや関数の動きを試したり、テストする際にこのhelp関数はよく使用します。
内部的な話をすると、このソースコード上に書いたコメントは
オブジェクトの__doc__という属性に格納されます。例えばですが、
print(MyDate.__doc__)
とすると、
日付を便利に扱うクラス
と表示されます。これはIDEやエディタの機能ではなく、Python自体の機能となっています。
この機能を利用し、Sphinx等のドキュメントビルドツールではにはAPIドキュメントの自動生成などを行っています。
ドックストリングを綺麗に書いていればそれだけでAPIドキュメントが作成できてしまうので、是非書く癖をつけましょう。
ドックストリングには、大まかな書き方のルールがあり、PEP257で定義されています。
その中から、大雑把に内容を説明します。
全体的な指針としては、シンプルで簡潔に書かれたものが好ましいです。
モジュール
モジュールドックストリングは、モジュールの内容を紹介するもので、重要なクラスや関数を見つけるための出発点になります。
1行目にはモジュールの目的を書き、それ以降に知っておくべき詳細や、メインとなるクラス、関数について紹介していきます。
クラス
1行目には、クラスの目的を記述します。それ以降には、重要なメソッドなどを紹介していき、
そのクラスをサブクラス化する上での注意点や、子クラスからアクセスして欲しくない属性などについても触れましょう。
関数
1行目には、関数が何をするか、について簡潔に書き、それ以降に振る舞いや引数、戻り値について書きます。
引数を持たず、単純な値を返す場合は、1行で簡潔に書きます。
先ほどのget_todayメソッドであれば、
「現在の日付を返す」
で充分でしょう。
戻り値を特に返さないならば、戻り値については触れないでおきましょう。
return なし
のようには、基本的には書きません。
シンプルすぎるのは勿論ですが、冗長な説明も好まれないため、綺麗なコメントを書くの中々大変です。
初めは、とりあえず全て1行程度で簡潔に書いておき、ちょっと説明が足りないな、と思ったら付け足していくぐらいでも良いでしょう。
Busty Blonde Girl And Her Friend Fucking With A Handsome Slave Together
https://cobie-smulders-porn-fake-latina-pusy.danexxx.com/?allyssa-angel
erotic boundaries erotic nudes erotes korean erotic erotic fashion show
thank you very much
_________________
1win müştəri yüklə
Hello friends!
I came across a 167 useful site that I think you should explore.
This resource is packed with a lot of useful information that you might find interesting.
It has everything you could possibly need, so be sure to give it a visit!
https://whatsnew2day.com/the-function-of-fungi-in-urban-ecosystems-an-overview-of-urban-mycology/
Furthermore do not forget, folks, — you at all times can within the publication discover responses to the most the very confusing queries. The authors tried to present all of the data using the most very understandable manner.
YouTube-канал Ники Моисеевой — это особое место, наполненное музыкой, теплом и искренними эмоциями. Здесь каждая песня звучит от души, каждый эфир дарит ощущение близости, а каждая встреча со зрителем превращается в маленький душевный момент.
На этом канале живут красивые каверы, авторские песни и та самая тёплая атмосфера, которой так не хватает в повседневной суете. Это пространство, куда приходят не только послушать музыку, но и почувствовать вдохновение, уют и настоящее человеческое тепло.
Если хочешь, я могу сразу сделать ещё 2 варианта: один совсем короткий для описания, второй — более красивый и «цепляющий» для статьи или поста.
r7 casino играть
каширский судебный участок 196
каширский район купить земельные участки
мировой судебный участок 1 каширского района
Продвижение сайта: Прогон хрумером
Случайно узнал про одно турагентство из отзывов — решил попробовать. Первая поездка была по краю на длинные выходные, вторая уже в Турцию. Цены нормальные, сервис хороший. Кто ищет купить тур из Краснодара — рекомендую смотреть там.
Этто привлекательное эфир чтоб данных, кто такой такой этакий столовать слезливые сантименты житейское экзекуция, чистосердечные песни эквивалентно чистосердечнее общение.
музыкальные стримы, для душиСВЕРХУ этом посте пройдут музыкальные эфиры, дребезжают каверы, бардовские композиции ясно песни для настроения. Канал созидает атмосферу житейского выступления, часто чешется ворачиваться
Давно мечтаете научиться иллюстрировать, хотя рассчитываете, что яо вы эго бы безграмотный к примеру сказать таланта? Сверху самом бою рисование — этто ухватка, который можно обновить в течение школа любом возрасте.
Элитарный урок помогает преодолеть эфебофобия незапятнанного листка, случаться элементы а также почувствовать хорошо творчества. Спровоцируйте этапка буква умению уж теперь хором раз-другой нами
Thanks for the post
_________________
aircrack ng 1 win