org.unix4j.Unix4j Maven / Gradle / Ivy
package org.unix4j;
import org.unix4j.builder.Unix4jCommandBuilder;
import org.unix4j.builder.DefaultUnix4jCommandBuilder;
import org.unix4j.command.NoOp;
import org.unix4j.context.ExecutionContextFactory;
import org.unix4j.unix.cat.CatOptions;
import org.unix4j.unix.echo.EchoOptions;
import org.unix4j.unix.find.FindOptions;
import org.unix4j.unix.grep.GrepOptions;
import org.unix4j.unix.head.HeadOptions;
import org.unix4j.unix.ls.LsOptions;
import org.unix4j.unix.sed.SedOptions;
import org.unix4j.unix.sort.SortOptions;
import org.unix4j.unix.tail.TailOptions;
import org.unix4j.unix.uniq.UniqOptions;
import org.unix4j.unix.wc.WcOptions;
/**
* Utility class with static methods serving as starting point to create a
* command or build a command chain joining several commands.
*
* Every method returns a new builder instance. For more information and a
* detailed description of command building and chaining, see
* {@link Unix4jCommandBuilder}.
*/
public final class Unix4j {
/**
* Returns a builder to create a command or command chain. The builder is
* initialized with a {@link NoOp} command which will be replaced by the
* first command joined to this builder's command chain.
*
* @return the builder to create the command or command chain
*/
public static Unix4jCommandBuilder builder() {
return new DefaultUnix4jCommandBuilder();
}
/**
* Returns a builder that uses the specified factory to create contexts for
* command execution. The builder is initialized with a {@link NoOp} command
* which will be replaced by the first command joined to this builder's
* command chain.
*
* @param contextFactory
* the factory used to create execution contexts that are passed
* to the execute method when a command is executed
* @return the builder to create the command or command chain
*/
public static Unix4jCommandBuilder use(ExecutionContextFactory contextFactory) {
return new DefaultUnix4jCommandBuilder(contextFactory);
}
/**
* Reads the lines from files specified as arguments and writes them to
the standard output. Options can be specified by acronym (with a
leading dash "-") or by long name (with two leading dashes "--").
File arguments are expanded if wildcards are used. All file
arguments are processed in command-argument order.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options and file operands for the
command. Options can be specified by acronym (with a leading dash
"-") or by long name (with two leading dashes "--"). File arguments
are expanded if wildcards are used.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cat(String... args) {
return builder().cat(args);
}
/**
* Reads the lines from the specified files and writes them to the
standard output. The files are processed in command-argument order.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param files The input files to be printed; relative paths are not resolved (use
the string path argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cat(java.io.File... files) {
return builder().cat(files);
}
/**
* Reads the lines from the specified files and writes them to the
standard output; the given options define the details of the output
format. The files are processed in command-argument order.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the cat command.
* @param files The input files to be printed; relative paths are not resolved (use
the string path argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cat(CatOptions options, java.io.File... files) {
return builder().cat(options, files);
}
/**
* Reads the lines from the specified files and writes them to the
standard output; the given options define the details of the output
format. The path arguments are expanded if wildcards are used and
processed in command-argument order.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the cat command.
* @param paths Pathnames of the input files to be printed; wildcards * and ? are
supported; relative paths are resolved on the basis of the current
working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cat(CatOptions options, String... paths) {
return builder().cat(options, paths);
}
/**
* Changes the current directory to the user home directory as defined
by the execution context (usually the directory specified by the
{@code "user.home"} system property).
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cd() {
return builder().cd();
}
/**
* The current working directory is changed to the given file. If the
specified file argument does not represent a valid directory, an
exception is thrown. Note that relative paths are not resolved with
the (old) current working directory. Use the String path to enable
relative path resolving and wildcards.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param file the file to use as input; relative paths are not resolved (use the
string path argument to enable relative path resolving based on the
current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cd(java.io.File file) {
return builder().cd(file);
}
/**
* The current working directory is changed to the given file. Relative
paths are resolved on the basis of the (old) current working
directory. Wildcards are possible if the first matching file
represents a directory. If the first file specified by the given
path argument is not a valid directory, an exception is thrown.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path the directory to become the new current working directory;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder cd(String path) {
return builder().cd(path);
}
/**
* Writes any of the specified strings, separated by single blank
({@code ' '}) characters to the standard output suppressing the
trailing line ending if the {@code "-n"} option is specified.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options for the command and the
strings to be written to the output. Options can be specified by
acronym (with a leading dash "-") or by long name (with two leading
dashes "--").
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder echo(String... args) {
return builder().echo(args);
}
/**
* Writes the specified string followed by a newline character to
the standard output suppressing the trailing line ending if the
{@code -n} option is specified.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the echo command.
* @param string A string to be written to standard output.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder echo(EchoOptions options, String string) {
return builder().echo(options, string);
}
/**
* Writes any of the specified strings, separated by single blank
({@code ' '}) characters to the standard output suppressing the
trailing line ending if the {@code -n} option is specified.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the echo command.
* @param strings Strings to be written to standard output, separated by single blank
characters.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder echo(EchoOptions options, String... strings) {
return builder().echo(options, strings);
}
/**
* Finds all files matching the search criteria specified by the given
arguments and writes the file names to the standard output.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--name" operand have to be prefixed with the operand name.
The files names written to the output are relative paths referring
to the working directory (or -- if provided -- relative to the path
given after the {@code "--path"} operand name).
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options and operands for the command.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--path" operand have to be prefixed with the operand name
(e.g. "--name" for subsequent path operand values).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(String... args) {
return builder().find(args);
}
/**
* Finds all files in or below the directory specified by {@code path}
and writes the file names to the standard output.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(String path) {
return builder().find(path);
}
/**
* Finds all files matching the specified {@code name} in or below the
directory specified by {@code path} and writes the file names to
the standard output.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(String path, String name) {
return builder().find(path, name);
}
/**
* Finds all files matching the specified file {@code size} in or below
the user's current working directory and writes the file names to
the standard output. Matching files use at least {@code size} bytes
on disk if {@code size} is positive, or at most {@code abs(size)}
bytes if {@code size} is zero or negative.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(long size) {
return builder().find(size);
}
/**
* Finds all files matching the specified file {@code size} in or below
the directory specified by {@code path} and writes the file names
to the standard output. Matching files use at least {@code size}
bytes on disk if {@code size} is positive, or at most
{@code abs(size)} bytes if {@code size} is zero or negative.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(String path, long size) {
return builder().find(path, size);
}
/**
* Finds all files matching the specified file {@code name} and
{@code size} in or below the user's current working directory and
writes the file names to the standard output. Matching files use
at least {@code size} bytes on disk if {@code size} is positive,
or at most {@code abs(size)} bytes if {@code size} is zero or
negative.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(long size, String name) {
return builder().find(size, name);
}
/**
* Finds all files matching the specified file {@code name} and
{@code size} in or below the directory specified by {@code path}
and writes the file names to the standard output. Matching files
use at least {@code size} bytes on disk if {@code size} is positive,
or at most {@code abs(size)} bytes if {@code size} is zero or
negative.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(String path, long size, String name) {
return builder().find(path, size, name);
}
/**
* Finds all files matching the specified {@code name} in or below the
user's current working directory and writes the file names to the
standard output.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String name) {
return builder().find(options, name);
}
/**
* Finds all files matching the specified {@code name} in or below the
directory specified by {@code path} and writes the file names to
the standard output.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String path, String name) {
return builder().find(options, path, name);
}
/**
* Finds all files matching the specified file {@code size} in or below
the user's current working directory and writes the file names to
the standard output. Matching files use at least {@code size} bytes
on disk if {@code size} is positive, or at most {@code abs(size)}
bytes if {@code size} is zero or negative.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, long size) {
return builder().find(options, size);
}
/**
* Finds all files matching the specified file {@code size} in or below
the directory specified by {@code path} and writes the file names
to the standard output. Matching files use at least {@code size}
bytes on disk if {@code size} is positive, or at most
{@code abs(size)} bytes if {@code size} is zero or negative.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String path, long size) {
return builder().find(options, path, size);
}
/**
* Finds all files that have been created, modified or accessed before
or after the specified {@code time} (depending on the given
{@code -time...} options). The names of the matching files found in
or below the user's current working directory are written to the
standard output.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param time Consider only files that have been created, modified or accessed
before or after the specified {@code time} operand; consider the
{@code -time...} options for details of the comparison.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, java.util.Date time) {
return builder().find(options, time);
}
/**
* Finds all files that have been created, modified or accessed before
or after the specified {@code time} (depending on the given
{@code -time...} options). The names of the matching files found in
or below the directory specified by {@code path} are written to
the standard output.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param time Consider only files that have been created, modified or accessed
before or after the specified {@code time} operand; consider the
{@code -time...} options for details of the comparison.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String path, java.util.Date time) {
return builder().find(options, path, time);
}
/**
* Finds all files matching the specified file {@code name} and
{@code size} in or below the user's current working directory and
writes the file names to the standard output. Matching files use
at least {@code size} bytes on disk if {@code size} is positive, or
at most {@code abs(size)} bytes if {@code size} is zero or negative.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, long size, String name) {
return builder().find(options, size, name);
}
/**
* Finds all files matching the specified file {@code name} and
{@code size} in or below the directory specified by {@code path}
and writes the file names to the standard output. Matching files
use at least {@code size} bytes on disk if {@code size} is positive,
or at most {@code abs(size)} bytes if {@code size} is zero or
negative.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String path, long size, String name) {
return builder().find(options, path, size, name);
}
/**
* Finds all files matching the given {@code name} that have been
created, modified or accessed before or after the specified
{@code time} (depending on the given {@code -time...} options). The
names of the matching files found in or below the user's current
working directory are written to the standard output.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param time Consider only files that have been created, modified or accessed
before or after the specified {@code time} operand; consider the
{@code -time...} options for details of the comparison.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, java.util.Date time, String name) {
return builder().find(options, time, name);
}
/**
* Finds all files matching the given {@code name} that have been
created, modified or accessed before or after the specified
{@code time} (depending on the given {@code -time...} options). The
names of the matching files found in or below the directory
specified by {@code path} are written to the standard output.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param time Consider only files that have been created, modified or accessed
before or after the specified {@code time} operand; consider the
{@code -time...} options for details of the comparison.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String path, java.util.Date time, String name) {
return builder().find(options, path, time, name);
}
/**
* Finds all files matching the given {@code name} and {@code size} and
have been created, modified or accessed before or after the specified
{@code time} (depending on the given {@code -time...} options).
Matching files use at least {@code size} bytes on disk if
{@code size} is positive, or at most {@code abs(size)} bytes if
{@code size} is zero or negative. The names of the matching files
found in or below the user's current working directory are written
to the standard output.
The files names written to the output are relative paths referring
to the working directory.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @param time Consider only files that have been created, modified or accessed
before or after the specified {@code time} operand; consider the
{@code -time...} options for details of the comparison.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, long size, java.util.Date time, String name) {
return builder().find(options, size, time, name);
}
/**
* Finds all files matching the given {@code name} and {@code size} and
have been created, modified or accessed before or after the specified
{@code time} (depending on the given {@code -time...} options).
Matching files use at least {@code size} bytes on disk if
{@code size} is positive, or at most {@code abs(size)} bytes if
{@code size} is zero or negative. The names of the matching files
found in or below the directory specified by {@code path} are
written to the standard output.
The files names written to the output are paths relative to the
specified {@code path} operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the file search.
* @param path Starting point for the search in the directory hierarchy;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @param size Consider only files using at least {@code size} bytes if {@code size}
is positive, or at most {@code abs(size)} bytes if {@code size} is zero
or negative.
* @param time Consider only files that have been created, modified or accessed
before or after the specified {@code time} operand; consider the
{@code -time...} options for details of the comparison.
* @param name Name pattern to match the file name after removing the path with the
leading directories; wildcards * and ? are supported, or full
regular expressions if either of the options {@code -regex (-r)} or
{@code -iregex (-i)} is specified.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder find(FindOptions options, String path, long size, java.util.Date time, String name) {
return builder().find(options, path, size, time, name);
}
/**
* Uses the given string as input for the next command. If the string
contains line ending codes (UNIX or DOS independent from the host
operating system), the string is split into multiple lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param string the string to use as input
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder fromString(String string) {
return builder().fromString(string);
}
/**
* Uses the given strings as input for the next command. Each string
usually represents a single line of the input; however, if any of
the strings contains line ending codes (UNIX or DOS independent from
the host operating system), it is split into multiple lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param strings the input lines
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder fromStrings(String... strings) {
return builder().fromStrings(strings);
}
/**
* Uses the strings in the specified {@code input} collection as input
lines for the next command. Each string usually represents a single
line of the input; however, if any of the strings contains line
ending codes (UNIX or DOS independent from the host operating
system), it is split into multiple lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param lines collection with input lines
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder from(java.util.Collection lines) {
return builder().from(lines);
}
/**
* Redirects the contents of the given file into the next command. This
is essentially equivalent to the following syntax in a unix command
shell: {@code path > ...}
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path the file to use as input; wildcards * and ? are supported; relative
paths are resolved on the basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder fromFile(String path) {
return builder().fromFile(path);
}
/**
* Redirects the contents of the given file into the next command. This
is essentially equivalent to the following syntax in a unix command
shell: {@code file > ...}
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param file the file to use as input; relative paths are not resolved (use the
string path argument to enable relative path resolving based on the
current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder fromFile(java.io.File file) {
return builder().fromFile(file);
}
/**
* Reads from the given resource relative to the classpath and
redirects the contents into the next command. The resource is
usually a file or URL on the classpath. The resource is read using
{@link Class#getResourceAsStream(String)}.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param resource a path to the file to redirect to the next command. The will need
to be on the classpath. If the file is in the root directory, the
filename should be prefixed with a forward slash. e.g.:
{@code "/test-file.txt"}
If the file is in a package, then the package should be specified
prefixed with a forward slash, and with each dot "." replaced with a
forward slash. e.g.:
{@code "/org/company/mypackage/test-file.txt"}
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder fromResource(String resource) {
return builder().fromResource(resource);
}
/**
* Reads from the given input stream and redirects the contents into
the next command.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param stream the input stream to read from
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder from(java.io.InputStream stream) {
return builder().from(stream);
}
/**
* Uses the given reader and redirects the read input into the next
command.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param reader the reader used to read the input
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder from(java.io.Reader reader) {
return builder().from(reader);
}
/**
* Reads from the given URL and redirects the contents into the next
command.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param url the URL to read from
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder from(java.net.URL url) {
return builder().from(url);
}
/**
* Reads from the given input object and redirects the contents into
the next command.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param input the input object to read from
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder from(org.unix4j.io.Input input) {
return builder().from(input);
}
/**
* Filters the lines from the specified input files and writes the
matching lines to the standard output. Every line is matched against
the given {@code regexp} string using case-sensitive comparison.
Line endings are not relevant for the comparison.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param regexp Lines will be printed which match the given regular expression. The
{@code regexp} string is surrounded with ".*" on both sides unless
the {@code --wholeLine} option is specified. If the
{@code --fixedStrings} option is used, plain string comparison is
used instead of regular expression matching.
* @param files The input files to be searched for the pattern; relative paths are
not resolved (use the string paths argument to enable relative path
resolving based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(String regexp, java.io.File... files) {
return builder().grep(regexp, files);
}
/**
* Filters the lines from the specified input files and writes the
matching lines to the standard output. Every line is matched against
the given regular expression {@code pattern} using case-sensitive
comparison. Line endings are not relevant for the comparison.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param pattern Lines will be printed which match the given pattern.
* @param files The input files to be searched for the pattern; relative paths are
not resolved (use the string paths argument to enable relative path
resolving based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(java.util.regex.Pattern pattern, java.io.File... files) {
return builder().grep(pattern, files);
}
/**
* Filters the lines from the specified input files and writes the
matching lines to the standard output. Every line is matched against
the given regular expression {@code pattern} using case-sensitive
comparison. Line endings are not relevant for the comparison.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param pattern Lines will be printed which match the given pattern.
* @param paths Pathnames of the input files to be searched for the pattern;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(java.util.regex.Pattern pattern, String... paths) {
return builder().grep(pattern, paths);
}
/**
* Filters the input lines from the specified input files and writes
the matching lines to the standard output. Every line is matched
against the given {@code regexp} string; the exact comparison rules
are defined by the specified matching {@code options}.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the types of patterns and command behavior.
* @param regexp Lines will be printed which match the given regular expression. The
{@code regexp} string is surrounded with ".*" on both sides unless
the {@code --wholeLine} option is specified. If the
{@code --fixedStrings} option is used, plain string comparison is
used instead of regular expression matching.
* @param files The input files to be searched for the pattern; relative paths are
not resolved (use the string paths argument to enable relative path
resolving based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(GrepOptions options, String regexp, java.io.File... files) {
return builder().grep(options, regexp, files);
}
/**
* Filters the input lines from the specified input files and writes
the matching lines to the standard output. Every line is matched
against the given {@code regexp} string; the exact comparison rules
are defined by the specified matching {@code options}.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the types of patterns and command behavior.
* @param regexp Lines will be printed which match the given regular expression. The
{@code regexp} string is surrounded with ".*" on both sides unless
the {@code --wholeLine} option is specified. If the
{@code --fixedStrings} option is used, plain string comparison is
used instead of regular expression matching.
* @param paths Pathnames of the input files to be searched for the pattern;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(GrepOptions options, String regexp, String... paths) {
return builder().grep(options, regexp, paths);
}
/**
* Filters the input lines from the specified input files and writes
the matching lines to the standard output. Every line is matched
against the given regular expression {@code pattern}; the exact
comparison rules are defined by the specified matching
{@code options}.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the types of patterns and command behavior.
* @param pattern Lines will be printed which match the given pattern.
* @param files The input files to be searched for the pattern; relative paths are
not resolved (use the string paths argument to enable relative path
resolving based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(GrepOptions options, java.util.regex.Pattern pattern, java.io.File... files) {
return builder().grep(options, pattern, files);
}
/**
* Filters the input lines from the specified input files and writes
the matching lines to the standard output. Every line is matched
against the given regular expression {@code pattern}; the exact
comparison rules are defined by the specified matching
{@code options}.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the types of patterns and command behavior.
* @param pattern Lines will be printed which match the given pattern.
* @param paths Pathnames of the input files to be searched for the pattern;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder grep(GrepOptions options, java.util.regex.Pattern pattern, String... paths) {
return builder().grep(options, pattern, paths);
}
/**
* Reads the first 10 lines from each of the specified files and writes
them to the standard output. If more than a single file is
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param files The input files to be filtered; relative paths are not resolved (use
the string paths argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder head(java.io.File... files) {
return builder().head(files);
}
/**
* Reads the first {@code count} lines from each of the specified files
and writes them to the standard output. If more than a single file
is specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param count The first {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param files The input files to be filtered; relative paths are not resolved (use
the string paths argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder head(long count, java.io.File... files) {
return builder().head(count, files);
}
/**
* Reads the first {@code count} lines from each of the specified files
and writes them to the standard output. If more than a single file
is specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param count The first {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param paths Pathnames of the input files to be filtered; wildcards * and ? are
supported; relative paths are resolved on the basis of the current
working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder head(long count, String... paths) {
return builder().head(count, paths);
}
/**
* Reads the first {@code count} lines or characters from each of the
specified files and writes them to the standard output. If more than
a single file is specified and the {@code -q} option is not
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the head command.
* @param count The first {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param files The input files to be filtered; relative paths are not resolved (use
the string paths argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder head(HeadOptions options, long count, java.io.File... files) {
return builder().head(options, count, files);
}
/**
* Reads the first {@code count} lines or characters from each of the
specified files and writes them to the standard output. If more than
a single file is specified and the {@code -q} option is not
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the head command.
* @param count The first {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param paths Pathnames of the input files to be filtered; wildcards * and ? are
supported; relative paths are resolved on the basis of the current
working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder head(HeadOptions options, long count, String... paths) {
return builder().head(options, count, paths);
}
/**
* Lists all files and directories in the user's current working
directory and writes them to the output.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder ls() {
return builder().ls();
}
/**
* Prints the name of the specified files and lists all files contained
in directories for every directory in those files.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--paths" operand have to be prefixed with the operand
name.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options and operands for the command.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--paths" operand have to be prefixed with the operand
name (e.g. "--count" for a subsequent count operand value).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder ls(String... args) {
return builder().ls(args);
}
/**
* Prints the name of the given files and lists all files contained in
directories for every directory in {@code files}.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param files The files or directories used as starting point for the listing;
relative paths are not resolved (use the string path argument to
enable relative path resolving based on the current working
directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder ls(java.io.File... files) {
return builder().ls(files);
}
/**
* Lists all files and directories in the user's current working
directory and writes them to the output using the given options
specifying the details of the output format.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the output format.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder ls(LsOptions options) {
return builder().ls(options);
}
/**
* Prints the name of the given files and lists all files contained in
directories for every directory in {@code files}. The given options
define the details of the output format.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the output format.
* @param files The files or directories used as starting point for the listing;
relative paths are not resolved (use the string path argument to
enable relative path resolving based on the current working
directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder ls(LsOptions options, java.io.File... files) {
return builder().ls(options, files);
}
/**
* Prints the name of the given files and lists all files contained in
directories for every directory in {@code files}. The given options
define the details of the output format.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the output format.
* @param paths The files or directories used as starting point for the listing;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder ls(LsOptions options, String... paths) {
return builder().ls(options, paths);
}
/**
* Executes the sed script specified by the given arguments and writes
the result to the standard output.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--script" operand have to be prefixed with the operand name.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options and operands for the command.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--script" operand have to be prefixed with the operand name
(e.g. "--occurrence" for subsequent occurrence indices).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(String... args) {
return builder().sed(args);
}
/**
* Executes the given sed script, such as "s/original/replacement/g".
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param script Sed script as one string, such as "s/original/replacement/g".
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(String script) {
return builder().sed(script);
}
/**
* Substitutes the replacement string for instances of the regexp in
the matched line.
An ampersand ('&') appearing in the replacement is be replaced
by the line matching the regexp. The characters "\n", where n is a
digit, are replaced by the text matched by the corresponding
backreference expression. The special meaning of '&' and "\n"
in this context can be suppressed by preceding it by a backslash.
A line can be split by substituting a newline ('\n') into it.
A substitution is considered to have been performed even if the
replacement string is identical to the string that it replaces.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param regexp Regular expression matched against a line.
* @param replacement Replacement string for substitute command. An ampersand ('&')
appearing in the replacement string is replaced by the string
matching the regular expression. The characters "\n", where n is a
digit, are replaced by the text matched by the corresponding
backreference expression. The special meaning of '&' and "\n" in
this context can be suppressed by preceding it by a backslash.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(String regexp, String replacement) {
return builder().sed(regexp, replacement);
}
/**
* Substitutes the replacement string for instances of the regexp in
the matched line. Only the given occurrences of the regexp found
within the matched string are substituted.
An ampersand ('&') appearing in the replacement is be replaced
by the line matching the regexp. The characters "\n", where n is a
digit, are replaced by the text matched by the corresponding
backreference expression. The special meaning of '&' and "\n"
in this context can be suppressed by preceding it by a backslash.
A line can be split by substituting a newline ('\n') into it.
A substitution is considered to have been performed even if the
replacement string is identical to the string that it replaces.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param regexp Regular expression matched against a line.
* @param replacement Replacement string for substitute command. An ampersand ('&')
appearing in the replacement string is replaced by the string
matching the regular expression. The characters "\n", where n is a
digit, are replaced by the text matched by the corresponding
backreference expression. The special meaning of '&' and "\n" in
this context can be suppressed by preceding it by a backslash.
* @param occurrence Substitute for the given occurrences only of the regexp found within
the matched string; the occurrence indices are one-based. If empty
or omitted, all occurrences are substituted.
(This operand only applies to the substitute command and is ignored
by all other commands).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(String regexp, String replacement, int... occurrence) {
return builder().sed(regexp, replacement, occurrence);
}
/**
* Executes the sed command specified by the given options or executes
the print command p if no command option has been declared.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Sed options and commands
* @param regexp Regular expression matched against a line.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(SedOptions options, String regexp) {
return builder().sed(options, regexp);
}
/**
* Executes the sed command specified by the given options or executes
the substitute command s if no command option has been declared.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Sed options and commands
* @param string1 Regular expression matched against a line for all commands except
for command y where string1 contains the source characters for the
translation.
* @param string2 Replacement string for substitute command s; appended, inserted or
changed text for a, i and c command; destination characters for
translate command y; ignored by all other commands.
If string2 is a replacement string for the substitute command: an
ampersand ('&') appearing in the replacement string is replaced
by the string matching the regular expression; the characters "\n",
where n is a digit, are replaced by the text matched by the
corresponding backreference expression. The special meaning of
'&' and "\n" in this context can be suppressed by preceding it
by a backslash.
(This operand only applies to the commands s, a, i, c and y and is
ignored by all other commands).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(SedOptions options, String string1, String string2) {
return builder().sed(options, string1, string2);
}
/**
* Executes the sed command specified by the given options or executes
the substitute command s if no command option has been declared.
The string1 operand usually contains the regular expression matched
against a line for all commands except for command y where string1
contains the source characters for the translation.
The string2 operand contains the replacement string for the
substitute command s. It contains the appended, inserted or changed
text for the commands a, i and c, respectively, and the destination
characters for the translate command y. All other commands ignore
the string2 operand.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Sed options and commands
* @param string1 Regular expression matched against a line for all commands except
for command y where string1 contains the source characters for the
translation.
* @param string2 Replacement string for substitute command s; appended, inserted or
changed text for a, i and c command; destination characters for
translate command y; ignored by all other commands.
If string2 is a replacement string for the substitute command: an
ampersand ('&') appearing in the replacement string is replaced
by the string matching the regular expression; the characters "\n",
where n is a digit, are replaced by the text matched by the
corresponding backreference expression. The special meaning of
'&' and "\n" in this context can be suppressed by preceding it
by a backslash.
(This operand only applies to the commands s, a, i, c and y and is
ignored by all other commands).
* @param occurrence Substitute for the given occurrences only of the regexp found within
the matched string; the occurrence indices are one-based. If empty
or omitted, all occurrences are substituted.
(This operand only applies to the substitute command and is ignored
by all other commands).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sed(SedOptions options, String string1, String string2, int... occurrence) {
return builder().sed(options, string1, string2, occurrence);
}
/**
* Sort the lines of all the specified files together and writes the
result to the standard output.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--paths" operand have to be prefixed with the operand
name.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options and operands for the command.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--paths" operand have to be prefixed with the operand
name (e.g. "--comparator" for a subsequent comparator operand value).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(String... args) {
return builder().sort(args);
}
/**
* Sort the lines of all the specified files together and writes the
result to the standard output.
Comparisons are based on the entire line without line ending. The
collating sequence of the current locale is used to perform the
comparisons.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param files The files to be sorted or merged; relative paths are not resolved
(use the string paths argument to enable relative path resolving
based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(java.io.File... files) {
return builder().sort(files);
}
/**
* Sort the lines of all the specified files together and writes the
result to the standard output.
Line comparisons are based on the specified {@code comparator}.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param comparator The comparator to use for the line comparisons.
* @param files The files to be sorted or merged; relative paths are not resolved
(use the string paths argument to enable relative path resolving
based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(java.util.Comparator comparator, java.io.File... files) {
return builder().sort(comparator, files);
}
/**
* Sort the lines of all the specified files together and writes the
result to the standard output.
Line comparisons are based on the specified {@code comparator}.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param comparator The comparator to use for the line comparisons.
* @param paths Pathnames of the files to be sorted, merged, or checked; wildcards *
and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(java.util.Comparator comparator, String... paths) {
return builder().sort(comparator, paths);
}
/**
* Sorts, merges, or sequence checks the lines the lines of all the
specified files together and writes the result to the standard
output.
Comparisons are based on the entire line without line ending. The
collating sequence of the current locale is used to perform the
comparisons.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options for the sort command.
* @param files The files to be sorted or merged; relative paths are not resolved
(use the string paths argument to enable relative path resolving
based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(SortOptions options, java.io.File... files) {
return builder().sort(options, files);
}
/**
* Sorts, merges, or sequence checks the lines the lines of all the
specified files together and writes the result to the standard
output.
Comparisons are based on the entire line without line ending. The
collating sequence of the current locale is used to perform the
comparisons.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options for the sort command.
* @param paths Pathnames of the files to be sorted, merged, or checked; wildcards *
and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(SortOptions options, String... paths) {
return builder().sort(options, paths);
}
/**
* Sorts, merges, or sequence checks the lines the lines of all the
specified files together and writes the result to the standard
output.
Line comparisons are based on the specified {@code comparator}.
All comparison related options except for {@code --reverse} are
ignored.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options for the sort command.
* @param comparator The comparator to use for the line comparisons.
* @param files The files to be sorted or merged; relative paths are not resolved
(use the string paths argument to enable relative path resolving
based on the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(SortOptions options, java.util.Comparator comparator, java.io.File... files) {
return builder().sort(options, comparator, files);
}
/**
* Sorts, merges, or sequence checks the lines the lines of all the
specified files together and writes the result to the standard
output.
Line comparisons are based on the specified {@code comparator}.
All comparison related options except for {@code --reverse} are
ignored.
The sort algorithm used is guaranteed to be stable: lines considered
equal will not be reordered as a result of the sort. If two lines
originate from different input files, the index of the file in the
input arguments list defines the ordering of the lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options for the sort command.
* @param comparator The comparator to use for the line comparisons.
* @param paths Pathnames of the files to be sorted, merged, or checked; wildcards *
and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder sort(SortOptions options, java.util.Comparator comparator, String... paths) {
return builder().sort(options, comparator, paths);
}
/**
* Reads the last n lines from each of the files specified and writes
them to the standard output. If more than a single file is
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--paths" operand have to be prefixed with the operand
name.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param args String arguments defining the options and operands for the command.
Options can be specified by acronym (with a leading dash "-") or by
long name (with two leading dashes "--"). Operands other than the
default "--paths" operand have to be prefixed with the operand
name (e.g. "--count" for a subsequent count operand value).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder tail(String... args) {
return builder().tail(args);
}
/**
* Reads the last 10 lines from each of the specified files and writes
them to the standard output. If more than a single file is
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param files The input files to be filtered; relative paths are not resolved (use
the string paths argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder tail(java.io.File... files) {
return builder().tail(files);
}
/**
* Reads the last {@code count} lines from each of the specified files
and writes them to the standard output. If more than a single file
is specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param count The last {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified, and offset from start
instead of end with {@code -s} option). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param files The input files to be filtered; relative paths are not resolved (use
the string paths argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder tail(long count, java.io.File... files) {
return builder().tail(count, files);
}
/**
* Reads the last {@code count} lines from each of the specified files
and writes them to the standard output. If more than a single file
is specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param count The last {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified, and offset from start
instead of end with {@code -s} option). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param paths Pathnames of the input files to be filtered; wildcards * and ? are
supported; relative paths are resolved on the basis of the current
working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder tail(long count, String... paths) {
return builder().tail(count, paths);
}
/**
* Reads the last {@code count} lines or characters from each of the
specified files and writes them to the standard output. If more than
a single file is specified and the {@code -q} option is not
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the tail command.
* @param count The last {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified, and offset from start
instead of end with {@code -s} option). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param files The input files to be filtered; relative paths are not resolved (use
the string paths argument to enable relative path resolving based on
the current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder tail(TailOptions options, long count, java.io.File... files) {
return builder().tail(options, count, files);
}
/**
* Reads the last {@code count} lines or characters from each of the
specified files and writes them to the standard output. If more than
a single file is specified and the {@code -q} option is not
specified, each file is preceded by a header consisting of the
string {@code "==> XXX <=="} where {@code "XXX"} is the name
of the file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options Options for the tail command.
* @param count The last {@code count} lines of each input file are
copied to standard output, starting from 1 (characters instead of
lines if the {@code -c} option is specified, and offset from start
instead of end with {@code -s} option). Must be a non-negative
integer or an exception is thrown. If {@code count} is greater than
the number number of lines (characters) in the input, the
application will not error and send the whole file to the output.
* @param paths Pathnames of the input files to be filtered; wildcards * and ? are
supported; relative paths are resolved on the basis of the current
working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder tail(TailOptions options, long count, String... paths) {
return builder().tail(options, count, paths);
}
/**
* Reads from the specified input {@code file} and compares adjacent
lines, writing one copy of each input line to the standard output.
The second and succeeding copies of repeated adjacent input lines
are not written to the output.
Note that repeated lines in the input are not detected if they are
not adjacent (see --global or -g option); sorted input lines always
result in unique output lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param file The files or directories used as starting point for the listing;
relative paths are not resolved (use the string path argument to
enable relative path resolving based on the current working
directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder uniq(java.io.File file) {
return builder().uniq(file);
}
/**
* Reads the file specified by its {@code path} and compares adjacent
lines, writing one copy of each input line to the standard output.
The second and succeeding copies of repeated adjacent input lines
are not written to the output.
Note that repeated lines in the input are not detected if they are
not adjacent (see --global or -g option); sorted input lines always
result in unique output lines.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param path The files or directories used as starting point for the listing;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder uniq(String path) {
return builder().uniq(path);
}
/**
* Reads from the specified input {@code file} and compares adjacent
lines, writing one copy of each input line to the standard output.
The second and succeeding copies of repeated adjacent input lines
are not written to the output.
Note that repeated non-adjacent lines in the input are only detected
with the --global or -g option. In other words, unique output lines
are guaranteed only if either (a) the --global or -g option is
specified, or (b) the input lines are sorted.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the uniqueness details for the output lines.
* @param file The files or directories used as starting point for the listing;
relative paths are not resolved (use the string path argument to
enable relative path resolving based on the current working
directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder uniq(UniqOptions options, java.io.File file) {
return builder().uniq(options, file);
}
/**
* Reads the file specified by its {@code path} and compares adjacent
lines, writing one copy of each input line to the standard output.
The second and succeeding copies of repeated adjacent input lines
are not written to the output.
Note that repeated non-adjacent lines in the input are only detected
with the --global or -g option. In other words, unique output lines
are guaranteed only if either (a) the --global or -g option is
specified, or (b) the input lines are sorted.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining the uniqueness details for the output lines.
* @param path The files or directories used as starting point for the listing;
wildcards * and ? are supported; relative paths are resolved on the
basis of the current working directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder uniq(UniqOptions options, String path) {
return builder().uniq(options, path);
}
/**
* Executes a count of lines, words and chars contained in each input
file and writes them to the standard output. If more than one input
file is specified, a line of cumulative counts for all the files is
displayed on a separate line after the output for the last file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param files The input files; relative paths are not resolved (use the string
paths argument to enable relative path resolving based on the
current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder wc(java.io.File... files) {
return builder().wc(files);
}
/**
* Executes a one or more counts, depending on the given options, in
each of the given input files and writes them to the standard
output. If more than one input file is specified, a line of
cumulative counts for all the files is displayed on a separate line
after the output for the last file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining command behavior.
* @param files The input files; relative paths are not resolved (use the string
paths argument to enable relative path resolving based on the
current working directory).
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder wc(WcOptions options, java.io.File... files) {
return builder().wc(options, files);
}
/**
* Executes a one or more counts, depending on the given options, in
each of the given input files and writes them to the standard
output. If more than one input file is specified, a line of
cumulative counts for all the files is displayed on a separate line
after the output for the last file.
*
* Note that the method returns the command builder to allow for command
* chaining. The command itself is returned by the {@link Unix4jCommandBuilder#build() build()} method
* of the returned builder (see {@link Unix4jCommandBuilder} for more information).
*
* @param options The options defining command behavior.
* @param paths Pathnames of the input files; wildcards * and ? are supported;
relative paths are resolved on the basis of the current working
directory.
* @return the command builder to allow for method chaining. Method
* chaining is used here to create command chains. Adding a command
* to the chain usually means that the previous command pipes
* its output to the added command (the pipe symbol in unix)
*/
public static Unix4jCommandBuilder wc(WcOptions options, String[] paths) {
return builder().wc(options, paths);
}
// no instances
private Unix4j() {
super();
}
}