WuttaWeb 0.20.3__tar.gz → 0.20.5__tar.gz

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.20.5 (2025-01-23)
+
+### Fix
+
+- improve styling for grid tools section
+- add basic checkbox support for grids
+- add WuttaRequestMixin for ThisPage component
+- avoid literal `None` when rendering form field value
+- let header title be even wider
+
+## v0.20.4 (2025-01-15)
+
+### Fix
+
+- add `WuttaDateWidget` and associated logic
+- add  `serialize_object()` method for `ObjectRef` schema node
+
 ## v0.20.3 (2025-01-14)
 
 ### Fix

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: WuttaWeb
-Version: 0.20.3
+Version: 0.20.5
 Summary: Web App for Wutta Framework
 Project-URL: Homepage, https://wuttaproject.org/
 Project-URL: Repository, https://forgejo.wuttaproject.org/wutta/wuttaweb
@@ -39,7 +39,7 @@ Requires-Dist: pyramid-tm
 Requires-Dist: pyramid>=2
 Requires-Dist: waitress
 Requires-Dist: webhelpers2
-Requires-Dist: wuttjamaican[db]>=0.20.1
+Requires-Dist: wuttjamaican[db]>=0.20.2
 Requires-Dist: zope-sqlalchemy>=1.5
 Provides-Extra: continuum
 Requires-Dist: wutta-continuum; extra == 'continuum'

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "WuttaWeb"
-version = "0.20.3"
+version = "0.20.5"
 description = "Web App for Wutta Framework"
 readme = "README.md"
 authors = [{name = "Lance Edgar", email = "lance@wuttaproject.org"}]
@@ -44,7 +44,7 @@ dependencies = [
         "pyramid_tm",
         "waitress",
         "WebHelpers2",
-        "WuttJamaican[db]>=0.20.1",
+        "WuttJamaican[db]>=0.20.2",
         "zope.sqlalchemy>=1.5",
 ]
 

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/forms/base.py

@@ -546,10 +546,13 @@ class Form:
         This is generally only possible if :attr:`model_class` is set
         to a valid SQLAlchemy mapped class.
 
-        As of writing this only looks for
-        :class:`sqlalchemy:sqlalchemy.types.DateTime` fields and if
-        any are found, they are configured to use
-        :class:`~wuttaweb.forms.widgets.WuttaDateTimeWidget()`.
+        This only checks for a couple of data types, with mapping as
+        follows:
+
+        * :class:`sqlalchemy:sqlalchemy.types.Date` ->
+          :class:`~wuttaweb.forms.widgets.WuttaDateWidget`
+        * :class:`sqlalchemy:sqlalchemy.types.DateTime` ->
+          :class:`~wuttaweb.forms.widgets.WuttaDateTimeWidget`
         """
         from wuttaweb.forms import widgets
 
@@ -565,8 +568,9 @@ class Form:
                 prop = getattr(attr, 'prop', None)
                 if prop and isinstance(prop, orm.ColumnProperty):
                     column = prop.columns[0]
-                    if isinstance(column.type, sa.DateTime):
-                        # self.set_renderer(key, self.render_datetime)
+                    if isinstance(column.type, sa.Date):
+                        self.set_widget(key, widgets.WuttaDateWidget(self.request))
+                    elif isinstance(column.type, sa.DateTime):
                         self.set_widget(key, widgets.WuttaDateTimeWidget(self.request))
 
     def set_grid(self, key, grid):
@@ -1029,12 +1033,13 @@ class Form:
             # render static text if field not in deform/schema
             # TODO: need to abstract this somehow
             if self.model_instance:
-                html = str(self.model_instance[fieldname])
+                value = self.model_instance[fieldname]
+                html = str(value) if value is not None else ''
             else:
                 html = ''
 
         # mark all that as safe
-        html = HTML.literal(html)
+        html = HTML.literal(html or ' ')
 
         # render field label
         label = self.get_label(fieldname)

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/forms/schema.py

@@ -334,8 +334,21 @@ class ObjectRef(colander.SchemaType):
         # nb. keep a ref to this for later use
         node.model_instance = appstruct
 
-        # serialize to uuid
-        return appstruct.uuid.hex
+        # serialize to PK as string
+        return self.serialize_object(appstruct)
+
+    def serialize_object(self, obj):
+        """
+        Serialize the given object to its primary key as string.
+
+        Default logic assumes the object has a UUID; subclass can
+        override as needed.
+
+        :param obj: Object reference for the node.
+
+        :returns: Object primary key as string.
+        """
+        return obj.uuid.hex
 
     def deserialize(self, node, cstruct):
         """ """
@@ -417,7 +430,7 @@ class ObjectRef(colander.SchemaType):
         if 'values' not in kwargs:
             query = self.get_query()
             objects = query.all()
-            values = [(obj.uuid.hex, str(obj))
+            values = [(self.serialize_object(obj), str(obj))
                       for obj in objects]
             if self.empty_option:
                 values.insert(0, self.empty_option)

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/forms/widgets.py

@@ -36,6 +36,7 @@ in the namespace:
 * :class:`deform:deform.widget.CheckboxWidget`
 * :class:`deform:deform.widget.SelectWidget`
 * :class:`deform:deform.widget.CheckboxChoiceWidget`
+* :class:`deform:deform.widget.DateInputWidget`
 * :class:`deform:deform.widget.DateTimeInputWidget`
 * :class:`deform:deform.widget.MoneyInputWidget`
 """
@@ -49,7 +50,7 @@ import humanize
 from deform.widget import (Widget, TextInputWidget, TextAreaWidget,
                            PasswordWidget, CheckedPasswordWidget,
                            CheckboxWidget, SelectWidget, CheckboxChoiceWidget,
-                           DateTimeInputWidget, MoneyInputWidget)
+                           DateInputWidget, DateTimeInputWidget, MoneyInputWidget)
 from webhelpers2.html import HTML
 
 from wuttjamaican.conf import parse_list
@@ -153,6 +154,43 @@ class WuttaCheckboxChoiceWidget(CheckboxChoiceWidget):
         self.app = self.config.get_app()
 
 
+class WuttaDateWidget(DateInputWidget):
+    """
+    Custom widget for :class:`python:datetime.date` fields.
+
+    The main purpose of this widget is to leverage
+    :meth:`~wuttjamaican:wuttjamaican.app.AppHandler.render_date()`
+    for the readonly display.
+
+    It is automatically used for SQLAlchemy mapped classes where the
+    field maps to a :class:`sqlalchemy:sqlalchemy.types.Date` column.
+    For other (non-mapped) date fields, or mapped datetime fields for
+    which a date widget is preferred, use
+    :meth:`~wuttaweb.forms.base.Form.set_widget()`.
+
+    This is a subclass of
+    :class:`deform:deform.widget.DateInputWidget` and uses these
+    Deform templates:
+
+    * ``dateinput``
+    """
+
+    def __init__(self, request, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.request = request
+        self.config = self.request.wutta_config
+        self.app = self.config.get_app()
+
+    def serialize(self, field, cstruct, **kw):
+        """ """
+        readonly = kw.get('readonly', self.readonly)
+        if readonly and cstruct:
+            dt = datetime.datetime.fromisoformat(cstruct)
+            return self.app.render_date(dt)
+
+        return super().serialize(field, cstruct, **kw)
+
+
 class WuttaDateTimeWidget(DateTimeInputWidget):
     """
     Custom widget for :class:`python:datetime.datetime` fields.

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/grids/base.py

@@ -118,6 +118,11 @@ class Grid:
        See also :meth:`set_renderer()` and
        :meth:`set_default_renderers()`.
 
+    .. attribute:: checkable
+
+       Boolean indicating whether the grid should expose per-row
+       checkboxes.
+
     .. attribute:: row_class
 
        This represents the CSS ``class`` attribute for a row within
@@ -362,6 +367,7 @@ class Grid:
             data=None,
             labels={},
             renderers={},
+            checkable=False,
             row_class=None,
             actions=[],
             linked_columns=[],
@@ -388,6 +394,7 @@ class Grid:
         self.key = key
         self.data = data
         self.labels = labels or {}
+        self.checkable = checkable
         self.row_class = row_class
         self.actions = actions or []
         self.linked_columns = linked_columns or []

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/templates/base.mako

@@ -155,7 +155,7 @@
     }
 
     #content-title h1 {
-        max-width: 85%;
+        max-width: 95%;
         overflow: hidden;
         padding-left: 0.5rem;
         text-overflow: ellipsis;
@@ -186,6 +186,11 @@
         width: 100%;
     }
 
+    .wutta-grid-tools-wrapper {
+        display: flex;
+        gap: 0.5rem;
+    }
+
     ##############################
     ## forms
     ##############################

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/templates/grids/vue_template.mako

@@ -116,6 +116,13 @@
                 hoverable
                 icon-pack="fas"
 
+                ## checkboxes
+                % if grid.checkable:
+                    checkable
+                    checkbox-position="right"
+                    :checked-rows.sync="checkedRows"
+                % endif
+
                 ## sorting
                 % if grid.sortable:
                     ## nb. buefy/oruga only support *one* default sorter
@@ -267,6 +274,11 @@
           shareLink: null,
       % endif
 
+      ## checkboxes
+      % if grid.checkable:
+          checkedRows: [],
+      % endif
+
       ## filtering
       % if grid.filterable:
           filters: ${json.dumps(grid.get_vue_filters())|n},

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/templates/page.mako

@@ -26,6 +26,7 @@
 
     const ThisPage = {
         template: '#this-page-template',
+        mixins: [WuttaRequestMixin],
         props: {
             ## configureFieldsHelp: Boolean,
         },

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/src/wuttaweb/views/master.py

@@ -189,6 +189,12 @@ class MasterView(View):
 
        This is optional; see also :meth:`get_grid_columns()`.
 
+    .. attribute:: checkable
+
+       Boolean indicating whether the grid should expose per-row
+       checkboxes.  This is passed along to set
+       :attr:`~wuttaweb.grids.base.Grid.checkable` on the grid.
+
     .. method:: grid_row_class(obj, data, i)
 
        This method is *not* defined on the ``MasterView`` base class;
@@ -395,6 +401,7 @@ class MasterView(View):
     # features
     listable = True
     has_grid = True
+    checkable = False
     filterable = True
     filter_defaults = None
     sortable = True
@@ -1992,6 +1999,7 @@ class MasterView(View):
 
             kwargs['tools'] = tools
 
+        kwargs.setdefault('checkable', self.checkable)
         if hasattr(self, 'grid_row_class'):
             kwargs.setdefault('row_class', self.grid_row_class)
         kwargs.setdefault('filterable', self.filterable)

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/tests/forms/test_base.py

@@ -3,6 +3,8 @@
 from unittest import TestCase
 from unittest.mock import MagicMock, patch
 
+import sqlalchemy as sa
+
 import colander
 import deform
 from pyramid import testing
@@ -188,6 +190,18 @@ class TestForm(TestCase):
         self.assertIn('created', form.widgets)
         self.assertIsInstance(form.widgets['created'], MyWidget)
 
+        # mock up a table with all relevant column types
+        class Whatever(model.Base):
+            __tablename__ = 'whatever'
+            id = sa.Column(sa.Integer(), primary_key=True)
+            date = sa.Column(sa.Date())
+            date_time = sa.Column(sa.DateTime())
+
+        # widget set for all known types
+        form = self.make_form(model_class=Whatever)
+        self.assertIsInstance(form.widgets['date'], widgets.WuttaDateWidget)
+        self.assertIsInstance(form.widgets['date_time'], widgets.WuttaDateTimeWidget)
+
     def test_set_grid(self):
         form = self.make_form(fields=['foo', 'bar'])
         self.assertNotIn('foo', form.widgets)

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/tests/forms/test_widgets.py

@@ -87,6 +87,46 @@ class TestObjectRefWidget(WebTestCase):
             self.assertNotIn('url', values)
 
 
+class TestWuttaDateWidget(WebTestCase):
+
+    def make_field(self, node, **kwargs):
+        # TODO: not sure why default renderer is in use even though
+        # pyramid_deform was included in setup?  but this works..
+        kwargs.setdefault('renderer', deform.Form.default_renderer)
+        return deform.Field(node, **kwargs)
+
+    def make_widget(self, **kwargs):
+        return mod.WuttaDateWidget(self.request, **kwargs)
+
+    def test_serialize(self):
+        node = colander.SchemaNode(colander.Date())
+        field = self.make_field(node)
+
+        # first try normal date
+        widget = self.make_widget()
+        dt = datetime.date(2025, 1, 15)
+
+        # editable widget has normal picker html
+        result = widget.serialize(field, str(dt))
+        self.assertIn('<wutta-datepicker', result)
+
+        # readonly is rendered per app convention
+        result = widget.serialize(field, str(dt), readonly=True)
+        self.assertEqual(result, '2025-01-15')
+
+        # now try again with datetime
+        widget = self.make_widget()
+        dt = datetime.datetime(2025, 1, 15, 8, 35)
+
+        # editable widget has normal picker html
+        result = widget.serialize(field, str(dt))
+        self.assertIn('<wutta-datepicker', result)
+
+        # readonly is rendered per app convention
+        result = widget.serialize(field, str(dt), readonly=True)
+        self.assertEqual(result, '2025-01-15')
+
+
 class TestWuttaDateTimeWidget(WebTestCase):
 
     def make_field(self, node, **kwargs):

{wuttaweb-0.20.3 → wuttaweb-0.20.5}/tests/grids/test_base.py

@@ -1433,7 +1433,7 @@ class TestGrid(WebTestCase):
         # null
         obj = MagicMock(dt=None)
         result = grid.render_date(obj, 'dt', None)
-        self.assertIsNone(result)
+        self.assertEqual(result, '')
 
         # typical
         dt = datetime.date(2025, 1, 13)
@@ -1446,7 +1446,7 @@ class TestGrid(WebTestCase):
 
         obj = MagicMock(dt=None)
         result = grid.render_datetime(obj, 'dt', None)
-        self.assertIsNone(result)
+        self.assertEqual(result, '')
 
         dt = datetime.datetime(2024, 12, 12, 13, 44, tzinfo=datetime.timezone.utc)
         obj = MagicMock(dt=dt)