BoxLang 🚀 A New JVM Dynamic Language Learn More...

TestBox

v6.3.2+16 Testing

TESTBOX

Total Downloads Latest Stable Version Apache2 License

Copyright Since 2005 TestBox by Luis Majano and Ortus Solutions, Corp
www.ortussolutions.com

TestBox v6 Now Available: Read the announcement ».

TestBox is a Behavior Driven Development (BDD) and Test Driven Development (TDD) framework for BoxLang JVM Language and ColdFusion (CFML). It also includes mocking and stubbing capabilities via its internal MockBox library. We also recommend you install the testbox-cli (https://www.forgebox.io/view/testbox-cli) package to leverage commandline test runners, test generations and watchers using CommandBox.

Requirements

  • BoxLang 1+
  • Lucee 5+
  • Adobe ColdFusion 2021+

Installation

You can visit the TestBox documentation page to view all of its features and capabilities. To install TestBox just drop it in your web root as /testbox or create a mapping /testbox that points to it.

You can also use CommandBox to install and leverage TestBox for commandline executions, test generations, watchers and much more:

Stable Release

box install testbox-cli testbox

Bleeding Edge Release

box install testbox@be

Bleeding edge builds are updated automatically as code is committed.

License

Apache License, Version 2.0.

Versioning

TestBox is maintained under the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

  • Breaking backward compatibility bumps the major (and resets the minor and patch)
  • New additions without breaking backward compatibility bumps the minor (and resets the patch)
  • Bug fixes and misc changes bumps the patch

Source Code

Bug Tracking

Support

Documentation

Community and Support

Join us in our Ortus Community and become a valuable member of this project TestBox BDD. We are looking forward to hearing from you!!

Official Site

HONOR GOES TO GOD ABOVE ALL

Because of His grace, this project exists. If you don't like this, then don't read it, its not for you.

"Therefore being justified by faith, we have peace with God through our Lord Jesus Christ: By whom also we have access by faith into this grace wherein we stand, and rejoice in hope of the glory of God. And not only so, but we glory in tribulations also: knowing that tribulation worketh patience; And patience, experience; and experience, hope: And hope maketh not ashamed; because the love of God is shed abroad in our hearts by the Holy Ghost which is given unto us. ." Romans 5:5

THE DAILY BREAD

"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)" Jn 14:1-12

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

6.3.2 - 2025-04-29

6.3.1 - 2025-04-01

Fixed

  • Update the run runners so they use the calculated location paths.

6.3.1 - 2025-04-01

Fixed

  • Fixed a typo in BaseReporter

6.3.0 - 2025-03-31

Bugs

  • TESTBOX-418 initArgs.bundles can be an array or simple value, consolidate it in boxlang runner
  • TESTBOX-420 Reporter options not being passed correctly

Improvements

  • TESTBOX-417 BoxLang only usage improvements
  • TESTBOX-419 Console reporter now includes colors and abiliy to execute via boxlang

6.3.0 - 2025-02-25

6.2.1 - 2025-02-06

6.2.0 - 2025-01-31

6.1.0 - 2025-01-28

New Features

  • TESTBOX-412 Updated to use cbMockData now instead of MockDataCFC

Improvements

Bugs

  • TESTBOX-408 Allow toHaveKey to support struct like objects
  • TESTBOX-410 Error when using the url.excludes with the HTML runner
  • TESTBOX-411 fix missing `cfloop` on test browser

6.0.1 - 2024-12-05

6.0.0 - 2024-09-27

New Features

  • TESTBOX-391 MockBox converted to script
  • TESTBOX-392 BoxLang classes support
  • TESTBOX-393 New environment helpers to do skip detections or anything you see fit: isAdobe, isLucee, isBoxLang, isWindows, isMac, isLinux
  • TESTBOX-394 new test(), xtest(), ftest() alias for more natuarl testing
  • TESTBOX-397 debug() get's two new arguments: label and showUDFs
  • TESTBOX-398 DisplayName on a bundle now shows up in the reports
  • TESTBOX-399 xUnit new annotation for @DisplayName so it can show instead of the function name
  • TESTBOX-401 BoxLang CLI mode and Runner
  • TESTBOX-402 New matcher: toHaveKeyWithCase()
  • TESTBOX-403 Assertions: key() and notKey() now have a CaseSensitive boolean argument

Improvements

  • TESTBOX-289 showUDFs = false option with debug()
  • TESTBOX-331 TextReporter doesn't correctly support testBundles URL param
  • TESTBOX-395 adding missing focused argument to spec methods
  • TESTBOX-396 Generating a repeatable id for specs to track them better in future UIs

Bugs

  • TESTBOX-123 If test spec descriptor contains a comma, it can not be drilled down to run that one spec directly
  • TESTBOX-338 describe handler in non-called test classes being executed

Tasks

  • TESTBOX-400 Drop Adobe 2018 support

Use It

$ box install testbox

How do I do this?

Collaborators 0

No collaborators yet.

Links

     

User Rating

5.00 / 2

Stats

  • {{ getFullDate("2014-05-29T16:22:57Z") }}
  • {{ getFullDate("2025-04-29T18:00:30Z") }}
  • 22,789
  • 1,899,038
Report Abuse