NAME

Parrot::Configure::Utils - Configuration Step Utilities

DESCRIPTION

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.

Functions

_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.
_slurp($filename)
Slurps $filename into memory and returns it as a string. This is just an alias for Parrot::BuildUtil::slurp_file.

SEE ALSO

Parrot::Configure::runsteps()
docs/configuration.pod
lib/Parrot/Configure/Compiler.pm