DP44/enriched-partialglm/Common/DTS.Common.Import/ImportOptions.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common.Import/ImportOptions/EqxImportOptions.cs Common/DTS.Common.Import/ImportOptions/CsvImportOptions.cs	2026-04-16T11:43:37.257209+00:00	zai-org/GLM-5-FP8	1	c231715b4e36a96d

Documentation: DTS.Common.Import.ImportOptions

1. Purpose

This module provides configuration option classes for data import operations within the DTS system. It defines three option classes—EqxImportOptions, CsvImportOptions, and ZeroMethodOptions—that encapsulate import behavior settings for EQX-format sensor imports, CSV file parsing, and zero method calibration configuration respectively. These classes serve as data transfer objects to parameterize import operations.

---

2. Public Interface

Class: EqxImportOptions

Namespace: DTS.Common.Import.ImportOptions

Configuration options for EQX import operations.

Property	Type	Default	Description
OverwriteExistingSensors	bool	true	Controls whether existing sensors should be overwritten during import.
ImportSensorModels	bool	true	Controls whether sensor models should be imported.

---

Class: CsvImportOptions

Namespace: DTS.Common.Import.ImportOptions

Configuration options for CSV file parsing and import.

Property	Type	Default	Description
Encoding	string	None (uninitialized)	Specifies the character encoding for the CSV file.
FieldSeparator	string	None (uninitialized)	Specifies the field delimiter character(s) used in the CSV.
ImportCulture	CultureInfo	None (uninitialized)	Specifies the culture settings for parsing culture-dependent data (e.g., number formats, dates).
StripBackSlash	bool	None (uninitialized)	Controls whether backslash characters should be removed during import.

---

Class: ZeroMethodOptions

Namespace: DTS.Common.Import.ImportOptions

Configuration options for zero method calibration settings.

Property	Type	Default	Description
ZeroMethodType	ZeroMethodType	None (uninitialized)	Specifies the type of zero method to apply. Type is defined in DTS.Common.Enums.Sensors.
ZeroMethodStart	double	None (uninitialized)	Specifies the start value for the zero method range.
ZeroMethodEnd	double	None (uninitialized)	Specifies the end value for the zero method range.

---

3. Invariants

Explicit invariants from source: None. The classes contain only auto-implemented properties with no validation logic, constructors, or constraints visible in the source.

Observations:

• EqxImportOptions properties have explicit default values of true.
• CsvImportOptions and ZeroMethodOptions properties have no default values; consumers must initialize them.
• No nullability annotations are present; reference type properties (Encoding, FieldSeparator, ImportCulture) may be null at runtime if not explicitly set.

---

4. Dependencies

This module depends on:

• System (core .NET types)
• System.Collections.Generic (generic collections)
• System.Globalization (CultureInfo type used in CsvImportOptions)
• System.Linq (LINQ support)
• System.Text (text encoding support)
• System.Threading.Tasks (async/task support)
• DTS.Common.Enums.Sensors (ZeroMethodType enum used in ZeroMethodOptions)

Consumers:

Not determinable from the provided source files alone. These option classes are likely consumed by import service classes or handlers elsewhere in the DTS.Common.Import namespace or broader DTS system.

---

5. Gotchas

1. Encoding is a string, not System.Text.Encoding: The CsvImportOptions.Encoding property is declared as string, not the System.Text.Encoding type. Consumers must convert between string representations and actual encoding objects.

2. Inconsistent default value patterns: EqxImportOptions initializes both properties to true, while CsvImportOptions and ZeroMethodOptions leave all properties uninitialized. This inconsistency may lead to unexpected null or default value behavior if consumers assume all option classes follow the same initialization pattern.

3. Unused imports: Both files import System.Collections.Generic, System.Linq, System.Text, and System.Threading.Tasks, but none of these namespaces are referenced in the visible code. This may indicate legacy code or generated boilerplate.

4. No validation or bounds checking: ZeroMethodOptions.ZeroMethodStart and ZeroMethodEnd are raw double values with no validation. The relationship between start and end (e.g., whether start must be less than end) is not enforced at this level.