GitHub プルリクエストを作成してマージする
プルリクエストは、オープンソースプロジェクトや一部の企業のワークフローで、コントリビュータからの変更を管理したり、変更がマージされる前にコードレビューを開始したりするために使用されます。
プルリクエストを作成すると、元のリポジトリにプッシュする変更内容を他のユーザーに伝えることができ、そのリポジトリのメンテナーが変更内容を確認し、議論して、ベースブランチに統合できるようになります。
プルリクエストの作成者は、プルリクエストのライフサイクルを PyCharm 内で直接管理できます。
プルリクエストを作成します。
プルリクエストツールウィンドウのプルリクエストの詳細を表示します。
レビュー担当者からの受け取ったフィードバックやコメントを活用します。
プルリクエストを統合または閉じるします。
プルリクエストを作成する
メインメニューで、に移動します。プルリクエストドラフトを含むプルリクエストツールウィンドウが開きます。
または、プルリクエストツールウィンドウを開き、右上隅の
プルリクエストの作成をクリックします。左側のリポジトリは、更新を受け取るベースリポジトリです。
名前をクリックし、変更を適用するブランチを選択します。
右側のリポジトリは、ベースリポジトリに追加される変更を含むヘッドリポジトリです。
名前をクリックし、適用する変更が含まれているブランチを選択します。
複数のリモートリポジトリを使用するプロジェクトがある場合は、このポップアップでヘッドリポジトリも変更できます。
任意のファイル名をダブルクリックして差分ビューを開き、送信しようとしている変更を確認します。
プルリクエストの名前をタイトルフィールドに指定し、必要に応じて、リクエストによって適用される変更の説明を指定します。
必要に応じて、レビュー担当者を追加したり、プルリクエストを他のユーザーに割り当てたり、プルリクエストにラベルを追加したりします。
プルリクエストの作成をクリックします。
プルリクエストをプッシュする準備がまだできていない場合は、ドラフトとして保存できます。
プルリクエストの作成ボタンの横にある
をクリックします。開いたメニューで、プルリクエストのドラフトを作成を選択します。
プルリクエストは、GitHub リポジトリにドラフトとして表示されます。メインメニューで を選択すると、後で戻ることができます。
pull_request_template.md ファイルがある場合、PyCharm はプルリクエストにテンプレートの説明を追加する必要があります。テンプレートの詳細については、「GitHub のドキュメント(英語)」を参照してください。
プルリクエストの詳細を表示する
プルリクエストを作成すると、いつでもプルリクエストツールウィンドウでそのプルリクエストを見つけることができます。
プルリクエストツールウィンドウを開くには、メインメニューで を選択します。
プルリクエストツールウィンドウでは、次の操作を実行できます。
状態別、作成者別、ラベル別、担当者別、レビューステータス別のリクエストのフィルター。
プルリクエストをアクティビティステータス (最新、最古、コメントが最も多い、または最も少ない、最近更新された、最も古い) で並べ替えます。
GitHub でプルリクエストに移動する : プルリクエストを選択して、コンテキストメニューからブラウザーでプルリクエストを開くを選択します。
リストからプルリクエストをダブルクリックすると、概要とタイムラインのタブが表示されます。
このビューでは、次の操作を実行できます。
選択したプルリクエストのタイムラインを見るを実行して、その進行状況を追跡します。
特定のコミットを選択するを使用して変更のリストをフィルタリングします。
受信した変更に基づくローカルブランチの作成 : プルリクエストを開き、受信した変更を含むブランチをクリックして、コンテキストメニューでチェックアウト「ブランチ名」を選択します。
その他のオプションについては、プルリクエストを確認するを参照してください。
受け取ったフィードバックを活用する
プルリクエストをレビュー用に送信すると、変更に関するコメントや提案を受け取ることができます。これらのコメントや提案は PyCharm から直接確認・適用できます。
メインメニューで、に移動します。
プルリクエストのリストで、操作するものを選択してダブルクリックします。
PyCharm は、選択したプルリクエストの概要を開きます。
変更が入ったブランチをクリックし、コンテキストメニューでチェックアウト「ブランチ名」を選択します。
ブランチをチェックアウトすると、レビュー担当者が提案した変更をテストし、その動作を確認するための完全なコンテキストが得られます。
チェックアウトが成功すると、PyCharm はレビューモードを起動します。つまり、ハイライト表示された変更とコメントは、Diff タブ (Ctrl+D) だけでなく、エディター (F4) でも確認できます。
調査するファイルを選択し、右クリックしてコンテキストメニューからソースに移動 F4 を選択します。
開いたファイルでは、ガター内のピンク色のマーカーは、行った変更とレビュー担当者が残したコメントを示します。
コメントを解決したり、返信したり、反応を残したりすることができます。
上部のツールバーの
/ 
を使用するか、Ctrl+Alt+Up/Ctrl+Alt+Down を押してコメント間を移動します。レビュー担当者が提案を残している場合は、自分のコードと提案されたコードの差分が表示され、ローカルに適用 (作業コピーにパッチを適用する) またはコミット (コミットメッセージのポップアップを開く) のいずれかを実行できます。
プルリクエストの作業が完了したら、レビューを再リクエストしたり、プルリクエストをマージしたり、プルリクエストをクローズしたりできます。
プルリクエストをマージまたはクローズする
リポジトリへのプッシュアクセス権がある場合は、作業が完了したらプルリクエストをマージできます。
メインメニューで、に移動します。
プルリクエストのリストで、操作するものを選択してダブルクリックします。
概要の下部には、レビュープロセスの段階とプッシュアクセス権に応じて異なるマージオプションのボタンがあります。
レビュー後に更新を承認した場合は、マージをクリックしてプルリクエストをマージできます。
その他のマージオプションについては、
をクリックし、スカッシュとマージを選択して変更を含むコミットを 1 つにまとめ、その後マージするか、リベースを選択してプルリクエストブランチからのコミットをリベースし、ベースブランチに追加します。
詳細をクリックし、このプルリクエストについて別の意見が必要な場合はレビューのリクエストを選択し、マージしない場合はプルリクエストを閉じるを選択します。レビューを送信せずにプルリクエストをマージする準備ができたら、プルリクエストの概要で
をクリックし、マージ、スカッシュとマージ、またはリベースを選択します。
関連ページ：
受信した GitHub プルリクエストを確認する
プルリクエストは、オープンソースプロジェクトや一部の企業のワークフローで、コントリビュータからの変更を管理したり、変更がマージされる前にコードレビューを開始したりするために使用されます。同僚や仲間のコントリビューターからコード変更のレビュー依頼を受けることがあります。プルリクエストレビュアーは、PyCharm で直接フィードバックを提供できます。プルリクエストツールウィンドウの保留中のレビューリクエストを選択します。ご意見・ご提案をお送りください。プルリクエストをマージまたはクローズします。受信...
Git リポジトリのセットアップ
既存の Git リポジトリのクローンを作成するか、既存のプロジェクトを Git バージョンコントロール下に置くと、PyCharm はコンピューターに Git がインストールされているかどうかを自動的に検出します。IDE が Git 実行可能ファイルを見つけられない場合、それをダウンロードすることを提案します。PyCharm は、Windows10 バージョン 2004 で使用可能な Windows Subsystem for Linux 2 (WSL2) の Git をサポートします。Git が...
GitHub でホストされているプロジェクトを管理する
プロジェクトをチェックアウトする (クローン)：PyCharm から直接貢献したいリポジトリのクローンを作成し、それに基づいて新しいプロジェクトを作成できます。メインメニューで、に移動します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の場...