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.
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.
| name | Wheels Test Generator |
|---|---|
| description | 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. |
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))");
}
}
Related Skills
- wheels-model-generator: Creates models to test
- wheels-controller-generator: Creates controllers to test
Generated by: Wheels Test Generator Skill v1.0