DP44/enriched-qwen3-coder-next/DataPRO/UnitTest/DTS.Common.DataModel.Tests.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/UnitTest/DTS.Common.DataModel.Tests/GroupShould.cs	2026-04-16T03:51:03.653495+00:00	Qwen/Qwen3-Coder-Next-FP8	1	574ef8550b69736d

DTS.Common.DataModel.Tests

Documentation Page: GroupShould.cs Unit Tests

1. Purpose

This file contains unit tests for the Group class in the GroupList.Model namespace, specifically validating the behavior of its Filter method and ConvertToEmbedded method. The tests ensure that filtering logic correctly handles edge cases (null/empty search terms, missing associated test setups), searches across multiple properties (DisplayName, Description, ChannelCount, LastModified), and that ConvertToEmbedded behaves idempotently when invoked on an already-embedded group.

2. Public Interface

The tests reference the following public members of the Group class (defined externally, not in this file):

• bool Filter(string term)
  Performs a case-sensitive substring search across DisplayName, Description, ChannelCount (as string), and LastModified (as string, using default ToString()). Returns true if any field contains the search term (or if term is null/empty, or if AssociatedTestSetups is null), otherwise false.

• void ConvertToEmbedded(IGroupChannel[] channels)
  Converts the Group instance to an embedded state. Tests confirm that invoking this method on a group with Embedded = true does not cause an exception and leaves Embedded as true. (Full behavior of this method is not fully specified by the tests.)

3. Invariants

• Filter("") and Filter(null) must return true.
• If AssociatedTestSetups is null, Filter(term) must return true (regardless of term).
• Filter(term) returns true if term is a substring of:
  • DisplayName,
  • Description,
  • ChannelCount.ToString(), or
  • LastModified.ToString()
    (using default string conversion and case-sensitive comparison).
• Filter(term) returns false only if term is non-null/non-empty, AssociatedTestSetups is non-null, and term is not found in any of the above fields.
• ConvertToEmbedded must be safe to call on an already-embedded group (no exception thrown, Embedded remains true).

4. Dependencies

• Internal dependencies (inferred from test setup):
  • GroupList.Model.Group — the class under test.
  • Interface.Groups.GroupList.TestSetupParentHelper — used to populate AssociatedTestSetups (a List<TestSetupParentHelper>).
  • Interface.Channels.IGroupChannel — used as the parameter type for ConvertToEmbedded.
• Test framework: NUnit (v3+), via [TestFixture] and [Test] attributes.
• Dependencies on this module: None explicitly stated in this test file. Tests are internal to the DTS.Common.DataModel.Tests namespace.

5. Gotchas

• Case sensitivity: Tests do not verify case-insensitive matching; Filter appears to be case-sensitive (e.g., "abc" matches "defabchy" but not "defABChy" unless explicitly implemented otherwise — not confirmed here).
• String conversion of ChannelCount and LastModified: Uses default .ToString(); behavior may vary with culture settings (e.g., LastModified.ToString() may produce "12/31/2023 10:00:00 AM" vs "2023-12-31T10:00:00" depending on environment).
• AssociatedTestSetups null vs empty list: Tests distinguish between null (returns true for any term) and an empty list (returns false if term not found elsewhere).
• ConvertToEmbedded behavior incomplete: Tests only verify idempotency for already-embedded groups. No tests confirm behavior for non-embedded groups, side effects (e.g., channel assignment), or exception conditions.
• No tests for Embedded property mutation: While Embedded is read in tests, no tests assert that ConvertToEmbedded sets it to true when initially false.