lino 25.2.2__py3-none-any.whl → 25.3.0__py3-none-any.whl

lino/core/requests.py

@@ -1,5 +1,5 @@
 # -*- coding: UTF-8 -*-
-# Copyright 2009-2024 Rumma & Ko Ltd
+# Copyright 2009-2025 Rumma & Ko Ltd
 # License: GNU Affero General Public License v3 (see file COPYING for details)
 """
 See introduction in :doc:`/dev/ar` and API reference in
@@ -10,13 +10,12 @@ See introduction in :doc:`/dev/ar` and API reference in
 
 import sys
 import json
-import html
 import logging
 from io import StringIO
 from lino import logger
 from contextlib import contextmanager
 from types import GeneratorType
-from copy import copy, deepcopy
+from copy import deepcopy
 from xml.sax.saxutils import escape
 from etgen import html as xghtml
 
@@ -24,6 +23,7 @@ from django.conf import settings
 from django.utils.translation import gettext_lazy as _
 from django.utils.translation import gettext
 from django.utils.translation import get_language, activate
+from django.utils.html import format_html
 from django.utils import translation
 from django.utils import timezone
 from django.core.mail import send_mail
@@ -33,7 +33,7 @@ from django.db import models
 from django.db.models.query import QuerySet
 from asgiref.sync import sync_to_async
 
-from lino.utils.html import E, tostring, iselement
+from lino.utils.html import E, tostring
 from lino.utils import AttrDict
 from lino.utils import capture_output
 from lino.utils import MissingRow
@@ -48,11 +48,9 @@ from lino.core.diff import ChangeWatcher
 from lino.core.utils import getrqdata
 from lino.core.utils import obj2unicode
 from lino.core.utils import obj2str
-from lino.core.utils import UnresolvedModel
 from lino.core.utils import format_request
 from lino.core.utils import PhantomRow
 from lino.core.store import get_atomizer
-from lino.core.exceptions import ChangedAPI
 
 # try:
 #     from django.contrib.contenttypes.models import ContentType
@@ -81,6 +79,7 @@ Subject: {subject}
 def noop(ar):
     return ar.success(gettext("Aborted"))
 
+
 def mi2bp(master_instance, bp):
     if master_instance is not None:
         if isinstance(master_instance, (models.Model, TableRow)):
@@ -103,6 +102,17 @@ def mi2bp(master_instance, bp):
             #     self.master_instance.__class__, self.master_instance))
 
 
+class PrintLogger(logging.Logger):
+    format = "%(message)s"
+
+    def __init__(self, level):
+        super().__init__("~", level)
+        h = logging.StreamHandler(stream=sys.stdout)
+        h.setFormatter(logging.Formatter(self.format))
+        self.addHandler(h)
+        # print("20231012", logging.getLevelName(self.level), self.__class__)
+
+
 class StringLogger(logging.Logger):
     # Instantiated by BaseRequest.capture_logger()
 
@@ -260,7 +270,7 @@ class ValidActionResponses(object):
 
 inheritable_attrs = frozenset(
     ["user", "subst_user", "renderer", "requesting_panel", "master_instance",
-    "logger", "show_urls"] )
+     "logger", "show_urls"])
 
 
 def bool2text(x):
@@ -269,7 +279,6 @@ def bool2text(x):
     return _("No")
 
 
-
 class SearchQuerySet:
     pass
 
@@ -429,7 +438,7 @@ class BaseRequest:
                 self.known_values.setdefault(k, v)
 
             self.obvious_fields |= self.actor.obvious_fields
-                # self.obvious_fields.update(obvious_fields.split())
+            # self.obvious_fields.update(obvious_fields.split())
             # if parent.obvious_fields is not None:
             if parent is not None and parent.actor is self.actor and parent.obvious_fields:
                 self.obvious_fields |= parent.obvious_fields
@@ -442,7 +451,6 @@ class BaseRequest:
                         self.actor, locals()
                     )
                 )
-            # if isinstance(self.master_instance, UnresolvedModel):
             if isinstance(self.master_instance, MissingRow):
                 raise exceptions.BadRequest(self.master_instance)
                 # raise Exception(
@@ -454,6 +462,7 @@ class BaseRequest:
         user=None,
         subst_user=None,
         current_project=None,
+        display_mode=None,
         master=None,
         master_instance=None,
         master_key=None,
@@ -483,6 +492,7 @@ class BaseRequest:
         else:
             self.user = user
         self.current_project = current_project
+        self.display_mode = display_mode
         if renderer is None:
             renderer = settings.SITE.kernel.text_renderer
             # renderer = settings.SITE.kernel.default_renderer
@@ -498,9 +508,11 @@ class BaseRequest:
                 master = self.actor.master
             if master_type and ContentType is not None:
                 try:
-                    master = ContentType.objects.get(pk=master_type).model_class()
+                    master = ContentType.objects.get(
+                        pk=master_type).model_class()
                 except ContentType.DoesNotExist:
-                    raise exceptions.BadRequest("Invalid master_type {}".format(master_type)) from None
+                    raise exceptions.BadRequest(
+                        "Invalid master_type {}".format(master_type)) from None
             self.master = master
 
             if self.master is not None and self.master_instance is None:
@@ -509,7 +521,8 @@ class BaseRequest:
                     master_instance = self.get_master_instance(
                         self.master, master_key, master_type
                     )
-                self.master_instance = self.actor.cast_master_instance(master_instance)
+                self.master_instance = self.actor.cast_master_instance(
+                    master_instance)
 
         self.row_meta = dict(meta=True)
 
@@ -535,12 +548,26 @@ class BaseRequest:
         try:
             # We instantiate a temporary Logger object, which is not known by the
             # root logger.
+            # self.logger = PrintLogger(level)
             self.logger = StringLogger(old_logger, level)
             # self.logger.parent =
             yield self.logger
 
         finally:
             self.logger.streamer.flush()
+            # print(self.logger.getvalue())
+            self.logger = old_logger
+
+    @contextmanager
+    def print_logger(self, level=logging.INFO):
+        old_logger = self.logger
+        try:
+            # We instantiate a temporary Logger object, which is not known by the
+            # root logger.
+            self.logger = PrintLogger(level)
+            yield None
+
+        finally:
             self.logger = old_logger
 
     @contextmanager
@@ -617,7 +644,10 @@ class BaseRequest:
             kw.update(user=request.user)
             kw.update(subst_user=request.subst_user)
         kw.update(requesting_panel=request.requesting_panel)
-        kw.update(current_project=rqdata.get(constants.URL_PARAM_PROJECT, None))
+        kw.update(current_project=rqdata.get(
+            constants.URL_PARAM_PROJECT, None))
+        kw.update(display_mode=rqdata.get(
+            constants.URL_PARAM_DISPLAY_MODE, None))
 
         # If the incoming request specifies an active tab, then the
         # response must forward this information. Otherwise Lino would
@@ -688,7 +718,8 @@ class BaseRequest:
                 offset = rqdata.get(constants.URL_PARAM_START, None)
                 if offset:
                     kw.update(offset=int(offset))
-                limit = rqdata.get(constants.URL_PARAM_LIMIT, self.actor.preview_limit)
+                limit = rqdata.get(constants.URL_PARAM_LIMIT,
+                                   self.actor.preview_limit)
                 if limit:
                     kw.update(limit=int(limit))
             except ValueError:
@@ -982,7 +1013,8 @@ class BaseRequest:
 
     debug = lambda self, *args, **kwargs: self.logger.debug(*args, **kwargs)
     info = lambda self, *args, **kwargs: self.logger.info(*args, **kwargs)
-    warning = lambda self, *args, **kwargs: self.logger.warning(*args, **kwargs)
+    warning = lambda self, * \
+        args, **kwargs: self.logger.warning(*args, **kwargs)
 
     async def adebug(self, *args, **kwargs):
         return await self.alogger.debug(*args, **kwargs)
@@ -1018,7 +1050,8 @@ class BaseRequest:
             )
             return
 
-        self.logger.info("Send email '%s' from %s to %s", subject, sender, recipients)
+        self.logger.info("Send email '%s' from %s to %s",
+                         subject, sender, recipients)
 
         recipients = [a for a in recipients if "@example.com" not in a]
         if not len(recipients):
@@ -1510,18 +1543,17 @@ class BaseRequest:
         if cls is not None:
             user_type = self.get_user().user_type
             for ba in cls.get_toolbar_actions(self.bound_action.action, user_type):
-                if not ba.action.select_rows:
-                    if ba.action.show_in_plain:
-                        ir = ba.request_from(self)
-                        # assert ir.user is self.user
-                        if ir.get_permission():
-                            # try:
-                            #     btn = ir.ar2button(**btnattrs)
-                            # except AttributeError:
-                            #     raise Exception("20200513 {}".format(ir))
-                            btn = ir.ar2button(**btnattrs)
-                            # assert iselement(btn)
-                            buttons.append(btn)
+                if ba.action.show_in_plain and not ba.action.select_rows:
+                    ir = ba.request_from(self)
+                    # assert ir.user is self.user
+                    if ir.get_permission():
+                        # try:
+                        #     btn = ir.ar2button(**btnattrs)
+                        # except AttributeError:
+                        #     raise Exception("20200513 {}".format(ir))
+                        btn = ir.ar2button(**btnattrs)
+                        # assert iselement(btn)
+                        buttons.append(btn)
         # print("20181106", cls, self.bound_action, buttons)
         return buttons
         # if len(buttons) == 0:
@@ -1637,8 +1669,10 @@ class BaseRequest:
         else:
             # print("20190703", self.actor, self.actor.default_action)
             sar = self.spawn_request(actor=self.actor)
-            list_title = tostring(sar.href_to_request(sar, list_title, icon_name=None))
-            return list_title + " » " + self.get_detail_title(elem)
+            list_title = tostring(sar.href_to_request(
+                sar, list_title, icon_name=None))
+            # return list_title + " » " + self.get_detail_title(elem)
+            return format_html("{} » {}", list_title,  self.get_detail_title(elem))
 
     def form2obj_and_save(ar, data, elem, is_new):
         """
@@ -1832,16 +1866,17 @@ class ActionRequest(BaseRequest):
                     else:
                         raise Exception(
                             "20160329 params_layout {0} has no params_store "
-                            "in {1!r}".format(self.actor.params_layout, self.actor)
+                            "in {1!r}".format(
+                                self.actor.params_layout, self.actor)
                         )
             else:
                 for k in param_values.keys():
                     if k not in pv:
-                        raise Exception(
-                            "Invalid key '%s' in param_values of %s "
-                            "request (possible keys are %s)"
-                            % (k, self.actor, list(pv.keys()))
-                        )
+                        msg = ("Invalid key '%s' in param_values of %s "
+                               "request (possible keys are %s)"
+                               % (k, self.actor, list(pv.keys())))
+                        # print(msg)  # 20250309
+                        raise Exception(msg)
                 pv.update(param_values)
             # print("20160329 ok", pv)
             self.param_values = AttrDict(**pv)
@@ -1857,7 +1892,8 @@ class ActionRequest(BaseRequest):
                 #     self.selected_rows, action)
                 # raise Exception(msg)
             if request is not None:
-                apv.update(action.params_layout.params_store.parse_params(request))
+                apv.update(
+                    action.params_layout.params_store.parse_params(request))
             self.action_param_values = AttrDict(**apv)
             # action.check_params(action_param_values)
             self.set_action_param_values(**action_param_values)
@@ -1975,19 +2011,20 @@ class ActionRequest(BaseRequest):
         except Exception as e:
             if not settings.SITE.catch_layout_exceptions:
                 raise
-            # Report this exception. But since such errors may occur
-            # rather often and since exception loggers usually send an
-            # email to the local system admin, make sure to log each
-            # exception only once.
-            self.no_data_text = f"{e} (set catch_layout_exceptions to see details)"
+            # Report this exception. But since such errors may occur rather
+            # often and since exception loggers usually send an email to the
+            # local system admin, make sure to log each exception only once.
+            e = str(e)
+            self.no_data_text = f"{e} (set catch_layout_exceptions to see \
+                details)"
             self._data_iterator = []
-            w = WARNINGS_LOGGED.get(str(e))
+            w = WARNINGS_LOGGED.get(e)
             if w is None:
-                WARNINGS_LOGGED[str(e)] = True
+                WARNINGS_LOGGED[e] = True
                 # raise
                 # logger.exception(e)
                 logger.warning(f"Error while executing {repr(self)}: {e}\n"
-                    "(Subsequent warnings will be silenced.)")
+                               "(Subsequent warnings will be silenced.)")
 
         if self._data_iterator is None:
             raise Exception(f"No data iterator for {self}")
@@ -1997,7 +2034,8 @@ class ActionRequest(BaseRequest):
             self._data_iterator = tuple(self._data_iterator)
         if isinstance(self._data_iterator, (SearchQuery, SearchQuerySet)):
             self._sliced_data_iterator = tuple(
-                self.actor.get_rows_from_search_query(self._data_iterator, self)
+                self.actor.get_rows_from_search_query(
+                    self._data_iterator, self)
             )
         else:
             self._sliced_data_iterator = sliced_data_iterator(
@@ -2121,7 +2159,8 @@ class ActionRequest(BaseRequest):
 
         if self.request is not None:
             for e in elems:
-                self.ah.store.form2obj(self, self.request.POST or self.rqdata, e, True)
+                self.ah.store.form2obj(
+                    self, self.request.POST or self.rqdata, e, True)
         for e in elems:
             e.full_clean()
         return elems
@@ -2132,7 +2171,8 @@ class ActionRequest(BaseRequest):
             self.actor.handle_uploaded_files(elem, self.request)
 
         if self.request is not None:
-            self.ah.store.form2obj(self, self.request.POST or self.rqdata, elem, True)
+            self.ah.store.form2obj(
+                self, self.request.POST or self.rqdata, elem, True)
         elem.full_clean()
         return elem
 
@@ -2145,7 +2185,8 @@ class ActionRequest(BaseRequest):
         if self._status is not None and not kw:
             return self._status
         if self.actor.parameters:
-            pv = self.actor.params_layout.params_store.pv2dict(self, self.param_values)
+            pv = self.actor.params_layout.params_store.pv2dict(
+                self, self.param_values)
             # print(f"20250121c {self}\n{self.actor.params_layout.params_store.__class__}\n{self.actor.params_layout.params_store.param_fields}")
             # print(f"20250121c {self} {self.param_values.keys()}\n{self.actor.params_layout}\n{pv.keys()}")
             # print(f"20250121c {self}|{self.actor.params_layout.params_store}\n{}")
@@ -2155,6 +2196,8 @@ class ActionRequest(BaseRequest):
         bp = kw.setdefault("base_params", {})
         if self.current_project is not None:
             bp[constants.URL_PARAM_PROJECT] = self.current_project
+        if self.display_mode is not None:
+            bp[constants.URL_PARAM_DISPLAY_MODE] = self.display_mode
         if self.subst_user is not None:
             # raise Exception("20230331")
             bp[constants.URL_PARAM_SUBST_USER] = self.subst_user.id
@@ -2258,7 +2301,6 @@ class ActionRequest(BaseRequest):
         # ~ s = self.get_title()
         # ~ return s.encode('us-ascii','replace')
 
-
     def to_rst(self, *args, **kw):
         """Returns a string representing this table request in
         reStructuredText markup.
@@ -2347,7 +2389,8 @@ class ActionRequest(BaseRequest):
             # if cellwidths and self.renderer.is_interactive:
             if cellwidths:
                 totwidth = sum([int(w) for w in cellwidths])
-                widths = [str(int(int(w) * 100 / totwidth)) + "%" for w in cellwidths]
+                widths = [str(int(int(w) * 100 / totwidth))
+                          + "%" for w in cellwidths]
                 for i, td in enumerate(headers):
                     # td.set('width', six.text_type(cellwidths[i]))
                     td.set("width", widths[i])
@@ -2355,7 +2398,8 @@ class ActionRequest(BaseRequest):
         # ~ print 20120623, ar.actor
         recno = 0
         for obj in data_iterator:
-            cells = ar.row2html(recno, columns, obj, sums, **self.renderer.cellattrs)
+            cells = ar.row2html(recno, columns, obj, sums,
+                                **self.renderer.cellattrs)
             if cells is not None:
                 recno += 1
                 tble.body.append(xghtml.E.tr(*cells))
@@ -2394,7 +2438,8 @@ class ActionRequest(BaseRequest):
                 columns = None
             else:
                 data = getrqdata(ar.request)
-                columns = [str(x) for x in data.getlist(constants.URL_PARAM_COLUMNS)]
+                columns = [str(x) for x in data.getlist(
+                    constants.URL_PARAM_COLUMNS)]
             if columns:
                 all_widths = data.getlist(constants.URL_PARAM_WIDTHS)
                 hiddens = [
@@ -2438,10 +2483,12 @@ class ActionRequest(BaseRequest):
                     # except AttributeError as ex:
                     #     raise AttributeError("20160529 %s : %s" % (e, ex))
                 #
-                fields = [e for e in fields if not e.value.get("hidden", False)]
+                fields = [e for e in fields if not e.value.get(
+                    "hidden", False)]
                 fields = [e for e in fields if not e.hidden]
 
-                widths = ["%d" % (e.width or e.preferred_width) for e in fields]
+                widths = ["%d" % (e.width or e.preferred_width)
+                          for e in fields]
                 columns = [e.name for e in fields]
 
             headers = [column_header(col) for col in fields]

lino/core/site.py

@@ -356,7 +356,7 @@ class Site(object):
     verbose_client_info_message = False
 
     stopsignal = "SIGTERM"
-    help_url = "http://www.lino-framework.org"
+    help_url = "https://www.lino-framework.org"
 
     help_email = "users@lino-framework.org"
 
@@ -395,11 +395,11 @@ class Site(object):
 
     date_format_strftime = "%d.%m.%Y"
 
-    date_format_regex = "/^[0123]?\d\.[01]?\d\.-?\d+$/"
+    date_format_regex = r"/^[0123]?\d\.[01]?\d\.-?\d+$/"
 
     datetime_format_strftime = "%Y-%m-%dT%H:%M:%S"
 
-    datetime_format_extjs = "Y-m-d\TH:i:s"
+    datetime_format_extjs = r"Y-m-d\TH:i:s"
 
     quick_startup = False
 
@@ -973,6 +973,7 @@ class Site(object):
 
     def install_settings(self):
         assert not self.help_url.endswith("/")
+        assert not self.server_url.endswith("/")
 
         for p in self.installed_plugins:
             p.install_django_settings(self)
@@ -2136,13 +2137,12 @@ class Site(object):
 
         # yield "lino.modlib.lino_startup"
 
-    # server_url = None
     copyright_name = None
     """Name of copyright holder of the site's content."""
 
     copyright_url = None
 
-    server_url = "http://127.0.0.1:8000/"
+    server_url = "http://127.0.0.1:8000"
     """The "official" URL used by "normal" users when accessing this Lino
     site.
 

lino/core/store.py

@@ -343,7 +343,8 @@ class ForeignKeyStoreField(RelatedMixin, ComboStoreField):
 
         relto_model = self.get_rel_to(obj)
         if not relto_model:
-            raise Warning("extract_form_data found no relto_model for %s" % self)
+            raise Warning(
+                "extract_form_data found no relto_model for %s" % self)
             # logger.info("20111209 get_value_text: no relto_model")
             # return
 
@@ -1134,7 +1135,7 @@ class ParameterStore(BaseStore):
         data = getrqdata(request)
         # print(20160329, data)
         # assert 'pv' in data
-        pv = data.getlist(self.url_param)  #'fv', 'pv', post[fn] post[fv][fn]
+        pv = data.getlist(self.url_param)  # 'fv', 'pv', post[fn] post[fv][fn]
 
         # logger.info("20120221 ParameterStore.parse_params(%s) --> %s",self.url_param,pv)
 
@@ -1220,6 +1221,8 @@ class Store(BaseStore):
 
         form = rh.actor.insert_layout
         if form:
+            if isinstance(form, str):
+                raise Exception(f"20250306 insert_layout {repr(rh.actor)}")
             dh = form.get_layout_handle()
             self.collect_fields(self.detail_fields, dh)
 

lino/core/utils.py

@@ -6,6 +6,8 @@ A collection of utilities which require Django settings to be
 importable.
 """
 
+from .exceptions import ChangedAPI
+from lino.utils import IncompleteDate
 import copy
 import sys
 import datetime
@@ -32,8 +34,6 @@ from django.apps import apps
 
 get_models = apps.get_models
 
-from lino.utils import IncompleteDate
-from .exceptions import ChangedAPI
 
 validate_url = URLValidator()
 
@@ -311,6 +311,7 @@ def range_filter(value, f1, f2):
     q2 = Q(**{f2 + "__isnull": True}) | Q(**{f2 + "__gte": value})
     return Q(q1, q2)
 
+
 def inrange_filter(fld, rng, **kw):
     """Assuming a database model with a field named `fld`, return a Q
     object to select the rows having value for `fld` within the given range `rng`.
@@ -343,7 +344,7 @@ def overlap_range_filter(sv, ev, f1, f2, **kw):
     #     raise ValueError(f"{rng} is not a valid range")
     if not ev:
         ev = sv
-    return Q(**{f1+"__lte" : ev, f2+"__gte" : sv})
+    return Q(**{f1+"__lte": ev, f2+"__gte": sv})
 
 
 def babelkw(*args, **kw):
@@ -544,7 +545,8 @@ def resolve_field(name, app_label=None):
     if len(l) == 2:
         model = apps.get_model(app_label, l[0])
         if model is None:
-            raise FieldDoesNotExist("No model named '%s.%s'" % (app_label, l[0]))
+            raise FieldDoesNotExist(
+                "No model named '%s.%s'" % (app_label, l[0]))
         return model._meta.get_field(l[1])
         # fld, remote_model, direct, m2m = model._meta.get_field_by_name(l[1])
         # assert remote_model is None or issubclass(model, remote_model), \
@@ -812,7 +814,8 @@ def error2str(self, e):
                 return str(getattr(de, "verbose_name", name))
 
             return "\n".join(
-                ["%s : %s" % (fieldlabel(k), self.error2str(v)) for k, v in md.items()]
+                ["%s : %s" % (fieldlabel(k), self.error2str(v))
+                 for k, v in md.items()]
             )
         return "\n".join(e.messages)
     return str(e)
@@ -1067,7 +1070,8 @@ class InstanceAction:
         """
         if len(args) and isinstance(args[0], BaseRequest):
             raise ChangedAPI("20181004")
-        ar = self.bound_action.request(renderer=settings.SITE.kernel.text_renderer)
+        ar = self.bound_action.request(
+            renderer=settings.SITE.kernel.text_renderer)
         self.run_from_code(ar, *args, **kwargs)
         return ar.response
 
@@ -1114,7 +1118,6 @@ class PhantomRow(VirtualRow):
         return str(self._ar.get_action_title())
 
 
-
 def login(username=None, **kwargs):
     """Return a basic :term:`action request` with the specified user signed in.
     """
@@ -1131,10 +1134,12 @@ def login(username=None, **kwargs):
     # import lino.core.urls  # hack: trigger ui instantiation
     return BaseRequest(**kwargs)
 
+
 def show(*args, **kwargs):
     """Print the specified data table to stdout."""
     return login().show(*args, **kwargs)
 
+
 def shows(*args, **kwargs):
     """Return the output of :func:`show`."""
     return capture_output(show, *args, **kwargs)

lino/help_texts.py

@@ -171,10 +171,6 @@ help_texts = {
     'lino.modlib.tinymce.Plugin.window_buttons2' : _("""The second row of toolbar buttons when editing in own window."""),
     'lino.modlib.tinymce.Plugin.window_buttons3' : _("""The third row of toolbar buttons when editing in own window."""),
     'lino.modlib.tinymce.Plugin.media_name' : _("""Lino currently includes three versions of TinyMCE, but for production sites we still use the eldest version 3.4.8."""),
-    'lino.modlib.uploads.Plugin' : _("""See /dev/plugins."""),
-    'lino.modlib.uploads.Plugin.remove_orphaned_files' : _("""Whether checkdata –fix should automatically delete orphaned files in the uploads folder."""),
-    'lino.modlib.uploads.Plugin.with_thumbnails' : _("""Whether to use PIL, the Python Imaging Library."""),
-    'lino.modlib.uploads.Plugin.with_volumes' : _("""Whether to use library files (volumes)."""),
     'lino.modlib.weasyprint.Plugin' : _("""See /dev/plugins."""),
     'lino.modlib.weasyprint.Plugin.header_height' : _("""Height of header in mm. Set to None if you want no header."""),
     'lino.modlib.weasyprint.Plugin.footer_height' : _("""Height of footer in mm. Set to None if you want no header."""),
@@ -262,8 +258,7 @@ help_texts = {
     'lino.utils.jsgen.Component.walk' : _("""Walk over this component and its children."""),
     'lino.utils.jsgen.VisibleComponent' : _("""A visible component"""),
     'lino.utils.jsgen.VisibleComponent.install_permission_handler' : _("""Define the allow_read handler used by get_view_permission(). This must be done only once, but after having configured debug_permissions and required_roles."""),
-    'lino.utils.media.MediaFile' : _("""Represents a file on the server below MEDIA_ROOT with two properties name and url."""),
-    'lino.utils.media.MediaFile.get_url' : _("""return the url that points to file on the server"""),
+    'lino.utils.media.MediaFile' : _("""Represents a file on the server below MEDIA_ROOT with two properties path and url."""),
     'lino.utils.mldbc.fields.BabelCharField' : _("""Define a variable number of CharField database fields, one for each language of your lino.core.site.Site.languages. See mldbc."""),
     'lino.utils.mldbc.fields.BabelTextField' : _("""Used for the clones of the master field, one for each non-default language. See mldbc."""),
     'lino.utils.mldbc.fields.LanguageField' : _("""A field that lets the user select a language from the available lino.core.site.Site.languages."""),
@@ -379,7 +374,7 @@ help_texts = {
     'lino.modlib.linod.SystemTask.disabled' : _("""Tells whether the task should be ignored."""),
     'lino.modlib.linod.SystemTask.log_level' : _("""The logging level to apply when running this task."""),
     'lino.modlib.linod.SystemTask.run' : _("""Performs a routine job."""),
-    'lino.modlib.linod.SystemTasks' : _("""The default actor for the SystemTask model."""),
+    'lino.modlib.linod.SystemTasks' : _("""The default table for the SystemTask model."""),
     'lino.modlib.linod.Runnable' : _("""Model mixin used by SystemTask and other models."""),
     'lino.modlib.linod.Runnable.procedure' : _("""The background procedure to run in this task."""),
     'lino.modlib.periods.StoredYear' : _("""The Django model used to store a fiscal year."""),
@@ -553,6 +548,10 @@ help_texts = {
     'lino.modlib.gkfs.GenericForeignKey' : _("""Add verbose_name and help_text to Django’s GFK."""),
     'lino.modlib.gkfs.GenericForeignKeyIdField' : _("""Use this instead of models.PositiveIntegerField for fields that are part of a GFK and you want Lino to render them using a Combobox."""),
     'lino.modlib.jinja.JinjaBuildMethod' : _("""Inherits from lino.modlib.printing.DjangoBuildMethod."""),
+    'lino.modlib.jinja.XMLMaker' : _("""Usage example in /topics/xml"""),
+    'lino.modlib.jinja.XMLMaker.xml_file_name' : _("""The name of the XML file to generate. This file will be overwritten without asking. The name formatted with one name self in the context."""),
+    'lino.modlib.jinja.XMLMaker.xml_file_template' : _("""The name of a Jinja template to render for generating the XML content."""),
+    'lino.modlib.jinja.XMLMaker.xml_validator_file' : _("""The name of a “validator” to use for validating the XML content."""),
     'lino.modlib.memo.Previewable' : _("""Adds three rich text fields (lino.core.fields.RichTextField):"""),
     'lino.modlib.memo.Previewable.body' : _("""An editable text body."""),
     'lino.modlib.memo.Previewable.body_short_preview' : _("""A read-only preview of the first paragraph of body."""),
@@ -686,7 +685,7 @@ help_texts = {
     'lino.modlib.uploads.AllUploads' : _("""Shows all upload files on this Lino site."""),
     'lino.modlib.uploads.AreaUploads' : _("""Mixin for tables of upload files where the upload area is known."""),
     'lino.modlib.uploads.MyUploads' : _("""Shows my uploads (i.e. those whose author is the requesting user)."""),
-    'lino.modlib.uploads.UploadBase' : _("""Abstract base class of Upload. This was named lino.mixins.uploadable.Uploadable until 20210217. It encapsulates some really basic functionality. Its usage is deprecated. If you were inheriting from lino.mixins.Uploadable, you should convert that model to point to an Upload instead."""),
+    'lino.modlib.uploads.UploadBase' : _("""Abstract base class of Upload encapsulating some really basic functionality."""),
     'lino.modlib.uploads.UploadType' : _("""Django model representing an upload type."""),
     'lino.modlib.uploads.UploadType.shortcut' : _("""Optional pointer to a virtual upload shortcut field. If this is not empty, then the given shortcut field will manage uploads of this type. See also Shortcuts."""),
     'lino.modlib.uploads.UploadTypes' : _("""The table with all existing upload types."""),

lino/mixins/duplicable.py

@@ -29,7 +29,7 @@ class Duplicate(actions.Action):
     sort_index = 11
     show_in_workflow = False
     # readonly = False  # like ShowInsert. See docs/blog/2012/0726
-    callable_from = "td"
+    callable_from = "t"
 
     # required_roles = set([Expert])
 
@@ -42,7 +42,7 @@ class Duplicate(actions.Action):
                 return False
             # if not user_type.has_required_roles([Expert]):
             #     return False
-        return super(Duplicate, self).get_view_permission(user_type)
+        return super().get_view_permission(user_type)
 
     def run_from_code(self, ar, **known_values):
         obj = ar.selected_rows[0]
@@ -97,7 +97,8 @@ class Duplicate(actions.Action):
             kw = dict()
             # kw.update(refresh=True)
             kw.update(
-                message=_("Duplicated %(old)s to %(new)s.") % dict(old=obj, new=new)
+                message=_("Duplicated %(old)s to %(new)s.") % dict(
+                    old=obj, new=new)
             )
             # ~ kw.update(new_status=dict(record_id=new.pk))
             ar2.success(**kw)
@@ -108,7 +109,8 @@ class Duplicate(actions.Action):
 
         obj = ar.selected_rows[0]
         ar.confirm(
-            ok, _("This will create a copy of {}.").format(obj), _("Are you sure?")
+            ok, _("This will create a copy of {}.").format(
+                obj), _("Are you sure?")
         )