half-orm 0.18.0__tar.gz → 0.18.2__tar.gz

{half_orm-0.18.0/half_orm.egg-info → half_orm-0.18.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: half_orm
-Version: 0.18.0
+Version: 0.18.2
 Summary: A simple PostgreSQL to Python mapper.
 Home-page: https://github.com/half-orm/half-orm
 Author: Joël Maïzi
@@ -40,6 +40,19 @@ Requires-Dist: importlib-metadata; python_version < "3.8"
 [![Coverage](https://coveralls.io/repos/github/half-orm/half-orm/badge.svg?branch=main)](https://coveralls.io/github/half-orm/half-orm?branch=main)
 [![Downloads](https://static.pepy.tech/badge/half_orm)](https://pepy.tech/project/half_orm)
 
+> ## ⚠️ BREAKING CHANGE in v0.18 — psycopg2 → psycopg 3
+>
+> halfORM 0.18 **drops psycopg2** and requires **[psycopg 3](https://www.psycopg.org/psycopg3/)**.
+>
+> ```bash
+> pip uninstall psycopg2-binary
+> pip install "psycopg[binary]"
+> ```
+>
+> If you use custom psycopg2 adapters in your own code, rewrite them with the
+> psycopg 3 `Dumper`/`Loader` API.
+> See the [full migration notes in CHANGELOG.md](CHANGELOG.md#0180-2026-03-19).
+
 **The PostgreSQL-native ORM that stays out of your way**
 
 > halfORM lets you keep your database schema in SQL where it belongs, while giving you the comfort of Python for data manipulation. No migrations, no schema conflicts, no ORM fighting — just PostgreSQL and Python working together.

{half_orm-0.18.0 → half_orm-0.18.2}/README.md

@@ -8,6 +8,19 @@
 [![Coverage](https://coveralls.io/repos/github/half-orm/half-orm/badge.svg?branch=main)](https://coveralls.io/github/half-orm/half-orm?branch=main)
 [![Downloads](https://static.pepy.tech/badge/half_orm)](https://pepy.tech/project/half_orm)
 
+> ## ⚠️ BREAKING CHANGE in v0.18 — psycopg2 → psycopg 3
+>
+> halfORM 0.18 **drops psycopg2** and requires **[psycopg 3](https://www.psycopg.org/psycopg3/)**.
+>
+> ```bash
+> pip uninstall psycopg2-binary
+> pip install "psycopg[binary]"
+> ```
+>
+> If you use custom psycopg2 adapters in your own code, rewrite them with the
+> psycopg 3 `Dumper`/`Loader` API.
+> See the [full migration notes in CHANGELOG.md](CHANGELOG.md#0180-2026-03-19).
+
 **The PostgreSQL-native ORM that stays out of your way**
 
 > halfORM lets you keep your database schema in SQL where it belongs, while giving you the comfort of Python for data manipulation. No migrations, no schema conflicts, no ORM fighting — just PostgreSQL and Python working together.

{half_orm-0.18.0 → half_orm-0.18.2}/half_orm/model.py

@@ -151,9 +151,11 @@ class Model:
                     f"(using peer authentication with dbname '{self.__config_file}')")
             raise psycopg.OperationalError(f"{exc}\n{config_info}") from exc
         # Register custom type dumpers on this connection
-        from half_orm.null import Null, NullDumper
+        from half_orm.null import Null, NullDumper, FieldDumper
+        from half_orm.field import Field
         from psycopg.types.json import JsonbDumper
         self.__conn.adapters.register_dumper(Null, NullDumper)
+        self.__conn.adapters.register_dumper(Field, FieldDumper)
         self.__conn.adapters.register_dumper(dict, JsonbDumper)
         self.__pg_meta = pg_meta.PgMeta(self.__conn, reload)
         if reload:
@@ -253,9 +255,11 @@ class Model:
             return
         self.__aconn = await AsyncConnection.connect(
             **self._dbinfo, row_factory=dict_row, autocommit=True)
-        from half_orm.null import Null, NullDumper
+        from half_orm.null import Null, NullDumper, FieldDumper
+        from half_orm.field import Field
         from psycopg.types.json import JsonbDumper
         self.__aconn.adapters.register_dumper(Null, NullDumper)
+        self.__aconn.adapters.register_dumper(Field, FieldDumper)
         self.__aconn.adapters.register_dumper(dict, JsonbDumper)
 
     async def adisconnect(self):
@@ -338,7 +342,8 @@ class Model:
         from half_orm.null import Null
         if isinstance(values, (list, tuple)):
             def _unwrap(v):
-                if isinstance(v, Field):
+                # Recursively unwrap nested Field objects (e.g. Relation(col=other.col))
+                while isinstance(v, Field):
                     v = v.value
                 if isinstance(v, Null):
                     return None

half_orm-0.18.2/half_orm/null.py

@@ -0,0 +1,46 @@
+#-*- coding: utf-8 -*-
+# pylint: disable=too-few-public-methods
+
+"""The null module provides the Null class
+The Null class is used to set NULL value to relation fields.
+"""
+
+from psycopg.adapt import Dumper
+
+__all__ = ['NULL']
+
+class Null:
+    """The Null class"""
+
+class NullDumper(Dumper):
+    """Dumper for the Null class — renders as SQL NULL literal."""
+    def dump(self, obj):
+        return b"NULL"
+
+    def quote(self, obj):
+        return b"NULL"
+
+NULL = Null()
+
+
+class FieldDumper(Dumper):
+    """Psycopg 3 Dumper for Field objects.
+
+    Delegates serialization to the appropriate dumper for ``Field.value``.
+    This handles the case where a Field object is passed directly as a query
+    parameter (e.g. ``Relation(col=other_relation.col)``).
+    """
+
+    def upgrade(self, obj, format):
+        v = obj.value
+        if isinstance(v, Null) or v is None:
+            return NullDumper(type(obj), self.connection)
+        return self
+
+    def dump(self, obj):
+        v = obj.value
+        if isinstance(v, Null) or v is None:
+            return None
+        from psycopg.adapt import Transformer, PyFormat
+        tx = Transformer(self.connection)
+        return tx.get_dumper(v, PyFormat.AUTO).dump(v)

half_orm-0.18.2/half_orm/version.txt

@@ -0,0 +1 @@
+0.18.2

{half_orm-0.18.0 → half_orm-0.18.2/half_orm.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: half_orm
-Version: 0.18.0
+Version: 0.18.2
 Summary: A simple PostgreSQL to Python mapper.
 Home-page: https://github.com/half-orm/half-orm
 Author: Joël Maïzi
@@ -40,6 +40,19 @@ Requires-Dist: importlib-metadata; python_version < "3.8"
 [![Coverage](https://coveralls.io/repos/github/half-orm/half-orm/badge.svg?branch=main)](https://coveralls.io/github/half-orm/half-orm?branch=main)
 [![Downloads](https://static.pepy.tech/badge/half_orm)](https://pepy.tech/project/half_orm)
 
+> ## ⚠️ BREAKING CHANGE in v0.18 — psycopg2 → psycopg 3
+>
+> halfORM 0.18 **drops psycopg2** and requires **[psycopg 3](https://www.psycopg.org/psycopg3/)**.
+>
+> ```bash
+> pip uninstall psycopg2-binary
+> pip install "psycopg[binary]"
+> ```
+>
+> If you use custom psycopg2 adapters in your own code, rewrite them with the
+> psycopg 3 `Dumper`/`Loader` API.
+> See the [full migration notes in CHANGELOG.md](CHANGELOG.md#0180-2026-03-19).
+
 **The PostgreSQL-native ORM that stays out of your way**
 
 > halfORM lets you keep your database schema in SQL where it belongs, while giving you the comfort of Python for data manipulation. No migrations, no schema conflicts, no ORM fighting — just PostgreSQL and Python working together.

half_orm-0.18.0/half_orm/null.py

@@ -1,23 +0,0 @@
-#-*- coding: utf-8 -*-
-# pylint: disable=too-few-public-methods
-
-"""The null module provides the Null class
-The Null class is used to set NULL value to relation fields.
-"""
-
-from psycopg.adapt import Dumper
-
-__all__ = ['NULL']
-
-class Null:
-    """The Null class"""
-
-class NullDumper(Dumper):
-    """Dumper for the Null class — renders as SQL NULL literal."""
-    def dump(self, obj):
-        return b"NULL"
-
-    def quote(self, obj):
-        return b"NULL"
-
-NULL = Null()

half_orm-0.18.0/half_orm/version.txt

@@ -1 +0,0 @@
-0.18.0