Parrot::Configure::Utils - Configuration Step Utilities
The Parrot::Configure::Utils module contains utility functions for use by the configuration step classes found under config/.
The subroutines found in this module do not require the Parrot::Configure object as an argument. Those subroutines formerly found in this module which do require the Parrot::Configure object as an argument have been moved into Parrot::Configure::Compiler.
_run_command($command,
$out,
$err)Runs the specified command.
Output is directed to the file specified by $out,
warnings and errors are directed to the file specified by $err.
_build_compile_command( $cc,
$ccflags,
$cc_args )Constructs a command-line to do the compile.
integrate($orig,
$new)Integrates $new into $orig.
Returns $orig if $new is undefined.
prompt($message,
$value)Prints out "message [default] " and waits for the user's response.
Returns the response,
or the default if the user just hit ENTER.
file_checksum($filename,
$ignore_pattern)Creates a checksum for the specified file. This is used to compare files.
Any lines matching the regular expression specified by $ignore_pattern are not included in the checksum.
copy_if_diff($from,
$to,
$ignore_pattern)Copies the file specified by $from to the location specified by $to if its contents have changed.
The regular expression specified by $ignore_pattern is passed to file_checksum() when comparing the files.
move_if_diff($from,
$to,
$ignore_pattern)Moves the file specified by $from to the location specified by $to if its contents have changed.
capture_output($command)Executes the given command. The command's output (both stdout and stderr), and its return status is returned as a 3-tuple. STDERR is redirected to test.err during the execution, and deleted after the command's run.
check_progs([$programs])Where $programs may be either a scalar with the name of a single program or an array ref of programs to search the current PATH for.
The first matching program name is returned or undef on failure.
Note: this function only returns the name of the program and not its complete path.
This function is similar to autoconf's AC_CHECK_PROGS macro.
print_to_cache( $cachefile,
$value )Opens a handle to write to the file specified in the first argument.
Prints the value specified in the second argument,
followed by a newline.
Typically,
this will be a hidden file in the user's top-level parrot directory.
Implicitly returns true value upon success; dies otherwise.
read_from_cache( $cachefile )Opens a handle to read from the file specified in the first argument. This is assumed to be a file consisting of a single string, optionally terminated with a newline. The string is returned.
_slurp($filename)Slurps $filename into memory and returns it as a string.
This is just an alias for Parrot::BuildUtil::slurp_file.
