content.txt
2.06 KB
!2 !-DoFixture-!:
!3 ''keywords''
* Actions start with a ''keyword'' and appear in every second cell.
* A ''keyword'' cell can be empty.
* The last ''keyword'' is optional.
* A ''keyword'' can contain any characters, such as "+"
!3 Special actions
!-DoFixture-! has several special actions, which apply to the rest of their row:
* ''check'' checks whether the result of the action in the rest of the row matches the value in the last cell of the row. That last cell is colored green, red, etc accordingly.
* ''reject'' checks that the action fails, as expected.
* ''not'' acts the same as ''reject''.
* ''ensure'' checks that the action succeeds.
* ''show'' displays the result of the action in the rest of the row by adding an extra cell in the report.
* ''show dot'' displays the result of the action in the rest of the row by adding an extra cell in the report. This is shown as a Dot graph.
* ''note'' ignores the rest of the row, allowing notes to be included in tables
* ''comment'' ignores the rest of the table
* ''ignored'' ignores the rest of the table, but colours it as ignored in the report
* ''abandon storytest'' to ignore the rest of the storytest (without colouring it as ignored)
!3 Flow Style
To be in "flow", the first table must be a ''!-DoFixture-!'' (or ''!-SequenceFixture-!''). The actions in all following tables are carried out with that fixture. However, as we saw before, an action may provide a different fixture, such as a ''!-RowFixture-!'', which will be used with the rest of the table.
!3 More Examples
Lots more examples of using !-DoFixture-! and the other flow fixtures are provided in ''Fit for Developing Software'' by Rick Mugridge and Ward Cunningham, Prentice-Hall, 2005. The tables and fixture code for these examples will be made available on the [[Fit website][http://fit.w2.com]].
!3 Fixture Code
Let's now look at WritingFixtures for !-DoFixture-! tables.
!3 More Technical Issues
SpecialisedIssues
---- * ''Copyright (c) 2004, 2005 Rick Mugridge, Rimu Research.''
* ''Released under the terms of the GNU General Public License version 2 or later.''