lino 25.4.1__py3-none-any.whl → 25.4.3__py3-none-any.whl

lino/__init__.py

@@ -31,7 +31,7 @@ from django import VERSION
 from django.apps import AppConfig
 from django.conf import settings
 import warnings
-__version__ = '25.4.1'
+__version__ = '25.4.3'
 
 # import setuptools  # avoid UserWarning "Distutils was imported before Setuptools"?
 

lino/api/dd.py

@@ -155,7 +155,7 @@ from lino.utils import IncompleteDate, read_exception
 
 from lino.utils.format_date import fdm, fdl, fdf, fdmy
 from lino.utils.format_date import fds as fds_
-from lino.utils.format_date import ftl, ftf
+from lino.utils.format_date import fdtl, fdtf
 
 
 def fds(d):
@@ -175,14 +175,8 @@ field2kw = settings.SITE.field2kw
 decfmt = settings.SITE.decfmt
 str2kw = settings.SITE.str2kw
 str2dict = settings.SITE.str2dict
-
-
-def today(*args, **kwargs):
-    # make it serializable for Django migrations
-    return settings.SITE.today(*args, **kwargs)
-
-
-# today = settings.SITE.today
+now = settings.SITE.now
+# today = settings.SITE.today  # see below
 strftime = settings.SITE.strftime
 demo_date = settings.SITE.demo_date
 is_abstract_model = settings.SITE.is_abstract_model
@@ -190,7 +184,6 @@ is_installed = settings.SITE.is_installed
 is_hidden_plugin = settings.SITE.is_hidden_plugin
 resolve_plugin = settings.SITE.resolve_plugin
 get_plugin_setting = settings.SITE.get_plugin_setting
-# get_db_overview_rst = settings.SITE.get_db_overview_rst
 add_welcome_handler = settings.SITE.add_welcome_handler
 build_media_url = settings.SITE.build_media_url
 build_site_cache_url = settings.SITE.build_site_cache_url
@@ -203,6 +196,11 @@ plugins = settings.SITE.plugins
 format_currency = settings.SITE.format_currency
 
 
+def today(*args, **kwargs):
+    # make it serializable for Django migrations
+    return settings.SITE.today(*args, **kwargs)
+
+
 get_language = translation.get_language
 
 

lino/core/dbtables.py

@@ -613,7 +613,7 @@ class Table(AbstractTable):
                 qs = qs.filter(**kw)
 
             if ar.exclude:
-                qs = qs.exclude(**ar.exclude)
+                qs = qs.exclude(ar.exclude)
                 # qs = qs.exclude(ar.exclude)
 
             if ar.param_values is not None:
@@ -654,8 +654,7 @@ class Table(AbstractTable):
                     qs = qs.filter(**d)
 
             if self.exclude:
-                qs = qs.exclude(**self.exclude)
-                # TODO: use Q object instead of dict
+                qs = qs.exclude(self.exclude)
 
             if ar.quick_search:
                 qs = self.add_quick_search_filter(qs, ar.quick_search)

lino/core/fields.py

@@ -6,6 +6,8 @@ Defines extended database field classes and utility functions
 related to fields.
 """
 
+#fmt: off
+
 from lino import logger
 import datetime
 from decimal import Decimal
@@ -112,10 +114,10 @@ class PercentageField(models.DecimalField):
         defaults = dict(
             max_length=5,
             max_digits=5,
-            decimal_places=2,
+            decimal_places=0,
         )
         defaults.update(kwargs)
-        super(PercentageField, self).__init__(*args, **defaults)
+        super().__init__(*args, **defaults)
 
 
 class TimeField(models.TimeField):
@@ -818,7 +820,7 @@ def virtualfield(return_type, **kwargs):
 
     def decorator(fn):
         if isinstance(return_type, DummyField):
-            rv = DummyField(fn)
+            rv = DummyField(return_type.get_default())
         else:
             rv = VirtualField(return_type, fn, **kwargs)
         rv.__doc__ = fn.__doc__
@@ -1001,10 +1003,8 @@ class QuantityField(models.CharField):
             if self.overflow_value:
                 return self.overflow_value
             raise ValidationError(
-                "Cannot accept quantity {} " "because max_length is {}".format(
-                    raw_value, self.max_length
-                )
-            )
+                f"Cannot accept quantity {raw_value} "
+                + f"because max_length is {self.max_length}")
             # print("20230129 Can't store {}={} in {}".format(self.name, raw_value, obj))
             # return -1
         return super().clean(raw_value, obj)
@@ -1111,8 +1111,20 @@ class Dummy(object):
 class DummyField(FakeField):
     """
     Represents a field that doesn't exist in the current configuration
-    but might exist in other configurations. The "value" of a
-    DummyField is always `None`.
+    but might exist in other configurations.
+
+    The "value" of a DummyField is always `None` or any other value to be
+    optionally specified at instantiation.
+
+    .. attribute:: dummy_value
+
+        The value to be returned by this field. Default value is `None`.
+
+    Usage examples:
+
+    - The value of :attr:`lino.modlib.users.User.nickname` is always ``""`` when
+      :data:`lino.modlib.users.with_nickname` is `False`.
+
 
     See e.g. :func:`ForeignKey` and :func:`fields_list`.
     """
@@ -1120,8 +1132,9 @@ class DummyField(FakeField):
     # choices = []
     # primary_key = False
 
-    def __init__(self, *args, **kw):
-        pass
+    def __init__(self, dummy_value=None):
+        super().__init__()
+        self.dummy_value = dummy_value
 
     # def __init__(self, name, *args, **kw):
     #     self.name = name
@@ -1132,10 +1145,10 @@ class DummyField(FakeField):
     def __get__(self, instance, owner):
         if instance is None:
             return self
-        return None
+        return self.dummy_value
 
     def get_default(self):
-        return None
+        return self.dummy_value
 
     def contribute_to_class(self, cls, name):
         self.name = name
@@ -1548,10 +1561,12 @@ def pointer_factory(cls, othermodel, *args, **kw):
 
     """
     if othermodel is None:
-        return DummyField(othermodel, *args, **kw)
+        # return DummyField(othermodel, *args, **kw)
+        return DummyField(None)
     if isinstance(othermodel, str):
         if not settings.SITE.is_installed_model_spec(othermodel):
-            return DummyField(othermodel, *args, **kw)
+            # return DummyField(othermodel, *args, **kw)
+            return DummyField(None)
 
     kw.setdefault("on_delete", models.CASCADE)
     return cls(othermodel, *args, **kw)

lino/core/kernel.py

@@ -21,6 +21,7 @@ application.
 
 import os
 import sys
+import time
 import codecs
 import atexit
 import signal
@@ -41,7 +42,7 @@ from django.db import models
 
 # import lino  # for is_testing
 from lino import logger
-# from lino.utils import codetime
+from lino.utils import codetime
 from lino.utils.html import E
 # from lino.core.utils import format_request
 # from lino.utils import isiterable
@@ -111,6 +112,32 @@ class Kernel(object):
         self.GFK_LIST = []
         # logger.info("20140227 Kernel.__init__() done")
 
+    # On a production server we test only the timestamp of settings.py file
+    # because otherwise the result can differ depending on which modules have
+    # already been imported.
+
+    _lino_version = None
+
+    def touch_lino_version(self):
+        if is_devserver():
+            self._lino_version = time.time()
+        else:
+            p = self.site.site_dir / "lino_version.txt"
+            p.touch()
+            self._lino_version = p.stat().st_mtime
+
+    @property
+    def lino_version(self):
+        if self._lino_version is None:
+            if is_devserver():
+                self._lino_version = codetime()
+            else:
+                p = self.site.site_dir / "lino_version.txt"
+                if not p.exists():
+                    p.touch()
+                self._lino_version = p.stat().st_mtime
+        return self._lino_version
+
     # _code_mtime = None
     #
     # @property
@@ -118,13 +145,12 @@ class Kernel(object):
     #     if self._code_mtime is None:
     #         # packages = [os.environ['DJANGO_SETTINGS_MODULE'], 'lino']
     #         # self._code_mtime = codetime(*packages)
-    #         if self.site.developer_site_cache:
+    #         # if self.site.developer_site_cache:
+    #         if is_devserver():
     #             self._code_mtime = codetime()
     #         else:
-    #             # On a production server we test only the timestamp of
-    #             # settings.py file because otherwise the result can differ
-    #             # depending on which modules have already been imported.
-    #             self._code_mtime = codetime(settings.SETTINGS_MODULE)
+    #             self._code_mtime = self.lino_version
+    #             # self._code_mtime = codetime(settings.SETTINGS_MODULE)
     #     return self._code_mtime
 
     def kernel_startup(self, site):
@@ -919,7 +945,7 @@ class Kernel(object):
         if not force and not self._must_build and fn.exists():
             mtime = os.stat(fn).st_mtime
             # if mtime > self.code_mtime:
-            if mtime > self.site.lino_version:
+            if mtime > self.lino_version:
                 # logger.debug("%s (%s) is up to date.", fn, time.ctime(mtime))
                 return 0
 

lino/core/renderer.py

@@ -124,6 +124,9 @@ class Renderer(object):
     #     if ar is None or a.get_bound_action_permission(ar, obj, None):
     #         return a
 
+    def add_help_text(self, kw, help_text, title, datasource, fieldname):
+        pass
+
     def get_detail_url(self, *args, **kwargs):
         return self.front_end.get_detail_url(*args, **kwargs)
 
@@ -750,9 +753,6 @@ class HtmlRenderer(Renderer):
     def goto_instance(self, ar, obj, **kw):
         pass
 
-    def add_help_text(self, kw, help_text, title, datasource, fieldname):
-        pass
-
 
 class TextRenderer(HtmlRenderer):
     """

lino/core/requests.py

@@ -829,7 +829,7 @@ class BaseRequest:
             unicode=str,  # backwards-compatibility. In new templates
             # you should prefer `str`.
             pgettext=pgettext,
-            now=timezone.now(),
+            now=dd.now(),
             getattr=getattr,
             restify=restify,
             activate_language=activate,
@@ -1805,6 +1805,8 @@ class ActionRequest(BaseRequest):
         selected_rows=None,
         **kw
     ):
+        if exclude is not None:
+            assert isinstance(exclude, models.Q)
         if title is not None:
             self.title = title
         if offset is not None:
@@ -1908,7 +1910,11 @@ class ActionRequest(BaseRequest):
         #         raise Exception("20230426 b {}".format(self.master))
 
         if issubclass(self.actor, AbstractTable):
-
+            if self.actor.exclude is not None:
+                if not isinstance(self.actor.exclude, models.Q):
+                    raise Exception(
+                        f"{self.actor}.exclude must be a Q object",
+                        f" not {self.actor.exclude}")
             self.exclude = exclude or self.actor.exclude
             self.page_length = self.actor.page_length
 
@@ -2019,8 +2025,7 @@ class ActionRequest(BaseRequest):
             # 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.no_data_text = e + " (set catch_layout_exceptions to see details)"
             self._data_iterator = []
             w = WARNINGS_LOGGED.get(e)
             if w is None:
@@ -2042,8 +2047,18 @@ class ActionRequest(BaseRequest):
                     self._data_iterator, self)
             )
         else:
+            offset = self.offset
+
+            if self.actor.start_at_bottom and offset is None and self.limit is not None:
+                count = self.get_total_count()
+                if not self.actor.no_phantom_row:
+                    count += 1
+                offset = (count // self.limit) * self.limit
+                if (count % self.limit) == 0 and count != 0:
+                    offset -= self.limit
+
             self._sliced_data_iterator = sliced_data_iterator(
-                self._data_iterator, self.offset, self.limit
+                self._data_iterator, offset, self.limit
             )
         # logger.info("20171116 executed : %s", self._sliced_data_iterator)
 
@@ -2069,11 +2084,11 @@ class ActionRequest(BaseRequest):
         assert issubclass(self.actor, AbstractTable)
         self.actor.check_params(self.param_values)
         if self.actor.get_data_rows is not None:
-            l = []
+            lst = []
             for row in self.actor.get_data_rows(self):
                 group = self.actor.group_from_row(row)
-                group.process_row(l, row)
-            return l
+                group.process_row(lst, row)
+            return lst
         # ~ logger.info("20120914 tables.get_data_iterator %s",self)
         # ~ logger.info("20120914 tables.get_data_iterator %s",self.actor)
         # print("20181121 get_data_iterator", self.actor)
@@ -2145,7 +2160,7 @@ class ActionRequest(BaseRequest):
         if self.known_values:
             # kw.update(self.known_values)
             for k, v in self.known_values.items():
-                if not "__" in k:
+                if "__" not in k:
                     kw[k] = v
         obj = self.actor.create_instance(self, **kw)
         return obj

lino/core/site.py

@@ -3,23 +3,8 @@
 # License: GNU Affero General Public License v3 (see file COPYING for details)
 # doctest lino/core/site.py
 
-from lino.core.exceptions import ChangedAPI
-from django.apps import apps
-from lino.utils.html import E, tostring
-from lino import assert_django_code, DJANGO_DEFAULT_LANGUAGE
-# from lino.core import constants
-from lino.core.plugin import Plugin
-from rstgen.confparser import ConfigParser
-from django.utils import translation
-from django.utils.html import mark_safe
-from django.utils.translation import get_language
-from django.utils.translation import gettext_lazy as _
-from django.conf import settings
-import rstgen
-from lino.utils import AttrDict, date_offset, i2d, buildurl
-from lino import logger, __version__
 from importlib.util import find_spec
-from importlib import import_module, reload
+from importlib import import_module
 from pathlib import Path
 import os
 import re
@@ -34,6 +19,22 @@ import logging
 # from pprint import pprint
 from logging.handlers import SocketHandler
 import time
+import rstgen
+from rstgen.confparser import ConfigParser
+from django.apps import apps
+from django.utils import timezone
+from django.utils import translation
+from django.utils.html import mark_safe
+from django.utils.translation import get_language
+from django.utils.translation import gettext_lazy as _
+from django.conf import settings
+from lino import assert_django_code, DJANGO_DEFAULT_LANGUAGE
+from lino import logger, __version__
+from lino.core.exceptions import ChangedAPI
+from lino.utils.html import E, tostring
+# from lino.core import constants
+from lino.core.plugin import Plugin
+from lino.utils import AttrDict, date_offset, i2d, buildurl
 
 NO_REMOTE_AUTH = True
 # 20240518 We have only one production site still using remote http
@@ -1386,6 +1387,11 @@ class Site(object):
             )
         return date_offset(base, *args, **kwargs)
 
+    def now(self, *args, **kwargs):
+        t = self.today()
+        now = timezone.now()
+        return now.replace(year=t.year, month=t.month, day=t.day)
+
     def welcome_text(self):
         return "This is %s using %s." % (self.site_version(), self.using_text())
 
@@ -1823,6 +1829,7 @@ class Site(object):
         self.install_settings()
 
     def is_imported_partner(self, obj):
+        # Deprecated.
         # ~ return obj.id is not None and (obj.id < 200000 or obj.id > 299999)
         return False
         # ~ return obj.id is not None and (obj.id > 10 and obj.id < 21)
@@ -2006,17 +2013,6 @@ class Site(object):
         s = self.plugins.jinja.render_from_ar(ar, "admin_main.html", **context)
         return mark_safe(s)
 
-    _lino_version = None
-
-    @property
-    def lino_version(self):
-        p = self.site_dir / "lino_version.txt"
-        if self._lino_version is None:
-            if not p.exists():
-                p.touch()
-            self._lino_version = p.stat().st_mtime
-        return self._lino_version
-
     def build_site_cache(self, force=False, later=False, verbosity=1):
         from lino.modlib.users.utils import with_user_profile
         from lino.modlib.users.choicelists import UserTypes
@@ -2026,8 +2022,9 @@ class Site(object):
         #     self.is_prepared = True
         # settings_file = self.django_settings.get("__file__")
         # Path(settings_file).touch()
-        p = self.site_dir / "lino_version.txt"
-        p.touch()
+        # p = self.site_dir / "lino_version.txt"
+        # p.touch()
+        self.kernel.touch_lino_version()
 
         if later:
             # print("20230823 later")
@@ -2082,6 +2079,18 @@ class Site(object):
                 time.time() - started,
             )
 
+    _top_link_generator = []
+
+    def get_top_links(self, ar):
+        messages = []
+        for l in self._top_link_generator:
+            for msg in l(ar):
+                messages.append(msg)
+        return tostring(E.div(*messages))
+
+    def add_top_link_generator(self, func):
+        self._top_link_generator.append(func)
+
     def get_welcome_messages(self, ar):
         for h in self._welcome_handlers:
             for msg in h(ar):

lino/core/tables.py

@@ -1,12 +1,10 @@
 # -*- 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)
 """Defines the classes :class:`AbstractTable` and
 :class:`VirtualTable`.
 
 """
-from lino import logger
-from future.utils import with_metaclass
 
 import os
 import yaml
@@ -15,8 +13,9 @@ from django.db import models
 from django.db.utils import OperationalError, ProgrammingError
 from django.conf import settings
 from django.utils.translation import gettext_lazy as _
-from django.core.exceptions import BadRequest
+# from django.core.exceptions import BadRequest
 
+from lino import logger
 from lino.core import actors
 from lino.core import actions
 from lino.core import fields
@@ -191,17 +190,15 @@ class AbstractTable(actors.Actor):
     will not pop-in.
     """
 
-    # start_at_bottom = False
-    # """Set this to `True` if you want your table to *start at the
-    # bottom*.  Unlike reverse ordering, the rows remain in their
-    # natural order, but when we open a grid on this table, we want it
-    # to start on the last page.
-    #
-    # Use cases would be :class:`lino_xl.lib.trading.InvoicesByJournal` and
-    # :class:`lino_xl.lib.accounting.InvoicesByJournal` but the result is not yet
-    # satisfying.
-    #
-    # """
+    start_at_bottom = False
+    """Set this to `True` if you want your table to *start at the
+    bottom*.  Unlike reverse ordering, the rows remain in their
+    natural order, but when we open a grid on this table, we want it
+    to start on the last page.
+
+    Use cases are in :class:`lino_xl.lib.trading.InvoicesByJournal` and
+    :class:`lino_xl.lib.accounting.InvoicesByJournal`.
+    """
 
     group_by = None
     """
@@ -397,21 +394,20 @@ method in order to sort the rows of the queryset.
     """
 
     filter = None
-    """If specified, this must be a `models.Q` object (not a dict of
-    (fieldname -> value) pairs) which will be passed to Django's
-    `filter
+    """
+    If specified, this must be a :class:`django.db.models.Q` object that will be
+    passed to Django's `filter
     <https://docs.djangoproject.com/en/5.0/ref/models/querysets/#filter>`__
     method.
 
-    Note that if you allow a user to insert rows into a filtered
-    table, you should make sure that new records satisfy your filter
-    condition, otherwise you can get surprising behaviour if the user
-    creates a new row.
+    If you allow a user to insert rows into a filtered table, you should make
+    sure that new records satisfy your filter condition, otherwise you can get
+    surprising behaviour if the user creates a new row.
 
-    If your filter consists of simple static values on some known
-    field, then you might prefer to use
-    :attr:`known_values  <lino.core.actors.Actor.known_values>`
-    instead because this will add automatic behaviour.
+    If your filter consists of simple static values on some known field, then
+    you might prefer to use :attr:`known_values
+    <lino.core.actors.Actor.known_values>` instead because this will add
+    automatic behaviour.
 
     One advantage of :attr:`filter` over
     :attr:`known_values  <lino.core.actors.Actor.known_values>`
@@ -421,11 +417,13 @@ method in order to sort the rows of the queryset.
     """
 
     exclude = None
-    """If specified, this must be dict which will be passed to Django's
-    `exclude
+    """
+    If specified, this must be a :class:`django.db.models.Q` object that will be
+    passed to Django's `exclude
     <https://docs.djangoproject.com/en/5.0/ref/models/querysets/#exclude>`__
-    method on the queryset.
+    method.
 
+    This is the logical opposite of :attr:`filter`.
     """
 
     extra = None

lino/help_texts.py

@@ -11,8 +11,8 @@ help_texts = {
     'lino.mixins.Modified' : _("""Adds a a timestamp field that holds the last modification time of every individual database object."""),
     'lino.mixins.Modified.modified' : _("""The time when this database object was last modified."""),
     'lino.mixins.Modified.auto_touch' : _("""Whether to touch objects automatically when saving them."""),
-    'lino.mixins.Created' : _("""Adds a timestamp field which holds the creation time of every individual database object."""),
-    'lino.mixins.Created.created' : _("""The time when this object was created."""),
+    'lino.mixins.Created' : _("""Adds a timestamp field that holds the creation time of every individual database row."""),
+    'lino.mixins.Created.created' : _("""The time when this database row was created."""),
     'lino.mixins.CreatedModified' : _("""Adds two timestamp fields created and modified."""),
     'lino.mixins.ProjectRelated' : _("""Mixin for models that are related to a “project”, i.e. to an object of the type given by your lino.core.site.Site.project_model."""),
     'lino.mixins.ProjectRelated.project' : _("""Pointer to the project to which this object is related."""),
@@ -253,6 +253,8 @@ help_texts = {
     '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 path and url."""),
+    'lino.utils.media.MediaFile.path' : _("""A pathlib.Path naming the file on the server’s file system."""),
+    'lino.utils.media.MediaFile.url' : _("""The URL to use for getting this file from a web client."""),
     '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."""),
@@ -551,6 +553,8 @@ help_texts = {
     '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.jinja.XMLMaker.get_xml_file' : _("""Get the name of the XML file to be generated for this database row."""),
+    'lino.modlib.jinja.XMLMaker.make_xml_file' : _("""Make the XML file for this database row."""),
     '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."""),
@@ -642,7 +646,7 @@ help_texts = {
     'lino.modlib.system.SiteConfig.simulate_today' : _("""A constant user-defined date to be substituted as current system date."""),
     'lino.modlib.system.SiteConfig.site_company' : _("""The site operator, i.e. the legal person that operates this Lino site."""),
     'lino.modlib.system.SiteConfig.hide_events_before' : _("""If this is not empty, any calendar events before that date are being hidden in certain places."""),
-    'lino.modlib.system.SiteConfigManager' : _("""Always return the cached instance which holds the one and only database instance."""),
+    'lino.modlib.system.SiteConfigManager' : _("""Returns the cached instance, which holds the one and only database instance."""),
     'lino.modlib.system.Lockable' : _("""Mixin to add row-level edit locking to any model."""),
     'lino.modlib.system.BuildSiteCache' : _("""Rebuild the site cache. This action is available on About."""),
     'lino.modlib.system.SiteConfigs' : _("""The table used to present the SiteConfig row in a Detail form."""),