/*
* Copyright 2014 Red Hat, Inc.
*
* Red Hat licenses this file to you under the Apache License, version 2.0
* (the "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package io.vertx.reactivex.core.cli;
import io.vertx.reactivex.RxHelper;
import io.vertx.reactivex.ObservableHelper;
import io.vertx.reactivex.FlowableHelper;
import io.vertx.reactivex.impl.AsyncResultMaybe;
import io.vertx.reactivex.impl.AsyncResultSingle;
import io.vertx.reactivex.impl.AsyncResultCompletable;
import io.vertx.reactivex.WriteStreamObserver;
import io.vertx.reactivex.WriteStreamSubscriber;
import java.util.Map;
import java.util.Set;
import java.util.List;
import java.util.Iterator;
import java.util.function.Function;
import java.util.stream.Collectors;
import io.vertx.core.Handler;
import io.vertx.core.AsyncResult;
import io.vertx.core.json.JsonObject;
import io.vertx.core.json.JsonArray;
import io.vertx.lang.rx.RxGen;
import io.vertx.lang.rx.TypeArg;
import io.vertx.lang.rx.MappingIterator;
Interface defining a command-line interface (in other words a command such as 'run', 'ls'...).
This interface is polyglot to ease reuse such as in Vert.x Shell.
A command line interface has a name, and defines a set of options and arguments. Options are key-value pair such
as -foo=bar
or -flag
. The supported formats depend on the used parser. Arguments are unlike options raw values. Options are defined using Option
, while argument are defined using Argument
.
Command line interfaces also define a summary and a description. These attributes are used in the usage generation
. To disable the help generation, set the hidden
attribute to true
.
Command Line Interface object does not contains "value", it's a model. It must be evaluated by a parser that returns a CommandLine
object containing the argument and option values. NOTE: This class has been automatically generated from the original
non RX-ified interface using Vert.x codegen. /**
* Interface defining a command-line interface (in other words a command such as 'run', 'ls'...).
* This interface is polyglot to ease reuse such as in Vert.x Shell.
* <p/>
* A command line interface has a name, and defines a set of options and arguments. Options are key-value pair such
* as <code>-foo=bar</code> or <code>-flag</code>. The supported formats depend on the used parser. Arguments are unlike
* options raw values. Options are defined using
* {@link io.vertx.core.cli.Option}, while argument are defined using {@link io.vertx.core.cli.Argument}.
* <p/>
* Command line interfaces also define a summary and a description. These attributes are used in the usage generation
* . To disable the help generation, set the <code>hidden</code> attribute to <code>true</code>.
* <p/>
* Command Line Interface object does not contains "value", it's a model. It must be evaluated by a
* parser that returns a {@link io.vertx.reactivex.core.cli.CommandLine} object containing the argument and option values.
*
* <p/>
* NOTE: This class has been automatically generated from the {@link io.vertx.core.cli.CLI original} non RX-ified interface using Vert.x codegen.
*/
@RxGen(io.vertx.core.cli.CLI.class)
public class CLI {
@Override
public String toString() {
return delegate.toString();
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
CLI that = (CLI) o;
return delegate.equals(that.delegate);
}
@Override
public int hashCode() {
return delegate.hashCode();
}
public static final TypeArg<CLI> __TYPE_ARG = new TypeArg<>( obj -> new CLI((io.vertx.core.cli.CLI) obj),
CLI::getDelegate
);
private final io.vertx.core.cli.CLI delegate;
public CLI(io.vertx.core.cli.CLI delegate) {
this.delegate = delegate;
}
public CLI(Object delegate) {
this.delegate = (io.vertx.core.cli.CLI)delegate;
}
public io.vertx.core.cli.CLI getDelegate() {
return delegate;
}
Creates an instance of CLI
using the default implementation. Params: - name – the name of the CLI (must not be
null
)
Returns: the created instance of CLI
/**
* Creates an instance of {@link io.vertx.reactivex.core.cli.CLI} using the default implementation.
* @param name the name of the CLI (must not be <code>null</code>)
* @return the created instance of {@link io.vertx.reactivex.core.cli.CLI}
*/
public static io.vertx.reactivex.core.cli.CLI create(String name) {
io.vertx.reactivex.core.cli.CLI ret = io.vertx.reactivex.core.cli.CLI.newInstance((io.vertx.core.cli.CLI)io.vertx.core.cli.CLI.create(name));
return ret;
}
Parses the user command line interface and create a new CommandLine
containing extracting values. Params: - arguments – the arguments
Returns: the creates command line
/**
* Parses the user command line interface and create a new {@link io.vertx.reactivex.core.cli.CommandLine} containing extracting values.
* @param arguments the arguments
* @return the creates command line
*/
public io.vertx.reactivex.core.cli.CommandLine parse(List<String> arguments) {
io.vertx.reactivex.core.cli.CommandLine ret = io.vertx.reactivex.core.cli.CommandLine.newInstance((io.vertx.core.cli.CommandLine)delegate.parse(arguments));
return ret;
}
Parses the user command line interface and create a new CommandLine
containing extracting values. Params: - arguments – the arguments
- validate – enable / disable parsing validation
Returns: the creates command line
/**
* Parses the user command line interface and create a new {@link io.vertx.reactivex.core.cli.CommandLine} containing extracting values.
* @param arguments the arguments
* @param validate enable / disable parsing validation
* @return the creates command line
*/
public io.vertx.reactivex.core.cli.CommandLine parse(List<String> arguments, boolean validate) {
io.vertx.reactivex.core.cli.CommandLine ret = io.vertx.reactivex.core.cli.CommandLine.newInstance((io.vertx.core.cli.CommandLine)delegate.parse(arguments, validate));
return ret;
}
Returns: the CLI name.
/**
* @return the CLI name.
*/
public String getName() {
String ret = delegate.getName();
return ret;
}
Sets the name of the CLI.
Params: - name – the name
Returns: the current CLI
instance
/**
* Sets the name of the CLI.
* @param name the name
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI setName(String name) {
delegate.setName(name);
return this;
}
Returns: the CLI description.
/**
* @return the CLI description.
*/
public String getDescription() {
String ret = delegate.getDescription();
return ret;
}
public io.vertx.reactivex.core.cli.CLI setDescription(String desc) {
delegate.setDescription(desc);
return this;
}
Returns: the CLI summary.
/**
* @return the CLI summary.
*/
public String getSummary() {
String ret = delegate.getSummary();
return ret;
}
Sets the summary of the CLI.
Params: - summary – the summary
Returns: the current CLI
instance
/**
* Sets the summary of the CLI.
* @param summary the summary
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI setSummary(String summary) {
delegate.setSummary(summary);
return this;
}
Checks whether or not the current CLI
instance is hidden. Returns: true
if the current CLI
is hidden, otherwise
/**
* Checks whether or not the current {@link io.vertx.reactivex.core.cli.CLI} instance is hidden.
* @return <code>true</code> if the current {@link io.vertx.reactivex.core.cli.CLI} is hidden, otherwise
*/
public boolean isHidden() {
boolean ret = delegate.isHidden();
return ret;
}
Sets whether or not the current instance of CLI
must be hidden. Hidden CLI are not listed when displaying usages / help messages. In other words, hidden commands are for power user. Params: - hidden – enables or disables the hidden aspect of the CI
Returns: the current CLI
instance
/**
* Sets whether or not the current instance of {@link io.vertx.reactivex.core.cli.CLI} must be hidden. Hidden CLI are not listed when
* displaying usages / help messages. In other words, hidden commands are for power user.
* @param hidden enables or disables the hidden aspect of the CI
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI setHidden(boolean hidden) {
delegate.setHidden(hidden);
return this;
}
Gets the list of options.
Returns: the list of options, empty if none.
/**
* Gets the list of options.
* @return the list of options, empty if none.
*/
public List<io.vertx.core.cli.Option> getOptions() {
List<io.vertx.core.cli.Option> ret = delegate.getOptions();
return ret;
}
Adds an option.
Params: - option – the option, must not be
null
.
Returns: the current CLI
instance
/**
* Adds an option.
* @param option the option, must not be <code>null</code>.
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI addOption(io.vertx.core.cli.Option option) {
delegate.addOption(option);
return this;
}
Adds a set of options. Unlike setOptions
}, this method does not remove the existing options. The given list is appended to the existing list. Params: - options – the options, must not be
null
Returns: the current CLI
instance
/**
* Adds a set of options. Unlike {@link io.vertx.reactivex.core.cli.CLI#setOptions}}, this method does not remove the existing options.
* The given list is appended to the existing list.
* @param options the options, must not be <code>null</code>
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI addOptions(List<io.vertx.core.cli.Option> options) {
delegate.addOptions(options);
return this;
}
Sets the list of arguments.
Params: - options – the list of options, must not be
null
Returns: the current CLI
instance
/**
* Sets the list of arguments.
* @param options the list of options, must not be <code>null</code>
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI setOptions(List<io.vertx.core.cli.Option> options) {
delegate.setOptions(options);
return this;
}
Gets the list of defined arguments.
Returns: the list of argument, empty if none.
/**
* Gets the list of defined arguments.
* @return the list of argument, empty if none.
*/
public List<io.vertx.core.cli.Argument> getArguments() {
List<io.vertx.core.cli.Argument> ret = delegate.getArguments();
return ret;
}
Adds an argument.
Params: - arg – the argument, must not be
null
Returns: the current CLI
instance
/**
* Adds an argument.
* @param arg the argument, must not be <code>null</code>
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI addArgument(io.vertx.core.cli.Argument arg) {
delegate.addArgument(arg);
return this;
}
Adds a set of arguments. Unlike setArguments
, this method does not remove the existing arguments. The given list is appended to the existing list. Params: - args – the arguments, must not be
null
Returns: the current CLI
instance
/**
* Adds a set of arguments. Unlike {@link io.vertx.reactivex.core.cli.CLI#setArguments}, this method does not remove the existing arguments.
* The given list is appended to the existing list.
* @param args the arguments, must not be <code>null</code>
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI addArguments(List<io.vertx.core.cli.Argument> args) {
delegate.addArguments(args);
return this;
}
Sets the list of arguments.
Params: - args – the list of arguments, must not be
null
Returns: the current CLI
instance
/**
* Sets the list of arguments.
* @param args the list of arguments, must not be <code>null</code>
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI setArguments(List<io.vertx.core.cli.Argument> args) {
delegate.setArguments(args);
return this;
}
Gets an Option
based on its name (short name, long name or argument name). Params: - name – the name, must not be
null
Returns: the Option
, null
if not found
/**
* Gets an {@link io.vertx.core.cli.Option} based on its name (short name, long name or argument name).
* @param name the name, must not be <code>null</code>
* @return the {@link io.vertx.core.cli.Option}, <code>null</code> if not found
*/
public io.vertx.core.cli.Option getOption(String name) {
io.vertx.core.cli.Option ret = delegate.getOption(name);
return ret;
}
Gets an Argument
based on its name (argument name). Params: - name – the name of the argument, must not be
null
Returns: the Argument
, null
if not found.
/**
* Gets an {@link io.vertx.core.cli.Argument} based on its name (argument name).
* @param name the name of the argument, must not be <code>null</code>
* @return the {@link io.vertx.core.cli.Argument}, <code>null</code> if not found.
*/
public io.vertx.core.cli.Argument getArgument(String name) {
io.vertx.core.cli.Argument ret = delegate.getArgument(name);
return ret;
}
Gets an Argument
based on its index. Params: - index – the index, must be positive or zero.
Returns: the Argument
, null
if not found.
/**
* Gets an {@link io.vertx.core.cli.Argument} based on its index.
* @param index the index, must be positive or zero.
* @return the {@link io.vertx.core.cli.Argument}, <code>null</code> if not found.
*/
public io.vertx.core.cli.Argument getArgument(int index) {
io.vertx.core.cli.Argument ret = delegate.getArgument(index);
return ret;
}
Removes an option identified by its name. This method does nothing if the option cannot be found.
Params: - name – the option name
Returns: the current CLI
instance
/**
* Removes an option identified by its name. This method does nothing if the option cannot be found.
* @param name the option name
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI removeOption(String name) {
delegate.removeOption(name);
return this;
}
Removes an argument identified by its index. This method does nothing if the argument cannot be found.
Params: - index – the argument index
Returns: the current CLI
instance
/**
* Removes an argument identified by its index. This method does nothing if the argument cannot be found.
* @param index the argument index
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI removeArgument(int index) {
delegate.removeArgument(index);
return this;
}
Returns: the CLI priority.
/**
* @return the CLI priority.
*/
public int getPriority() {
int ret = delegate.getPriority();
return ret;
}
Sets the priority of the CLI.
Params: - priority – the priority
Returns: the current CLI
instance
/**
* Sets the priority of the CLI.
* @param priority the priority
* @return the current {@link io.vertx.reactivex.core.cli.CLI} instance
*/
public io.vertx.reactivex.core.cli.CLI setPriority(int priority) {
delegate.setPriority(priority);
return this;
}
public static CLI newInstance(io.vertx.core.cli.CLI arg) {
return arg != null ? new CLI(arg) : null;
}
}