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


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

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

Имя

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

Synopsis

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.

Arguments

  • search terms

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

Options

  • --configfile <FILE>

    Файл конфигурации NuGet (nuget.config), который будет использоваться. Если этот параметр указан, будут использоваться только параметры из этого файла. Если не указано, будет использоваться иерархия файлов конфигурации из текущего каталога. Дополнительные сведения см. в разделе Common NuGet Configurations.

  • --exact-match

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

  • --format

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

  • --interactive

    Позволяет команде остановить и ждать ввода или действия пользователя. Например, чтобы завершить проверку подлинности.

  • --prerelease

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

  • --skip

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

  • --source <SOURCE>

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

  • --take

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

  • -v|--verbosity <LEVEL>

    Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic]. Дополнительные сведения см. в разделе LoggerVerbosity.

  • -?|-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   |