[Groovy] Class FileNameCompleter

class FileNameCompleter
extends FileNameCompleter

A file name completer takes the buffer and issues a list of potential completions.

This completer tries to behave as similar as possible to bash's file name completion (using GNU readline) with the following exceptions:

Candidates that are directories will end with "File.separator"
Wildcard regular expressions are not evaluated or replaced
The "~" character can be used to represent the user's home directory. It cannot fully complete to other users' homes in all operating systems, since java does not provide any way of determining that easily, but it will attempt a simplistic approach.

Properties Summary

Properties
Type	Name and description
`boolean`	`escapeBackslash` If the filename will be placed inside a single/double quoted String we must escape backslash when on e.g.
`boolean`	`escapeSpaces` Set false if e.g. the filename will be inside a String.
`boolean`	`printSpaceAfterFullCompletion` True for say, a command-line arg, false for instance inside a String.

Constructors
Constructor and description
`FileNameCompleter (boolean printSpaceAfterFullCompletion, boolean escapeBackslash, boolean escapeSpaces)`

Methods
Type Params	Return Type	Name and description
	`int`	`complete(String buffer, int cursor, List<CharSequence> candidates)`
	`protected int`	`matchFiles(String buffer, String translated, File[] files, List<CharSequence> candidates)`

If the filename will be placed inside a single/double quoted String we must escape backslash when on e.g. Windows.

Set false if e.g. the filename will be inside a String. Should not be true if quoteFilenamesWithSpaces is true.

True for say, a command-line arg, false for instance inside a String.