Class BashCompletionGenerator<T>

java.lang.Object

com.github.rvesse.airline.help.common.AbstractUsageGenerator

com.github.rvesse.airline.help.common.AbstractGlobalUsageGenerator<T>

com.github.rvesse.airline.help.cli.bash.BashCompletionGenerator<T>

All Implemented Interfaces:

GlobalUsageGenerator<T>

public class BashCompletionGenerator<T>
extends AbstractGlobalUsageGenerator<T>

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	DOUBLE_NEWLINE
private static final char	NEWLINE
private final boolean	withDebugging

Fields inherited from class AbstractUsageGenerator

DEFAULT_COLUMNS

Constructor Summary

Constructors

Constructor	Description
BashCompletionGenerator()
BashCompletionGenerator(boolean includeHidden, boolean enableDebugging)	Creates a new completion generator

Method Summary

Modifier and Type	Method	Description
private String	bashize(String value)
private void	generateCommandCompletionFunction(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, CommandMetadata command)
private void	generateCommandFunctions(GlobalMetadata<T> global, Writer writer)
private void	generateGroupCompletionFunction(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group)
private void	generateGroupFunctions(GlobalMetadata<T> global, Writer writer)
protected BashCompletion	getCompletionData(ArgumentsMetadata arguments)	Gets the completion info for arguments
protected BashCompletion	getCompletionData(OptionMetadata option)	Gets the completion info for an option
protected BashCompletion	getCompletionData(Collection<Accessor> accessors)
private void	indent(Writer writer, int indent)
private void	repeat(Writer writer, int count, char c)
void	usage(GlobalMetadata<T> global, OutputStream output)	Generate the help and output it to the stream
private void	writeCommandCase(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, CommandMetadata command, int indent, boolean isNestedFunction)
private void	writeCommandFunctionCall(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, CommandMetadata command, int indent)
private void	writeCommandFunctionName(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, CommandMetadata command, boolean declare)
private void	writeCompletionGeneration(Writer writer, int indent, boolean isNestedFunction, BashCompletion completion, String... varNames)
private void	writeFunctionName(Writer writer, GlobalMetadata<T> global, boolean declare)
private void	writeGroupCase(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, int indent)
private void	writeGroupFunctionCall(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, int indent)
private void	writeGroupFunctionName(Writer writer, GlobalMetadata<T> global, CommandGroupMetadata group, boolean declare)
private void	writeHeader(Writer writer)
private void	writeHelperFunctions(Writer writer)
private void	writeWordListVariable(Writer writer, int indent, String varName, Iterator<String> words)

Methods inherited from class AbstractGlobalUsageGenerator

findHelpSections, sortCommandGroups, usage

Methods inherited from class AbstractUsageGenerator

getCommandComparator, getOptionComparator, htmlize, includeHidden, sortArgumentsRestrictions, sortCommands, sortOptionRestrictions, sortOptions, toDefaultCommand, toDescription, toDescription, toSynopsisUsage, toUsage, toUsage

Methods inherited from class Object

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

Field Details

NEWLINE

private static final char NEWLINE

See Also:

• Constant Field Values

DOUBLE_NEWLINE

private static final String DOUBLE_NEWLINE

See Also:

• Constant Field Values

withDebugging

private final boolean withDebugging

Constructor Details

BashCompletionGenerator

public BashCompletionGenerator()

BashCompletionGenerator

public BashCompletionGenerator(boolean includeHidden,
 boolean enableDebugging)

Creates a new completion generator

Parameters:

enableDebugging - Whether to enable debugging, when true the generated script will do set -o xtrace in its functions and set +o xtrace at the end of its functions

Method Details

usage

public void usage(GlobalMetadata<T> global,
 OutputStream output)
           throws IOException

Description copied from interface: GlobalUsageGenerator

Generate the help and output it to the stream

Parameters:

global - Global metadata

output - Stream to output to

Throws:

IOException - Thrown if there is a problem generating usage output

generateCommandFunctions

private void generateCommandFunctions(GlobalMetadata<T> global,
 Writer writer)
                               throws IOException

Throws:

IOException

generateGroupFunctions

private void generateGroupFunctions(GlobalMetadata<T> global,
 Writer writer)
                             throws IOException

Throws:

IOException

writeHeader

private void writeHeader(Writer writer)
                  throws IOException

Throws:

IOException

writeHelperFunctions

private void writeHelperFunctions(Writer writer)
                           throws IOException

Throws:

IOException

writeCommandCase

private void writeCommandCase(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 CommandMetadata command,
 int indent,
 boolean isNestedFunction)
                       throws IOException

Throws:

IOException

writeCommandFunctionCall

private void writeCommandFunctionCall(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 CommandMetadata command,
 int indent)
                               throws IOException

Throws:

IOException

writeGroupCase

private void writeGroupCase(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 int indent)
                     throws IOException

Throws:

IOException

writeGroupFunctionCall

private void writeGroupFunctionCall(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 int indent)
                             throws IOException

Throws:

IOException

generateGroupCompletionFunction

private void generateGroupCompletionFunction(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group)
                                      throws IOException

Throws:

IOException

generateCommandCompletionFunction

private void generateCommandCompletionFunction(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 CommandMetadata command)
                                        throws IOException

Throws:

IOException

indent

private void indent(Writer writer,
 int indent)
             throws IOException

Throws:

IOException

repeat

private void repeat(Writer writer,
 int count,
 char c)
             throws IOException

Throws:

IOException

writeWordListVariable

private void writeWordListVariable(Writer writer,
 int indent,
 String varName,
 Iterator<String> words)
                            throws IOException

Throws:

IOException

writeFunctionName

private void writeFunctionName(Writer writer,
 GlobalMetadata<T> global,
 boolean declare)
                        throws IOException

Throws:

IOException

writeGroupFunctionName

private void writeGroupFunctionName(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 boolean declare)
                             throws IOException

Throws:

IOException

writeCommandFunctionName

private void writeCommandFunctionName(Writer writer,
 GlobalMetadata<T> global,
 CommandGroupMetadata group,
 CommandMetadata command,
 boolean declare)
                               throws IOException

Throws:

IOException

writeCompletionGeneration

private void writeCompletionGeneration(Writer writer,
 int indent,
 boolean isNestedFunction,
 BashCompletion completion,
 String... varNames)
                                throws IOException

Throws:

IOException

bashize

private String bashize(String value)

getCompletionData

protected BashCompletion getCompletionData(OptionMetadata option)

Gets the completion info for an option

Parameters:

option - Option

Returns:

Completion data, null if none specified

getCompletionData

protected BashCompletion getCompletionData(ArgumentsMetadata arguments)

Gets the completion info for arguments

Parameters:

arguments - Arguments

Returns:

Completion data, null if none specified

getCompletionData

protected BashCompletion getCompletionData(Collection<Accessor> accessors)