-spec exec_(string(), [string()], list()) -> integer() |
                                             {integer(), iolist()}.

Execute a command and return exit code. If options list contains atom collect_output then this function will capture the output and return tuple {ExitCode, [Line, Line, ...]}. If it contains a tuple {search_path, false} then Command is treated as an absolute name.

Arguments:

• Command: name of the executable (e.g. "ls")
• Args: list of arguments passed to the executable (e.g. ["-a", "."])
• Options: list of options passed to erlang:open_port/2

-spec exec_(string(), [string()]) -> integer().

Equivalent to exec_(Cmd, Args, [])

-spec exec(string(), [string()], list()) -> true.

Execute a command and return true if it exits with code 0 or throw exit:unsat otherwise. By default this function searches for the executable in PATH. This can be disabled by passing {search_path, false} tuple in the options. Then Command will be treated as an absolute name.

Arguments:

• Cmd: name of the executable (e.g. "ls")
• Args: list of arguments passed to the executable (e.g. ["-a", "."])
• Opts: list of additional options passed to erlang:open_port/2

-spec exec(string(), [string()]) -> true.

Equivalent to exec(Cmd, Args, []).

-spec patsubst(filename_pattern(), file:filename_all(),
               template_vars()) -> file:filename_all().

A special version of ‘template/3’ for manipulating file names. It automatically adds the following substitutions:

• extension equal to the file extension of argument Src
• basename equal to the basename of Src without the extension
• dirname directory of Src

Example:

patsubst("${profile}/ebin/${basename}.beam", "src/foo.erl", #{profile => <<"debug">>}) ->
   <<"debug/ebin/foo.beam">>

-spec patsubst(filename_pattern(),
               file:filename_all()) -> file:filename_all().

Equivalent to patsubst(Pattern, Src, #{}).

-spec template(iodata(), template_vars(),
               list) -> string();
              (iodata(), template_vars(), binary) -> binary();
              (iodata(), template_vars(), iolist) -> iodata();
              (iodata(), template_vars(), path) -> file:filename().

Substitute variables Substitutions in Pattern and return a value of the given type.

Example:

template("Foo = ${foo}, bar = ${bar}", #{foo => <<"1">>, <<"bar">> => <<"2">>}, binary) ->
    <<"Foo = 1, bar = 2">>

-spec newer(boolean(),
            file:filename_all() | [file:filename_all()],
            file:filename_all() |
            [file:filename_all()]) -> boolean().

Version of newer/2 that takes an additional argument that specifies whether to ensure directories for the target files or not.

-spec max_mtime([file:filename_all()]) -> integer().

Returns maximum modification time for a set of files. Throws an exception if any input file doesn’t exist.

-spec newer(file:filename_all() | [file:filename_all()],
            file:filename_all() |
            [file:filename_all()]) -> boolean().

Returns true if any of the source files is newer than the target or if the target does not exist, false otherwise. This function assumes that the Target will be created, and creates the directory for the Target as a side effect. If this is not desirable, use anvl_lib:newer(false, Srcs, Targets) instead.