marcelacarvalho / dotnet-commands

A tool that allows you to use .NET Core apps as .NET CLI Commands.

.NET Commands

A tool that allows you to use .NET Core apps as .NET CLI Commands.

This is a community project, free and open source. Everyone is invited to contribute, fork, share and use the code.

Installing

On Windows, run:

Powershell

&{$wc=New-Object System.Net.WebClient;$wc.Proxy=[System.Net.WebRequest]::DefaultWebProxy;$wc.Proxy.Credentials=[System.Net.CredentialCache]::DefaultNetworkCredentials;Invoke-Expression($wc.DownloadString('https://raw.githubusercontent.com/Lambda3/dotnet-commands/master/src/dotnet-commands/install.ps1'))}

CMD

@powershell -NoProfile -ExecutionPolicy unrestricted -Command "&{$wc=New-Object System.Net.WebClient;$wc.Proxy=[System.Net.WebRequest]::DefaultWebProxy;$wc.Proxy.Credentials=[System.Net.CredentialCache]::DefaultNetworkCredentials;Invoke-Expression($wc.DownloadString('https://raw.githubusercontent.com/Lambda3/dotnet-commands/master/src/dotnet-commands/install.ps1'))}"

On Linux, TBD.

Running

Simply run dotnet commands to see the options, which are similar to this:

DotNet Commands
  Usage:
    dotnet commands install <command> [--force] [--pre] [--verbose]
    dotnet commands uninstall <command> [ --verbose]
    dotnet commands update (<command> | all) [--pre] [--verbose]
    dotnet commands --help
    dotnet commands --version
  Options:
    --force                    Installs even if package was already installed. Optional.
    --pre                      Include pre-release versions. Optional.
    --verbose                  Verbose. Optional.
    --help -h                  Show this screen.
    --version -v               Show version.

You can try to install dotnet-foo, a library to try.

dotnet commands install dotnet-foo

And you can then use dotnet-foo like this:

dotnet foo

Writing commands

A more detailed explanation is comming. But the idea is simple, either create a Nuget which contains an executable (*.exe, *.ps1, or *.cmd) in the tools folder named dotnet-yourtool, or add a commandMetadata.json similar to the one in this project and add it to the content folder.

Status

We are still missing work on Linux and Mac, and only install works. PRs welcome.

Maintainers/Core team

• Giovanni Bassi, aka Giggio, Lambda3, @giovannibassi

Contributors can be found at the contributors page on Github.

Contact

Twitter is the best option.

License

This software is open source, licensed under the Apache License, Version 2.0. See LICENSE.txt for details. Check out the terms of the license before you contribute, fork, copy or do anything with the code. If you decide to contribute you agree to grant copyright of all your contribution to this project, and agree to mention clearly if do not agree to these terms. Your work will be licensed with the project at Apache V2, along the rest of the code.