lip pkg view
以 JSON 顯示套件的套件檔和版本。
概要
text
lip pkg view <PACKAGE> [-h | --help]說明
<PACKAGE> 是一個套件參數，形式與 lip install 接受的相同：儲存庫（可以帶 #<variant> 和 @<ref>）、https:// URL，或本機的 ZIP 檔案或目錄。
lip pkg view 讀取該參數首先指名的套件，輸出它的套件檔和所在儲存庫的版本：
| 參數 | 顯示的套件 |
|---|---|
<repo> | 儲存庫在最高版本標籤處的內容。 |
<repo>@<version> | 儲存庫在標籤 v<version> 處的內容。 |
<repo>@branch:<name>、@tag:<name>、@rev:<commit> | 儲存庫在該提交處的內容。 |
| URL 或本機路徑 | 該歸檔本身。 |
無法取得該歸檔，或者它不是套件時，命令失敗。
lip v0.x 的 tooth.json 會顯示為 lip 針對執行端 server 和平臺 win-x64 從中讀出的套件檔。參見早期格式。
除了儲存下載內容的快取之外，lip pkg view 不變更任何東西。它不是工作區操作，也不需要伺服器。
選項
| 選項 | 說明 |
|---|---|
-h、--help | 輸出幫助並結束。 |
沒有 --json 選項：結果始終是 JSON。
輸出
結果寫到標準輸出：一個恰好包含下列成員的 JSON 物件，後跟一個換行。
json
{ "manifest": { ... }, "versions": ["<version>", ...] }| 成員 | 值 |
|---|---|
manifest | 該套件的套件檔 lip.toml，作為 JSON 物件，其中的模板已渲染。 |
versions | 對於儲存庫：它的版本標籤（名為 v 加 SemVer 版本的標籤）所對應的版本，不帶 v，從低到高，每個只出現一次。參數中的變體和引用不影響這個清單。對於 URL 或本機路徑：空陣列。 |
例如，對一個模組的目錄執行 lip pkg view ./MyMod：
json
{
"manifest": {
"format": 4,
"id": "github.com/user/MyMod",
"version": "1.0.0",
"variants": {
"": [
{
"side": "server",
"platform": "win-x64",
"deps": {
"github.com/LiteLDev/LeviLamina": ">=1.0.0 <2.0.0"
},
"assets": [
{
"type": "mcmod",
"urls": [
"https://github.com/user/MyMod/releases/download/v1.0.0/MyMod-server-win-x64.zip"
]
}
]
}
]
}
},
"versions": []
}結束狀態
| 結束代碼 | 含義 |
|---|---|
0 | 結果已輸出。 |
非 0 | 用法錯誤；參數無效；或無法取得歸檔，或者它不是套件。 |
示例
檢視一個套件的最新版本，並列出它的版本：
shell
lip pkg view github.com/LiteLDev/LeviLamina用 jq 只列出版本：
shell
lip pkg view github.com/LiteLDev/LeviLamina | jq -r '.versions[]'檢視指定版本，以及某個分支的最新提交：
shell
lip pkg view github.com/user/repo@1.0.0
lip pkg view github.com/user/repo@branch:main檢查 lip 能否讀取你正在編寫的 lip.toml：
shell
lip pkg view .