Ubuntu Manpages

dotnet-package-search

Searches for a NuGet package.

dotnet-package-search - Searches for a NuGet package.

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

The dotnet package search command searches for a NuGet package.

  • search terms

Specifies the search term to filter results. Use this argument to search for packages matching the provided query. Example: dotnet package search json.

  • --configfile

The NuGet configuration file. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see Common NuGet configurations.

  • --exact-match

This option narrows the search to only include packages whose IDs exactly match the specified search term, effectively filtering out any partial matches. It provides a concise list of all available versions for the identified package. Causes --take and --skip options to be ignored. Utilize this option to display all available versions of a specified package.

  • --format

The format options are table and json. The default is table.

  • --interactive

Allows the command to stop and wait for user input or action (for example to complete authentication).

  • --prerelease

Allow prerelease packages to be shown.

  • --skip

The number of results to skip, for pagination. The default value is 0.

  • --source <SOURCE>

The package source to search. You can pass multiple –source options to search multiple package sources.

  • --take

The number of results to return. The default value is 20.

  • --verbosity

Display this amount of details in the output: normal, minimal, or detailed. The default is normal.

  • -?|-h|--help

Prints out a description of how to use the command.

  • Search NuGet.org for packages that match the search term “Newtonsoft.Json,” and render the output as a table with up to 20 packages:
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     |
    |---------------------------------------------|----------------|--------|-----------------|
    ...
  • Search NuGet.org for packages that match the search term “Newtonsoft.Json,” and render the output as 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"
            }
        ]
        }
    ]
    }
  • Search NuGet.org for packages using the search term “Newtonsoft.Json,” show only two results, and skip the first packages in the search result:
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      |
  • Search for packages that exactly match “Newtonsoft.Json” and list all available versions of it, ignoring any packages that contain “Newtonsoft.Json” as a part of their name or description but don’t match it exactly:
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   |