SOLIDとクリーンコードは私には決して堅牢でもクリーンでも感じられなかった
Solid and Clean Code never felt solid or clean to me (devz.cl)
要約
この記事では、プログラミングの学習過程で著者がSOLID原則やクリーンコードに対して抱いた懐疑的な見方を述べています。特に「Uncle Bob」として知られるRobert C. Martin氏の提唱する原則が、根拠に乏しい、あるいは冗長な説明を伴う「詐欺的」なものに感じられたと指摘しています。著者は、これらの原則が新米プログラマーを教条主義的な行動に誘導するリスクがあると考えています。
全文翻訳
SOLIDとクリーンコードは、私にとって決して堅実でもクリーンでもなかった
[画像: Sheep]
私はオンラインのドキュメントやプロジェクトを通してプログラミングを学びました。書籍も読みましたが、私のプログラミングやソフトウェアエンジニアリングのキャリアにおいて、それらが決定的だったとは思いません。読んだ書籍の一部は以下の通りです。
-
Designing Data-Intensive Applications: 非常に良い本でした。
-
The Mythical Man-Month: 古いと感じましたが、業界がどこから来たのかを理解するには役立ちました。
-
Design Patterns, Elements of Reusable Object-Oriented Software: あまり覚えていません。おそらく、すべてのパターンを完全に理解するには早すぎた時期に読んだのだと思いますが、少なくともデザインパターンに関する一般的な理解は得られました。
-
Clean Code: この本は、シニアエンジニアからのアドバイスの寄せ集めのように感じましたが、その多くは検証可能な良いアドバイスではありませんでした。部外者としては、自分のコードが読まれることを意識する必要があるということに気づかせてくれただけでした。
ある日、面接官にデザインパターンとSOLID原則について尋ねられました。私はGang of Fourの本から学んだパターンについて話し始めましたが、彼は私を遮り、SOLID原則について尋ねているのであり、私が何を話しているのか確信が持てないと言いました。今になって思えば、彼はそのトピックについてあまり知らずに、単にルーブリックを読んでいただけだったのでしょうが、私は混乱したままその面接を後にしました。
そこでSOLID原則をググったところ、「アンクルボブ」という人物の動画にたどり着きました。彼は導入部分の大部分を水の分子について語ることに費やし、その後10分以上かけて、新しいプログラマーの数は常に倍増しており、その成長率が続く限り、すべてのエンジニアの半分は常に経験不足であると説明しました。そして、話が始まってから20分も経ってから、彼は悪いコードはあなたを遅くする(当たり前だろ、シャーロック)、コードの硬直性や結合度は悪い、ということを説明し始め、30分経ってようやくトピックの本題に入りました。
この話のほぼ半分は、5分で完全に説明できたはずです。
私がどこから来たのか
その頃、私は歴史学を3年生で専攻していました。週に何千ページも読んだり書いたりする必要がありました。誰もが同じように書くわけではなく、異なる学問分野には異なる文章スタイルがあることを学びました。歴史を書くのであれば、暗黙のうちに従うべき構造や語彙があり、他の人文科学や社会科学も同様で、おそらく自然科学もそうでしょう。
私はそれらを、互いの著作を読み続けるうちに自然発生する、ある種のライティングカルチャーから生じる文化的なルールと見なしています。そのため、良い成績を取るために、エッセイでは教授や彼らが好む著者たちの文章スタイルや調査スタイルを模倣しようとしました。どのような著者を読んでいるのか、その文章の密度、ペース、そして物語と議論をどのように織り交ぜているのか、といった感覚を掴み始めました。
また、ここでは説明しない理由で、その頃までに、おそらく4〜5件の成功した詐欺/コンを間近で見ていました。実際に、詐欺師と被害者のすぐそばで、数ヶ月にわたって詐欺が行われているのを、無力にも見守っていました。
これらすべてを言うと、私は人々がどのように書き、話すかを理解する感覚を養ってきたということです。
なぜこれが詐欺のように読めるのか
「アンクルボブ」を軽蔑するつもりはありませんが、彼が書いたこと、話したことすべてが、天才プログラマーの話し方/書き方だと私を説得しようとしながら、私の時間を詐取されているような気分にさせました。
まず、「アンクルボブ」というニックネームですが、これには次のような背景があります。
はっきりさせておくと、「アンクルボブ」という名前は1989年に同僚から付けられました。長年、私のメールやuunetの署名に使われていました。(uunetが何だったか知らない子供たちもいます。)その名前は定着し、最終的にブランドとして採用しました。
– Robert C. Martin, https://news.ycombinator.com/item?id=7713646
これはまあまあの説明ですが、それでも、信頼できるシニアエンジニアとしてのブランドを確立しようとしていた人物にとって、その名前が操作的だと感じられる事実は変わりません。
また、余談ですが、もちろんuunetが何だったか知らない子供たちもいます。
わかっています。あなたは「経験豊富な」プログラマーなのです。
エンジニアは、自分が客観的な真実を見ることができる公平な機械であると仮定する傾向がありますが、歴史を学んで私が学んだことは、客観性を追求できる唯一の方法は、自分が主観的な人間であることを受け入れることだということです。自分がどれほど客観的であると仮定するほど、自分自身の主観性であれ、他者の主観性であれ、より容易に操作される可能性があります。同僚が「アンクルボブ」を実在の賢明な叔父のように慕い、複雑な依存性注入の悪ふざけを正当化するために彼を引用するのを聞いて、私の操作感覚はすべてオフになりました。
次に、彼が使う実際の文章があります。前述したように、彼のスタイルはフィラーコンテンツに過度に依存しています。もちろん、それは単なるランダムなフィラーコンテンツではありません。彼は自信を持って顎をさすりながら言えること、時折気の利いたジョークを挟むこと、そしてその過程で賢く見えるようなことです。もし私の大学の教授が私にそのように書いているのを見つけたら、彼らの時間を無駄にしたとして減点されたでしょう。大学でこれを何度も見ました。特に私たち学生が。必要なページ数を埋められない場合、私たちは過剰な引用や、議論に影響を与えることなく長さを延ばすだけの、わずかに無関係な物語を追加することに頼りました。
私がフィラーだらけの歴史書やエッセイを読む方法は、まずテキストをスキャンして実際のコンテンツをハイライトし、その後で改めて読み直すことでした。アンクルボブの本でも同じことができます。
「ワークショップのほんの一部を見るだけで、ロバートがどれほど賢いかがわかります。開発におけるソフトウェアの原則、天文学、数学、歴史、企業の世界、そしてほとんどの「プログラマー」と呼ばれる人々が聞いたこともないかもしれない他の主題について(たくさん)話しています!」
– フィラーコンテンツを気に入ったらしい誰か
今、これは部分的には好みの問題であると認めなければなりません。しかし、私の意見では、クラフトの新規参入者にシニア経験の源泉として自分自身を売る場合、いくらかの責任が伴います。最良の場合、あなたは彼らの時間を無駄にしています。最悪の場合、あなたはかなりの信仰を著者にかけることを要求する、低品質なコンテンツを通じて、彼らを教条的な行動に操作しているのです。
アクロニム・マーケティング
ソフトウェアエンジニアはアクロニム(頭字語)が大好きです。
アジャイルのアクロニムには、SOLID、DRY、KISS、YAGNIなどがあります。
ベンダープッシュのアクロニムには、ACID、CAP、OLAP、OLTPなどがあります。
リストは無限です。中には賛成できるものもあります。ACIDやCAPのように、よく調査され、正直な起源を持つものもありますが、同時にこれらが企業と「アジャイル」支持者の両方にとってマーケティングの箇条書きやスローガンとして役立ったために広まったように感じます。よく調べてみると、SOLID原則のいくつかは、精査すると決して堅実ではありません。エンジニアが不必要にコードをDRY(Don't Repeat Yourself)にしようとして生み出した複雑さの量は、終わりのない時間を費やしました。そして、人々がこれらのアクロニムを極端に解釈して自分たちの実践を正当化するトピックについては、さらに続けることができます。
ACID、CAP、OLAP、OLTPなどのアクロニムは、面接の基礎知識として含まれていますが、実際にはソフトウェアシステムを理解するための、はるかに優れた代替手段があります。あまり華やかではないアクロニムのPACELC設計原則は、私のお気に入りの1つです。
エンジニアに公平に言うと、これはアメリカの文化の一部のように見えます。これらの人々は何にでもアクロニムを使います。アメリカ在住の同僚と働き始めたとき、私は毎週のように新しいアクロニムをググる必要がありました。
私にとって、アクロニムの世界で最悪の加害者はEBITDAです。その時点では、まったく新しい単語になっています。新しい概念を考案してください。たとえば、Core Operating Earningsのようなものです。
Wishful Naming(願望的命名)
歴史書を書くとき、「ヒスパニック植民地時代のクリーンな歴史」とか「20世紀チリ農業文化のソリッドな歴史」などとは呼びません。通常は、それが何であるかをそのまま呼びます。私にとって、人々が自分のコードやソフトウェアを「クリーン」「イージー」「シンプル」と呼ぶのは、常に間違っていると感じます。書いているときに目指した主観的な特性を、自分の創造物に与えると宣言する権利はありません。
私は、人々が自分のクラス(特にJavaから来るもの)にSimpleRepositoryのような名前を付けているのを見たことがあります。Repositoryではなぜいけないのでしょうか?もし私があなたのクラスをその名に値するほどシンプルだと感じなかったらどうなりますか?それを削除してもいいですか?もしそれがComplexRepositoryに成長したらどうなりますか?
書籍でも同じです。
アンクルボブがどれほどの経験を持っているとしても、彼は自分のコードをクリーンと呼ぶ権利はありません。「Clean Code」の本にある彼の例の多くは、まったくクリーンではなく、彼自身の原則に矛盾しているとさえ見なされる可能性があります。
私が言いたいのは…
ソフトウェアエンジニアリング文化は、過度に教条的で主観的です。私たちは自分たちが思っているよりも客観的であると考えようとしますが、そうではありません。私たちは、かわいいボーダーコリーに群がられる羊のように、マーケティング手法に陥ります。
アンクルボブ、ごめんなさい。ここであなたをサンドバッグとして使いました。あなたの本や講演は好きではありませんが、少なくともそれは正直な仕事です。私の趣味には少しばかり操作的すぎますが。
これは、SOLIDやClean Codeの内容やアイデアに対する具体的な批判ではありません。それは、それらがどのように提示され、それが私にどのような気分にさせたかについての話です。