概要
Pharoがソースコードをgithubに置くようになって、既に1年が過ぎていた。レポジトリの周りの巨大なソースコードはPharoersの第二の故郷となり、人々はそこでコミットを産み、プルリクし、そしてマージしていった。
さあ、君もプルリクを送って Pharo コントリビュータ になろう！
はじめに
Pharoの更新の大雑把な概要は以下の手順になっています。
- 問題点を発見したら、
fogbugzissue trackerに登録する。 -
fogbuzissue tracker のイシュー番号でブランチを切って、修正し、プルリクを送る。 - Pharoのコミッターがプルリクを確認しマージする。
本エントリでは、2.の部分について説明します。
準備
ブランチを切り、修正し、コミットし、プルリクを送る作業は全てPharo上で行うことができます。Pharo上でのgithubからレポジトリをクローンし、コミットし、プルリクを作成する作業はIcebergというツールを使って行います。まずは、pharo-projectのpharoレポジトリをフォークします。そして、最新のPharoイメージをダウンロードし、レポジトリをクローンします。
まず最初に、pharoレポジトリをフォークします。ウェブブラウザでgithub上のpharo-project/pharoレポジトリを開いて、ログインして、右上の「Fork」ボタンを押しましょう。
次に、最新のイメージを入手します。PharoLauncherを使うとイメージの管理を含め簡単にできます。PharoLauncherで日本語を使えるようにする3つの方法を参考に、PharoLauncherをダウンロードし、起動し、Pharo 7.0の64ビットの最新イメージをダウンロードしてください。
IcebergはToolsメニューから起動することができます。
Icebergを起動すると、icebergとpharoのレポジトリが「local repository missing」と表示されています。これは、レポジトリと連携できていない状態になっていることを示しています。コンテキストメニューの 「Repair repository」で連携させます。
まだローカルにcloneしていないので、「Clone again this repository」を選択します。
「Clone from github.com」を選択し、Owner nameとして自分のgithubアカウント名を入力し、Project nameとして「pharo」と入力して、Protocolとして「HTTPS」を選んでください。
OKボタンを押すと、しばらく時間がかかりますが、github上の自分のpharoレポジトリからローカルレポジトリをcloneします。
イシュー用のブランチを切る
いよいよ本題です。プルリクを作るために作業用のブランチを作成します。Icebergでpharoレポジトリを選択して、コンテキストメニューから「Pharo」の「Create new branch for issue...」を選択します。
fogbugz のイシュー番号を入力すると、イシュータイトルを自動的に読み込んでくれます。
OKボタンを押すと、作業用ブランチが「イシュー番号-イシュータイトル」というブランチ名で作成されます。
修正する
がんばれ。
コミットしてプルリクを作成する
イシューで報告された問題が解決されたら、コミットしてプルリクを作成します。Icebergでpharoレポジトリを選択してコンテキストメニューで「commit」を選択して、修正されたコードをコミットします。
コードの差分などを確認して、コミットコメントを記入し、OKボタンを押します。
再びIceberg上でpharoレポジトリを選択し、コンテキストメニューから「Github」の「Create Pull Request...」を選択します。
これでさきほどのコミットがpharo-projectのpharoレポジトリにプルリクとして送られます。
マージされるのを見る
コミッターさんがあれこれ質問したりすることがあるので、ちゃんと対応しましょう。納得してもらえたら、pharoレポジトリにマージされます。
おわりに
文章にするとメンドくさそうに見えますが、やってみると思ったより簡単です。さあ、あなたもPharoのコントリビュータになろう！
追記
Pharo 7 からイシュートラッカーが fogbuzz から github(https://github.com/pharo-project/pharo/issues )に変更されました。
また、イシュー報告やプルリクエスト送信の how to が更新されているので、参考にしてください。