Module com.github.rvesse.airline

Package com.github.rvesse.airline

Class HelpOption<C>

java.lang.Object

com.github.rvesse.airline.HelpOption<C>

public class HelpOption<C>
extends java.lang.Object

An option that provides a simple way for the user to request help with a command

Field Summary

Fields

Modifier and Type	Field	Description
private CommandMetadata	commandMetadata
private GlobalMetadata<C>	globalMetadata
private CommandGroupMetadata	groupMetadata
java.lang.Boolean	help
private boolean	shown

Constructor Summary

Constructors

Constructor	Description
HelpOption()

Method Summary

Modifier and Type	Method	Description
void	showHelp()	Shows help using the default CliCommandUsageGenerator
void	showHelp(CommandUsageGenerator generator)	Shows help using the given usage generator
<T> boolean	showHelpIfErrors(ParseResult<T> result)	Shows help if any parsing errors were detected.
<T> boolean	showHelpIfErrors(ParseResult<T> result, boolean printErrors)	Shows help if any parsing errors were detected
<T> boolean	showHelpIfErrors(ParseResult<T> result, boolean printErrors, CommandUsageGenerator generator)	Shows help if any parsing errors were detected
boolean	showHelpIfRequested()	Shows help if user requested it and it hasn't already been shown using the default CliCommandUsageGenerator
boolean	showHelpIfRequested(CommandUsageGenerator generator)	Shows help if user requested it, and it hasn't already been shown
private static java.lang.String[]	toGroupNames(CommandGroupMetadata group)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

globalMetadata

@AirlineModule
private GlobalMetadata<C> globalMetadata

groupMetadata

@AirlineModule
private CommandGroupMetadata groupMetadata

commandMetadata

@AirlineModule
private CommandMetadata commandMetadata

help

@Option(name={"-h","--help"},
        description="Display help information")
public java.lang.Boolean help

shown

private boolean shown

Constructor Detail

HelpOption

public HelpOption()

Method Detail

showHelpIfRequested

public boolean showHelpIfRequested()

Shows help if user requested it and it hasn't already been shown using the default CliCommandUsageGenerator

Returns:

True if help was requested by the user

showHelpIfRequested

public boolean showHelpIfRequested(CommandUsageGenerator generator)

Shows help if user requested it, and it hasn't already been shown

Parameters:

generator - Usage generator

Returns:

True if help was requested by the user

showHelpIfErrors

public <T> boolean showHelpIfErrors(ParseResult<T> result)

Shows help if any parsing errors were detected. If errors were detected the error messages are printed prior to the help

Type Parameters:

T - Command type we were attempting to parse

Parameters:

result - Parsing result, if null then this method does nothing

Returns:

True if help was shown

showHelpIfErrors

public <T> boolean showHelpIfErrors(ParseResult<T> result,
                                    boolean printErrors)

Shows help if any parsing errors were detected

Type Parameters:

T - Command type we were attempting to parse

Parameters:

result - Parsing result, if null then this method does nothing

printErrors - Whether to print error messages prior to the help, set to false if your code has already done that

Returns:

True if help was shown

showHelpIfErrors

public <T> boolean showHelpIfErrors(ParseResult<T> result,
                                    boolean printErrors,
                                    CommandUsageGenerator generator)

Shows help if any parsing errors were detected

Type Parameters:

T - Command type we were attempting to parse

Parameters:

result - Parsing result, if null then this method does nothing

printErrors - Whether to print error messages prior to the help, set to false if your code has already done that

generator - Command generator for printing the help

Returns:

True if help was shown, false otherwise

showHelp

public void showHelp()

Shows help using the default CliCommandUsageGenerator

showHelp

public void showHelp(CommandUsageGenerator generator)

Shows help using the given usage generator

Parameters:

generator - Usage generator

toGroupNames

private static java.lang.String[] toGroupNames(CommandGroupMetadata group)