はじめに

OSSとは

簡単に言うと、誰でも無料で読んだり使ったりすることができるソースコードです。

オープンソースという言葉が生まれた1998年に、定義が定められました。
オープンソースの定義(v1.9)注釈付

まとめると、
・再配布自由
・ソースコードの公開
・派生物の許容
・差別の禁止
・追加ライセンスの禁止

これらの条件を守っているものがオープンソースと呼ばれるようです。

ChatGPTの出現

ChatGPTや各Pluginの活用方法がメジャーになったことで、コードリーディングに関しても今までとは比べ物にならない程、効率的に行うことができるようになりました。

何のために読むのか

OSSコードリーディングは、他人のコードを読むことで技術力を向上させる方法として知られています。
実際にどのような良いことがあるのかをまとめました。

業務のため

自社のシステムに組み込まれているOSSのコードを理解し, システムの安定性を保つために行います。
OSSのコードまで理解しておくと、開発やシステムの保守、デバッグも本質的な理解をした上で行えるようになります。

発生している障害を解決するため

自分の作っている、または既に存在しているシステムにおいて障害が発生した時、OSSの内部構造を理解していないと解決できない場合があります。
ライブラリのソースコードまで踏み込むのは一見遠回りなようですが、本質的な解決をすることでエンジニアとしての経験値を得ることができます。

機能実装のため

ソースコードにおける既存の機能を学習することで、自身のプロジェクトに実装する際の参考にします。
例えば、Reactによる先人のソースコードを読むことで、フロントエンド開発に関して自分の中のベストプラクティスを定めることができるでしょう。

技術のキャッチアップのため

技術トレンドをキャッチアップするために、先進的なプロジェクトのコードを読むことがあります。
例えばEthereumのソースコードを読み、ブロックチェーン技術について理解を深める、などです。

プログラミング言語学習のため

学習したいプログラミング言語の理解を深める際に有効です。
ある程度文法が理解できている言語であれば、実際にソフトウェアでどのように使われているかを学習することができます。

何を読めばいいのか

業務上読むべきものが決まっている場合はそれを読むとよいでしょう。
そうでない場合は、

・ある程度習熟している言語
・実際に使っていたり、仕様を把握しているもの
・新しい技術で、知的好奇心がくすぐられているもの

など先ほど例に挙げたような目的別に、自分なりに選定しましょう。
もし馴染みのないOSSの場合は、一度自分で動かしてみたり使ってみることをおすすめします。

ここで、githubで自分の読みたい言語を指定して検索する方法を紹介します。

とは言っても、検索バーでlanguage:<言語>と入力するだけです。
他にも、
filename:でファイル名を指定したり、
path:でパスを指定することもできます。

気を付けるべきこと

全体を読もうとしない。

OSSコードリーディングにおける初見殺しと呼べる行動が、
巨大なソースコードを一から読もうとすることです。

Linuxなど超有名どころのソースコードは、
自力でコードを一から読み始めても一生全体を理解することはできないでしょう。

途中で挫折して、自分がどの部分を理解したのかさえ分からないというのがオチです。

小規模なソフトウェアの全容を把握したいときはいいかもしれませんが、
どのみちいきなりコードを読み始めるのではなく、自分が全体の中のどの部分を読もうとしているのかを把握しましょう。

目的を見失わない

とにかく自分が何のためにコードを理解したいのかを忘れないようにしましょう。
OSSコードリーディングに限ったことではありませんが、
忍耐力が必要な作業には目的意識が必要です。

読んだ先に何があるのか、何を得ることができるのかを明確にし、
飽きてきたとしても作業を続けることができる動機を作ることが重要です。

せっかくであれば後から振り返って意味のない行動にならないようにしたいですね。

OSSコードリーディングの手法

コードリーディングのための環境

github上で読んでいくのが手軽かつ構造的に見ることができるのでいいでしょう。

ただ開発や保守で必要な場合など、本格的に細部の挙動まで把握しておくべき場合は普段自分が使っているエディタを用いるのがよいと思います。

検索やコードジャンプ機能がある、VScodeなどが便利です。

目的を決める

先ほども述べたように何のためにコードリーディングを始めるのか、どのような状態になりたいのかは明確にしておきましょう。

ドキュメントを読む

ドキュメントが充実している場合、目的によってはそもそもソースコードを読む必要もないかもしれません。
関数の説明や、コンポーネントごとの役割の説明などをしてくれている場合が多いのでまずは目を通してみることをおすすめします。

QAサイトを確認する

コミュニティサイトやチャットで、開発者が質問に対して答えている場合があります。
自分の気になっている部分が既存の疑問の場合、それを読むことで解決できる場合があります。
githubやslack, google groupなどが使われることが多いようです。

全体像を把握する

アーキテクチャや主要なコンポーネントを把握しておくと、調べたい機能がどのあたりに属するのか見当がつきやすいです。
ここに関してはいくつか方法があります。
・ドキュメントを読んで把握する。
・ChatGPTに聞いてみる。
・自らの経験と勘で、フォルダ構成から把握する。
自分のレベルごとに全体像を把握するための方法を考えましょう。

以下はPyTorchのソースコードに関して、ChatGPTに質問した例です。

PyTorchに関してあまり知らない人でも、torch/nnらへんを見ればニューラルネットワークモジュールとその周辺が記述されているんだなということが分かりそうですね。

重点的に読む部分を決める

先ほども注意点としてあげたように、いきなり全体を読もうとするのは危険です。
全体像を把握した上で、自分の目的と持っている時間的なリソースとの兼ね合いで何を重点的に読むのかを明確にしましょう。

ここまで来たら、あとは自信をもってどんどん読み進めるのみです！

コミットログ・プルリクエストを見てみる

余裕があれば、コミットログやプルリクエストを見てみると勉強になります。
どのような経緯で実装したのか、なぜ変更が必要だったのか、を考えることでエンジニアとしての経験を自分のものにすることができます。

読んでも分からない時は実際に動かす

OSSに限らず、最も自分の身になる勉強法は自分で動かすことです。
ソースコードの一部分を自分のエディタ上で動かせるような環境を整え、積極的に実行するとよいでしょう。

アウトプットする

言わずもがなですが、アウトプットすることで理解度・定着度が圧倒的に高くなります。
・個人ブログ
・社内wiki
・スライド+登壇
など手軽なものでもアウトプットすることで自分のレベルをどんどん上げていくことが可能です。

OSSコードリーディングの実践

今回紹介した流れを基に、OSSコードリーディングを実践してみました。
Lightningのソースコードについて読んでいきたいと思います。

Lightningとは、PyTorchのコードを簡略化して書くことができるようになるライブラリです。
研究者がエンジニアリングに力を入れなくても機械学習を用いられるようにすることを目的としています。

以下が公式ドキュメントです。

目的としては、pytorch_lightning.LightningModuleの仕組みをある程度理解することとします。
pytorch_lightningモジュールに含まれる、LightningModuleのソースコードを探し出し、理解していきたいと思います。

まずはドキュメントやQAサイトを読んでみます。機能の説明はしてくれていますが、実際のソースコードについては触れられていないため、ソースコードを読んでいくことにします。

ドキュメント内にソースコードが記述されているgithubリポジトリへのリンクがあったのでそこへ飛びます。

全体像を把握するために、一通り各フォルダの中身を眺めてみました。
以下のsrc/lightning/pytorchディレクトリにpytorch lightningについて記述されているようでした。

またChatGPTにも、各フォルダがどのような役割をしているのかを簡単に聞いてみました。

出力にもある通りChatGPTの内容は2022年1月時点の内容であるためディレクトリの構成は若干違いますが、各フォルダの役割に関してある程度全体像を掴むことができました。

ある程度全体像を掴むことができたので、LigtningModuleについて読んでいきます。

一旦「LightningModule」でリポジトリ内を検索してみます。
早速、LightningModuleについて記述されていそうな場所を見つけました。

このLightningModuleの仕組みを把握するために、中身を読んでいきます。

まずは全体をざっと眺めます。
親となるクラスが複数存在し、関数やクラスメソッド、オーバーロードが多く記述されています。

github上では、クラス内にどのような関数や変数が記述されているのかを構造的に書いてくれています。

これは全体像を把握する上では大変便利です。

次に、自分が仕組みを把握するために重点的に読む部分を決めました。
具体的には、

・元となるクラスの構造
・自分も使う、主要な関数の仕組み
・気になる関数の役割

を読みました。
深く読もうと思えばもっと深く読むこともできますが、ここは自分の持つ時間と目的との兼ね合いで考えましょう。

まずは元となるクラスの構造とその役割を見ていきました。
元となるクラスは5つあることが分かります。
それぞれについてリポジトリ上で検索をして、記述されている場所を探しました。

以下は１つめの親クラスに関しての記述です。

この時、親クラスの呼び出し順について復習するために、自分でコードを書いて実行をするなどをしました。

myclass.py

class BaseClass:
    def __init__(self):
        super().__init__()
        print("BaseClass init")
        super().__init__()

class SecondClass:
    def __init__(self):
        print("Second init")
        super().__init__()

class ThirdClass:
    def __init__(self):
        print("Third init")

class MyClass(BaseClass, SecondClass, ThirdClass):
    def __init__(self):
        super().__init__()
        print("MyClass init")

myclass = MyClass()

Second init
Third init
BaseClass init
Second init
Third init
MyClass init

super().__init__によって次に記述されている親クラスのコンストラクタが呼び出されることが確認できました。

次の親クラスであるModelHooks, DataHooks, CheckpointHooksは同じファイル内に記述してありました。
こちらもそれぞれ読んである程度の役割を把握しました。

残るはModuleクラスです。Moduleクラスに関しては、

module.py

from torch.nn import Module

でインポートされているため、lightningではなくpytorchに記述されているクラスのようです。
今回の目的とは少し逸れますが、このModuleクラスの場所も探したいと思います。

pytorchのリポジトリ

を眺め、それぞれのフォルダの中身を見てみましたがどこに記述されていそうか見当がつきませんでした。
リポジトリ内を検索をしても様々なmoduleという単語がヒットしてしまい見つかりそうにありません。
そこで、今回はChatGPTに聞いてみることにしました。

今回の場合は一発でそのファイルへのリンクを出力してくれました。
以下がそのリンクです。

Moduleクラスが記述されていることが分かります。
Moduleクラスに関しては今回の目的に対して重要ではないので、眺める程度にとどめました。

まとめ

今回はOSSを題材に、コードリーディングのに関する進め方、気を付けた方がよいことをまとめました。
これらを意識するだけで効率の良いキャッチアップを行うことができると思いますので、ぜひご活用ください！

弊社Nucoでは、他にも様々なお役立ち記事を公開しています。よかったら、Organizationのページも覗いてみてください。
また、Nucoでは一緒に働く仲間も募集しています！興味をお持ちいただける方は、こちらまで。