pesquisa de pacotes dotnet

Artigo
03/24/2024

Este artigo aplica-se a: ✔️ SDK do .NET 8.0.2xx e versões posteriores

Nome

dotnet package search - Procura por um pacote NuGet.

Sinopse

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

O dotnet package search comando procura um pacote NuGet.

Argumentos

search terms

Especifica o termo de pesquisa para filtrar resultados. Use esse argumento para procurar pacotes que correspondam à consulta fornecida. Exemplo: dotnet package search json.

Opções

--configfile

O arquivo de configuração do NuGet. Se especificado, somente as configurações desse arquivo serão usadas. Se não for especificado, a hierarquia de arquivos de configuração do diretório atual será usada. Para obter mais informações, consulte Configurações comuns do NuGet.
--exact-match

Esta opção restringe a pesquisa para incluir apenas pacotes cujos IDs correspondem exatamente ao termo de pesquisa especificado, filtrando efetivamente quaisquer correspondências parciais. Ele fornece uma lista concisa de todas as versões disponíveis para o pacote identificado. Causas --take e --skip opções a serem ignoradas. Utilize esta opção para exibir todas as versões disponíveis de um pacote especificado.
--format

As opções de formato são table e json. A predefinição é table.
--interactive

Permite que o comando pare e aguarde a entrada ou ação do usuário (por exemplo, para concluir a autenticação).
--prerelease

Permitir que pacotes de pré-lançamento sejam mostrados.
--skip

O número de resultados a ignorar, para paginação. O valor predefinido é 0.
--source <SOURCE>

A fonte do pacote a ser pesquisada. Você pode passar várias opções --source para pesquisar várias fontes de pacote.
--take

O número de resultados a retornar. O valor padrão é 20.
--verbosity

Exiba essa quantidade de detalhes na saída: normal, minimal, ou detailed. A predefinição é normal.

-?|-h|--help

Imprime uma descrição de como usar o comando.

Exemplos

Pesquise NuGet.org pacotes que correspondam ao termo de pesquisa "Newtonsoft.Json" e renderize a saída como uma tabela com até 20 pacotes:

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

Pesquise NuGet.org pacotes que correspondam ao termo de pesquisa "Newtonsoft.Json" e renderize a saída como 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"
            }
        ]
        }
    ]
    }

Os NuGet.org de pesquisa para pacotes usando o termo de pesquisa "Newtonsoft.Json", mostram apenas dois resultados e ignoram os primeiros pacotes no resultado da pesquisa:

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      |

Procure pacotes que correspondam exatamente a "Newtonsoft.Json" e liste todas as versões disponíveis dele, ignorando quaisquer pacotes que contenham "Newtonsoft.Json" como parte de seu nome ou descrição, mas não correspondam exatamente:

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   |

Partilhar via