python-general-be-lib 0.10.0__py3-none-any.whl → 0.10.0.post2__py3-none-any.whl

general/interface/mixin/timestamp_mixin.py

@@ -17,12 +17,19 @@ class TimestampMixin:
     ``TIMESTAMP WITH TIME ZONE``, on the backends that ignore the flag the column is a
     plain timestamp and the value is the one the database produces.
 
-    ``create_date`` is filled by a **server-side** default, so it is correct even for rows
-    inserted outside the library, by a migration or by hand. ``write_date`` is refreshed by
-    ``onupdate``, which SQLAlchemy adds to the UPDATE statement it builds: it therefore
-    covers ``CrudRepository.update`` and ``upsert``, and does **not** cover a raw SQL
-    UPDATE run outside the library — that would need a database trigger, which a mixin
-    cannot install.
+    Both timestamps carry **two** defaults, and both are needed. ``server_default`` is a
+    DDL clause: it ends up in the ``CREATE TABLE`` and covers the rows inserted outside the
+    library, by a migration or by hand — but only on the tables the library creates
+    afterwards. On a table that already exists the column has no such clause, and since
+    SQLAlchemy omits a ``server_default`` column from the INSERT expecting the database to
+    fill it, the write would fail on the ``NOT NULL``. The ``default`` is what covers that
+    case: being a SQL expression it is rendered inline in the INSERT, so the value comes
+    from the database clock either way, and no DDL is required.
+
+    ``write_date`` is refreshed by ``onupdate``, which SQLAlchemy adds to the UPDATE
+    statement it builds: it therefore covers ``CrudRepository.update`` and ``upsert``, and
+    does **not** cover a raw SQL UPDATE run outside the library — that would need a
+    database trigger, which a mixin cannot install.
 
     Attributes:
         create_date (Column): Insert instant, from the ``now()`` of the database. Not null.
@@ -31,5 +38,5 @@ class TimestampMixin:
             update.
     """
 
-    create_date = Column(DateTime, server_default=func.now(), nullable=False)
-    write_date = Column(DateTime, server_default=func.now(), onupdate=func.now(), nullable=False)
+    create_date = Column(DateTime, default=func.now(), server_default=func.now(), nullable=False)
+    write_date = Column(DateTime, default=func.now(), server_default=func.now(), onupdate=func.now(), nullable=False)

{python_general_be_lib-0.10.0.dist-info → python_general_be_lib-0.10.0.post2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-general-be-lib
-Version: 0.10.0
+Version: 0.10.0.post2
 Summary: General purpose backend library — SQLAlchemy CRUD/Geometry repositories, FastAPI exceptions, Pydantic base models, logger utilities.
 Author-email: Andrea Di Placido <a.diplacido@arpes.it>, "Arpes S.r.l." <it.admin@arpes.it>
 License: MIT

{python_general_be_lib-0.10.0.dist-info → python_general_be_lib-0.10.0.post2.dist-info}/RECORD

@@ -17,7 +17,7 @@ general/interface/metadata/geom_metadata.py,sha256=gzeFkC9qyV_GXxtAaKmA9dka0DaC-
 general/interface/mixin/__init__.py,sha256=M5-e6T_R63Utwh3_WcmoE3wanwIZjNjbgLYrrFlSpTA,659
 general/interface/mixin/audit_mixin.py,sha256=N2JDD9JxXDMeBqu0yAlhVWFOK3EeUA2b215hPvXytUU,1421
 general/interface/mixin/softdelete_mixin.py,sha256=526luzM4DBCorcq99kZ6BYqtQKKJCpnxX9rSEigfyIU,2148
-general/interface/mixin/timestamp_mixin.py,sha256=TMetFs3zgI7YanckFnfycpNGn-ZbptwweKdOxe125O0,1641
+general/interface/mixin/timestamp_mixin.py,sha256=wmcIx2Y8jgVqg9A-1E61BvkcKCo52ZjKNHeKfXJmUl0,2220
 general/interface/repository/__init__.py,sha256=eWoNy35LVu6sDrK5ju7VAeoclknKO0-yTgjVckJpi8s,321
 general/interface/repository/crud_repository.py,sha256=pA3zNvZuLa7Ddeq1j8vNjPNc4KFWAL1-RwEuyc5C0oE,40543
 general/interface/repository/geometry_repository.py,sha256=dB1AmZyyi5cWEzl-_4-2eOXXex-rQsa_cu6bl85wtNE,11252
@@ -33,8 +33,8 @@ general/interface/repository/handler/json_ilike_handler.py,sha256=icfA4dO8E_W_KU
 general/interface/repository/handler/or_handler.py,sha256=UOjIh77H4y-x434YGLYRfVIXKnod1M5XPiMf71V2JTg,3137
 general/interface/repository/handler/soft_delete_handler.py,sha256=1WD1n6q5plyJ0RDniJcEwNlic1WJqXvSlCj99VLc_3A,4100
 general/interface/repository/handler/statement_manager.py,sha256=dPG-HZy0jVM3Y4ZnCp2QPY4gLgt-rWSzOvY1_UmotcI,7333
-python_general_be_lib-0.10.0.dist-info/licenses/LICENSE,sha256=iUaO1XZyB9P3Tmog0OILuTisP6vXGe3QKz-4yRTxOFk,1069
-python_general_be_lib-0.10.0.dist-info/METADATA,sha256=yUNc1zJR-Nih7Iz9nVpD8jncus9MkL-fzihP8psvVfU,3410
-python_general_be_lib-0.10.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_general_be_lib-0.10.0.dist-info/top_level.txt,sha256=tTZePW8_CNUqSgKFd2SEH72ZbnhS0OYjRsgcv0ikSFY,8
-python_general_be_lib-0.10.0.dist-info/RECORD,,
+python_general_be_lib-0.10.0.post2.dist-info/licenses/LICENSE,sha256=iUaO1XZyB9P3Tmog0OILuTisP6vXGe3QKz-4yRTxOFk,1069
+python_general_be_lib-0.10.0.post2.dist-info/METADATA,sha256=O8iGfUPSn-CZq-EUAL9SGfLW2TD1KL7DXmM_gXDPWO8,3416
+python_general_be_lib-0.10.0.post2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_general_be_lib-0.10.0.post2.dist-info/top_level.txt,sha256=tTZePW8_CNUqSgKFd2SEH72ZbnhS0OYjRsgcv0ikSFY,8
+python_general_be_lib-0.10.0.post2.dist-info/RECORD,,