Skip to content

nuget.exe, xplat, dotnet cli commands and options planning

Drew Gillies edited this page Sep 30, 2016 · 8 revisions

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)

Contributing

What's Being Worked On?

Check out the proposals in the accepted & proposed folders on the repository, and active PRs for proposals being discussed today.

Common Problems

Clone this wiki locally
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy