node-coldfusion-tester

Fast automated tests for ColdFusion projects using TestBox

Video demonstration here...

Prerequisites: TestBox

You will need TestBox installed in the webroot of your coldfusion server.

Install the package globaly

npm install -g node-coldfusion-tester

Setting up a ColdFusion project to use this tool

Navigate to your project folder in your terminal of choice and type:

cftester --init

You will be asked some questions:

prompt: The host running your ColdFusion:  (http://localhost:8500)
prompt: Path from the host to the root of your ColdFusion project:  some/path
prompt: Name of the folder in your project that contains the tests:  (test)
prompt: List of folders inside your test folder containing different kinds of tests (e.g. integration and unit):  (spec,unit)
prompt: Path from the host to the test runner:  (testbox/system/runners/HTMLRunner.cfm)
prompt: Suffix to be used for test files:  (Spec)
prompt: List of folders in your project to be ignored from watching. This supports anytime matchers (https://github.com/es128/anymatch): (**/testbox/**)

This in turn will create a cf-tester-config.json file in the current folder containing:

{
  "host": "http://localhost:8500",
  "basePath": "some/path",
  "testFolder": "test",
  "testTypes": [
    "spec",
    "unit"
  ],
  "testRunner": "testbox/system/runners/HTMLRunner.cfm",
  "testFileSuffix": "Spec",
  "ignored": [
    "**/testbox/**"
  ]
}

Start watching your files

In the terminal you can now type:

cftester

And the system will start watching your files for changes and run relevant tests as you save your edits.