Files

Gabriel Radureau 0daaf9bf96 feat: implement BDD testing with Godog

Implement comprehensive BDD testing framework using Godog:
- Added feature files for greet and health endpoints
- Created test server that runs on port 9191
- Implemented step definitions using Godog's exact patterns
- Fixed undefined step warnings by following Godog conventions
- All tests passing with proper response validation
- Maintained black box testing principles

Key files:
- pkg/bdd/steps/steps.go - Step definitions using StepContext struct
- pkg/bdd/testserver/ - Test server implementation
- features/*.feature - BDD feature files
- pkg/bdd/README.md - Documentation for proper step patterns

The implementation follows Godog's exact pattern suggestions to avoid
undefined step warnings and provides comprehensive API testing.

2026-04-04 17:43:57 +02:00

3.2 KiB

Raw Blame History

BDD Testing with Godog

This package implements Behavior-Driven Development (BDD) testing using the Godog framework.

Important Requirements for Step Definitions

Step Pattern Matching

Godog has very specific requirements for step pattern matching. To avoid "undefined" warnings:

Use the exact regex pattern that Godog suggests in its error messages
Use the exact parameter names that Godog suggests (arg1, arg2, etc.)
Match the feature file syntax exactly including quotes and JSON formatting

Example

Feature file step:

Then the response should be "{\"message\":\"Hello world!\"}"

Correct step definition:

ctx.Step(`^the response should be "{\"([^"]*)\":\"([^"]*)\"}"$`, func(arg1, arg2 string) error {
    // Implementation here
    return nil
})

Incorrect patterns that cause "undefined" warnings:

// Wrong: Different regex pattern
ctx.Step(`^the response should be "{\"message\":\"([^"]*)\"}"$`, func(message string) error {
    // ...
})

// Wrong: Different parameter names
ctx.Step(`^the response should be "{\"([^"]*)\":\"([^"]*)\"}"$`, func(key, value string) error {
    // ...
})

Current Implementation

Step Definition Strategy

First eliminate "undefined" warnings by using Godog's exact suggested patterns
Return godog.ErrPending initially to confirm pattern matching works
Then implement actual validation logic

Files

suite.go: Test suite initialization and server management
testserver/: Test server and client implementation
steps/: Step definitions for each feature

Debugging "Undefined" Steps

If you see "undefined" warnings:

Run the tests to see Godog's suggested pattern:
```
go test ./features/... -v
```
Copy the exact regex pattern from the error message
Copy the exact parameter names (arg1, arg2, etc.)
Update your step definition to match exactly

Common Mistakes

The "undefined" warnings are not a Godog bug - they occur when step definitions don't match Godog's expected patterns exactly:

Using different regex patterns than what Godog suggests
Using descriptive parameter names instead of arg1, arg2
Not escaping quotes properly in JSON patterns
Trying to be "clever" with regex optimization

Solution: Always use the exact pattern and parameter names that Godog suggests in its error messages.

Best Practices

Follow Godog's suggestions exactly - Copy-paste the pattern and parameter names
Test pattern matching first - Use godog.ErrPending to verify patterns work
Then implement logic - Replace godog.ErrPending with actual validation
Don't over-optimize regex - Use the patterns Godog provides, even if they seem verbose
One pattern per step type - Use generic patterns to cover similar steps

Why This Matters

Godog's step matching is very specific by design:

It needs to reliably match feature file steps to code
It provides exact patterns to ensure consistency
Following its suggestions guarantees your steps will be recognized

Remember: The "undefined" warnings are Godog telling you exactly how to fix your step definitions!

3.2 KiB Raw Blame History