From 22a1c99abe49acbaa7fc6a02b50572ca5ca8389e Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Thu, 5 Mar 2026 20:28:47 -0600
Subject: [PATCH 1/6] fix: make empty <select> option work better for
 WuttaDictEnum

pretty sure this makes sense.. guess we'll see if it causes problems
---
 src/wuttaweb/forms/schema.py |  8 +++++++-
 tests/forms/test_schema.py   | 14 ++++++++++++++
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/src/wuttaweb/forms/schema.py b/src/wuttaweb/forms/schema.py
index 20f957b..bca71ae 100644
--- a/src/wuttaweb/forms/schema.py
+++ b/src/wuttaweb/forms/schema.py
@@ -205,17 +205,23 @@ class WuttaDictEnum(colander.String):
     """
 
     def __init__(self, request, enum_dct, *args, **kwargs):
+        self.null_value = kwargs.pop("null_value", "")
         super().__init__(*args, **kwargs)
         self.request = request
         self.config = self.request.wutta_config
         self.app = self.config.get_app()
         self.enum_dct = enum_dct
 
+    def serialize(self, node, appstruct):
+        if appstruct is colander.null:
+            return self.null_value
+        return super().serialize(node, appstruct)
+
     def widget_maker(self, **kwargs):  # pylint: disable=empty-docstring
         """ """
         if "values" not in kwargs:
             kwargs["values"] = list(self.enum_dct.items())
-
+        kwargs.setdefault("null_value", self.null_value)
         return widgets.SelectWidget(**kwargs)
 
 
diff --git a/tests/forms/test_schema.py b/tests/forms/test_schema.py
index 6c587fb..f2290ef 100644
--- a/tests/forms/test_schema.py
+++ b/tests/forms/test_schema.py
@@ -153,6 +153,20 @@ MOCK_STATUS = {
 
 class TestWuttaDictEnum(WebTestCase):
 
+    def test_serialize(self):
+
+        # null_value is empty string by default
+        typ = mod.WuttaDictEnum(self.request, MOCK_STATUS)
+        node = colander.SchemaNode(typ)
+        self.assertEqual(typ.serialize(node, 1), "1")
+        self.assertEqual(typ.serialize(node, colander.null), "")
+
+        # but can override if needed (?)
+        typ = mod.WuttaDictEnum(self.request, MOCK_STATUS, null_value="nope")
+        node = colander.SchemaNode(typ)
+        self.assertEqual(typ.serialize(node, 1), "1")
+        self.assertEqual(typ.serialize(node, colander.null), "nope")
+
     def test_widget_maker(self):
         typ = mod.WuttaDictEnum(self.request, MOCK_STATUS)
         widget = typ.widget_maker()

From 634c1b1fe5494b61b1878dfb761ad607d98aedd1 Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Fri, 6 Mar 2026 19:57:08 -0600
Subject: [PATCH 2/6] fix: improve JSON-safe rendering for sets

---
 src/wuttaweb/util.py |  7 +++++++
 tests/test_util.py   | 24 ++++++++++++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/src/wuttaweb/util.py b/src/wuttaweb/util.py
index 1080820..a708398 100644
--- a/src/wuttaweb/util.py
+++ b/src/wuttaweb/util.py
@@ -654,6 +654,13 @@ def make_json_safe(value, key=None, warn=True):
             parent[i] = make_json_safe(v, key=key, warn=warn)
         value = parent
 
+    elif isinstance(value, set):
+        # recursively convert set (as list)
+        parent = list(value)
+        for i, v in enumerate(parent):
+            parent[i] = make_json_safe(v, key=key, warn=warn)
+        value = parent
+
     elif isinstance(value, _uuid.UUID):
         # convert UUID to str
         value = value.hex
diff --git a/tests/test_util.py b/tests/test_util.py
index 0be2911..b9c7490 100644
--- a/tests/test_util.py
+++ b/tests/test_util.py
@@ -735,6 +735,30 @@ class TestMakeJsonSafe(TestCase):
             ],
         )
 
+    def test_set(self):
+        model = self.app.model
+        person = model.Person(full_name="Betty Boop")
+
+        data = {
+            "foo",
+            "bar",
+            person,
+        }
+
+        self.assertRaises(TypeError, json.dumps, data)
+        value = mod.make_json_safe(data)
+        self.assertNotIsInstance(value, set)
+        self.assertIsInstance(value, list)
+        # nb. must sort values, otherwise comparison may fail
+        self.assertEqual(
+            sorted(value),
+            [
+                "Betty Boop",  # nb. upper-case sorts first
+                "bar",
+                "foo",
+            ],
+        )
+
 
 class TestRenderVueFinalize(TestCase):
 

From 19cf6cf03a14294990fea0cd07d2295a98e5a39e Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Sun, 8 Mar 2026 12:26:21 -0500
Subject: [PATCH 3/6] fix: serialize None to null, for ObjectRef schema type

not sure how this didn't come up until now..anyway hopefully it's the
right thing but we'll see
---
 src/wuttaweb/forms/schema.py | 10 ++++++----
 tests/forms/test_schema.py   |  2 ++
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/wuttaweb/forms/schema.py b/src/wuttaweb/forms/schema.py
index bca71ae..5e0364e 100644
--- a/src/wuttaweb/forms/schema.py
+++ b/src/wuttaweb/forms/schema.py
@@ -357,15 +357,17 @@ class ObjectRef(colander.SchemaType):
 
     def serialize(self, node, appstruct):  # pylint: disable=empty-docstring
         """ """
-        # nb. normalize to empty option if no object ref, so that
-        # works as expected
+        # normalize to empty option if no object ref, so that works as
+        # expected
         if self.empty_option and not appstruct:
             return self.empty_option[0]
 
-        if appstruct is colander.null:
+        # even if there is no empty option, still treat any false-ish
+        # value as null
+        if not appstruct:
             return colander.null
 
-        # nb. keep a ref to this for later use
+        # keep a ref to this for later use
         node.model_instance = appstruct
 
         # serialize to PK as string
diff --git a/tests/forms/test_schema.py b/tests/forms/test_schema.py
index f2290ef..844cb44 100644
--- a/tests/forms/test_schema.py
+++ b/tests/forms/test_schema.py
@@ -257,6 +257,8 @@ class TestObjectRef(DataTestCase):
         typ = mod.ObjectRef(self.request)
         value = typ.serialize(node, colander.null)
         self.assertIs(value, colander.null)
+        value = typ.serialize(node, None)
+        self.assertIs(value, colander.null)
 
         # model instance
         person = model.Person(full_name="Betty Boop")

From ceec4714fa81303d185a630bc75193b4679ae988 Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Mon, 9 Mar 2026 22:07:29 -0500
Subject: [PATCH 4/6] fix: skip custom rendering for missing grid columns

---
 src/wuttaweb/grids/base.py |  6 ++++--
 tests/grids/test_base.py   | 40 +++++++++++++++++++++++++++++---------
 2 files changed, 35 insertions(+), 11 deletions(-)

diff --git a/src/wuttaweb/grids/base.py b/src/wuttaweb/grids/base.py
index 2ac2646..1906997 100644
--- a/src/wuttaweb/grids/base.py
+++ b/src/wuttaweb/grids/base.py
@@ -2515,8 +2515,10 @@ class Grid:  # pylint: disable=too-many-instance-attributes,too-many-public-meth
 
             # customize value rendering where applicable
             for key, renderer in self.renderers.items():
-                value = record.get(key, None)
-                record[key] = renderer(original_record, key, value)
+                # nb. no need to render if column not included
+                if key in self.columns:
+                    value = record.get(key, None)
+                    record[key] = renderer(original_record, key, value)
 
             # add action urls to each record
             for action in self.actions:
diff --git a/tests/grids/test_base.py b/tests/grids/test_base.py
index 1e193ea..15a7a06 100644
--- a/tests/grids/test_base.py
+++ b/tests/grids/test_base.py
@@ -1985,11 +1985,13 @@ class TestGrid(WebTestCase):
 
         # typical data is a list
         mydata = [
-            {"foo": "bar"},
+            {"foo": "bar", "baz": "zoo"},
         ]
-        grid = self.make_grid(columns=["foo"], data=mydata)
+        grid = self.make_grid(columns=["foo", "baz"], data=mydata)
         context = grid.get_vue_context()
-        self.assertEqual(context, {"data": [{"foo": "bar"}], "row_classes": {}})
+        self.assertEqual(
+            context, {"data": [{"foo": "bar", "baz": "zoo"}], "row_classes": {}}
+        )
 
         # non-declared columns are discarded
         mydata = [
@@ -2001,27 +2003,47 @@ class TestGrid(WebTestCase):
 
         # if grid has actions, that list may be supplemented
         mydata = [
-            {"foo": "bar"},
+            {"foo": "bar", "baz": "zoo"},
         ]
-        grid = self.make_grid(columns=["foo"], data=mydata)
+        grid = self.make_grid(columns=["foo", "baz"], data=mydata)
         grid.actions.append(mod.GridAction(self.request, "view", url="/blarg"))
         context = grid.get_vue_context()
         self.assertIsNot(context["data"], mydata)
         self.assertEqual(
             context,
-            {"data": [{"foo": "bar", "_action_url_view": "/blarg"}], "row_classes": {}},
+            {
+                "data": [{"foo": "bar", "baz": "zoo", "_action_url_view": "/blarg"}],
+                "row_classes": {},
+            },
         )
 
         # can override value rendering
-        grid.set_renderer("foo", lambda record, key, value: "blah blah")
+        renderer = MagicMock(return_value="blah blah")
+        grid.set_renderer("foo", renderer)
         context = grid.get_vue_context()
         self.assertEqual(
             context,
             {
-                "data": [{"foo": "blah blah", "_action_url_view": "/blarg"}],
+                "data": [
+                    {"foo": "blah blah", "baz": "zoo", "_action_url_view": "/blarg"}
+                ],
                 "row_classes": {},
             },
         )
+        renderer.assert_called_once_with({"foo": "bar", "baz": "zoo"}, "foo", "bar")
+
+        # custom rendering skipped if column not included
+        grid.remove("foo")
+        renderer.reset_mock()
+        context = grid.get_vue_context()
+        self.assertEqual(
+            context,
+            {
+                "data": [{"baz": "zoo", "_action_url_view": "/blarg"}],
+                "row_classes": {},
+            },
+        )
+        renderer.assert_not_called()
 
         # can set row class
         grid.row_class = "whatever"
@@ -2029,7 +2051,7 @@ class TestGrid(WebTestCase):
         self.assertEqual(
             context,
             {
-                "data": [{"foo": "blah blah", "_action_url_view": "/blarg"}],
+                "data": [{"baz": "zoo", "_action_url_view": "/blarg"}],
                 "row_classes": {"0": "whatever"},
             },
         )

From 24f7d7ac0ad47b10565e18ce2604beb4d199e4d2 Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Tue, 10 Mar 2026 09:10:14 -0500
Subject: [PATCH 5/6] fix: add base class for `WuttaList` schema type

---
 src/wuttaweb/forms/schema.py | 54 +++++++++++++++++++++++++++++++++---
 tests/forms/test_schema.py   | 20 +++++++++++++
 2 files changed, 70 insertions(+), 4 deletions(-)

diff --git a/src/wuttaweb/forms/schema.py b/src/wuttaweb/forms/schema.py
index 5e0364e..6deb56d 100644
--- a/src/wuttaweb/forms/schema.py
+++ b/src/wuttaweb/forms/schema.py
@@ -280,13 +280,59 @@ class WuttaQuantity(colander.Decimal):
         return self.app.render_quantity(appstruct)
 
 
-class WuttaSet(colander.Set):
+class WuttaList(colander.List):
     """
-    Custom schema type for :class:`python:set` fields.
-
-    This is a subclass of :class:`colander.Set`.
+    Custom schema type for :class:`python:list` fields; this is a
+    subclass of :class:`colander.List`.
 
     :param request: Current :term:`request` object.
+
+    As of now this merely provides a way (in fact, requires you) to
+    pass the request in, so it can be leveraged as needed.  Instances
+    of this type will have the following attributes:
+
+    .. attribute:: request
+
+       Reference to the current :term:`request`.
+
+    .. attribute:: config
+
+       Reference to the app :term:`config object`.
+
+    .. attribute:: app
+
+       Reference to the :term:`app handler` instance.
+    """
+
+    def __init__(self, request):
+        super().__init__()
+        self.request = request
+        self.config = self.request.wutta_config
+        self.app = self.config.get_app()
+
+
+class WuttaSet(colander.Set):
+    """
+    Custom schema type for :class:`python:set` fields; this is a
+    subclass of :class:`colander.Set`.
+
+    :param request: Current :term:`request` object.
+
+    As of now this merely provides a way (in fact, requires you) to
+    pass the request in, so it can be leveraged as needed.  Instances
+    of this type will have the following attributes:
+
+    .. attribute:: request
+
+       Reference to the current :term:`request`.
+
+    .. attribute:: config
+
+       Reference to the app :term:`config object`.
+
+    .. attribute:: app
+
+       Reference to the :term:`app handler` instance.
     """
 
     def __init__(self, request):
diff --git a/tests/forms/test_schema.py b/tests/forms/test_schema.py
index 844cb44..d6b7420 100644
--- a/tests/forms/test_schema.py
+++ b/tests/forms/test_schema.py
@@ -198,6 +198,26 @@ class TestWuttaMoney(WebTestCase):
         self.assertEqual(widget.scale, 4)
 
 
+class TestWuttaList(WebTestCase):
+
+    def test_constructor(self):
+        node = colander.SchemaNode(mod.WuttaList(self.request))
+        typ = node.typ
+        self.assertIs(typ.request, self.request)
+        self.assertIs(typ.config, self.config)
+        self.assertIs(typ.app, self.app)
+
+
+class TestWuttaSet(WebTestCase):
+
+    def test_constructor(self):
+        node = colander.SchemaNode(mod.WuttaSet(self.request))
+        typ = node.typ
+        self.assertIs(typ.request, self.request)
+        self.assertIs(typ.config, self.config)
+        self.assertIs(typ.app, self.app)
+
+
 class TestWuttaQuantity(WebTestCase):
 
     def test_serialize(self):

From 064b1b6d8a5ab9632c8230aca232ca82769d245f Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Tue, 10 Mar 2026 10:58:06 -0500
Subject: [PATCH 6/6] =?UTF-8?q?bump:=20version=200.29.1=20=E2=86=92=200.29?=
 =?UTF-8?q?.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md   | 10 ++++++++++
 pyproject.toml |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 46b6dac..9202116 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,16 @@ All notable changes to wuttaweb will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## v0.29.2 (2026-03-10)
+
+### Fix
+
+- add base class for `WuttaList` schema type
+- skip custom rendering for missing grid columns
+- serialize None to null, for ObjectRef schema type
+- improve JSON-safe rendering for sets
+- make empty <select> option work better for WuttaDictEnum
+
 ## v0.29.1 (2026-03-04)
 
 ### Fix
diff --git a/pyproject.toml b/pyproject.toml
index 2fa4ee9..2613603 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "WuttaWeb"
-version = "0.29.1"
+version = "0.29.2"
 description = "Web App for Wutta Framework"
 readme = "README.md"
 authors = [{name = "Lance Edgar", email = "lance@wuttaproject.org"}]