script-launcher/README.md

1.9 KiB

Script Launcher

Find executable scripts in a directory and allow to select which one to execute.

Installation

As .NET CLI Tool

To be installed as a tool, you need the .NET CLI which is included in the .NET SDK

Install manually using the following commands or by using the provided installation scripts.

dotnet pack ./src -o ./nupkg
dotnet tool install -g ScriptLauncher --add-source ./nupkg --ignore-failed-sources

As a Standalone Executable

You will need the identifier of the .NET Runtime (RID) and the Target Framework Moniker (TFM) for your OS and Runtime.

# self contained: will not need the .NET runtime to function, bigger resulting size
dotnet publish -c Release --self-contained -p:PublishSingleFile=true -p:PublishTrimmed=true -f <TFM> -r <RID> -o <output-directory> ./src

# no self contained: will need the .NET runtime to be installed to function, smallest size
dotnet publish -c Release --no-self-contained -p:PublishSingleFile=true -r <RID> -o <output-directory> ./src

NOTE: The option -p:PublishTrimmed=true may produce some warnings. If so simply skip that option and the resulting executable will be larger

Usage

USAGE:
    scrl <path> [OPTIONS]

ARGUMENTS:
    <path>    Starting directory (Default: .)

OPTIONS:
    -h, --help          Prints help information
    -x, --extensions    Comma separated list of script extensions
    -d, --depth         Search depth
    -e, --elevated      Run with elevated privileges
    -g, --group         Group scripts by folder
    -b, --brief         Show brief information