lino 25.2.3__py3-none-any.whl → 25.3.1__py3-none-any.whl

lino/core/elems.py

@@ -5,6 +5,7 @@
 
 """
 
+from lino.utils.jsgen import VisibleComponent
 import types
 import decimal
 from lxml.html import fromstring
@@ -181,7 +182,8 @@ class GridColumn(jsgen.Component):
             elif isinstance(editor.field, fields.VirtualField):
                 # kw.update(sortable=False)
                 if has_fk_renderer(editor.field.return_type):
-                    rend = fk_renderer(editor.field.return_type, editor.field.name)
+                    rend = fk_renderer(
+                        editor.field.return_type, editor.field.name)
             if rend:
                 kw.update(renderer=js_code(rend))
             kw.update(editable=editor.editable)
@@ -221,9 +223,6 @@ class Calendar(jsgen.Component):
     value_template = "new Lino.CalendarPanel(%s)"
 
 
-from lino.utils.jsgen import VisibleComponent
-
-
 class LayoutElement(VisibleComponent):
     stored = False
     ext_name = None
@@ -358,10 +357,12 @@ class LayoutElement(VisibleComponent):
             label = self.get_label()
             if not label:
                 raise Exception(
-                    "Item %s of tabbed %s has no label!" % (self, self.layout_handle)
+                    "Item %s of tabbed %s has no label!" % (
+                        self, self.layout_handle)
                 )
             ukw = dict(title=label)
-            ukw.update(listeners=dict(activate=js_code("Lino.on_tab_activate")))
+            ukw.update(listeners=dict(
+                activate=js_code("Lino.on_tab_activate")))
             # add_help_text(
             #     ukw, self.help_text, 'title',
             #     self.layout_handle.layout._datasource, self.name)
@@ -485,14 +486,13 @@ class FieldElement(LayoutElement):
         self.hide_sum = hide_sum
 
         if "listeners" not in kw:
-            if not isinstance(layout_handle.layout, ColumnsLayout):
-                layout_handle.ui.renderer.add_help_text(
-                    kw,
-                    self.field.help_text,
-                    self.field.verbose_name,
-                    layout_handle.layout._datasource,
-                    self.field.name,
-                )
+            # if not isinstance(layout_handle.layout, ColumnsLayout):
+            layout_handle.ui.renderer.add_help_text(
+                kw,
+                self.field.help_text,
+                self.field.verbose_name,
+                layout_handle.layout._datasource,
+                self.field.name)
 
         # http://www.rowlands-bcs.com/extjs/tips/tooltips-form-fields
         # if self.field.__doc__:
@@ -747,7 +747,8 @@ class TextFieldElement(FieldElement):
     oui5_field_template = "/openui5/elems/field/TextFieldElement.xml"
 
     def __init__(self, layout_handle, field, **kw):
-        self.format = getattr(field, "format", None) or settings.SITE.textfield_format
+        self.format = getattr(
+            field, "format", None) or settings.SITE.textfield_format
 
         if layout_handle.ui.renderer.extjs_version == 3:
             self.value_template = "new Ext.form.TextArea(%s)"
@@ -885,7 +886,8 @@ class CharFieldElement(FieldElement):
             kw.update(maxLength=self.field.max_length)
             if self.field.max_length <= 10:
                 kw.update(
-                    boxMinWidth=js_code("Lino.chars2width(%d)" % self.field.max_length)
+                    boxMinWidth=js_code("Lino.chars2width(%d)" %
+                                        self.field.max_length)
                 )
         for lino_name, extjs_name in (
             ("regex", "regex"),
@@ -945,7 +947,8 @@ class ComboFieldElement(FieldElement):
         if not isinstance(self.layout_handle.layout, ColumnsLayout) and not isinstance(
             self, SimpleRemoteComboFieldElement
         ):
-            kw.update(hiddenName=self.field.name + constants.CHOICES_HIDDEN_SUFFIX)
+            kw.update(hiddenName=self.field.name
+                      + constants.CHOICES_HIDDEN_SUFFIX)
         return kw
 
 
@@ -1030,12 +1033,14 @@ class RemoteComboFieldElement(ComboFieldElement):
             # print repr(sto)
             if self.layout_handle.ui.renderer.extjs_version == 3:
                 kw.update(
-                    store=js_code("new Lino.ComplexRemoteComboStore(%s)" % py2js(sto))
+                    store=js_code(
+                        "new Lino.ComplexRemoteComboStore(%s)" % py2js(sto))
                 )
             else:
                 kw.update(
                     store=js_code(
-                        "Ext.create('Lino.ComplexRemoteComboStore',%s)" % py2js(sto)
+                        "Ext.create('Lino.ComplexRemoteComboStore',%s)" % py2js(
+                            sto)
                     )
                 )
         return kw
@@ -1088,11 +1093,13 @@ class ForeignKeyElement(ComplexRemoteComboFieldElement):
 
         if settings.SITE.kernel.web_front_ends[0].app_label == "react":
             options = dict(
-                related_actor_id=actor.actor_id, allowBlank=kw.get("allowBlank", False)
+                related_actor_id=actor.actor_id, allowBlank=kw.get(
+                    "allowBlank", False)
             )
             da = actor.detail_action
             options.update(
-                view_permission=bool(da) and da.get_view_permission(get_user_profile())
+                view_permission=bool(da) and da.get_view_permission(
+                    get_user_profile())
             )
             if hasattr(self.field, "model") and hasattr(
                 self.field.model, f"create_{self.field.name}_choice"
@@ -1122,7 +1129,8 @@ class ForeignKeyElement(ComplexRemoteComboFieldElement):
             if self.layout_handle.ui.renderer.extjs_version is not None:
                 if actor is None:
                     raise Exception(
-                        "20181229 {!r} {}".format(self, self.field.remote_field.model)
+                        "20181229 {!r} {}".format(
+                            self, self.field.remote_field.model)
                     )
                 a1 = actor.detail_action
                 if a1 and not a1.get_view_permission(get_user_profile()):
@@ -1146,7 +1154,8 @@ class ForeignKeyElement(ComplexRemoteComboFieldElement):
 
         kw.update(pageSize=actor.page_length)
         if actor.model is not None:
-            kw.update(emptyText=_("Select a %s...") % actor.model._meta.verbose_name)
+            kw.update(emptyText=_("Select a %s...") %
+                      actor.model._meta.verbose_name)
         return kw
 
     def cell_html(self, ar, row):
@@ -1174,7 +1183,8 @@ class TimeFieldElement(FieldElement):
     def get_field_options(self, **kwargs):
         kwargs = FieldElement.get_field_options(self, **kwargs)
         if settings.SITE.calendar_start_hour:
-            kwargs["minValue"] = "{}:00".format(settings.SITE.calendar_start_hour)
+            kwargs["minValue"] = "{}:00".format(
+                settings.SITE.calendar_start_hour)
             # kwargs['minValue'] = settings.SITE.calendar_start_hour
         eh = settings.SITE.calendar_end_hour
         if eh:
@@ -1243,7 +1253,8 @@ class DateFieldElement(FieldElement):
     # ~ preferred_width = 8 # 20131022
     preferred_width = 13
     filter_type = "date"
-    gridfilters_settings = dict(type="date", dateFormat=settings.SITE.date_format_extjs)
+    gridfilters_settings = dict(
+        type="date", dateFormat=settings.SITE.date_format_extjs)
     # todo: DateFieldElement.preferred_width should be computed from Report.date_format
     # ~ grid_column_template = "new Ext.grid.DateColumn(%s)"
 
@@ -1376,7 +1387,8 @@ class DecimalFieldElement(NumberFieldElement):
 
     def __init__(self, *args, **kw):
         FieldElement.__init__(self, *args, **kw)
-        self.preferred_width = max(5, self.field.max_digits) + self.field.decimal_places
+        self.preferred_width = max(
+            5, self.field.max_digits) + self.field.decimal_places
         # fmt = '0,000'
         # fmt = '0.0'
         # if self.field.decimal_places > 0:
@@ -2442,9 +2454,11 @@ class SlaveContainer(GridElement):
         if constants.DISPLAY_MODE_LIST in rpt.extra_display_modes:
             slaves["list"] = get_list_element(layout_handle, rpt, name, **kw)
         if constants.DISPLAY_MODE_SUMMARY in rpt.extra_display_modes:
-            slaves["summary"] = get_summary_element(layout_handle, rpt, name, **kw)
+            slaves["summary"] = get_summary_element(
+                layout_handle, rpt, name, **kw)
         if constants.DISPLAY_MODE_HTML in rpt.extra_display_modes:
-            slaves["html"] = get_htmlbox_element(layout_handle, rpt, name, **kw)
+            slaves["html"] = get_htmlbox_element(
+                layout_handle, rpt, name, **kw)
         if slaves:
             self.slaves = slaves
         super().__init__(layout_handle, name, rpt, *columns, **kw)
@@ -2765,7 +2779,8 @@ def create_layout_element(lh, name, **kw):
         # ctx = (lh.layout.__class__, name, ', '.join(dir(lh.layout)))
         # raise Exception(
         #     "Instance of %s has no data element '%s' (names are %s)" % ctx)
-        raise Exception("Invalid data element '{1}' in {0}".format(lh.layout, name))
+        raise Exception(
+            "Invalid data element '{1}' in {0}".format(lh.layout, name))
 
     if isinstance(de, type) and issubclass(de, fields.Dummy):
         return None
@@ -2864,7 +2879,8 @@ def create_layout_element(lh, name, **kw):
                         title=_("Show this table in own window"),
                         style="text-decoration:none;",
                     )
-                    kw.update(label="{} {}".format(de.get_label(), tostring(btn)))
+                    kw.update(label="{} {}".format(
+                        de.get_label(), tostring(btn)))
 
             if (
                 len(de.default_display_modes) > 1

lino/core/fields.py

@@ -70,7 +70,7 @@ def set_default_verbose_name(f):
 
     """
     if f.verbose_name is None or (
-        f.name is not None and f.verbose_name == f.name.replace("_", " ")):
+            f.name is not None and f.verbose_name == f.name.replace("_", " ")):
         f.verbose_name = f.remote_field.model._meta.verbose_name
 
 
@@ -322,7 +322,8 @@ class FakeField(object):
 
     def __repr__(self):
         # copied from django Field
-        path = "%s.%s" % (self.__class__.__module__, self.__class__.__qualname__)
+        path = "%s.%s" % (self.__class__.__module__,
+                          self.__class__.__qualname__)
         name = getattr(self, "name", None)
         if name is not None:
             return "<%s: %s>" % (path, name)
@@ -604,7 +605,8 @@ class VirtualField(FakeField):
                 f = self.return_type = resolve_field(f)
             except Exception as e:
                 raise Exception(
-                    "Invalid return type spec {} for {} : {}".format(f, self, e)
+                    "Invalid return type spec {} for {} : {}".format(
+                        f, self, e)
                 )
 
         if isinstance(f, FakeField):
@@ -947,7 +949,8 @@ class QuantityField(models.CharField):
         kw.setdefault("max_length", settings.SITE.quantity_max_length)
         super().__init__(*args, **kw)
         if self.blank and not self.null:
-            raise ChangedAPI("When `blank` is True, `null` must be True as well.")
+            raise ChangedAPI(
+                "When `blank` is True, `null` must be True as well.")
 
     # ~ def get_internal_type(self):
     # ~ return "CharField"
@@ -1207,7 +1210,8 @@ class ImportedFields(object):
 
     @classmethod
     def declare_imported_fields(cls, names):
-        cls._imported_fields = cls._imported_fields | set(fields_list(cls, names))
+        cls._imported_fields = cls._imported_fields | set(
+            fields_list(cls, names))
         # ~ logger.info('20120801 %s.declare_imported_fields() --> %s' % (
         # ~ cls,cls._imported_fields))
 
@@ -1299,14 +1303,19 @@ class TableRow(object):
         #         return v
         #     raise Exception("Oops, {} on {} is {}".format(name, cls, v))
 
+    @classmethod
+    def override_column_headers(cls, ar, **headers):
+        return headers
+
     @classmethod
     def disable_create(self, ar):
         return None
 
     def get_detail_action(self, ar):
-        """Return the (bound) detail action to use for showing this object in
-        a detail window.  Return `None` when no detail form exists or
-        the requesting user has no permission to see it.
+        """
+        Return the (bound) detail action to use for showing this database row in
+        a detail window.  Return `None` when no detail window exists or the
+        requesting user has no permission to see it.
 
         `ar` is the action request that asks to see the detail.
         If the action request's actor can be used for this model,
@@ -1511,7 +1520,8 @@ def fields_list(model, field_names):
         else:
             e = model.get_data_elem(name)
             if e is None:
-                raise FieldDoesNotExist("No data element %r in %s" % (name, model))
+                raise FieldDoesNotExist(
+                    "No data element %r in %s" % (name, model))
             if not hasattr(e, "name"):
                 raise FieldDoesNotExist(
                     "%s %r in %s has no name" % (e.__class__, name, model)

lino/core/inject.py

@@ -132,9 +132,9 @@ def check_pending_injects(sender, models_list=None, **kw):
     # ~ logger.info("20131110 no pending injects")
     """
     20130106
-    now we loop a last time over each model and fill it's _meta._field_cache
-    otherwise if some application module used inject_field() on a model which
-    has subclasses, then the new field would not be seen by subclasses
+    now we loop a last time over each model and fill its _meta._field_cache
+    otherwise if some plugin used inject_field() on a model that
+    has subclasses, the new field would not be seen by subclasses
     """
     for model in models_list:
         model._meta._expire_cache()
@@ -225,7 +225,8 @@ def update_model(model_spec, **actions):
     def todo(model):
         for k, v in actions.items():
             if not hasattr(model, k):
-                raise Exception("%s has no attribute %s to update." % (model, k))
+                raise Exception(
+                    "%s has no attribute %s to update." % (model, k))
             setattr(model, k, v)
 
     if isinstance(model_spec, models.Model):
@@ -389,8 +390,8 @@ def inject_quick_add_buttons(model, name, target):
     inject_field(
         model,
         name,
-        fields.VirtualField(fields.DisplayField(tm._meta.verbose_name_plural), fn),
-    )
+        fields.VirtualField(fields.DisplayField(
+            tm._meta.verbose_name_plural), fn))
 
 
 # def django_patch():

lino/core/kernel.py

@@ -4,8 +4,7 @@
 """This defines the :class:`Kernel` class.
 
 The "kernel" of a Lino site is (like `SITE` itself) a "de facto
-singleton", available to application code as ``SITE.kernel`` (and its
-alias for backwards compatibility: ``SITE.ui``).
+singleton", available to application code as ``SITE.kernel``).
 
 The kernel is instantiated at the end of the startup process, when the
 :setting:`SITE` has been instantiated and models have been loaded.  It
@@ -22,19 +21,16 @@ application.
 
 import os
 import sys
-import time
 import codecs
 import atexit
 import signal
 import threading
 from importlib import import_module
-import json
 
-from django.apps import AppConfig
+# from django.apps import AppConfig
 from django.apps import apps
 from django.conf import settings
 from django.http import HttpResponse
-from django.utils.encoding import force_str
 from django.utils.text import format_lazy
 from django.utils.translation import gettext_lazy as _
 from django.core.exceptions import PermissionDenied, ValidationError
@@ -454,7 +450,8 @@ class Kernel(object):
                 try:
                     a.setup_columns()
                 except DatabaseError:
-                    logger.debug("Ignoring DatabaseError in %s.setup_columns", a)
+                    logger.debug(
+                        "Ignoring DatabaseError in %s.setup_columns", a)
             if (
                 issubclass(a, dbtables.Table)
                 and a.model is not None
@@ -533,7 +530,8 @@ class Kernel(object):
         # for p in site.installed_plugins:
         #     p.after_discover()
 
-        self.reserved_names = [getattr(constants, n) for n in constants.URL_PARAMS]
+        self.reserved_names = [getattr(constants, n)
+                               for n in constants.URL_PARAMS]
 
         names = set()
         for n in self.reserved_names:
@@ -565,7 +563,8 @@ class Kernel(object):
                         found = True
                         break
                 if not found:
-                    raise Exception(f"Invalid modname {modname} in Site.web_front_ends")
+                    raise Exception(
+                        f"Invalid modname {modname} in Site.web_front_ends")
             self.web_front_ends = lst
             # print("20230407 web front ends:")
             # print("\n".join(["- {0.url_prefix} --> {0.app_name} {1}".format(p, hash(p))
@@ -623,7 +622,8 @@ class Kernel(object):
 
                     return get_welcome_messages
 
-                site.add_welcome_handler(handler(a), a, "welcome_message_when_count")
+                site.add_welcome_handler(
+                    handler(a), a, "welcome_message_when_count")
 
         # Remove "meaningless" user roles, i.e. those which are either used by all
         # types or by no type. This seems to be
@@ -712,7 +712,8 @@ class Kernel(object):
                             msg = (
                                 "{0}.{1} has on_delete SET_NULL but " "is not nullable "
                             )
-                            msg = msg.format(fmn(m), fk.name, fk.remote_field.model)
+                            msg = msg.format(
+                                fmn(m), fk.name, fk.remote_field.model)
                             raise Exception(msg)
 
                     else:
@@ -785,7 +786,8 @@ class Kernel(object):
                         pointed_model.objects.get(pk=fk)
                     except pointed_model.DoesNotExist:
                         msg = "Invalid primary key {1} for {2} in `{0}`"
-                        obj._message = msg.format(gfk.fk_field, fk, fmn(pointed_model))
+                        obj._message = msg.format(
+                            gfk.fk_field, fk, fmn(pointed_model))
                         if gfk.name in model.allow_cascaded_delete:
                             obj._todo = "delete"
                         elif fk_field.null:
@@ -807,7 +809,8 @@ class Kernel(object):
         """
         if not ar.get_permission():
             if False:
-                msg = "{} has no permission to run {}".format(ar.get_user(), ar)
+                msg = "{} has no permission to run {}".format(
+                    ar.get_user(), ar)
             else:
                 msg = "No permission to run {}".format(ar)
             # raise Exception(msg)
@@ -842,7 +845,8 @@ class Kernel(object):
                 and ar.master_instance is not None
                 and len(ar.selected_rows)
             ):
-                ar.set_response(master_data=ar.selected_rows[0].get_master_data(ar))
+                ar.set_response(
+                    master_data=ar.selected_rows[0].get_master_data(ar))
             if (
                 a.parameters
                 and not a.no_params_window
@@ -852,15 +856,16 @@ class Kernel(object):
         except Warning as e:
             ar.error(e, alert=True)
         except Exception as e:
-        # except (ValidationError, IntegrityError) as e:
-            msg = ar.ah.actor.error2str(e)
-            logger.info("Error during kernel.run_action() in %s: %s", ar, msg)
-            if is_devserver():
-                # can be interesting during development but disturbs on a
-                # production server
-                logger.exception(e)
             # print(f"20240911 oops {repr(e)}")
+            msg = ar.ah.actor.error2str(e)
             ar.error(msg, alert=True)
+            if not isinstance(e, (ValidationError, IntegrityError)):
+                logger.info(
+                    "Error during kernel.run_action() in %s: %s", ar, msg)
+                if is_devserver():
+                    # can be interesting during development but disturbs on a
+                    # production server
+                    logger.exception(e)
 
         return ar.renderer.render_action_response(ar)
 
@@ -947,51 +952,6 @@ class Kernel(object):
     # def setup_static_link(self, urlpatterns, short_name,
     #                       attr_name=None, source=None):
 
-    def mark_virgin(self):
-        dbhash = self.get_dbhash()
-        fn = self.site.site_dir / "dbhash.json"
-        with fn.open("w") as fp:
-            json.dump(dbhash, fp)
-
-    def check_virgin(self):
-        new = self.get_dbhash()
-        fn = self.site.site_dir / "dbhash.json"
-        if not fn.exists():
-            raise Exception(
-                "No `dbhash.json` in {} " "(did you run `django-admin prep`?)".format(
-                    self.site.site_dir
-                )
-            )
-        with fn.open("r") as fp:
-            old = json.load(fp)
-
-        # noi1r has noi1e as master_site, but the react front end removes the
-        # tinymce plugin, i.e. noi1r doesn't care about
-        # tinymce.TextFieldTemplate model.
-
-        diffs = {}
-        for k, v in new.items():
-            oldv = old.get(k, None)
-            if oldv != v:
-                diffs[k] = (oldv, v)
-        # diff = set(old.items()) ^ set(new.items())
-        if diffs:
-            # db = self.site.django_settings.get('SETTINGS_MODULE')
-            db = self.site.site_dir
-            raise Exception("Database {} isn't virgin: {}".format(db, diffs))
-
-        # logger.info("Database certified as virgin")
-
-    def get_dbhash(self):
-        # TODO: we currently check only the number of rows per model. That's
-        # very naive.
-        rv = dict()
-        for m in get_models(include_auto_created=True):
-            k = fmn(m)
-            if k != "sessions.Session":
-                rv[k] = m.objects.count()
-        return rv
-
 
 def site_startup(self):
     """This is being imported and called from