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>+

將一個或多個檔案提交到給定的伺服器。<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、身份驗證設定以及預設資料庫和測試套件設定。如果此檔案存在，其他 admin 命令會讀取此檔案。

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 將會自動解壓縮到暫時目錄中，並在退出時移除。這對於測試以及來回傳遞資料庫實例很有用，例如，當其他人只需要能夠檢視結果時。