lnt ツール¶
lnt コマンドラインユーティリティは、クライアントサイドとサーバーサイドで使用するための以下のコマンドを提供します。以下はコマンドと最も重要なオプションのリストです。特定のツールの詳細については、lnt <toolname> --help を使用してください。
クライアントサイドツール¶
lnt checkformat [<file>]LNTテストレポートファイルの構文をチェックします。LNTが生形式(JSONやプロパティリストなど)を読み取ることができることを確認するだけでなく、一時的なインメモリデータベースインスタンスを作成し、テストレポートファイルを正しくインポートできることを確認します。
引数なしで実行すると、
stdinから入力ファイルを読み取ろうとします。lnt convert <input path> [<output path>]LNTテストレポート形式間で変換します。デフォルトでは、プロパティリスト形式に変換します。入力(
stdinから読み取る場合)または出力(stdoutに書き込む場合)に-を使用できます。lnt importreport <input path> [<output path>]テキストベースのキーと値のペアをLNT JSONレポートファイルに変換します。
lnt submit <server url> <file>+指定されたサーバーに1つ以上のファイルを提出します。
<server url>は、サーバー上の実際のsubmitRunページのURLである必要があります。提出されるデータベースは、事実上このURLの一部です。lnt showtests利用可能なビルトインテストを一覧表示します。このツールの詳細については、テストプロデューサー のドキュメントを参照してください。
lnt runtest [<run options>] <test name> ... test arguments ...ビルトインテストを実行します。このツールの詳細については、テストプロデューサー のドキュメントを参照してください。
lnt check-no-errors <file>+レポートファイルの実行セクションに “no_errors”: true が含まれていることを確認します。そうでない場合は、リターンコード1で終了します。これは、ベンチマークのいずれかが正しくコンパイルまたは実行されなかった場合にエラーを報告する継続的インテグレーションスクリプトに役立ちます。
サーバー管理¶
lnt admin ツールを使用すると、LNTのREST APIを介してサーバーに接続し、データのクエリと変更を実行できます。データの変更は、lntadmin.cfg ファイルで指定された認証メカニズムを使用する場合にのみ可能です。詳細は、書き込み操作 を参照してください。
lnt admin create-config現在のディレクトリに lntadmin.cfg 設定ファイルを作成します。このファイルは、LNTサーバーのURL、認証設定、デフォルトのデータベースとテストスイートの設定を記述します。他の管理コマンドは、このファイルが存在する場合に読み取ります。
lnt admin list-machinesマシンとそのID番号を一覧表示します
lnt admin machine-info <machine>指定されたマシンの情報を表示します。
lnt admin get-machine <machine>マシン情報をダウンロードし、データをJSONファイルに保存します。
lnt admin rm-machine <machine>指定されたマシンと関連する実行とサンプルを削除します。
lnt admin rename-machine <machine> <new-name>指定されたマシンの名前を変更します。
lnt admin merge-machine-into <machine> <merge-into-machine>あるマシンから別のマシンにすべての実行を移動し、マシンを削除します。
lnt admin list-runs <machine>指定されたマシンのすべての実行を一覧表示します。
lnt admin get-run <run>+指定された実行をダウンロードします。
lnt admin post-run <filename>+指定されたレポートファイルを新しい実行としてサーバーに投稿します。
lnt admin rm-run <run>+指定された実行と関連するサンプルを削除します。
サーバーサイドツール¶
以下のツールは、LNTサーバーとの対話に使用されます
lnt create <path>新しいLNTサーバーインスタンスを作成します。このコマンドには、生成されたサーバーを調整するため多数のパラメータがありますが、すべてLNT設定ファイルで後から変更できます。
デフォルトのサーバーには、 *default* という名前のsqlite3データベースがあります。
--db-dir postgresql://user@hostnameを使用してPostgreSQLを使用するように指定できます。lnt import <instance path> <file>+LNTデータファイルをデータベースにインポートします。
--databaseを使用して、書き込むデータベースを選択できます。デフォルトでは、設定で有効になっている場合、レポートメールも生成されます。これを無効にするには、--no-emailを使用できます。lnt runserver <instance path>開発WSGIサーバーを使用してLNTサーバーを起動します。追加のオプションを使用して、サーバーのホストとポート、および自動リロードなどの便利な開発機能を制御できます。
lnt updatedb --database <NAME> --testsuite <NAME> <instance path>指定されたデータベースとテストスイートを変更します。
現在サポートされているコマンドは、
--delete-machineと--delete-runのみです。
インスタンスパスを受け取るすべてのコマンドは、lnt.cfg ファイルへのパス、インスタンスディレクトリへのパス、または(圧縮された)tarballへのパスのいずれかを渡すことをサポートしています。tarballは自動的に一時ディレクトリに解凍され、終了時に削除されます。これは、テストやデータベースインスタンスのやり取りに役立ちます。たとえば、他のユーザーが結果を表示できるだけでよい場合などです。