CommandLine.RunFirst

java.lang.Object
- org.apache.logging.log4j.core.tools.picocli.CommandLine.RunFirst

All Implemented Interfaces:

CommandLine.IParseResultHandler

Enclosing class:

CommandLine
```
public static class CommandLine.RunFirst
extends java.lang.Object
implements CommandLine.IParseResultHandler
```
Command line parse result handler that prints help if requested, and otherwise executes the top-level Runnable or Callable command. For use in the parseWithHandler methods.
From picocli v2.0, RunFirst is used to implement the run and call convenience methods.

Since:

2.0

Constructor Summary

Constructors
Constructor Description

RunFirst()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`java.util.List<java.lang.Object>`	`handleParseResult(java.util.List<CommandLine> parsedCommands, java.io.PrintStream out, CommandLine.Help.Ansi ansi)`	Prints help if requested, and otherwise executes the top-level `Runnable` or `Callable` command.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RunFirst
```
public RunFirst()
```
- Method Detail
  - handleParseResult
```
public java.util.List<java.lang.Object> handleParseResult(java.util.List<CommandLine> parsedCommands,
                                                          java.io.PrintStream out,
                                                          CommandLine.Help.Ansi ansi)
```
    Prints help if requested, and otherwise executes the top-level Runnable or Callable command. If the top-level command does not implement either Runnable or Callable, a ExecutionException is thrown detailing the problem and capturing the offending CommandLine object.
    
    Specified by:
    
    handleParseResult in interface CommandLine.IParseResultHandler
    
    Parameters:
    
    parsedCommands - the CommandLine objects that resulted from successfully parsing the command line arguments
    
    out - the PrintStream to print help to if requested
    
    ansi - for printing help messages using ANSI styles and colors
    
    Returns:
    
    an empty list if help was requested, or a list containing a single element: the result of calling the Callable, or a null element if the top-level command was a Runnable
    
    Throws:
    
    CommandLine.ExecutionException - if a problem occurred while processing the parse results; use CommandLine.ExecutionException.getCommandLine() to get the command or subcommand where processing failed