-
black777cat
- 1124
- 5
- 0
- 0
-
- いいね！0
こはた｜Python、GAS勉強中
@kohaku935
コメントで、命名をごまかす… 命名がしっくり来ていない時に、これはやってしまうやつ。 理想は、コードのみで語りかける。 #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:06:31
ホッタ@技術同人誌執筆中
@Hotta3216
その時読み手が気にするのは「コードの意図」や「何に注意すれば安全に変更できるか」 それら課題を解決できるコメントが「良いコメント」 #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:07:26
ホッタ@技術同人誌執筆中
@Hotta3216
ドキュメントコメント ドキュメンテーションコメントと言うこともある あるフォーマットに従って記述すると、APIドキュメント生成やエディタ上でのポップアップ表示ができる Pythonにもあるよ！ #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:08:48
kudou
@kudou32323
意図や仕様変更時の注意点を書いておくのが、良いコメントではないか →つまり、コードの翻訳ではなくて、もっと本質的な注意点を書くということ →コード自体は名前の付け方を工夫して、コメント不要でも理解できるのが理想 #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:08:59
kudou
@kudou32323
必ず自身のクラスのインスタンス変数を使う →インスタンス変数を守るためにガード節を用意する #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:14:44
こはた｜Python、GAS勉強中
@kohaku935
5人目：ホッタさん 12章 「メソッド（関数）」 インスタンス変数は、不変にする。 新しいインスタンスを生成して返す。 #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:17:45
kudou
@kudou32323
尋ねるな、命じろ Tell, Don't Ask! まだこの言葉の意味が分かっていない・・・ #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:20:23
kudou
@kudou32323
getter/setterを必要としている時点で、このクラスの外で変数の中身を設定したり、判断しているロジックを組んでいることになる →getter/setterは尋ねているから、良くないのか・・・？ #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:24:15
こはた｜Python、GAS勉強中
@kohaku935
本来のカプセル化は、データとそのデータを操作するロジックを１つのクラスにまとめ、必要なメソッドだけを外部に出す。 #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:24:41
こはた｜Python、GAS勉強中
@kohaku935
コマンド・クエリ分離 取得＆更新を一緒にやると、混乱する。 取得と更新は別のメソッドで提供する。 #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:26:24
kudou
@kudou32323
モディファイアやめよう →状態の変更と取得を同時に行うメソッドは混乱しやすいし使いにくい →コマンドとクエリの2つにメソッドを分けよう #ノンプロ研 #ミノ駆動本 #輪読会 pic.twitter.com/83NnfjqHag
2022-07-03 21:26:47
拡大
kudou
@kudou32323
エラーは戻り値で返さない、例外をスローすること →ガード節を入れて、インスタンス化する際に例外を創出する なるほどー、ガード節にはそういう効果もあるのか！ #ノンプロ研 #ミノ駆動本 #輪読会
2022-07-03 21:32:54