Null guard on parse_string to prevent accidentical coercion of pd.NA to '<NA>'

Author: turukawa

CHANGELOG

@@ -1,3 +1,4 @@
+- 1.2.8: Null guard on `parse_string` to prevent accidentical coercion of `pd.NA` to `'<NA>'`.
 - 1.2.7: Fixed brittle reference to `WHYQD_SPILLWAY` temporary directory to be more robust.
 - 1.2.6: Fixed brittle reference to `WHYQD_SPILLWAY` temporary directory to be more robust.
 - 1.2.5: Fixed date parser error when date is an int POSIX timestamp.

docs/changelog.md

@@ -8,6 +8,10 @@ tags: wrangling, crosswalks, versions
 ---
 # Change log
 
+## Version 1.2.8 (2026-04-19)
+
+- Null guard on `parse_string` to prevent accidentical coercion of `pd.NA` to `'<NA>'`.
+
 ## Version 1.2.5 (2025-09-30)
 
 - Fixed date parser error when date is an int POSIX timestamp.

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "whyqd"
-version = "1.2.7"
+version = "1.2.8"
 description = "data wrangling simplicity, complete audit transparency, and at speed"
 authors = ["Gavin Chait <gchait@whythawk.com>"]
 license = "BSD-3-Clause"

whyqd/VERSION

@@ -1 +1 @@
-1.2.7
+1.2.8

whyqd/parsers/datasource.py

@@ -803,7 +803,9 @@ def parse_int(self, x: str | int | float) -> np.nan | int:
         except ValueError:
             return None
 
-    def parse_string(self, x: str) -> None | str:
+    def parse_string(self, x: str | None) -> str | None:
+        if _pd.isna(x):
+            return None
         x = str(x).replace("\n", " ").replace("\r", "").replace("\t", "").replace("\\", "").strip()
         x = " ".join(str(x).split())
         if x and x[0] == "'":