Поиск пакетов dotnet

Мақала
03/24/2024

Эта статья относится к пакету ✔️ SDK для .NET 8.0.2xx и более поздних версий.

Имя.

dotnet package search — выполняет поиск пакета NuGet.

Краткие сведения

dotnet package search <SEARCH TERM> [--configfile <FILE>] [--exact-match] [--format <FORMAT OPTION>]
    [--interactive] [--prerelease] [--skip <NUMBER>] [--source <SOURCE>] [--take <NUMBER>]
    [--verbosity <VERBOSITY VALUE>]

dotnet package search -h|--help

Description

Команда dotnet package search ищет пакет NuGet.

Аргументы

search terms

Задает условие поиска для фильтрации результатов. Используйте этот аргумент для поиска пакетов, соответствующих предоставленному запросу. Пример: dotnet package search json.

Параметры

--configfile

Файл конфигурации NuGet. Если этот параметр указан, будут использоваться только параметры из этого файла. Если не указано, будет использоваться иерархия файлов конфигурации из текущего каталога. Дополнительные сведения см. в статье Распространенные конфигурации NuGet.
--exact-match

Этот параметр сужает поиск только для включения пакетов, идентификаторы которых точно соответствуют указанному термину поиска, эффективно отфильтровывая любые частичные совпадения. Он содержит краткий список всех доступных версий для определенного пакета. Причины --take и --skip параметры пропускаются. Используйте этот параметр для отображения всех доступных версий указанного пакета.
--format

Параметры формата и tablejson. Значение по умолчанию — table.
--interactive

Позволяет остановить команду и дождаться, пока пользователь введет данные или выполнит действие (например, завершит проверку подлинности).
--prerelease

Разрешить отображать предварительные пакеты.
--skip

Количество пропущенных результатов для разбиения на страницы. Значение по умолчанию равно 0.
--source <SOURCE>

Источник пакета для поиска. Можно передать несколько вариантов --source для поиска нескольких источников пакетов.
--take

Количество возвращаемых результатов. Значение по умолчанию — 20.
--verbosity

Отображение этого количества сведений в выходных данных: normalили minimaldetailed. Значение по умолчанию — normal.

-?|-h|--help

Выводит описание использования команды.

Примеры

Выполните поиск NuGet.org для пакетов, соответствующих термину поиска Newtonsoft.Json, и отрисуйте выходные данные в виде таблицы с до 20 пакетов:

dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json

    Source: https://api.nuget.org/v3/index.json
    | Package ID                                  | Latest Version | Owners | Downloads       |
    |---------------------------------------------|----------------|--------|-----------------|
    | Newtonsoft.Json                             | 13.0.3         |        | 3,829,822,911   |
    |---------------------------------------------|----------------|--------|-----------------|
    | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
    |---------------------------------------------|----------------|--------|-----------------|
    | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
    |---------------------------------------------|----------------|--------|-----------------|
    | Microsoft.AspNetCore.Mvc.NewtonsoftJson     | 7.0.12         |        | 317,067,823     |
    |---------------------------------------------|----------------|--------|-----------------|
    ...

Выполните поиск NuGet.org пакетов, соответствующих поисковому термину Newtonsoft.Json, и отрисуйте выходные данные в формате json.

dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --format json

    {
    "version": 2,
    "problems": [],
    "searchResult": [
        {
        "sourceName": "https://api.nuget.org/v3/index.json",
        "packages": [
            {
            "id": "Newtonsoft.Json",
            "latestVersion": "13.0.3",
            "totalDownloads": 4456137550,
            "owners": "dotnetfoundation, jamesnk, newtonsoft"
            },
            {
            "id": "Newtonsoft.Json.Bson",
            "latestVersion": "1.0.2",
            "totalDownloads": 655362732,
            "owners": "dotnetfoundation, jamesnk, newtonsoft"
            },
            {
            "id": "Newtonsoft.Json.Schema",
            "latestVersion": "3.0.15",
            "totalDownloads": 46062119,
            "owners": "jamesnk, newtonsoft"
            },
            {
            "id": "Microsoft.AspNetCore.Mvc.NewtonsoftJson",
            "latestVersion": "8.0.3",
            "totalDownloads": 372202749,
            "owners": "aspnet, dotnetframework, Microsoft"
            },
            {
            "id": "Newtonsoft.Json.Encryption",
            "latestVersion": "2.2.0",
            "totalDownloads": 113101,
            "owners": "simoncropp"
            }
        ]
        }
    ]
    }

Поиск NuGet.org для пакетов с помощью поискового термина Newtonsoft.Json отображает только два результата и пропускает первые пакеты в результатах поиска:

dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --skip 1 --take 2

    Source: https://api.nuget.org/v3/index.json
    | Package ID                                  | Latest Version | Owners | Downloads       |
    |---------------------------------------------|----------------|--------|-----------------|
    | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
    | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |

Найдите пакеты, которые точно соответствуют "Newtonsoft.Json" и перечисляют все доступные версии, игнорируя все пакеты, содержащие "Newtonsoft.Json" в составе их имени или описания, но не совпадают именно с ним:

dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --exact-match

    Source: https://api.nuget.org/v3/index.json
    | Package ID                                  | Version | Owners | Downloads       |
    |---------------------------------------------|---------|--------|-----------------|
    | Newtonsoft.Json                             | 13.0.3  |        | 3,829,822,911   |

Бөлісу құралы: