Update CHANGELOG and swift format

Author: RISCfuture

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Change Log
 
+## [3.0.0] - 2026-03-20
+
+### Added
+
+- XML parsing for METARs and TAFs from aviationweather.gov cache files.
+  - `METAR.from(xml:)` and `TAF.from(xml:)` return `AsyncStream<Result<..., Error>>`
+    for resilient batch parsing with per-entry error handling.
+- Winds aloft parsing.
+
+### Changed
+
+- CLI tools (`decode-metar`, `decode-taf`) now support `--format xml` and
+  `--output json` options.
+- Log messages in CLI tools now go to stderr to keep JSON output clean.
+- Updated to Swift 6.2.
+- Added swift-format for code formatting.
+
+### Fixed
+
+- Fixed CSV parsing for updated aviationweather.gov format (quoted raw text,
+  separate station_id column).
+- Fixed handling of TAF periods where the end date comes before the start date
+  (e.g., crossing month boundaries).
+
 ## [2.0.1] - 2025-08-20
 
 ### Fixed

Sources/SwiftMETAR/Error.swift

@@ -57,18 +57,18 @@ extension Error: LocalizedError {
     switch self {
       case .invalidWindsAloftHeader, .invalidWindsAloftGroup, .invalidWindsAloftColumns:
         #if canImport(Darwin)
-        return String(
-          localized: "Couldn’t parse Winds Aloft product.",
-          comment: "error description"
-        )
+          return String(
+            localized: "Couldn’t parse Winds Aloft product.",
+            comment: "error description"
+          )
         #else
-        return "Couldn’t parse Winds Aloft product."
+          return "Couldn’t parse Winds Aloft product."
         #endif
       default:
         #if canImport(Darwin)
-        return String(localized: "Couldn’t parse METAR or TAF.", comment: "error description")
+          return String(localized: "Couldn’t parse METAR or TAF.", comment: "error description")
         #else
-        return "Couldn’t parse METAR or TAF."
+          return "Couldn’t parse METAR or TAF."
         #endif
     }
   }
@@ -77,120 +77,120 @@ extension Error: LocalizedError {
     switch self {
       case .badFormat:
         #if canImport(Darwin)
-        return String(localized: "METAR or TAF format is incorrect.", comment: "failure reason")
+          return String(localized: "METAR or TAF format is incorrect.", comment: "failure reason")
         #else
-        return "METAR or TAF format is incorrect."
+          return "METAR or TAF format is incorrect."
         #endif
       case .invalidDate(let date):
         #if canImport(Darwin)
-        return String(localized: "Invalid date ‘\(date)’.", comment: "failure reason")
+          return String(localized: "Invalid date ‘\(date)’.", comment: "failure reason")
         #else
-        return "Invalid date ‘\(date)’."
+          return "Invalid date ‘\(date)’."
         #endif
       case .invalidWinds(let winds):
         #if canImport(Darwin)
-        return String(localized: "Invalid winds ‘\(winds)’.", comment: "failure reason")
+          return String(localized: "Invalid winds ‘\(winds)’.", comment: "failure reason")
         #else
-        return "Invalid winds ‘\(winds)’."
+          return "Invalid winds ‘\(winds)’."
         #endif
       case .invalidVisibility(let visibility):
         #if canImport(Darwin)
-        return String(localized: "Invalid visibility ‘\(visibility)’.", comment: "failure reason")
+          return String(localized: "Invalid visibility ‘\(visibility)’.", comment: "failure reason")
         #else
-        return "Invalid visibility ‘\(visibility)’."
+          return "Invalid visibility ‘\(visibility)’."
         #endif
       case .invalidWeather(let weather):
         #if canImport(Darwin)
-        return String(localized: "Invalid weather ‘\(weather)’.", comment: "failure reason")
+          return String(localized: "Invalid weather ‘\(weather)’.", comment: "failure reason")
         #else
-        return "Invalid weather ‘\(weather)’."
+          return "Invalid weather ‘\(weather)’."
         #endif
       case .invalidConditions(let conditions):
         #if canImport(Darwin)
-        return String(localized: "Invalid conditions ‘\(conditions)’.", comment: "failure reason")
+          return String(localized: "Invalid conditions ‘\(conditions)’.", comment: "failure reason")
         #else
-        return "Invalid conditions ‘\(conditions)’."
+          return "Invalid conditions ‘\(conditions)’."
         #endif
       case .invalidTempDewpoint(let temps):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid temperature and dewpoint ‘\(temps)’.",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid temperature and dewpoint ‘\(temps)’.",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid temperature and dewpoint ‘\(temps)’."
+          return "Invalid temperature and dewpoint ‘\(temps)’."
         #endif
       case .invalidAltimeter(let altimeter):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid altimeter setting ‘\(altimeter)’.",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid altimeter setting ‘\(altimeter)’.",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid altimeter setting ‘\(altimeter)’."
+          return "Invalid altimeter setting ‘\(altimeter)’."
         #endif
       case .invalidPeriod(let period):
         #if canImport(Darwin)
-        return String(localized: "Invalid TAF period ‘\(period)’.", comment: "failure reason")
+          return String(localized: "Invalid TAF period ‘\(period)’.", comment: "failure reason")
         #else
-        return "Invalid TAF period ‘\(period)’."
+          return "Invalid TAF period ‘\(period)’."
         #endif
       case .invalidWindshear(let windshear):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid low-level windshear ‘\(windshear)’.",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid low-level windshear ‘\(windshear)’.",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid low-level windshear ‘\(windshear)’."
+          return "Invalid low-level windshear ‘\(windshear)’."
         #endif
       case .invalidIcing(let icing):
         #if canImport(Darwin)
-        return String(localized: "Invalid icing ‘\(icing)’", comment: "failure reason")
+          return String(localized: "Invalid icing ‘\(icing)’", comment: "failure reason")
         #else
-        return "Invalid icing ‘\(icing)’"
+          return "Invalid icing ‘\(icing)’"
         #endif
       case .invalidTurbulence(let turbulence):
         #if canImport(Darwin)
-        return String(localized: "Invalid turbulence ‘\(turbulence)’", comment: "failure reason")
+          return String(localized: "Invalid turbulence ‘\(turbulence)’", comment: "failure reason")
         #else
-        return "Invalid turbulence ‘\(turbulence)’"
+          return "Invalid turbulence ‘\(turbulence)’"
         #endif
       case .invalidForecastTemperature(let temp):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid forecast temperature '\(temp)'",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid forecast temperature '\(temp)'",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid forecast temperature '\(temp)'"
+          return "Invalid forecast temperature '\(temp)'"
         #endif
       case .invalidWindsAloftHeader(let header):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid winds aloft header '\(header)'.",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid winds aloft header '\(header)'.",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid winds aloft header '\(header)'."
+          return "Invalid winds aloft header '\(header)'."
         #endif
       case .invalidWindsAloftGroup(let group):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid winds aloft data group '\(group)'.",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid winds aloft data group '\(group)'.",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid winds aloft data group '\(group)'."
+          return "Invalid winds aloft data group '\(group)'."
         #endif
       case .invalidWindsAloftColumns(let columns):
         #if canImport(Darwin)
-        return String(
-          localized: "Invalid winds aloft column layout '\(columns)'.",
-          comment: "failure reason"
-        )
+          return String(
+            localized: "Invalid winds aloft column layout '\(columns)'.",
+            comment: "failure reason"
+          )
         #else
-        return "Invalid winds aloft column layout '\(columns)'."
+          return "Invalid winds aloft column layout '\(columns)'."
         #endif
     }
   }
@@ -199,21 +199,21 @@ extension Error: LocalizedError {
     switch self {
       case .invalidWindsAloftHeader, .invalidWindsAloftGroup, .invalidWindsAloftColumns:
         #if canImport(Darwin)
-        return String(
-          localized: "Verify the format of the Winds Aloft product.",
-          comment: "recovery suggestion"
-        )
+          return String(
+            localized: "Verify the format of the Winds Aloft product.",
+            comment: "recovery suggestion"
+          )
         #else
-        return "Verify the format of the Winds Aloft product."
+          return "Verify the format of the Winds Aloft product."
         #endif
       default:
         #if canImport(Darwin)
-        return String(
-          localized: "Verify the format of the METAR or TAF string.",
-          comment: "recovery suggestion"
-        )
+          return String(
+            localized: "Verify the format of the METAR or TAF string.",
+            comment: "recovery suggestion"
+          )
         #else
-        return "Verify the format of the METAR or TAF string."
+          return "Verify the format of the METAR or TAF string."
         #endif
     }
   }