fUnit 0.0.2 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/COPYING +219 -217
- data/README +116 -11
- data/Rakefile +8 -4
- data/bin/funit +8 -0
- data/docs/html/classes/Funit/Assertions.html +6 -6
- data/docs/html/classes/Funit/Compiler.html +1 -1
- data/docs/html/classes/Funit/Depend.html +11 -11
- data/docs/html/classes/Funit/TestSuite.html +8 -8
- data/docs/html/classes/Funit.html +14 -8
- data/docs/html/created.rid +1 -1
- data/docs/html/files/COPYING.html +246 -441
- data/docs/html/files/README.html +147 -15
- data/docs/html/files/lib/funit/assertions_rb.html +7 -1
- data/docs/html/files/lib/funit/fortran_deps_rb.html +2 -2
- data/docs/html/files/lib/funit/functions_rb.html +7 -1
- data/docs/html/files/lib/funit/test_suite_rb.html +7 -1
- data/docs/html/files/lib/funit_rb.html +7 -1
- data/examples/CFD/FluxFunctionsMT.f90 +2 -2
- data/examples/CFD/FluxFunctionsMT.ftk +1 -1
- data/examples/CFD/GasModelMT.f90 +1 -1
- data/examples/CFD/GasModelMT.ftk +1 -1
- data/examples/CFD/TestRunner.f90 +4 -4
- data/examples/StopWatch/StopWatchMT.f90 +1 -1
- data/examples/StopWatch/TestRunner.f90 +1 -1
- data/lib/funit/assertions.rb +10 -0
- data/lib/funit/fortran_deps.rb +11 -1
- data/lib/funit/functions.rb +10 -0
- data/lib/funit/test_suite.rb +10 -0
- data/lib/funit.rb +11 -0
- data/tests/tc_test_suite.rb +31 -0
- metadata +6 -8
- data/docs/HISTORY +0 -20
- data/lib/clean +0 -1
- data/lib/mklinks +0 -5
data/COPYING
CHANGED
@@ -1,79 +1,81 @@
|
|
1
|
-
|
1
|
+
= Copying
|
2
2
|
|
3
|
-
|
4
|
-
REPRODUCTION, DISTRIBUTION, MODIFICATION AND REDISTRIBUTION OF CERTAIN
|
5
|
-
COMPUTER SOFTWARE ORIGINALLY RELEASED BY THE UNITED STATES GOVERNMENT
|
6
|
-
AS REPRESENTED BY THE GOVERNMENT AGENCY LISTED BELOW ("GOVERNMENT
|
7
|
-
AGENCY"). THE UNITED STATES GOVERNMENT, AS REPRESENTED BY GOVERNMENT
|
8
|
-
AGENCY, IS AN INTENDED THIRD-PARTY BENEFICIARY OF ALL SUBSEQUENT
|
9
|
-
DISTRIBUTIONS OR REDISTRIBUTIONS OF THE SUBJECT SOFTWARE. ANYONE WHO
|
10
|
-
USES, REPRODUCES, DISTRIBUTES, MODIFIES OR REDISTRIBUTES THE SUBJECT
|
11
|
-
SOFTWARE, AS DEFINED HEREIN, OR ANY PART THEREOF, IS, BY THAT ACTION,
|
12
|
-
ACCEPTING IN FULL THE RESPONSIBILITIES AND OBLIGATIONS CONTAINED IN
|
13
|
-
THIS AGREEMENT.
|
3
|
+
NASA OPEN SOURCE AGREEMENT VERSION 1.3
|
14
4
|
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
5
|
+
THIS OPEN SOURCE AGREEMENT ("AGREEMENT") DEFINES THE RIGHTS OF USE,
|
6
|
+
REPRODUCTION, DISTRIBUTION, MODIFICATION AND REDISTRIBUTION OF CERTAIN
|
7
|
+
COMPUTER SOFTWARE ORIGINALLY RELEASED BY THE UNITED STATES GOVERNMENT
|
8
|
+
AS REPRESENTED BY THE GOVERNMENT AGENCY LISTED BELOW ("GOVERNMENT
|
9
|
+
AGENCY"). THE UNITED STATES GOVERNMENT, AS REPRESENTED BY GOVERNMENT
|
10
|
+
AGENCY, IS AN INTENDED THIRD-PARTY BENEFICIARY OF ALL SUBSEQUENT
|
11
|
+
DISTRIBUTIONS OR REDISTRIBUTIONS OF THE SUBJECT SOFTWARE. ANYONE WHO
|
12
|
+
USES, REPRODUCES, DISTRIBUTES, MODIFIES OR REDISTRIBUTES THE SUBJECT
|
13
|
+
SOFTWARE, AS DEFINED HEREIN, OR ANY PART THEREOF, IS, BY THAT ACTION,
|
14
|
+
ACCEPTING IN FULL THE RESPONSIBILITIES AND OBLIGATIONS CONTAINED IN
|
15
|
+
THIS AGREEMENT.
|
20
16
|
|
21
|
-
|
17
|
+
Government Agency: NASA Langley Research Center
|
18
|
+
Government Agency Original Software Designation: LAR-17081-1
|
19
|
+
Government Agency Original Software Title: fUnit
|
20
|
+
User Registration Requested: please see clause 3.F.
|
21
|
+
Government Agency Point of Contact: funit-support@rubyforge.org
|
22
22
|
|
23
|
-
|
24
|
-
Original Software, and any entity that makes a Modification.
|
23
|
+
1. DEFINITIONS
|
25
24
|
|
26
|
-
|
27
|
-
|
28
|
-
alone or when combined with the Subject Software.
|
25
|
+
A. "Contributor" means Government Agency, as the developer of the
|
26
|
+
Original Software, and any entity that makes a Modification.
|
29
27
|
|
30
|
-
|
31
|
-
|
28
|
+
B. "Covered Patents" mean patent claims licensable by a Contributor
|
29
|
+
that are necessarily infringed by the use or sale of its Modification
|
30
|
+
alone or when combined with the Subject Software.
|
32
31
|
|
33
|
-
|
34
|
-
|
32
|
+
C. "Display" means the showing of a copy of the Subject Software,
|
33
|
+
either directly or by means of an image, or any other device.
|
35
34
|
|
36
|
-
|
37
|
-
Software,
|
38
|
-
Software that is not governed by the terms of this Agreement.
|
35
|
+
D. "Distribution" means conveyance or transfer of the Subject
|
36
|
+
Software, regardless of means, to another.
|
39
37
|
|
40
|
-
|
41
|
-
|
42
|
-
Software
|
43
|
-
term is defined in the Copyright Statute, 17 USC 101. However, the
|
44
|
-
act of including Subject Software as part of a Larger Work does not in
|
45
|
-
and of itself constitute a Modification.
|
38
|
+
E. "Larger Work" means computer software that combines Subject
|
39
|
+
Software, or portions thereof, with software separate from the Subject
|
40
|
+
Software that is not governed by the terms of this Agreement.
|
46
41
|
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
42
|
+
F. "Modification" means any alteration of, including addition to or
|
43
|
+
deletion from, the substance or structure of either the Original
|
44
|
+
Software or Subject Software, and includes derivative works, as that
|
45
|
+
term is defined in the Copyright Statute, 17 USC 101. However, the
|
46
|
+
act of including Subject Software as part of a Larger Work does not in
|
47
|
+
and of itself constitute a Modification.
|
51
48
|
|
52
|
-
|
53
|
-
this Agreement
|
49
|
+
G. "Original Software" means the computer software first released
|
50
|
+
under this Agreement by Government Agency with Government Agency
|
51
|
+
designation NASA and entitled fUnit, including source code,
|
52
|
+
object code and accompanying documentation, if any.
|
54
53
|
|
55
|
-
|
56
|
-
|
54
|
+
H. "Recipient" means anyone who acquires the Subject Software under
|
55
|
+
this Agreement, including all Contributors.
|
57
56
|
|
58
|
-
|
59
|
-
|
57
|
+
I. "Redistribution" means Distribution of the Subject Software after a
|
58
|
+
Modification has been made.
|
60
59
|
|
61
|
-
|
62
|
-
|
60
|
+
J. "Reproduction" means the making of a counterpart, image or copy of
|
61
|
+
the Subject Software.
|
63
62
|
|
64
|
-
|
65
|
-
|
63
|
+
K. "Sale" means the exchange of the Subject Software for money or
|
64
|
+
equivalent value.
|
66
65
|
|
67
|
-
|
68
|
-
|
66
|
+
L. "Subject Software" means the Original Software, Modifications, or
|
67
|
+
any respective parts thereof.
|
69
68
|
|
70
|
-
|
69
|
+
M. "Use" means the application or employment of the Subject Software
|
70
|
+
for any purpose.
|
71
71
|
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
72
|
+
2. GRANT OF RIGHTS
|
73
|
+
|
74
|
+
A. Under Non-Patent Rights: Subject to the terms and conditions of
|
75
|
+
this Agreement, each Contributor, with respect to its own contribution
|
76
|
+
to the Subject Software, hereby grants to each Recipient a
|
77
|
+
non-exclusive, world-wide, royalty-free license to engage in the
|
78
|
+
following activities pertaining to the Subject Software:
|
77
79
|
|
78
80
|
1. Use
|
79
81
|
2. Distribution
|
@@ -82,11 +84,11 @@ following activities pertaining to the Subject Software:
|
|
82
84
|
5. Redistribution
|
83
85
|
6. Display
|
84
86
|
|
85
|
-
B. Under Patent Rights: Subject to the terms and conditions of this
|
86
|
-
Agreement, each Contributor, with respect to its own contribution to
|
87
|
-
the Subject Software, hereby grants to each Recipient under Covered
|
88
|
-
Patents a non-exclusive, world-wide, royalty-free license to engage in
|
89
|
-
the following activities pertaining to the Subject Software:
|
87
|
+
B. Under Patent Rights: Subject to the terms and conditions of this
|
88
|
+
Agreement, each Contributor, with respect to its own contribution to
|
89
|
+
the Subject Software, hereby grants to each Recipient under Covered
|
90
|
+
Patents a non-exclusive, world-wide, royalty-free license to engage in
|
91
|
+
the following activities pertaining to the Subject Software:
|
90
92
|
|
91
93
|
1. Use
|
92
94
|
2. Distribution
|
@@ -94,169 +96,169 @@ the following activities pertaining to the Subject Software:
|
|
94
96
|
4. Sale
|
95
97
|
5. Offer for Sale
|
96
98
|
|
97
|
-
C. The rights granted under Paragraph B. also apply to the combination
|
98
|
-
of a Contributor's Modification and the Subject Software if, at the
|
99
|
-
time the Modification is added by the Contributor, the addition of
|
100
|
-
such Modification causes the combination to be covered by the Covered
|
101
|
-
Patents. It does not apply to any other combinations that include a
|
102
|
-
Modification.
|
99
|
+
C. The rights granted under Paragraph B. also apply to the combination
|
100
|
+
of a Contributor's Modification and the Subject Software if, at the
|
101
|
+
time the Modification is added by the Contributor, the addition of
|
102
|
+
such Modification causes the combination to be covered by the Covered
|
103
|
+
Patents. It does not apply to any other combinations that include a
|
104
|
+
Modification.
|
103
105
|
|
104
|
-
D. The rights granted in Paragraphs A. and B. allow the Recipient to
|
105
|
-
sublicense those same rights. Such sublicense must be under the same
|
106
|
-
terms and conditions of this Agreement.
|
106
|
+
D. The rights granted in Paragraphs A. and B. allow the Recipient to
|
107
|
+
sublicense those same rights. Such sublicense must be under the same
|
108
|
+
terms and conditions of this Agreement.
|
107
109
|
|
108
|
-
3. OBLIGATIONS OF RECIPIENT
|
110
|
+
3. OBLIGATIONS OF RECIPIENT
|
109
111
|
|
110
|
-
A. Distribution or Redistribution of the Subject Software must be made
|
111
|
-
under this Agreement except for additions covered under paragraph 3H.
|
112
|
+
A. Distribution or Redistribution of the Subject Software must be made
|
113
|
+
under this Agreement except for additions covered under paragraph 3H.
|
112
114
|
|
113
|
-
1. Whenever a Recipient distributes or redistributes the Subject
|
114
|
-
|
115
|
-
|
115
|
+
1. Whenever a Recipient distributes or redistributes the Subject
|
116
|
+
Software, a copy of this Agreement must be included with each copy
|
117
|
+
of the Subject Software; and
|
116
118
|
|
117
|
-
2. If Recipient distributes or redistributes the Subject Software in
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
119
|
+
2. If Recipient distributes or redistributes the Subject Software in
|
120
|
+
any form other than source code, Recipient must also make the
|
121
|
+
source code freely available, and must provide with each copy of
|
122
|
+
the Subject Software information on how to obtain the source code
|
123
|
+
in a reasonable manner on or through a medium customarily used for
|
124
|
+
software exchange.
|
123
125
|
|
124
|
-
B. Each Recipient must ensure that the following copyright notice
|
125
|
-
appears prominently in the Subject Software:
|
126
|
+
B. Each Recipient must ensure that the following copyright notice
|
127
|
+
appears prominently in the Subject Software:
|
126
128
|
|
127
129
|
Copyright 2006 United States Government as represented by
|
128
130
|
NASA Langley Research Center. No copyright is claimed in
|
129
131
|
the United States under Title 17, U.S. Code. All Other Rights
|
130
132
|
Reserved.
|
131
133
|
|
132
|
-
C. Each Contributor must characterize its alteration of the Subject
|
133
|
-
Software as a Modification and must identify itself as the originator
|
134
|
-
of its Modification in a manner that reasonably allows subsequent
|
135
|
-
Recipients to identify the originator of the Modification. In
|
136
|
-
fulfillment of these requirements, Contributor must include a file
|
137
|
-
(e.g., a change log file) that describes the alterations made and the
|
138
|
-
date of the alterations, identifies Contributor as originator of the
|
139
|
-
alterations, and consents to characterization of the alterations as a
|
140
|
-
Modification, for example, by including a statement that the
|
141
|
-
Modification is derived, directly or indirectly, from Original
|
142
|
-
Software provided by Government Agency. Once consent is granted, it
|
143
|
-
may not thereafter be revoked.
|
144
|
-
|
145
|
-
D. A Contributor may add its own copyright notice to the Subject
|
146
|
-
Software. Once a copyright notice has been added to the Subject
|
147
|
-
Software, a Recipient may not remove it without the express permission
|
148
|
-
of the Contributor who added the notice.
|
149
|
-
|
150
|
-
E. A Recipient may not make any representation in the Subject Software
|
151
|
-
or in any promotional, advertising or other material that may be
|
152
|
-
construed as an endorsement by Government Agency or by any prior
|
153
|
-
Recipient of any product or service provided by Recipient, or that may
|
154
|
-
seek to obtain commercial advantage by the fact of Government Agency's
|
155
|
-
or a prior Recipient's participation in this Agreement.
|
156
|
-
|
157
|
-
F. In an effort to track usage and maintain accurate records of the
|
158
|
-
Subject Software, each Recipient, upon receipt of the Subject Software,
|
159
|
-
is requested to provide Government Agency, by e-mail to the Government
|
160
|
-
Agency Point of Contact listed in clause 5.F., the following information:
|
161
|
-
name, institution (if applicable), postal code, and country.
|
162
|
-
Recipient's name and personal information shall be used for statistical
|
163
|
-
purposes only. Once a Recipient makes a Modification available, it is
|
164
|
-
requested that the Recipient inform Government Agency, by e-mail to the
|
165
|
-
Government Agency Point of Contact listed in clause 5.F., how to
|
166
|
-
access the Modification.
|
167
|
-
|
168
|
-
G. Each Contributor represents that that its Modification is believed
|
169
|
-
to be Contributor's original creation and does not violate any
|
170
|
-
existing agreements, regulations, statutes or rules, and further that
|
171
|
-
Contributor has sufficient rights to grant the rights conveyed by this
|
172
|
-
Agreement.
|
173
|
-
|
174
|
-
H. A Recipient may choose to offer, and to charge a fee for, warranty,
|
175
|
-
support, indemnity and/or liability obligations to one or more other
|
176
|
-
Recipients of the Subject Software. A Recipient may do so, however,
|
177
|
-
only on its own behalf and not on behalf of Government Agency or any
|
178
|
-
other Recipient. Such a Recipient must make it absolutely clear that
|
179
|
-
any such warranty, support, indemnity and/or liability obligation is
|
180
|
-
offered by that Recipient alone. Further, such Recipient agrees to
|
181
|
-
indemnify Government Agency and every other Recipient for any
|
182
|
-
liability incurred by them as a result of warranty, support, indemnity
|
183
|
-
and/or liability offered by such Recipient.
|
184
|
-
|
185
|
-
I. A Recipient may create a Larger Work by combining Subject Software
|
186
|
-
with separate software not governed by the terms of this agreement and
|
187
|
-
distribute the Larger Work as a single product. In such case, the
|
188
|
-
Recipient must make sure Subject Software, or portions thereof,
|
189
|
-
included in the Larger Work is subject to this Agreement.
|
190
|
-
|
191
|
-
J. Notwithstanding any provisions contained herein, Recipient is
|
192
|
-
hereby put on notice that export of any goods or technical data from
|
193
|
-
the United States may require some form of export license from the
|
194
|
-
U.S. Government. Failure to obtain necessary export licenses may
|
195
|
-
result in criminal liability under U.S. laws. Government Agency
|
196
|
-
neither represents that a license shall not be required nor that, if
|
197
|
-
required, it shall be issued. Nothing granted herein provides any
|
198
|
-
such export license.
|
199
|
-
|
200
|
-
4. DISCLAIMER OF WARRANTIES AND LIABILITIES; WAIVER AND INDEMNIFICATION
|
201
|
-
|
202
|
-
A. No Warranty: THE SUBJECT SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY
|
203
|
-
WARRANTY OF ANY KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY,
|
204
|
-
INCLUDING, BUT NOT LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE
|
205
|
-
WILL CONFORM TO SPECIFICATIONS, ANY IMPLIED WARRANTIES OF
|
206
|
-
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR FREEDOM FROM
|
207
|
-
INFRINGEMENT, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL BE ERROR
|
208
|
-
FREE, OR ANY WARRANTY THAT DOCUMENTATION, IF PROVIDED, WILL CONFORM TO
|
209
|
-
THE SUBJECT SOFTWARE. THIS AGREEMENT DOES NOT, IN ANY MANNER,
|
210
|
-
CONSTITUTE AN ENDORSEMENT BY GOVERNMENT AGENCY OR ANY PRIOR RECIPIENT
|
211
|
-
OF ANY RESULTS, RESULTING DESIGNS, HARDWARE, SOFTWARE PRODUCTS OR ANY
|
212
|
-
OTHER APPLICATIONS RESULTING FROM USE OF THE SUBJECT SOFTWARE.
|
213
|
-
FURTHER, GOVERNMENT AGENCY DISCLAIMS ALL WARRANTIES AND LIABILITIES
|
214
|
-
REGARDING THIRD-PARTY SOFTWARE, IF PRESENT IN THE ORIGINAL SOFTWARE,
|
215
|
-
AND DISTRIBUTES IT "AS IS."
|
216
|
-
|
217
|
-
B. Waiver and Indemnity: RECIPIENT AGREES TO WAIVE ANY AND ALL CLAIMS
|
218
|
-
AGAINST THE UNITED STATES GOVERNMENT, ITS CONTRACTORS AND
|
219
|
-
SUBCONTRACTORS, AS WELL AS ANY PRIOR RECIPIENT. IF RECIPIENT'S USE OF
|
220
|
-
THE SUBJECT SOFTWARE RESULTS IN ANY LIABILITIES, DEMANDS, DAMAGES,
|
221
|
-
EXPENSES OR LOSSES ARISING FROM SUCH USE, INCLUDING ANY DAMAGES FROM
|
222
|
-
PRODUCTS BASED ON, OR RESULTING FROM, RECIPIENT'S USE OF THE SUBJECT
|
223
|
-
SOFTWARE, RECIPIENT SHALL INDEMNIFY AND HOLD HARMLESS THE UNITED
|
224
|
-
STATES GOVERNMENT, ITS CONTRACTORS AND SUBCONTRACTORS, AS WELL AS ANY
|
225
|
-
PRIOR RECIPIENT, TO THE EXTENT PERMITTED BY LAW. RECIPIENT'S SOLE
|
226
|
-
REMEDY FOR ANY SUCH MATTER SHALL BE THE IMMEDIATE, UNILATERAL
|
227
|
-
TERMINATION OF THIS AGREEMENT.
|
228
|
-
|
229
|
-
|
230
|
-
5. GENERAL TERMS
|
231
|
-
|
232
|
-
A. Termination: This Agreement and the rights granted hereunder will
|
233
|
-
terminate automatically if a Recipient fails to comply with these
|
234
|
-
terms and conditions, and fails to cure such noncompliance within
|
235
|
-
thirty (30) days of becoming aware of such noncompliance. Upon
|
236
|
-
termination, a Recipient agrees to immediately cease use and
|
237
|
-
distribution of the Subject Software. All sublicenses to the Subject
|
238
|
-
Software properly granted by the breaching Recipient shall survive any
|
239
|
-
such termination of this Agreement.
|
240
|
-
|
241
|
-
B. Severability: If any provision of this Agreement is invalid or
|
242
|
-
unenforceable under applicable law, it shall not affect the validity
|
243
|
-
or enforceability of the remainder of the terms of this Agreement.
|
244
|
-
|
245
|
-
C. Applicable Law: This Agreement shall be subject to United States
|
246
|
-
federal law only for all purposes, including, but not limited to,
|
247
|
-
determining the validity of this Agreement, the meaning of its
|
248
|
-
provisions and the rights, obligations and remedies of the parties.
|
249
|
-
|
250
|
-
D. Entire Understanding: This Agreement constitutes the entire
|
251
|
-
understanding and agreement of the parties relating to release of the
|
252
|
-
Subject Software and may not be superseded, modified or amended except
|
253
|
-
by further written agreement duly executed by the parties.
|
254
|
-
|
255
|
-
E. Binding Authority: By accepting and using the Subject Software
|
256
|
-
under this Agreement, a Recipient affirms its authority to bind the
|
257
|
-
Recipient to all terms and conditions of this Agreement and that that
|
258
|
-
Recipient hereby agrees to all terms and conditions herein.
|
259
|
-
|
260
|
-
F. Point of Contact: Any Recipient contact with Government Agency is
|
261
|
-
to be directed to the designated representative as follows:
|
262
|
-
funit-support@rubyforge.org.
|
134
|
+
C. Each Contributor must characterize its alteration of the Subject
|
135
|
+
Software as a Modification and must identify itself as the originator
|
136
|
+
of its Modification in a manner that reasonably allows subsequent
|
137
|
+
Recipients to identify the originator of the Modification. In
|
138
|
+
fulfillment of these requirements, Contributor must include a file
|
139
|
+
(e.g., a change log file) that describes the alterations made and the
|
140
|
+
date of the alterations, identifies Contributor as originator of the
|
141
|
+
alterations, and consents to characterization of the alterations as a
|
142
|
+
Modification, for example, by including a statement that the
|
143
|
+
Modification is derived, directly or indirectly, from Original
|
144
|
+
Software provided by Government Agency. Once consent is granted, it
|
145
|
+
may not thereafter be revoked.
|
146
|
+
|
147
|
+
D. A Contributor may add its own copyright notice to the Subject
|
148
|
+
Software. Once a copyright notice has been added to the Subject
|
149
|
+
Software, a Recipient may not remove it without the express permission
|
150
|
+
of the Contributor who added the notice.
|
151
|
+
|
152
|
+
E. A Recipient may not make any representation in the Subject Software
|
153
|
+
or in any promotional, advertising or other material that may be
|
154
|
+
construed as an endorsement by Government Agency or by any prior
|
155
|
+
Recipient of any product or service provided by Recipient, or that may
|
156
|
+
seek to obtain commercial advantage by the fact of Government Agency's
|
157
|
+
or a prior Recipient's participation in this Agreement.
|
158
|
+
|
159
|
+
F. In an effort to track usage and maintain accurate records of the
|
160
|
+
Subject Software, each Recipient, upon receipt of the Subject Software,
|
161
|
+
is requested to provide Government Agency, by e-mail to the Government
|
162
|
+
Agency Point of Contact listed in clause 5.F., the following information:
|
163
|
+
name, institution (if applicable), postal code, and country.
|
164
|
+
Recipient's name and personal information shall be used for statistical
|
165
|
+
purposes only. Once a Recipient makes a Modification available, it is
|
166
|
+
requested that the Recipient inform Government Agency, by e-mail to the
|
167
|
+
Government Agency Point of Contact listed in clause 5.F., how to
|
168
|
+
access the Modification.
|
169
|
+
|
170
|
+
G. Each Contributor represents that that its Modification is believed
|
171
|
+
to be Contributor's original creation and does not violate any
|
172
|
+
existing agreements, regulations, statutes or rules, and further that
|
173
|
+
Contributor has sufficient rights to grant the rights conveyed by this
|
174
|
+
Agreement.
|
175
|
+
|
176
|
+
H. A Recipient may choose to offer, and to charge a fee for, warranty,
|
177
|
+
support, indemnity and/or liability obligations to one or more other
|
178
|
+
Recipients of the Subject Software. A Recipient may do so, however,
|
179
|
+
only on its own behalf and not on behalf of Government Agency or any
|
180
|
+
other Recipient. Such a Recipient must make it absolutely clear that
|
181
|
+
any such warranty, support, indemnity and/or liability obligation is
|
182
|
+
offered by that Recipient alone. Further, such Recipient agrees to
|
183
|
+
indemnify Government Agency and every other Recipient for any
|
184
|
+
liability incurred by them as a result of warranty, support, indemnity
|
185
|
+
and/or liability offered by such Recipient.
|
186
|
+
|
187
|
+
I. A Recipient may create a Larger Work by combining Subject Software
|
188
|
+
with separate software not governed by the terms of this agreement and
|
189
|
+
distribute the Larger Work as a single product. In such case, the
|
190
|
+
Recipient must make sure Subject Software, or portions thereof,
|
191
|
+
included in the Larger Work is subject to this Agreement.
|
192
|
+
|
193
|
+
J. Notwithstanding any provisions contained herein, Recipient is
|
194
|
+
hereby put on notice that export of any goods or technical data from
|
195
|
+
the United States may require some form of export license from the
|
196
|
+
U.S. Government. Failure to obtain necessary export licenses may
|
197
|
+
result in criminal liability under U.S. laws. Government Agency
|
198
|
+
neither represents that a license shall not be required nor that, if
|
199
|
+
required, it shall be issued. Nothing granted herein provides any
|
200
|
+
such export license.
|
201
|
+
|
202
|
+
4. DISCLAIMER OF WARRANTIES AND LIABILITIES; WAIVER AND INDEMNIFICATION
|
203
|
+
|
204
|
+
A. No Warranty: THE SUBJECT SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY
|
205
|
+
WARRANTY OF ANY KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY,
|
206
|
+
INCLUDING, BUT NOT LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE
|
207
|
+
WILL CONFORM TO SPECIFICATIONS, ANY IMPLIED WARRANTIES OF
|
208
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR FREEDOM FROM
|
209
|
+
INFRINGEMENT, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL BE ERROR
|
210
|
+
FREE, OR ANY WARRANTY THAT DOCUMENTATION, IF PROVIDED, WILL CONFORM TO
|
211
|
+
THE SUBJECT SOFTWARE. THIS AGREEMENT DOES NOT, IN ANY MANNER,
|
212
|
+
CONSTITUTE AN ENDORSEMENT BY GOVERNMENT AGENCY OR ANY PRIOR RECIPIENT
|
213
|
+
OF ANY RESULTS, RESULTING DESIGNS, HARDWARE, SOFTWARE PRODUCTS OR ANY
|
214
|
+
OTHER APPLICATIONS RESULTING FROM USE OF THE SUBJECT SOFTWARE.
|
215
|
+
FURTHER, GOVERNMENT AGENCY DISCLAIMS ALL WARRANTIES AND LIABILITIES
|
216
|
+
REGARDING THIRD-PARTY SOFTWARE, IF PRESENT IN THE ORIGINAL SOFTWARE,
|
217
|
+
AND DISTRIBUTES IT "AS IS."
|
218
|
+
|
219
|
+
B. Waiver and Indemnity: RECIPIENT AGREES TO WAIVE ANY AND ALL CLAIMS
|
220
|
+
AGAINST THE UNITED STATES GOVERNMENT, ITS CONTRACTORS AND
|
221
|
+
SUBCONTRACTORS, AS WELL AS ANY PRIOR RECIPIENT. IF RECIPIENT'S USE OF
|
222
|
+
THE SUBJECT SOFTWARE RESULTS IN ANY LIABILITIES, DEMANDS, DAMAGES,
|
223
|
+
EXPENSES OR LOSSES ARISING FROM SUCH USE, INCLUDING ANY DAMAGES FROM
|
224
|
+
PRODUCTS BASED ON, OR RESULTING FROM, RECIPIENT'S USE OF THE SUBJECT
|
225
|
+
SOFTWARE, RECIPIENT SHALL INDEMNIFY AND HOLD HARMLESS THE UNITED
|
226
|
+
STATES GOVERNMENT, ITS CONTRACTORS AND SUBCONTRACTORS, AS WELL AS ANY
|
227
|
+
PRIOR RECIPIENT, TO THE EXTENT PERMITTED BY LAW. RECIPIENT'S SOLE
|
228
|
+
REMEDY FOR ANY SUCH MATTER SHALL BE THE IMMEDIATE, UNILATERAL
|
229
|
+
TERMINATION OF THIS AGREEMENT.
|
230
|
+
|
231
|
+
|
232
|
+
5. GENERAL TERMS
|
233
|
+
|
234
|
+
A. Termination: This Agreement and the rights granted hereunder will
|
235
|
+
terminate automatically if a Recipient fails to comply with these
|
236
|
+
terms and conditions, and fails to cure such noncompliance within
|
237
|
+
thirty (30) days of becoming aware of such noncompliance. Upon
|
238
|
+
termination, a Recipient agrees to immediately cease use and
|
239
|
+
distribution of the Subject Software. All sublicenses to the Subject
|
240
|
+
Software properly granted by the breaching Recipient shall survive any
|
241
|
+
such termination of this Agreement.
|
242
|
+
|
243
|
+
B. Severability: If any provision of this Agreement is invalid or
|
244
|
+
unenforceable under applicable law, it shall not affect the validity
|
245
|
+
or enforceability of the remainder of the terms of this Agreement.
|
246
|
+
|
247
|
+
C. Applicable Law: This Agreement shall be subject to United States
|
248
|
+
federal law only for all purposes, including, but not limited to,
|
249
|
+
determining the validity of this Agreement, the meaning of its
|
250
|
+
provisions and the rights, obligations and remedies of the parties.
|
251
|
+
|
252
|
+
D. Entire Understanding: This Agreement constitutes the entire
|
253
|
+
understanding and agreement of the parties relating to release of the
|
254
|
+
Subject Software and may not be superseded, modified or amended except
|
255
|
+
by further written agreement duly executed by the parties.
|
256
|
+
|
257
|
+
E. Binding Authority: By accepting and using the Subject Software
|
258
|
+
under this Agreement, a Recipient affirms its authority to bind the
|
259
|
+
Recipient to all terms and conditions of this Agreement and that that
|
260
|
+
Recipient hereby agrees to all terms and conditions herein.
|
261
|
+
|
262
|
+
F. Point of Contact: Any Recipient contact with Government Agency is
|
263
|
+
to be directed to the designated representative as follows:
|
264
|
+
funit-support@rubyforge.org.
|
data/README
CHANGED
@@ -1,27 +1,132 @@
|
|
1
1
|
= FUnit: a Fortran Unit Testing Framework
|
2
2
|
|
3
|
-
FUnit is a unit testing
|
3
|
+
FUnit is a {unit testing}[http://en.wikipedia.org/wiki/Unit_testing]
|
4
|
+
framework for Fortran modules.
|
5
|
+
|
4
6
|
Unit tests are written in Fortran fragments that use a small
|
5
|
-
set of testing-specific
|
6
|
-
fragments into valid Fortran code and compiles,
|
7
|
-
|
8
|
-
|
9
|
-
|
7
|
+
set of testing-specific keywords and functions. FUnit transforms
|
8
|
+
these fragments into valid Fortran code and compiles, links, and
|
9
|
+
runs them against the module under test.
|
10
|
+
|
11
|
+
FUnit is
|
12
|
+
{opinionated software}[http://www.oreillynet.com/pub/a/network/2005/08/30/ruby-rails-david-heinemeier-hansson.html]
|
13
|
+
which values convention over configuration.
|
14
|
+
Specifically, fUnit requires a Fortran 95 compiler,
|
15
|
+
it only supports testing routines contained in modules,
|
16
|
+
it requires tests to be stored along side the code under test,
|
17
|
+
and it requires that you follow a specific naming rule
|
18
|
+
for test files.
|
19
|
+
|
20
|
+
* Documentation: http://funit.rubyforge.org
|
21
|
+
* Project Page: http://rubyforge.org/projects/funit
|
22
|
+
|
23
|
+
== Requirements
|
10
24
|
|
11
25
|
1. A Fortran 90/95/2003 compiler (set via F9X environment variable)
|
12
|
-
2. {The Ruby language}[http://www.ruby-lang.org/]
|
13
|
-
|
26
|
+
2. {The Ruby language}[http://www.ruby-lang.org/] with the
|
27
|
+
{RubyGems package manager}[http://rubyforge.org/projects/rubygems/]
|
14
28
|
|
15
29
|
== Installation
|
16
30
|
|
17
31
|
gem install funit
|
18
32
|
|
33
|
+
== Example
|
34
|
+
|
35
|
+
Suppose you have a module in <tt>gas_physics.f90</tt> that
|
36
|
+
contains a routine that returns viscosity as a function of
|
37
|
+
temperature,
|
38
|
+
|
39
|
+
module gas_physics
|
40
|
+
..
|
41
|
+
contains
|
42
|
+
..
|
43
|
+
function viscosity(temperature)
|
44
|
+
real :: viscosity, temperature
|
45
|
+
viscosity = 2.0e-3 * temperature**1.5
|
46
|
+
end function
|
47
|
+
..
|
48
|
+
end module
|
49
|
+
|
50
|
+
The tests of this module would be contained in <tt>gas_physicsMT.ftk</tt>,
|
51
|
+
and might contain a test like,
|
52
|
+
|
53
|
+
..
|
54
|
+
beginTest viscosity_varies_as_temperature
|
55
|
+
IsRealEqual( 0.0, viscosity(0.0) )
|
56
|
+
IsEqualWithin( 0.7071, viscosity(50.0), 1e-3 )
|
57
|
+
endTest
|
58
|
+
..
|
59
|
+
|
60
|
+
This brief fragment is all you need, the framework provides
|
61
|
+
the rest of the trappings to turn this into valid Fortran code.
|
62
|
+
|
63
|
+
You would run the tests for the <tt>gas_physics</tt> module
|
64
|
+
with the command,
|
65
|
+
|
66
|
+
funit gas_physics
|
67
|
+
|
68
|
+
which would transform your fragments contained in <tt>gas_physicsMT.ftk</tt>
|
69
|
+
into valid Fortran code, create a test runner program, compile everything,
|
70
|
+
and run the tests. A sample output would look like,
|
71
|
+
|
72
|
+
parsing gas_physicsMT.ftk
|
73
|
+
computing dependencies
|
74
|
+
locating associated source files and sorting for compilation
|
75
|
+
g95 -o TestRunner
|
76
|
+
gas_physics.f90 \
|
77
|
+
gas_physicsMT.f90 \
|
78
|
+
TestRunner.f90
|
79
|
+
|
80
|
+
gas_physics test suite:
|
81
|
+
Passed 2 of 2 possible asserts comprising 1 of 1 tests.
|
82
|
+
|
83
|
+
== Support
|
84
|
+
|
85
|
+
Send email to funit-support@rubyforge.org or submit a request
|
86
|
+
through http://rubyforge.org/tracker/?group_id=1416.
|
87
|
+
|
88
|
+
== License
|
89
|
+
|
90
|
+
FUnit is released under the NASA Open Source Agreement, which
|
91
|
+
requests registration. If you would like to register, send
|
92
|
+
an email to funit-support@rubyforge.org with your name, institution
|
93
|
+
(if applicable), city, postal code, and country.
|
94
|
+
See COPYING[http://funit.rubyforge.org/files/COPYING.html] for details.
|
95
|
+
|
96
|
+
== A Brief History
|
97
|
+
|
98
|
+
On October 4, 2001, Mike Hill (then of
|
99
|
+
{Object Mentor}[http://www.objectmentor.com/], now of
|
100
|
+
{Industrial Logic}[http://www.industriallogic.com])
|
101
|
+
visited NASA Langley Research Center in Hampton, Virginia
|
102
|
+
and gave a test-first design talk at Institute for Computer
|
103
|
+
and Applied Sciences and Engineering (ICASE). Copies of his
|
104
|
+
slides are available at
|
105
|
+
{icase.edu/series/MPP}[http://www.icase.edu/series/MPP/].
|
106
|
+
|
107
|
+
Mike spent the afternoon with Bil Kleb, Bill Wood, Karen Bibb,
|
108
|
+
and Mike Park reasoning out how we might create a testing framework
|
109
|
+
for Fortran 90 to use during FUN3D[http://fun3d.larc.nasa.gov]
|
110
|
+
code development. By the end of the afternoon we had a working
|
111
|
+
protoype based on the macro expansion techniques employed in
|
112
|
+
Mike Hill's cpptestkit[http://sourceforge.net/projects/cpptestkit].
|
113
|
+
We quickly found C-preprocessor macros to be to restrictive and
|
114
|
+
rewrote the framework in Ruby[http:www.ruby-lang.org].
|
115
|
+
|
19
116
|
== To Do
|
20
117
|
|
21
|
-
* Make tests
|
22
|
-
*
|
23
|
-
* Change from CamelCase to snake_case.
|
118
|
+
* Make tests fail gracefully if Fortran compiler is not found.
|
119
|
+
* Complete migration rom CamelCase to snake_case for methods and variables.
|
24
120
|
* Use 'test' keyword instead of 'beginTest' business.
|
121
|
+
* Don't add to test name during translation to avoid 32 character limit trouble.
|
122
|
+
* Rename assertions to more consistent with other xUnits.
|
123
|
+
* Add assertions to capture stops and warning messages.
|
25
124
|
* Clean up documentation.
|
26
125
|
* To increase portability, create a single, stand-alone executable with
|
27
126
|
Erik Veenstra's RubyScript2Exe[http://www.erikveen.dds.nl/rubyscript2exe/].
|
127
|
+
* Use a makefile instead of a single, ordered command line for compilation.
|
128
|
+
* Add a clean option to remove all generated artifacts.
|
129
|
+
* Migrate to a new naming convention?
|
130
|
+
E.g., gas_physics.fun -> gas_physics_fun.f90
|
131
|
+
* Change Fortran envinoment variable from <tt>F9X</tt> to GNU-standard
|
132
|
+
<tt>FC</tt>.
|