1 |
$description = "The following test creates a makefile to ... |
# -*-perl-*- |
|
<FILL IN DESCRIPTION HERE> "; |
|
2 |
|
|
3 |
|
$description = "<FILL IN SHORT DESCRIPTION HERE>"; |
4 |
$details = "<FILL IN DETAILS OF HOW YOU TEST WHAT YOU SAY YOU ARE TESTING>"; |
$details = "<FILL IN DETAILS OF HOW YOU TEST WHAT YOU SAY YOU ARE TESTING>"; |
5 |
|
|
6 |
# IF YOU NEED >1 MAKEFILE FOR THIS TEST, USE &get_tmpfile; TO GET |
# Run a make test. See the documentation of run_make_test() in |
7 |
# THE NAME OF THE MAKEFILE. THIS INSURES CONSISTENCY AND KEEPS TRACK OF |
# run_make_tests.pl, but briefly the first argument is a string with the |
8 |
# HOW MANY MAKEFILES EXIST FOR EASY DELETION AT THE END. |
# contents of a makefile to be tested, the second is a string containing the |
9 |
# EXAMPLE: $makefile2 = &get_tmpfile; |
# arguments to be passed to the make invocation, the third is a string |
10 |
|
# containing the expected output. The fourth is the expected exit code for |
11 |
|
# make. If not specified, it's assumed that the make program should succeed |
12 |
|
# (exit with 0). |
13 |
|
|
14 |
|
run_make_test('Your test makefile goes here', |
15 |
|
'Arguments to pass to make go here', |
16 |
|
'Expected output from the invocation goes here'); |
17 |
|
|
18 |
open(MAKEFILE,"> $makefile"); |
# There are various special tokens, options, etc. See the full documentation |
19 |
|
# in run_make_tests.pl. |
20 |
|
|
|
# The Contents of the MAKEFILE ... |
|
|
|
|
|
print MAKEFILE " <FILL IN THE CONTENTS OF THE MAKEFILE HERE> \n"; |
|
|
|
|
|
# END of Contents of MAKEFILE |
|
|
|
|
|
close(MAKEFILE); |
|
|
|
|
|
|
|
|
# Run make. You may specify a makefile, but if you don't want to, just |
|
|
# insert "" where $make_filename is now. You may also specify specific |
|
|
# options to run make with, but you also don't have to. (Insert "" where it |
|
|
# says <FILL IN OPTIONS HERE>), The last field in this subroutine call |
|
|
# is the code which is returned from make. If you think that make should |
|
|
# execute with no errors, you may OPTIONALLY put 0; Otherwise put the |
|
|
# error code that you expect back from make for this test. |
|
|
|
|
|
# Every time you run make, you just need to say &get_logfile and that |
|
|
# subroutine will get a new logfile name for you in incrementing order |
|
|
# according to how many times you call it within ONE test. It is |
|
|
# reset to 0 at the beginning of every new test script. |
|
|
|
|
|
&run_make_with_options($makefile, |
|
|
"<FILL IN OPTIONS HERE>", |
|
|
&get_logfile, |
|
|
0); |
|
|
|
|
|
|
|
|
# THE REST OF THIS FILE DEPENDS HIGHLY ON WHAT KIND OF TEST YOU ARE |
|
|
# CREATING, SO IT WILL VARY. BASICALLY, YOU MAY INSERT ANYTHING YOU |
|
|
# WISH AT THIS POINT TO SEE IF THE TEST WORKED OK. IF THERE ARE |
|
|
# ADDITIONAL TESTS BESIDES &compare_output, AND IT FAILES, YOU |
|
|
# MUST *** SET $test_passed = 0 !!! *** |
|
|
|
|
|
# Create the answer to what should be produced by this Makefile |
|
|
$answer = "<INSERT ANSWER HERE>"; |
|
|
|
|
|
# COMPARE RESULTS |
|
|
|
|
|
# In this call to compare output, you should use the call &get_logfile(1) |
|
|
# to send the name of the last logfile created. You may also use |
|
|
# the special call &get_logfile(1) which returns the same as &get_logfile(1). |
|
|
|
|
|
&compare_output($answer,&get_logfile(1)); |
|
|
|
|
|
# If you wish to &error ("abort |
|
|
") if the compare fails, then add a "|| &error ("abort |
|
|
")" to the |
|
|
# end of the previous line. |
|
21 |
|
|
22 |
# This tells the test driver that the perl test script executed properly. |
# This tells the test driver that the perl test script executed properly. |
23 |
1; |
1; |