Merge pull request #1 from Pymetheus/update-main

v0.1.5 Update

Author: Pymetheus

docs/SECURITY.md

@@ -4,11 +4,11 @@ If you believe you have found a security vulnerability, please report it to us a
 
 ## Supported Versions
 
-Currently only the 0.1.4 version of the sqlalchemy-dbtoolkit is supported.
+Currently only the 0.1.5 version of the sqlalchemy-dbtoolkit is supported.
 
 | Version | Supported          |
-| ------- | ------------------ |
-| 0.1.4   | :white_check_mark: |
+|---------| ------------------ |
+| 0.1.5   | :white_check_mark: |
 | others  | :x:                |
 
 ## Reporting a Vulnerability

setup.py

@@ -5,7 +5,7 @@
 
 setup(
     name="sqlalchemy-dbtoolkit",
-    version="0.1.4",
+    version="0.1.5",
     description="A toolkit for building SQLAlchemy database engines and utilities.",
     long_description=long_description,
     long_description_content_type="text/markdown",

sqlalchemy_dbtoolkit/utils/sanitization.py

@@ -0,0 +1,21 @@
+import pandas as pd
+
+
+def sanitize_nan_to_none(value):
+    """
+    Converts NaN-like values to None for safe SQL insertion.
+
+    Args:
+        value (any): The value to sanitize. Can be of any type, including float, string, or None.
+
+    Returns:
+        any: None if the value represents missing data (e.g., np.nan, pd.NA, or the string "NaN");
+             otherwise, returns the original value.
+    """
+
+    if pd.isna(value):
+        return None
+    elif isinstance(value, str) and value.strip().lower() == "nan":
+        return None
+    else:
+        return value