Add time zone metadata

Different metadata structure for gt3x and bin

Author: Asanto32

src/wristpy/core/models.py

@@ -118,6 +118,7 @@ class WatchData(BaseModel):
     temperature: Optional[Measurement] = None
     idle_sleep_mode_flag: Optional[bool] = None
     dynamic_range: Optional[tuple[float, float]] = None
+    time_zone: Optional[str] = None
 
     @field_validator("acceleration")
     def validate_acceleration(cls, v: Measurement) -> Measurement:

src/wristpy/core/orchestrator.py

@@ -419,6 +419,7 @@ def _run_file(
         "activity_metric": activity_metric,
         "nonwear_algorithm": list(nonwear_algorithm),
         "input_file": str(input),
+        "time_zone": watch_data.time_zone,
     }
 
     results = writers.OrchestratorResults(

src/wristpy/io/readers/readers.py

@@ -45,6 +45,9 @@ def read_watch_data(file_name: Union[pathlib.Path, str]) -> models.WatchData:
         idle_sleep_mode_flag = (
             data["metadata"]["device_feature_enabled"]["sleep_mode"].lower() == "true"
         )
+        time_zone = f"GMT {data['metadata']['info']['TimeZone']}"
+    elif file_type == ".bin":
+        time_zone = data["metadata"]["Configuration Info"]["Time Zone"]
 
     dynamic_range = _extract_dynamic_range(
         metadata=data["metadata"],
@@ -59,6 +62,7 @@ def read_watch_data(file_name: Union[pathlib.Path, str]) -> models.WatchData:
         temperature=measurements.get("temperature"),
         idle_sleep_mode_flag=idle_sleep_mode_flag,
         dynamic_range=dynamic_range,
+        time_zone=str(time_zone),
     )
 
 

tests/unit/test_readers.py

@@ -74,3 +74,23 @@ def test_extract_dynamic_range_gt3x(sample_data_gt3x: pathlib.Path) -> None:
     assert (
         result == expected_dynamic_range
     ), f"Expected dynamic range of: {expected_dynamic_range}, result was: {result}"
+
+
+def test_timezone_extraction_gt3x(sample_data_gt3x: pathlib.Path) -> None:
+    """Test extracting timezone metadata from .gt3x files."""
+    expected_timezone = "GMT -05:00:00"
+    watch_data = readers.read_watch_data(sample_data_gt3x)
+
+    assert (
+        watch_data.time_zone == expected_timezone
+    ), f"Expected timezone of: {expected_timezone}, result was: {watch_data.time_zone}"
+
+
+def test_timezone_extraction_bin(sample_data_bin: pathlib.Path) -> None:
+    """Test extracting timezone metadata from .bin files."""
+    expected_timezone = "GMT -05:00"
+    watch_data = readers.read_watch_data(sample_data_bin)
+
+    assert (
+        watch_data.time_zone == expected_timezone
+    ), f"Expected timezone of: {expected_timezone}, result was: {watch_data.time_zone}"