agentjido / jido / 572e1cb98334aa2da717b8702167fc4b5793422d

66%

push

github

Test DSL - Part 2:  Enhance agent case helpers (#75)

* Enhance AgentCase with new helper functions for improved testing

- Add 5 new helper functions to JidoTest.AgentCase:
  - get_agent_state/1: Get current agent state
  - assert_agent_state/2: Assert state matches expected values (maps/keywords)
  - wait_for_agent_status/3: Wait for agent to reach specific status
  - assert_queue_empty/1: Assert signal queue is empty
  - assert_queue_size/2: Assert signal queue has expected size

- All helpers maintain pipeline-style API returning context for chaining
- Add comprehensive test suite with 23 tests in agent_case_test.exs
- Move AgentCase-specific tests from server_test.exs to dedicated test file
- Update documentation with examples and usage patterns

Benefits:
- Reduces test boilerplate and improves readability
- Provides meaningful error messages for debugging
- Validates process lifecycle (alive/dead checks)
- Supports both full and partial state validation

* Add comprehensive queue testing for AgentCase helpers

- Add test for multiple signals queued simultaneously
- Add test for queue state changes during processing
- Add test for assert_queue_empty failure when queue has items
- Verify queue helpers work correctly with 1-3 signals
- All 26 tests now pass including queue edge cases

* Restructure AgentCase tests by function grouping

- Group tests by function instead of conceptual categories
- Each describe block now contains tests for a single function
- Better test organization: spawn_agent/2, send_signal_async/3, etc.
- Add separate pipeline chaining tests section
- Improved test discoverability and maintainability
- All 31 tests pass with cleaner structure

* Add comprehensive agent testing guide

- Create guides/agents/testing.md with complete AgentCase documentation
- Cover all 8 AgentCase DSL functions with examples
- Include testing patterns: lifecycle, state, signals, queues
- Add best practices and advanced testing techniques
- Provide... (continued)

27 of 27 new or added lines in 1 file covered. (100.0%)

1074 of 1603 relevant lines covered (67.0%)

560.8 hits per line