NAME
Parrot::Configure::Step - Configuration Step Utilities
DESCRIPTION
The Parrot::Configure::Step module contains utility functions for steps to use.
Note that the actual configuration step itself is NOT an instance of this class, rather it is defined to be in the package Configure::Step. See docs/configuration.pod for more information on how to create new configuration steps.
Functions
integrate($orig, $new)-
Integrates
$newinto$orig. 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, $ignorePattern)-
Creates a checksum for the specified file. This is used to compare files.
Any lines matching the regular expression specified by
$ignorePatternare not included in the checksum. copy_if_diff($from, $to, $ignorePattern)-
Copies the file specified by
$fromto the location specified by$toif it's contents have changed.The regular expression specified by
$ignorePatternis passed tofile_checksum()when comparing the files. move_if_diff($from, $to, $ignorePattern)-
Moves the file specified by
$fromto the location specified by$toif it's contents have changed. genfile($source, $target, %options)-
Takes the specified source file, substitutes any sequences matching
/\$\{\w+\}/for the given key's value in the configuration system's data, and writes the results to specified target file. _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. cc_gen($source)-
Generates test.c from the specified source file.
cc_build($cc_args, $link_args)-
These items are used from current config settings:
$cc, $ccflags, $ldout, $o, $link, $linkflags, $cc_exe_out, $exe, $libsCalls the compiler and linker on test.c.
cc_run()-
Calls the test (or test.exe) executable. Any output is directed to test.out.
cc_run_capture()-
Same as
cc_run()except that warnings and errors are also directed to test.out. cc_clean()-
Cleans up all files in the root folder that match the glob test.*.
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.