Blog

Luis Majano

April 29, 2020

Spread the word


Share your thoughts


We are excited to announce a major version release of TestBox version 4.0.0. To install just use CommandBox: install testbox --saveDev or to update your TestBox installation update testbox. So let's explore this release:

 

What's New With 4.0.0

TestBox 4.0.0 is a major release. It has compatibility changes that you should be aware of and lots of good features!

 

Compatibility

The major compatibility issues are the engine support removals:

  • Lucee 4.5 Support Dropped
  • Adobe ColdFusion 11 Dropped
 

Updating

It is easy to update, just type update testbox and you are done!

 

Major Features

 

TestBox Output Utilities

Sometimes you need to dump something that is in the CFC you are testing or maybe an asynchronous test. The debug() method is only accessible from your test bundle, so getting to the TestBox output utilities is not easy. We have now implemented the testing utilities into the request scope as request.testbox

This utility struct provides you with the following methods:

MethodComment
console()Send output to the console
debug()Send output to the TestBox reporter debugger
clearDebugBuffer()Clear the debugger
print()Send output to the ColdFusion output buffer
printLn()Same as print() but adding a <br> separator

This way in your code you can add them for better debugging, especially when testing async code:

request.testbox.console( "I am here" )
request.testbox.debug( "why is this not running" )
 

Mocking Data

We have included MockDataCFC as a dependency to TestBox 4. This will allow you to mock not only objects but data as well. You can access the mocking method via the new mockData() method in all your specs. This feature is a life-saver when mocking APIs or data within your applications.

# Array of objects
var data = mockData(
    $num = 3,
    "author" = "name",
    "id" = "uuid"
);

# An object
var data = mockData(
    $returnType = "struct",
    "author" = "name",
    "id" = "uuid"
);

Let's imagine the following object graph:

Author
    Has Many Books
        Has Many Categories
    Has Keywords
    Has A Publisher

I can then use this mocking DSL to define it:

mockData(
    fullName    = "name",
    description = "sentence",
    age         = "age",
    id          = "uuid",
    createdDate = "datetime",
    isActive	= "oneof:true:  false",

    // one to many complex object definitions
    books = [
        {
            $num = "rand:1:         3",
            "id" = "uuid",
            "title" = "words:1:         5",
            "categories" = {
                "$num"      = "2",
                "id"        = "uuid",
                "category"  = "words"
            }
        }
    ],

    // object definition
    publisher = {
        "id" 	= "uuid",
        "name" 	= "sentence"
    },

    // array of values
    keywords = [
        {
            "$num" 	= "rand:1:         10",
            "$type" = "words"
        }
    ]
);

More information here: https://www.forgebox.io/view/mockdatacfc

 

Release Notes

 

Bugs

  • [TESTBOX-275] - Exception in beforeTests/afterTests not reported in a meaningful way on the ANT Junit Reporter
  • [TESTBOX-278] - Fix the coverage % in HTML visualizer
 

New Features

  • [TESTBOX-274] - New testbox output utilities struct: request.testbox
  • [TESTBOX-276] - MockdataCFC is now a first class module in TestBox
  • [TESTBOX-277] - New mockData() method in your base specs so you can mock any type of data
  • [TESTBOX-280] - Add cfconfig.json for controlling output and consistency between testing in diff engines
 

Tasks

Add Your Comment

Recent Entries

Introducing: The Ortus ORM Extension

Introducing: The Ortus ORM Extension

We are excited to announce the Ortus ORM Extension, a new effort to improve the CFML ecosystem by modernizing Hibernate ORM support on the Lucee CFML server. The Ortus ORM extension is an open-source fork of the Lucee Hibernate extension which focuses on speed, reliability, and collaboration with the excellent CFML community.

Michael Born
Michael Born
June 06, 2023
CBWIRE 3.0.0 Released

CBWIRE 3.0.0 Released

We are very excited to announce the release of version 3 of CBWIRE, our ColdBox module that makes building modern, reactive apps a breeze. This version brings with it a new component syntax, 19 enhancements and bug fixes, and improved documentation. Our biggest goal with this release was to improve the developer experience and to provide a low barrier to entry to getting started with CBWIRE.

Grant Copley
Grant Copley
May 22, 2023
ColdBox 7.0.0 Released

ColdBox 7.0.0 Released

Introducing ColdBox 7: Revolutionizing Web Development with Cutting-Edge Features and Unparalleled Performance

We are thrilled to announce the highly anticipated release of ColdBox 7, the latest version of the acclaimed web development HMVC framework for ColdFusion (CFML). ColdBox 7 introduces groundbreaking features and advancements, elevating the development experience to new heights and empowering developers to create exceptional web applications and APIs.

Designed to meet the evolving needs of modern web development, ColdBox 7 boasts a range of powerful features that streamline the development process and enhance productivity. With its robust HMVC architecture and developer-friendly tools, ColdBox 7 enables developers to deliver high-performance, scalable, and maintainable web applications and APIs with ease.

Esme Acevedo
Esme Acevedo
May 16, 2023