velocity-python 0.1.125__tar.gz → 0.1.126__tar.gz

{velocity_python-0.1.125 → velocity_python-0.1.126}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.125
+Version: 0.1.126
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT

{velocity_python-0.1.125 → velocity_python-0.1.126}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "velocity-python"
-version = "0.1.125"
+version = "0.1.126"
 authors = [
   { name="Velocity Team", email="info@codeclubs.org" },
 ]

{velocity_python-0.1.125 → velocity_python-0.1.126}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.1.125"
+__version__ = version = "0.1.126"
 
 import importlib as _importlib
 

{velocity_python-0.1.125 → velocity_python-0.1.126}/src/velocity/db/core/jsonproxy.py

@@ -68,6 +68,22 @@ class BoundList(list):
         super().__init__(_wrap(v, ctrl) for v in iterable)
         self._ctrl = ctrl
 
+    # -- copies are plain values ---------------------------------------
+    # A copy of a bound value is a plain list with no link to the row.
+    # Without these, copy.deepcopy rebuilt the proxy through the pickle
+    # path and refilled it with __setitem__ — one flush (an UPDATE) per
+    # nested container for a read-only copy, or an AttributeError when the
+    # rebuilt controller had no flush (2026-09-28, found by a dance forms
+    # migration deep-copying a definition read from a JSONB column).
+    def __copy__(self):
+        return unwrap(self)
+
+    def __deepcopy__(self, memo):
+        return unwrap(self)
+
+    def __reduce__(self):
+        return (list, (unwrap(self),))
+
     # -- mutators ------------------------------------------------------
     def __setitem__(self, index, value):
         if isinstance(index, slice):
@@ -131,6 +147,22 @@ class BoundDict(dict):
         super().__init__({k: _wrap(v, ctrl) for k, v in mapping.items()})
         self._ctrl = ctrl
 
+    # -- copies are plain values ---------------------------------------
+    # A copy of a bound value is a plain dict with no link to the row.
+    # Without these, copy.deepcopy rebuilt the proxy through the pickle
+    # path and refilled it with __setitem__ — one flush (an UPDATE) per
+    # nested container for a read-only copy, or an AttributeError when the
+    # rebuilt controller had no flush (2026-09-28, found by a dance forms
+    # migration deep-copying a definition read from a JSONB column).
+    def __copy__(self):
+        return unwrap(self)
+
+    def __deepcopy__(self, memo):
+        return unwrap(self)
+
+    def __reduce__(self):
+        return (dict, (unwrap(self),))
+
     # -- mutators ------------------------------------------------------
     def __setitem__(self, key, value):
         super().__setitem__(key, _wrap(value, self._ctrl))

{velocity_python-0.1.125 → velocity_python-0.1.126}/src/velocity_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.125
+Version: 0.1.126
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT

{velocity_python-0.1.125 → velocity_python-0.1.126}/tests/test_json_columns.py

@@ -423,3 +423,60 @@ class TestRowJsonTextDecode(unittest.TestCase):
 
 if __name__ == "__main__":
     unittest.main()
+
+
+class TestProxyCopies(unittest.TestCase):
+    """A copy of a bound JSON value is a plain value: copying never
+    touches the row (2026-09-28)."""
+
+    def _bound(self):
+        from velocity.db.core import jsonproxy
+
+        writes = []
+        value = {
+            "pages": [{"ui": [{"copy": "x"}], "skippable": {"label": "s"}}],
+            "tags": ["a", ["b"]],
+        }
+        return jsonproxy.bind(value, writes.append), value, writes
+
+    def _assert_plain(self, value):
+        self.assertIn(type(value), (dict, list))
+        items = value.values() if isinstance(value, dict) else value
+        for item in items:
+            if isinstance(item, (dict, list)):
+                self._assert_plain(item)
+
+    def test_deepcopy_and_copy_are_plain_and_write_nothing(self):
+        import copy
+
+        bound, original, writes = self._bound()
+        deep = copy.deepcopy(bound)
+        shallow = copy.copy(bound)
+        self.assertEqual(deep, original)
+        self.assertEqual(shallow, original)
+        self._assert_plain(deep)
+        self._assert_plain(shallow)
+        self.assertEqual(writes, [])
+        # the copy is independent of the row
+        deep["pages"][0]["skippable"]["label"] = "changed"
+        self.assertEqual(bound["pages"][0]["skippable"]["label"], "s")
+        self.assertEqual(writes, [])
+        # nested proxies copy plain too
+        self._assert_plain(copy.deepcopy(bound["pages"]))
+        self._assert_plain(copy.copy(bound["tags"]))
+        self.assertEqual(writes, [])
+
+    def test_pickle_round_trip_is_plain(self):
+        import pickle
+
+        bound, original, writes = self._bound()
+        back = pickle.loads(pickle.dumps(bound))
+        self.assertEqual(back, original)
+        self._assert_plain(back)
+        self.assertEqual(writes, [])
+
+    def test_mutation_still_flushes(self):
+        bound, _original, writes = self._bound()
+        bound["pages"][0]["skippable"]["label"] = "t"
+        self.assertEqual(len(writes), 1)
+        self.assertEqual(writes[0]["pages"][0]["skippable"]["label"], "t")