{"title":"コードのコミット","version":"5.2","locale":"ja","docname":"internals/contributing/committing-code","url":"/ja/5.2/internals/contributing/committing-code/","canonical":"https://djangodocs.dev/ja/5.2/internals/contributing/committing-code/","summary":"このセクションは、マージする人や、コードがどのように Django にコミットされるのかに興味のある人向けのものです。","html":"

コードのコミットLink to this heading#

\n

このセクションは、マージする人や、コードがどのように Django にコミットされるのかに興味のある人向けのものです。もしあなたが Django にコードを貢献したいコミュニティメンバーなら、代わりに Working with Git and GitHub を見てください。

\n
\n

プルリクエストの取り扱いLink to this heading#

\n

Django は GitHub でホストされているので、パッチはプルリクエストの形で提供されます。

\n

プルリクエストをコミットする際には、個々のコミットが以下に説明するコミットガイドラインに合致していることを確認してください。コントリビューターは可能な限り最高のプルリクエストを提供することが期待されています。実際には、コミットガイドラインに精通しているであろうマージャーが、自分自身でコミットを標準に近づけることを決定するかもしれません。

\n

JenkinsやGitHubのアクションに、OracleやSeleniumのような自動で実行されないプルリクエストビルダーを使ってプルリクエストをテストさせたいかもしれません。手順については CI wiki page を参照してください。

\n

ローカルでプルリクエストをチェックすることが多くなったら、この git エイリアスが役立つでしょう:

\n
Ini
[alias]\n    pr = !sh -c \\"git fetch upstream pull/${1}/head:pr/${1} && git checkout pr/${1}\\"\n
\n

これを ~/.gitconfig に追加し、 upstream を django/django に設定してください。そして、 git pr #### を実行すると、対応するプルリクエストをチェックアウトできます。

\n

この時点で、コードに手を加えることができます。 git rebase -i と git commit --amend を使って、コミットの品質が期待通りのものであることを確認しましょう。準備ができたら次のようにします:

\n

Linux / macOS

Shell
$ # Pull in the latest changes from main.\n$ git checkout main\n$ git pull upstream main\n$ # Rebase the pull request on main.\n$ git checkout pr/####\n$ git rebase main\n$ git checkout main\n$ # Merge the work as "fast-forward" to main to avoid a merge commit.\n$ # (in practice, you can omit "--ff-only" since you just rebased)\n$ git merge --ff-only pr/XXXX\n$ # If you're not sure if you did things correctly, check that only the\n$ # changes you expect will be pushed to upstream.\n$ git push --dry-run upstream main\n$ # Push!\n$ git push upstream main\n$ # Delete the pull request branch.\n$ git branch -d pr/xxxx\n
\n

Windows

Windows
...\\> REM Pull in the latest changes from main.\n...\\> git checkout main\n...\\> git pull upstream main\n...\\> REM Rebase the pull request on main.\n...\\> git checkout pr/####\n...\\> git rebase main\n...\\> git checkout main\n...\\> REM Merge the work as "fast-forward" to main to avoid a merge commit.\n...\\> REM (in practice, you can omit "--ff-only" since you just rebased)\n...\\> git merge --ff-only pr/XXXX\n...\\> REM If you're not sure if you did things correctly, check that only the\n...\\> REM changes you expect will be pushed to upstream.\n...\\> git push --dry-run upstream main\n...\\> REM Push!\n...\\> git push upstream main\n...\\> REM Delete the pull request branch.\n...\\> git branch -d pr/xxxx\n
\n

ブランチを強制的にプッシュします。これにより、メインとブランチのコミットハッシュが一致するようになり、プルリクエストが自動的にクローズされます。

\n

プルリクエストを複数のコミットとしてマージする必要がない場合は、GitHub の "Squash and merge" ボタンを使ってください。コミットメッセージを ガイドライン に合うように必要に応じて編集し、メッセージの最初の行に自動的に付加されるプルリクエスト番号を削除します。

\n

プルリクエストのコミット履歴を書き換えるとき、その目的は Django のコミット履歴をできるだけ有用なものにすることです:

\n\n

実用性は純粋さに勝るので、プルリクエストに対してどの程度履歴を加工するかは各マージャー次第です。主なポイントは、コミュニティを巻き込むこと、仕事を終わらせること、そして使えるコミット履歴を持つことです。

\n
\n
\n

コミットガイドラインLink to this heading#

\n

また、Django の Git リポジトリにコードをコミットする際には、以下のガイドラインに従ってください:

\n\n\n\n
\n
\n

コミットの取り消しLink to this heading#

\n

完璧な人はいません。間違ったコミットがなされることもあります。

\n

しかし、ミスが起こらないように最大限の努力をしましょう。私たちに差し戻しポリシーがあるからといって、可能な限り最高の品質を目指すあなたの責任が緩和されるわけではありません。本当に: 自分の仕事をダブルチェックするか、そもそもコミットする**前に**別のマージャーにチェックしてもらいましょう！

\n

誤ったコミットが発見された場合は、以下のガイドラインに従ってください:

\n\n
","rootId":"committing-code","toc":[{"title":"プルリクエストの取り扱い","anchor":"handling-pull-requests","children":[]},{"title":"コミットガイドライン","anchor":"committing-guidelines","children":[]},{"title":"コミットの取り消し","anchor":"reverting-commits","children":[]}],"breadcrumbs":[{"docname":"internals/index","title":"Django internals","url":"/ja/5.2/internals/"},{"docname":"internals/contributing/index","title":"Django へのコントリビュート","url":"/ja/5.2/internals/contributing/"},{"docname":"internals/contributing/writing-code/index","title":"Contributing code","url":"/ja/5.2/internals/contributing/writing-code/"}],"prev":{"docname":"internals/contributing/accessibility","title":"アクセシビリティ","url":"/ja/5.2/internals/contributing/accessibility/"},"next":{"docname":"internals/contributing/writing-documentation","title":"ドキュメントを書く","url":"/ja/5.2/internals/contributing/writing-documentation/"},"formats":{"html":"/ja/5.2/internals/contributing/committing-code/","markdown":"/ja/5.2/internals/contributing/committing-code.md","json":"/ja/5.2/internals/contributing/committing-code.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/internals/contributing/committing-code.txt","official":"https://docs.djangoproject.com/ja/5.2/internals/contributing/committing-code/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}