adams.flow.source.DirectoryLister
Returns the contents of a directory (files/dirs).
Flow input/output:
- output: java.lang.String
The logging level for outputting errors and debugging output.
| command-line | -logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> | 
| default | WARNING | 
| min-user-mode | Expert | 
The name of the actor.
| command-line | -name <java.lang.String> | 
| default | DirectoryLister | 
The annotations to attach to this actor.
| command-line | -annotation <adams.core.base.BaseAnnotation> | 
| default |  | 
If set to true, transformation is skipped and the input token is just forwarded as it is.
| command-line | -skip <boolean> | 
| default | false | 
If set to true, the flow execution at this level gets stopped in case this actor encounters an error; the error gets propagated; useful for critical actors.
| command-line | -stop-flow-on-error <boolean> | 
| default | false | 
| min-user-mode | Expert | 
If enabled, then no errors are output in the console; Note: the enclosing actor handler must have this enabled as well.
| command-line | -silent <boolean> | 
| default | false | 
| min-user-mode | Expert | 
Whether to output the files as array or as single strings.
| command-line | -output-array <boolean> | 
| default | false | 
The directory to watch for files/directories.
| command-line | -dir <adams.core.io.PlaceholderDirectory> | 
| default | ${CWD} | 
Whether to include directories in the output.
| command-line | -list-dirs <boolean> | 
| default | false | 
Whether to include files in the output.
| command-line | -list-files <boolean> | 
| default | false | 
The maximum number of items (files/dirs) to return (<= 0 is unlimited).
| command-line | -max-items <int> | 
| default | -1 | 
The regular expression that the files/dirs must match (empty string matches all).
| command-line | -regexp <adams.core.base.BaseRegExp> | 
| default |  | 
| more | https://docs.oracle.com/javase/tutorial/essential/regex/ | 
| https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html | 
The type of sorting to perform.
| command-line | -sorting <NO_SORTING|SORT_BY_NAME|SORT_BY_LAST_MODIFIED> | 
| default | NO_SORTING | 
If set to true, the files are sorted in descending manner.
| command-line | -descending <boolean> | 
| default | false | 
Whether to search recursively or not.
| command-line | -recursive <boolean> | 
| default | false | 
The maximum depth to search in recursive mode (1 = only watch directory, -1 = infinite).
| command-line | -max-depth <int> | 
| default | -1 | 
The name of the file, that finishes the watching.
| command-line | -stop-file <java.lang.String> | 
| default | STOP.txt | 
The number of seconds to wait before polling the directory again if no elements were retrieved; a value of -1 indicates that polling happens only once.
| command-line | -wait <int> | 
| default | -1 | 
If set to true, then the waiting period is enforced between polls, even if there are files/dirs that could get processed.
| command-line | -always-wait <boolean> | 
| default | false | 
If set to true, locked files are skipped. Depends on the underlying OS how this is implemented. Under Linux, a JVM would have to lock the file explicitly via java.nio.channels.FileChannel.lock(). Simply opening it for writing does not lock the file.
| command-line | -skip-locked <boolean> | 
| default | false | 
The minimum file timestamp that the files can have.
| command-line | -min-timestamp <adams.core.base.BaseDateTime> | 
| default | -INF | 
The maximum file timestamp that the files can have.
| command-line | -max-timestamp <adams.core.base.BaseDateTime> | 
| default | +INF | 
If enabled, forward slashes are used in the output (but the '\\' prefix of UNC paths is not converted).
| command-line | -use-forward-slashes <boolean> | 
| default | false |