private static async Task RunAsync(this TargetCollection targets, List <string> names, Options options, Output output, Logger log, Func <Exception, bool> messageOnly, List <string> args)
{
if (options.UnknownOptions.Count > 0)
{
throw new InvalidUsageException($"Unknown option{(options.UnknownOptions.Count > 1 ? "s" : "")} {options.UnknownOptions.Spaced()}. \"--help\" for usage.");
}
await log.Verbose($"Args: {string.Join(" ", args)}").Tax();
if (options.ShowHelp)
{
await output.Usage(targets).Tax();
return;
}
if (options.ListTree || options.ListDependencies || options.ListInputs || options.ListTargets)
{
var rootTargets = names.Any() ? names : targets.Select(target => target.Name).OrderBy(name => name).ToList();
var maxDepth = options.ListTree ? int.MaxValue : options.ListDependencies ? 1 : 0;
var maxDepthToShowInputs = options.ListTree ? int.MaxValue : 0;
await output.Targets(targets, rootTargets, maxDepth, maxDepthToShowInputs, options.ListInputs).Tax();
return;
}
if (names.Count == 0)
{
names.Add("default");
}
await targets.RunAsync(names, options.SkipDependencies, options.DryRun, options.Parallel, log, messageOnly).Tax();
}
private string GetUsage(TargetCollection targets) =>
$@"{p.Default}Usage:{p.Reset} {p.CommandLine}<command-line>{p.Reset} {p.Option}[<options>]{p.Reset} {p.Target}[<targets>]{p.Reset}
{p.Default}command-line: The command line which invokes the build targets.{p.Reset}
{p.Default}Examples:{p.Reset}
{p.CommandLine}build.cmd{p.Reset}
{p.CommandLine}build.sh{p.Reset}
{p.CommandLine}dotnet run --project targets --{p.Reset}
{p.Default}options:{p.Reset}
{p.Option}-c{p.Default},{p.Reset} {p.Option}--clear{p.Reset} {p.Default}Clear the console before execution{p.Reset}
{p.Option}-n{p.Default},{p.Reset} {p.Option}--dry-run{p.Reset} {p.Default}Do a dry run without executing actions{p.Reset}
{p.Option}-d{p.Default},{p.Reset} {p.Option}--list-dependencies{p.Reset} {p.Default}List all (or specified) targets and dependencies, then exit{p.Reset}
{p.Option}-i{p.Default},{p.Reset} {p.Option}--list-inputs{p.Reset} {p.Default}List all (or specified) targets and inputs, then exit{p.Reset}
{p.Option}-l{p.Default},{p.Reset} {p.Option}--list-targets{p.Reset} {p.Default}List all (or specified) targets, then exit{p.Reset}
{p.Option}-t{p.Default},{p.Reset} {p.Option}--list-tree{p.Reset} {p.Default}List all (or specified) targets and dependency trees, then exit{p.Reset}
{p.Option}-N{p.Default},{p.Reset} {p.Option}--no-color{p.Reset} {p.Default}Disable colored output{p.Reset}
{p.Option}-E{p.Default},{p.Reset} {p.Option}--no-extended-chars{p.Reset} {p.Default}Disable extended characters{p.Reset}
{p.Option}-p{p.Default},{p.Reset} {p.Option}--parallel{p.Reset} {p.Default}Run targets in parallel{p.Reset}
{p.Option}-s{p.Default},{p.Reset} {p.Option}--skip-dependencies{p.Reset} {p.Default}Do not run targets' dependencies{p.Reset}
{p.Option}-v{p.Default},{p.Reset} {p.Option}--verbose{p.Reset} {p.Default}Enable verbose output{p.Reset}
{p.Option}--appveyor{p.Reset} {p.Default}Force Appveyor mode (normally auto-detected){p.Reset}
{p.Option}--azure-pipelines{p.Reset} {p.Default}Force Azure Pipelines mode (normally auto-detected){p.Reset}
{p.Option}--github-actions{p.Reset} {p.Default}Force GitHub Actions mode (normally auto-detected){p.Reset}
{p.Option}--gitlab-ci{p.Reset} {p.Default}Force GitLab CI mode (normally auto-detected){p.Reset}
{p.Option}--teamcity{p.Reset} {p.Default}Force TeamCity mode (normally auto-detected){p.Reset}
{p.Option}--travis{p.Reset} {p.Default}Force Travis CI mode (normally auto-detected){p.Reset}
{p.Option}-h{p.Default},{p.Reset} {p.Option}--help{p.Default},{p.Reset} {p.Option}-?{p.Reset} {p.Default}Show this help, then exit (case insensitive){p.Reset}
{p.Default}targets: A list of targets to run or list.{p.Reset}
{p.Default}If not specified, the {p.Target}""default""{p.Default} target will be run, or all targets will be listed.{p.Reset}
{p.Default}Remarks:{p.Reset}
{p.Default}The {p.Option}--list-xxx{p.Default} options can be combined.{p.Reset}
{p.Default}Examples:{p.Reset}
{p.CommandLine}build.cmd{p.Reset}
{p.CommandLine}build.cmd{p.Reset} {p.Option}-D{p.Reset}
{p.CommandLine}build.sh{p.Reset} {p.Option}-t{p.Reset} {p.Option}-I{p.Reset} {p.Target}default{p.Reset}
{p.CommandLine}build.sh{p.Reset} {p.Target}test{p.Reset} {p.Target}pack{p.Reset}
{p.CommandLine}dotnet run --project targets --{p.Reset} {p.Option}-n{p.Reset} {p.Target}build{p.Reset}
{p.Default}Targets:{p.Reset}
"
+ string.Join(
@"
",
targets.Select(target => $" {p.Target}{target.Name}{p.Reset}"))
+
@"
";
// editorconfig-checker-disable
private string GetUsage(TargetCollection targets) =>
$@"{p.Default}Usage:{p.Reset}
{p.Invocation}[invocation]{p.Reset} {p.Option}[options]{p.Reset} {p.Target}[<targets>...]{p.Reset}
{p.Default}Arguments:{p.Reset}
{p.Target}<targets>{p.Reset} {p.Default}A list of targets to run or list. If not specified, the {p.Target}""default""{p.Default} target will be run, or all targets will be listed.{p.Reset}
{p.Default}Options:{p.Reset}
{p.Option}-c{p.Default},{p.Reset} {p.Option}--clear{p.Reset} {p.Default}Clear the console before execution{p.Reset}
{p.Option}-n{p.Default},{p.Reset} {p.Option}--dry-run{p.Reset} {p.Default}Do a dry run without executing actions{p.Reset}
{p.Option}-d{p.Default},{p.Reset} {p.Option}--list-dependencies{p.Reset} {p.Default}List all (or specified) targets and dependencies, then exit{p.Reset}
{p.Option}-i{p.Default},{p.Reset} {p.Option}--list-inputs{p.Reset} {p.Default}List all (or specified) targets and inputs, then exit{p.Reset}
{p.Option}-l{p.Default},{p.Reset} {p.Option}--list-targets{p.Reset} {p.Default}List all (or specified) targets, then exit{p.Reset}
{p.Option}-t{p.Default},{p.Reset} {p.Option}--list-tree{p.Reset} {p.Default}List all (or specified) targets and dependency trees, then exit{p.Reset}
{p.Option}-N{p.Default},{p.Reset} {p.Option}--no-color{p.Reset} {p.Default}Disable colored output{p.Reset}
{p.Option}-E{p.Default},{p.Reset} {p.Option}--no-extended-chars{p.Reset} {p.Default}Disable extended characters{p.Reset}
{p.Option}-p{p.Default},{p.Reset} {p.Option}--parallel{p.Reset} {p.Default}Run targets in parallel{p.Reset}
{p.Option}-s{p.Default},{p.Reset} {p.Option}--skip-dependencies{p.Reset} {p.Default}Do not run targets' dependencies{p.Reset}
{p.Option}-v{p.Default},{p.Reset} {p.Option}--verbose{p.Reset} {p.Default}Enable verbose output{p.Reset}
{p.Option}--appveyor{p.Reset} {p.Default}Force Appveyor mode (normally auto-detected){p.Reset}
{p.Option}--azure-pipelines{p.Reset} {p.Default}Force Azure Pipelines mode (normally auto-detected){p.Reset}
{p.Option}--github-actions{p.Reset} {p.Default}Force GitHub Actions mode (normally auto-detected){p.Reset}
{p.Option}--gitlab-ci{p.Reset} {p.Default}Force GitLab CI mode (normally auto-detected){p.Reset}
{p.Option}--teamcity{p.Reset} {p.Default}Force TeamCity mode (normally auto-detected){p.Reset}
{p.Option}--travis{p.Reset} {p.Default}Force Travis CI mode (normally auto-detected){p.Reset}
{p.Option}-?{p.Default},{p.Reset} {p.Option}-h{p.Default},{p.Reset} {p.Option}--help{p.Reset} {p.Default}Show help and usage information, then exit (case insensitive){p.Reset}
{p.Default}Remarks:{p.Reset}
{p.Default}The {p.Option}--list-xxx{p.Default} options may be combined.{p.Reset}
{p.Default}The {p.Invocation}invocation{p.Reset} is typically a call to dotnet run, or the path to a script which wraps a call to dotnet run.
{p.Default}Examples:{p.Reset}
{p.Invocation}./build.{scriptExtension}{p.Reset}
{p.Invocation}./build.{scriptExtension}{p.Reset} {p.Option}-d{p.Reset}
{p.Invocation}./build.{scriptExtension}{p.Reset} {p.Option}-t{p.Reset} {p.Option}-i{p.Reset} {p.Target}default{p.Reset}
{p.Invocation}./build.{scriptExtension}{p.Reset} {p.Target}test{p.Reset} {p.Target}pack{p.Reset}
{p.Invocation}dotnet run --project targets --{p.Reset} {p.Option}-n{p.Reset} {p.Target}build{p.Reset}
{p.Default}Targets:{p.Reset}
"
+ List(targets, targets.Select(target => target.Name).ToList(), 0, 0, false, " ");
