Installation
Before you install cfcUnit, you must be running CFMX 6.1 and the Mach-II (1.0.9) application framework. Due to the number of bug fixes and enhancements with components provided in CFMX 6.1, prior versions will not work. If you do have CFMX but not 6.1, it is a free upgrate. Currenly, Mach-II is being used as the foundation for the test runner UIs, so that must also be installed. Right now, cfcUnit is known to run on version 1.0.9 and up, but it is probably best to use the latest release.
The cfcUnit distribution is made up of two parts:
- core cfcUnit library components (/org/cfcunit/)
- Mach-II application files (/cfcunit/)
To deploy cfcUnit, simply unpack the zip file into the webroot. That's it.
If the cfcUnit files have been successfully deployed, you should be able to go right into your browser and open a new test runner. This document assumes that the web site is available at http://localhost. The test runner application can be found at http://localhost/cfcunit. Once you have the test runner up, you want to test the core framework files to make sure they are all working properly. To run the tests, enter "org.cfcunit.tests.AllTests" into the "Test Class" text field.
There is a text version of the test runner as well as an html version. The Text Runner will tell you if a test passes or fails, but little else. The HTML Runner on the other hand give much more information about each test's success or failure. Select one or the other and click the button labeled "Run Test". If the tests pass the runner will let you know. If not, then check out the error message and figure out why. Next, run the same tests using the other tests runner to make sure that they both work (for completeness).
If you've gotten this far, congratulations! cfcUnit is now installed and ready to be used. Now lets write some tests.