wheels-test-generator

Generate TestBox BDD test specs for Wheels models, controllers, and integration tests. Use when creating tests for models (validations, associations), controllers (actions, filters), or integration workflows. Ensures comprehensive test coverage with proper setup/teardown and Wheels testing conventions.

⭐200stars🔀107forks📁View on GitHub🕐Updated Jan 1, 2026

When & Why to Use This Skill

The Wheels Test Generator is a specialized Claude skill designed to automate the creation of TestBox BDD test specifications for the CFWheels framework. It streamlines the development process by generating comprehensive test suites for models, controllers, and integration workflows, ensuring robust code quality and adherence to ColdFusion (CFML) testing conventions.

Use Cases

  • Model Validation Testing: Automatically generating tests for model properties, validations, and associations to ensure data integrity and business logic accuracy.
  • Controller Action Verification: Creating specs to test controller actions, filters, and response behaviors such as redirects, flash messages, and variable assignments.
  • End-to-End Integration Workflows: Simulating complex user lifecycles and database interactions to verify system-wide stability and feature performance.
  • Legacy Code Coverage: Quickly scaffolding BDD test suites for existing CFWheels applications to improve maintainability and reduce regression risks during refactoring.
nameWheels Test Generator
descriptionGenerate TestBox BDD test specs for Wheels models, controllers, and integration tests. Use when creating tests for models (validations, associations), controllers (actions, filters), or integration workflows. Ensures comprehensive test coverage with proper setup/teardown and Wheels testing conventions.

Wheels Test Generator

When to Use This Skill

Activate automatically when:

  • User requests to create tests/specs
  • User wants to test a model, controller, or workflow
  • User mentions: test, spec, TestBox, BDD, describe, it, expect
  • After generating models/controllers (proactive testing)

Model Test Template

component extends="wheels.Test" {

    function setup() {
        // Runs before each test
        super.setup();
        model = model("Post").new();
    }

    function teardown() {
        // Runs after each test
        if (isObject(model) && model.isPersisted()) {
            model.delete();
        }
        super.teardown();
    }

    function testValidatesPresenceOfTitle() {
        model.title = "";
        assert("!model.valid()");
        assert("model.hasErrors('title')");
    }

    function testHasManyComments() {
        model = model("Post").create(title="Test", content="Content");
        comment = model("Comment").create(postId=model.id, content="Comment");

        assert("model.comments().recordCount == 1");

        model.delete(); // Cascade should delete comment
        assert("!isObject(model('Comment').findByKey(comment.id))");
    }
}

Controller Test Template

component extends="wheels.Test" {

    function setup() {
        super.setup();
        params = {controller="posts", action="index"};
    }

    function testIndexLoadsAllPosts() {
        controller = controller("Posts", params);
        controller.processAction("index");

        assert("isQuery(controller.posts)");
    }

    function testShowRequiresKey() {
        params.action = "show";
        controller = controller("Posts", params);
        // Should redirect due to missing key
    }

    function testCreateWithValidData() {
        params.action = "create";
        params.post = {title="Test", content="Content"};

        controller = controller("Posts", params);
        controller.processAction("create");

        assert("flashKeyExists('success')");
    }
}

Integration Test Template

component extends="wheels.Test" {

    function testCompletePostLifecycle() {
        // Create
        post = model("Post").create(title="Test", content="Content");
        assert("isObject(post) && post.isPersisted()");

        // Update
        post.update(title="Updated");
        assert("post.title == 'Updated'");

        // Add comment
        comment = model("Comment").create(postId=post.id, content="Comment");
        assert("post.comments().recordCount == 1");

        // Delete (cascade)
        post.delete();
        assert("!isObject(model('Comment').findByKey(comment.id))");
    }
}
  • wheels-model-generator: Creates models to test
  • wheels-controller-generator: Creates controllers to test

Generated by: Wheels Test Generator Skill v1.0