oshiro の日記

I love good unittest, low level programing and nice team

プログラミング

コメントの目的はコードの「意図」を理解してもらうこと

最近 Twitter 等でコメント論争がありましたので, 自分自身のコメント方の振り返りも兼ねて記事に起こしてみようと思いました. 本当は「コメントとはかく書くべきである!」みたいなことが言えればいいんですけど、私そこまでコメント力無いので基本的には『…

メソッド名は抽象的でよいと思う

最近見たコードで「ん?これは。。。」というコードを見かけたので、そこら辺にスポットした話を書こうと思います。 まずは何も言わずに下記のコードを見てください。 class CsvGenerator(): def generate_csv(): xxx def generate_csv_from_json(): yyy def…