ソース配信の作成

プロジェクトのソース配布は実行することで作成できます。

$ python -m build --sdist .

プロジェクトのルートフォルダーで、.tar.gzアーカイブがプロジェクトルートフォルダーのdistフォルダーに作成されます。このアーカイブには、すべてのバージョン管理メタデータが削除されたリビジョン管理の最新のコミットの全内容が格納されています。コミットされていない変更とリビジョン管理システムに認識されていないファイルは含まれません。

ソース配布アーカイブは、meson dist --no-tests --allow-dirtyコマンドを実行して取得したアーカイブに必要なメタデータファイルを格納することで作成されます。ソース配布を作成するには、meson-pythonはmeson setupコマンドを実行してMesonプロジェクトを正常に設定する必要があります。追加の引数をmeson distに渡すことで、その動作を変更できます。詳細については、関連するMesonドキュメントと引数をMesonに渡すガイドを参照してください。

meson distコマンドは、アーカイブを作成するために、基盤となるリビジョン管理システムのアーカイブツールを使用します。つまり、リビジョン管理システムでバージョン管理されたプロジェクトに対してのみソース配布を作成できます。Mesonは、GitおよびMercurialリビジョン管理システムをサポートしています。

関連するリビジョン管理システムのメカニズムを使用して、ファイルはソース配布から除外できます。リビジョン管理システムとしてGitを使用する場合、export-ignore属性を設定することでソース配布からファイルを排除できます。たとえば、次を含む.gitattributesファイルを追加します

dev/** export-ignore

devフォルダーがソース配布から除外されます。詳細については、git archiveのドキュメントを参照してください。ソース配布の内容を変更するもう1つのメカニズムは、distスクリプトによって提供されます。詳細については、関連するMesonドキュメントを参照してください。