ddsql 0.3.0__tar.gz → 0.3.1__tar.gz

{ddsql-0.3.0 → ddsql-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ddsql
-Version: 0.3.0
+Version: 0.3.1
 Summary: SQL Query Library
 Keywords: python,ddsql
 Author: davyddd
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
-Requires-Dist: ddutils>=0.2.0,<0.3.0
+Requires-Dist: ddutils>=0.3.0,<0.4.0
 Requires-Dist: jinja2>=3.0.0,<4.0.0
 Requires-Python: >=3.11, <3.15
 Project-URL: Repository, https://github.com/davyddd/ddsql
@@ -71,6 +71,11 @@ or create your own by inheriting from `BaseSerializer`.
 | `date`               | `'2025-01-01'`          | `'2025-01-01'::date`               | `toDate('2025-01-01')`                                |
 | `list`/`tuple`/`set` | `(item1, item2, ...)`   | `(item1, item2, ...)`              | `(item1, item2, ...)`                                 |
 
+An `Enum` member is serialized by its value: `Kind.ADMIN` of a `class Kind(str, Enum)` renders as `'admin'`,
+a plain `Enum` holding a `datetime` as that `datetime`. A subclass is matched as its base type
+(a `ProfileId(UUID)` as a `UUID`, a `pendulum.DateTime` as a `datetime`). `bytes` and `bytearray` are not
+serialized: like any other type missing from the table they go to `serialize_other_object`.
+
 String values are escaped according to the dialect rules, so quotes, backslashes 
 and control characters cannot break the query:
 

{ddsql-0.3.0 → ddsql-0.3.1}/README.md

@@ -51,6 +51,11 @@ or create your own by inheriting from `BaseSerializer`.
 | `date`               | `'2025-01-01'`          | `'2025-01-01'::date`               | `toDate('2025-01-01')`                                |
 | `list`/`tuple`/`set` | `(item1, item2, ...)`   | `(item1, item2, ...)`              | `(item1, item2, ...)`                                 |
 
+An `Enum` member is serialized by its value: `Kind.ADMIN` of a `class Kind(str, Enum)` renders as `'admin'`,
+a plain `Enum` holding a `datetime` as that `datetime`. A subclass is matched as its base type
+(a `ProfileId(UUID)` as a `UUID`, a `pendulum.DateTime` as a `datetime`). `bytes` and `bytearray` are not
+serialized: like any other type missing from the table they go to `serialize_other_object`.
+
 String values are escaped according to the dialect rules, so quotes, backslashes 
 and control characters cannot break the query:
 

{ddsql-0.3.0 → ddsql-0.3.1}/ddsql/serializers/base.py

@@ -4,6 +4,9 @@ from decimal import Decimal
 from typing import Any
 from uuid import UUID
 
+from ddutils.annotation_helpers import NON_COMPLEX_SEQUENCE_TYPES
+from ddutils.value_helpers import unwrap_enum
+
 
 class BaseSerializer:
     @property
@@ -11,6 +14,9 @@ class BaseSerializer:
         return {'serialize_value': self.serialize_value}
 
     def serialize_value(self, value: Any) -> str:
+        # an `Enum` member is serialized by its value: `f'{Kind.A}'` of a `class Kind(int, Enum)` is 'Kind.A', not '1'
+        value = unwrap_enum(value)
+
         if value is None:
             return self.serialize_none(value)
         elif isinstance(value, bool):
@@ -27,7 +33,8 @@ class BaseSerializer:
             # the check for date must come after datetime,
             # because a datetime instance can also be identified as a date
             return self.serialize_date(value)
-        elif isinstance(value, Collection) and not isinstance(value, Mapping):
+        elif isinstance(value, Collection) and not isinstance(value, (Mapping, *NON_COMPLEX_SEQUENCE_TYPES)):
+            # `bytes` is a collection of ints, but has no SQL representation here
             return self.serialize_collection(value)
         else:
             return self.serialize_other_object(value)

{ddsql-0.3.0 → ddsql-0.3.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "ddsql"
 description = "SQL Query Library"
-version = "0.3.0"
+version = "0.3.1"
 license = "MIT"
 license-files = ["LICENSE"]
 readme = "README.md"
@@ -19,7 +19,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "ddutils>=0.2.0,<0.3.0",
+    "ddutils>=0.3.0,<0.4.0",
     "jinja2>=3.0.0,<4.0.0",
 ]
 

{ddsql-0.3.0 → ddsql-0.3.1}/pyproject.toml.orig

@@ -1,7 +1,7 @@
 [project]
 name = "ddsql"
 description = "SQL Query Library"
-version = "0.3.0"
+version = "0.3.1"
 authors = [{ name = "davyddd" }]
 license = "MIT"
 license-files = ["LICENSE"]
@@ -18,7 +18,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "ddutils>=0.2.0,<0.3.0",
+    "ddutils>=0.3.0,<0.4.0",
     "jinja2>=3.0.0,<4.0.0",
 ]