dotnet-package-search - Searches for a NuGet package.
dotnet package search NAME SYNOPSIS DESCRIPTION ARGUMENTS OPTIONS EXAMPLESdotnet package search
This article applies to: ✔️ .NET 8.0.2xx SDK and later versions
NAME
dotnet-package-search - Searches for a NuGet package.
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
The dotnet package search command searches for a NuGet package.
ARGUMENTS
|
• |
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.
OPTIONS
|
• |
--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.
EXAMPLES
|
• |
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 |