pesquisa de pacotes dotnet

Artigo
03/22/2024

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

Nome

dotnet package search - Procura 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

Descrição

O dotnet package search comando procura um pacote NuGet.

Argumentos

search terms

Especifica o termo de pesquisa para filtrar os 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 esse arquivo for especificado, serão usadas somente as configurações dele. Se ele não for especificado, será usada a hierarquia de arquivos de configuração do diretório atual. Para obter mais informações, confira Configurações Comuns do NuGet.
--exact-match

Essa opção restringe a pesquisa para incluir apenas pacotes cujos IDs correspondam 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 essa 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. O padrão é table.
--interactive

Permite que o comando pare e aguarde a entrada ou uma 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 serem ignorados, para paginação. O valor padrão é 0.
--source <SOURCE>

A origem do pacote a ser pesquisada. Você pode passar várias opções --source para pesquisar vários códigos-fonte de pacotes.
--take

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

Exiba essa quantidade de detalhes na saída: normal, minimalou detailed. O padrã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"
            }
        ]
        }
    ]
    }

Pesquisar NuGet.org pacotes usando o termo de pesquisa "Newtonsoft.Json", mostrar apenas dois resultados e ignorar 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   |

Compartilhar via