GitHub の Repository Template 機能で既存のボイラープレートリポジトリを依存関係なく新しいリポジトリに複製する

f:id:bulldra:20210516105910j:plain

テンプレート的な既存リポジトリを依存関係なく複製したい

　Python でちょっとしたツールを作る時に毎回毎回同じようなコードを書くのも面倒なので、 GitHub に定型コードを集めたリポジトリを作って git clone や fork を使ってリポジトリを複製していたのだけど、それも面倒に感じていた。

　clone / pull してから git のコマンドで依存関係を切って別のリモートリポジトリをに push し直す作業は不毛だし、ツール個別の支流開発が二度と親リポジトリに戻ることはないのに fork するのも正しくない。複製数の制限にも引っかかる。

　そんな時には GitHub の Repository Template 機能を利用することで、ボイラープレート的なリポジトリの依存関係を気にせずに新しいリポジトリに複製してくれる。Repository Template には以下の特性がある。

ひとつのリポジトリからいくつでも複製を作成可能
元となったリポジトリのコミット履歴を継承しない

　簡単な手順で親リポジトリとの依存関係を切って自分用の新しいリポジトリを生成できるのが強み。まさにボイラープレートをテンプレート的に利用するための機能だ。

ボイラープレートコードとは？

ボイラープレートコード (英: boilerplate code、または単にボイラープレート) は、コンピュータプログラミングでは、殆ど、または全く変化することなく、複数の場所で繰り返される定型コードのセクションのこと。冗長な言語を使用する場合、プログラマーはコードを少しだけ書くだけでも多くのコードを作成する必要がある。このような定型コードはボイラープレートと呼ばれる。

　ボイラープレートコードとは、設定ファイル入力、ログ出力、引数解釈やなどの汎用的ではないが典型的な定型コードをまとめたもの。フレームワークやライブラリ自体は疎結合かつ柔軟なカスタマイズが可能なように作成されるべきだが、それを利用する側にかかれるコードの「いつもの感じ」は複製的にせざるを得ない。

　僕自身のために作成した python 用ボイラープレートでは .gitignore、Dockerfile、pytest 環境なども含めておくことで、コードを書き始めるまでのハードルを下げたいという意図がある。Docker さえインストールしてあれば Python 環境やライブラリインストールもホスト環境を汚さずに仮想コンテナ内に展開できる。