Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.
Sign upnuget.exe, xplat, dotnet cli commands and options planning
Problem
Inconsitent options across commands in NuGet.exe, the XPlat DLL and dotnet CLI.
Solution
(under discussion)
Commands and options
Delete
NuGet.exe delete
-
-Source
-
-NoPrompt
same as non-interactive--check this
-
-ApiKey
-
-Help
-
-Verbosity
-
-NonInteractive
-
-ConfigFile
-
-ForceEnglishOutput
NuGet.CommandLine.XPlat.dll delete
-
-s/--source
-
--non-interactive
add abbreviated option
-
-k/--api-key
-
--help
-
--force-english-output
remove this from our commands for consistency in dotnet CLI
-
--config-file
support this
-
(verbosity is covered via dotnet cli)
dotnet nuget delete
- As per NuGet.CommandLine.XPlat.dll delete
Pack
NuGet.exe pack
-
-OutputDirectory
-
-BasePath
-
-Version
-
-Suffix
-
-Exclude +
-
-Symbols
-
-Tool
-
-Build
-
-NoDefaultExcludes
-
-NoPackageAnalysis
-
-ExcludeEmptyDirectories
-
-IncludeReferencedProjects
going away - no need to propagate to xplat
-
-Properties +
-
-MinClientVersion
-
-MSBuildVersion
only a nuget.exe scenario
-
-Help
-
-Verbosity
-
-NonInteractive
redundant--don't propagate to xplat
-
-ForceEnglishOutput
NuGet.CommandLine.XPlat.dll pack
-
-b/--base-path
-
--build
-
--exclude
-
-e/--exclude-empty-directories
-
--min-client-version
-
--no-default-excludes
-
--no-package-analysis
-
-o/--output-directory
-
-p/--properties
-
--serviceable
move this to metadata
-
--suffix
-
-s/-symbols
-
--verbosity
(verbosity is also covered via dotnet cli--check this)
verbosity is special in pack and restore. We need to standardize.
-
-v/--version
-
--help
-
--force-english-output
remove this from our commands for consistency in dotnet CLI
-
--tool
more design work to do
-
--analyzers
add?
dotnet pack
-
-o/--output
-
--no-build
if build is customized, we don't want to mess with it
-
--build-base-path
don't use this
-
-c/--configuration
follow CLI's call on this
-
--version-suffix
change to --suffix
-
-s/--serviceable
move to metadata
Push
NuGet.exe push
- -Source
- -ApiKey
- -Timeout
- -DisableBuffering
- -NoSymbols
- -Help
- -Verbosity
- -NonInteractive
- -ConfigFile
- -ForceEnglishOutput
NuGet.CommandLine.XPlat.dll push
-
-s/--source
-
-ss/--symbols-source
remove -ss
-
-t/--timeout
-
-k/--api-key
-
-sk/--symbol-api-key
remove -sk
-
-d/--disable-buffering
-
-n/--no-symbols
-
--help
-
--force-english-output
-
--config-file
need to support this
we may need to light up credential providers and --non-interactive here
-
(verbosity is covered via dotnet cli)
dotnet push
- As per NuGet.CommandLine.XPlat.dll push
Restore
NuGet.exe restore
-
-RequireConsent
research: let's make this less troublesome
-
-Project2ProjectTimeOut
less relevant now. Don't propagate to xplat.
-
-PackagesDirectory
-
-SolutionDirectory
-
-MSBuildVersion
-
-Source +
-
-FallbackSource +
-
-NoCache
-
-DisableParallelProcessing
-
-PackageSaveMode
more design work, may need to move to xplat when done
-
-Help
-
-Verbosity
-
-NonInteractive
move to xplat
-
-ConfigFile
-
-ForceEnglishOutput
NuGet.CommandLine.XPlat.dll restore
-
-s/--source
-
--packages
-
--disable-parallel
-
-f/-fallbacksource
-
--configfile
-
--no-cache
-
--infer-runtimes
going away
-
--ignore-failed-sources
-
--legacy-packages-directory
-
--help
-
--force-english-output
remove this from our commands for consistency in dotnet CLI
-
--non-interactive
add here
-
(verbosity is covered via dotnet cli)