テストデータをバージョン管理にチェックインする必要がありますか？

PDFファイルを処理する機能のテストコードを書いています。テストの背後にある基本的な考え方は、特別に選択したいくつかのPDFにそれらを向け、それらを処理し、出力が期待どおりであることを確認することです。

私の質問は、これらの大きなPDFをどこに保存すればよいのかということです。コードとともにバージョン管理にチェックインする必要がありますか？または、それらを別の場所に配置しますか？明らかに、テストコードはPDFなしでは（または異なるPDFでさえ）役に立たないのですが、それでもリポジトリにそれらを入れることは間違っていると感じています。

バージョン管理システムには、配布用のアプリケーション（MSI、RPMなど）をビルド、コンパイル、テスト、およびパッケージ化するために必要なものがすべて含まれている必要があります。また、ビルド構成や他のスクリプトもバージョン管理する必要があると主張します。

プロジェクトをチェックアウトし、完全なコンパイル、ビルド、およびテスト環境を用意できるはずです。

テストデータをチェックインするには、2つの方法があります。最初に、テストデータ自体（この場合はPDF）をチェックインできます。次に、テストデータの生成に使用できるソースデータをチェックインできます（該当する場合）。これは、テストデータを含む空のデータベースにロードされたSQLスクリプト、またはPDFやその他のファイルにコンパイルできるテキストベースのファイルである可能性があります。

他のものはすべてをバージョン管理にチェックインすることに同意しないかもしれませんが、私はプロの経験で、完全な環境をゼロから再構築できるようにすることが重要であると感じました。

準備したセットアップファイルがないとテストが役に立たない場合は、VCSにテストコードとともにファイルを含めるのが理にかなっています。

テストで使用されるファイルはコードではありませんが、コードが依存する依存関係として表示できます。そのため、すべてをまとめておくことにはメリットがあります。

カウンターポイントとして、一部のVCSは大きなバイナリファイルを適切に処理できません。また、VCSにあらゆる種類のバイナリファイルを含めることに反対しているVCSもあります。これらのケースのいずれかが当てはまる場合は、簡単にアクセスできる既知の場所にテストファイルを保存するのも理にかなっています。

また、テストコードに「foo.pdfすべてのテストを実行するために依存している」というコメントを入れることも検討します。

静的データの場合は、バージョン管理に入れます。これらのファイルは、チェックインしても実際には変更されません。それらの機能が不要になった場合は削除されるか、新しいテストファイルが追加されます。いずれにせよ、スペースを占有するバイナリの差分の問題を心配する必要はありません。

たとえば、テストデータを生成している場合 ランダムに、テストが失敗したときに自動的に保存する必要がありますが、そうでなければ破棄します。この方法で保存されたデータは、通常の回帰テストに変換する必要があります。これにより、これらのエッジケースは、抽選の運に頼るのではなく、将来的に確実にテストされます。

そのデータをテストとメインアプリケーションコードに明確に含めます。非常によく整理されたテストスイートを用意するのに役立ちます-pdf抽出をテストしている場合（そして、そのコードがうまくカプセル化されている場合）、アプリコードへのパスに基づいて、テストデータへのパスを構築できるはずです-それはいつも私のために働いています。

gitを使用すると、.gitignoreを設定して、一時出力またはテストロギングがレポを汚染しないようにすることができます。