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

---
source_files:
  - DataPRO/UnitTest/DTS.Common.Import.Tests/GroupHelperShould.cs
  - DataPRO/UnitTest/DTS.Common.Import.Tests/CalibrationImportShould.cs
generated_at: "2026-04-16T03:51:24.502617+00:00"
model: "Qwen/Qwen3-Coder-Next-FP8"
schema_version: 1
sha256: "91da420b0b2120ea"
---

# DTS.Common.Import.Tests

## Documentation: `DTS.Common.Import.Tests` Unit Test Module

---

### 1. **Purpose**

This module contains unit tests for the `DTS.Common.Import` functionality, specifically validating the behavior of `GroupHelper` and `CalibrationImport` classes. Its role is to ensure correctness, robustness, and invariants of data import logic—particularly around group creation, channel ordering, sensor ID normalization, and calibration record handling—including edge cases such as null inputs and excitation voltage mismatches. It does not contain production logic itself but serves as the authoritative specification for expected behavior of the tested components.

---

### 2. **Public Interface**

The test file itself does not expose a public API; it *tests* public members of other modules. Based on test usage, the following public APIs are referenced:

#### `GroupHelper.CreateEmptyGroup()`
- **Signature**: `static Group CreateEmptyGroup()` *(inferred from usage)*  
- **Behavior**: Creates a new `Group` instance with `LastModifiedBy` initialized to `"---"`.

#### `GroupHelper.ReverseChannelOrder(TestTemplate, Dictionary<string, string>, List<SensorData>)`
- **Signature**: `static List<T> ReverseChannelOrder<T>(TestTemplate testTemplate, Dictionary<string, string> channelMap, List<SensorData> sensors)` *(inferred from usage)*  
- **Behavior**: Safely handles null inputs for `testTemplate` and `sensors` by returning an empty list. Otherwise, performs channel reordering based on `channelMap`. *(Exact implementation details not visible.)*

#### `GroupHelper.NormalizeSensorIds(List<SensorData>)`
- **Signature**: `static List<SensorData> NormalizeSensorIds(List<SensorData> sensors)` *(inferred from usage)*  
- **Behavior**: Safely handles null input by returning an empty list. Otherwise, normalizes sensor IDs in the list. *(Exact normalization logic not visible.)*

#### `CalibrationImport.CheckForExcitationCalibration(SensorCalibration, int, ExcitationVoltageOptions.ExcitationVoltageOption, string)`
- **Signature**: `SensorCalibration CheckForExcitationCalibration(SensorCalibration sensorCalibration, int channelIndex, ExcitationVoltageOptions.ExcitationVoltageOption expectedExcitation, string channelName)`  
- **Behavior**:  
  - If the excitation voltage of the *first* calibration record matches `expectedExcitation`, returns the original `sensorCalibration` unchanged.  
  - If it does *not* match, returns a *modified* `SensorCalibration` with an additional calibration record (resulting in `Records.Records.Count == 2`). *(Exact record duplication or cloning logic not visible.)*

#### `CalibrationImport.AddLinearCalRecordIfNeeded(SensorCalibration, bool, bool)`
- **Signature**: `SensorCalibration AddLinearCalRecordIfNeeded(SensorCalibration sensorCalibration, bool forceAdd, bool isZeroMethodRequired)` *(inferred from usage)*  
- **Behavior**:  
  - If `sensorCalibration.Records.Records.Count != 1`, returns the original unchanged.  
  - If `Count == 1`, returns a modified `SensorCalibration` where:  
    - The existing record’s `Poly.IsValid` is set to `false`.  
    - A *second* calibration record is added (resulting in `Count == 2`).  
  *(Exact record creation logic not visible.)*

#### `CalibrationImport.AddLinearZeroMethodIfNeeded(SensorCalibration, ZeroMethodType, int, int)`
- **Signature**: `SensorCalibration AddLinearZeroMethodIfNeeded(SensorCalibration sensorCalibration, ZeroMethodType zeroMethodType, int channelIndex, int sensorIndex)` *(inferred from usage)*  
- **Behavior**:  
  - If `sensorCalibration.Records.Records.Count != 1`, returns the original unchanged.  
  - If `Count == 1`, returns a modified `SensorCalibration` with `ZeroMethods.Methods.Count == 2`. *(Exact zero method addition logic not visible.)*

---

### 3. **Invariants**

- `GroupHelper.CreateEmptyGroup()` always produces a `Group` with `LastModifiedBy == "---"`.
- `GroupHelper.ReverseChannelOrder()` and `GroupHelper.NormalizeSensorIds()` must never throw exceptions when passed `null` for `sensors` or `testTemplate`; they must return empty lists instead.
- `CalibrationImport.CheckForExcitationCalibration()`:
  - When the first calibration record’s `Excitation` matches the expected value, the returned object is *identical* (reference equality not tested, but no modification is performed).
  - When mismatched, the returned `SensorCalibration` has exactly *two* calibration records.
- `CalibrationImport.AddLinearCalRecordIfNeeded()`:
  - Only modifies the calibration when there is exactly *one* record.
  - In that case, it invalidates the existing record (`Poly.IsValid == false`) and adds a second record.
- `CalibrationImport.AddLinearZeroMethodIfNeeded()`:
  - Only modifies the calibration when there is exactly *one* record.
  - In that case, it ensures `ZeroMethods.Methods.Count == 2`.

---

### 4. **Dependencies**

**Test Module Dependencies**:
- `DTS.Common.Import.Tests` references:
  - `DTS.Common.Interface.TestSetups.TestSetupsList` (for `TestTemplate`, inferred)
  - `DTS.SensorDB` (for `SensorData`)
  - `DataPROWin7.DataModel` (for `Group`, inferred)
  - `NUnit.Framework` (test framework)
  - `NSubstitute` (mocking library)
  - `DTS.Common.Enums` (for `ExcitationVoltageOptions`, `ZeroMethodType`)
  - `DTS.Common.Interface.Sensors` (for `ICalibrationRecords`, `ICalibrationRecord`)
  - `Classes.Sensors.LinearizationFormula` (from `DTS.SensorDB` or `DataPROWin7.DataModel`, inferred)

**Tested Components’ Dependencies** *(inferred)*:
- `GroupHelper`, `CalibrationImport` likely depend on:
  - `DTS.SensorDB` (sensor data models)
  - `DTS.Common.Interface.Sensors` (calibration interfaces)
  - `DTS.Common.Enums` (enum types)
  - Possibly `DataPROWin7.DataModel` (e.g., `Group`, `TestTemplate`)

**Dependents**:
- This test module is consumed by the test runner (NUnit) and likely part of a CI pipeline. No runtime dependents are visible.

---

### 5. **Gotchas**

- **Typos in test names**: Tests use `"ShouldNotThorwException"` (missing 'w' in "Throw")—likely a typo in test method names, but does not affect behavior.
- **Ambiguity in record duplication logic**: In `CheckForExcitationCalibration`, when excitation mismatches, a second record is added—but it is unclear whether this is a *copy* of the first record, a *new placeholder*, or a *modified* record. The tests only assert count, not content.
- **Zero method vs. calibration record distinction**: `AddLinearZeroMethodIfNeeded` modifies `ZeroMethods.Methods`, while `AddLinearCalRecordIfNeeded` modifies `Records.Records`. The interaction between these two mechanisms is not tested—potential for confusion or overlap.
- **No tests for `AddLinearCalRecordIfNeeded` with `forceAdd == true` or `isZeroMethodRequired == true`**: Only default (`false`, `false`) cases are tested.
- **No tests for non-null, non-empty inputs in `GroupHelper` methods**: All tests for `ReverseChannelOrder` and `NormalizeSensorIds` only verify null-safety; behavior on valid inputs is not specified here.

> *No other obvious tech debt or quirks identified from source alone.*