purolator: handle french tracking descriptions

Author: HansDaigle

modules/connectors/purolator/karrio/providers/purolator/units.py

@@ -2,6 +2,7 @@
 import pathlib
 import re
 import typing
+import unicodedata
 import karrio.lib as lib
 import karrio.core.units as units
 import karrio.core.models as models
@@ -325,6 +326,12 @@ class TrackingStatus(lib.Enum):
             "returned to shipper",
             "to be returned to sender",
             "returned to the shipper",
+            "retourne a l'expediteur",
+            "retour a l'expediteur",
+            "renvoye a l'expediteur",
+            "retourne a l expediteur",
+            "retour a l expediteur",
+            "renvoye a l expediteur",
         ),
         TrackingStatus.return_to_sender.name,
     ),
@@ -333,6 +340,12 @@ class TrackingStatus(lib.Enum):
             "available for pickup",
             "held for pickup",
             "pickup location",
+            "disponible pour le ramassage",
+            "disponible pour ramassage",
+            "point de ramassage",
+            "point de cueillette",
+            "ramassage",
+            "ramasser",
         ),
         TrackingStatus.ready_for_pickup.name,
     ),
@@ -356,6 +369,24 @@ class TrackingStatus(lib.Enum):
             "rail delay",
             "ferry delay",
             "service disruption",
+            "retard",
+            "retarde",
+            "retardee",
+            "retardes",
+            "retardees",
+            "reporte",
+            "reportee",
+            "reportes",
+            "reportees",
+            "replanifie",
+            "replanifiee",
+            "replanifies",
+            "replanifiees",
+            "meteo",
+            "intemperies",
+            "fermeture de route",
+            "catastrophe naturelle",
+            "perturbation de service",
         ),
         TrackingStatus.delivery_delayed.name,
     ),
@@ -364,6 +395,12 @@ class TrackingStatus(lib.Enum):
 
 def normalize_tracking_description(description: typing.Optional[str]) -> str:
     normalized = re.sub(r"\s+", " ", str(description or "").strip().lower())
+    normalized = normalized.replace("’", "'")
+    normalized = "".join(
+        c
+        for c in unicodedata.normalize("NFKD", normalized)
+        if not unicodedata.combining(c)
+    )
     return normalized.rstrip(".")
 
 

modules/connectors/purolator/tests/purolator/test_tracking.py

@@ -93,6 +93,29 @@ def test_map_tracking_status_with_undeliverable_keyword_fallback(self):
             provider_units.TrackingStatus.unknown.name,
         )
 
+    def test_map_tracking_status_with_french_descriptions(self):
+        self.assertEqual(
+            provider_units.map_tracking_status(
+                "Undeliverable",
+                "Envoi disponible pour le ramassage au point de service",
+            ),
+            provider_units.TrackingStatus.ready_for_pickup.name,
+        )
+        self.assertEqual(
+            provider_units.map_tracking_status(
+                "Undeliverable",
+                "Envoi retourné à l’expéditeur",
+            ),
+            provider_units.TrackingStatus.return_to_sender.name,
+        )
+        self.assertEqual(
+            provider_units.map_tracking_status(
+                "Undeliverable",
+                "Livraison retardée en raison des conditions météo",
+            ),
+            provider_units.TrackingStatus.delivery_delayed.name,
+        )
+
 
 if __name__ == "__main__":
     unittest.main()