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

lino/__init__.py

@@ -26,7 +26,12 @@ defines no models, some template files, a series of :term:`django-admin commands
 
 """
 
-__version__ = '25.3.0'
+from django.utils.translation import gettext_lazy as _
+from django import VERSION
+from django.apps import AppConfig
+from django.conf import settings
+import warnings
+__version__ = '25.3.2'
 
 # import setuptools  # avoid UserWarning "Distutils was imported before Setuptools"?
 
@@ -60,7 +65,6 @@ elif sys.version_info[0] == 2 and sys.version_info[1] > 6:
 else:
     PYAFTER26 = False
 
-import warnings
 
 warnings.filterwarnings(
     "error",
@@ -92,8 +96,6 @@ warnings.filterwarnings(
 # TODO: get everything to work even when ResourceWarning gives an error
 # warnings.filterwarnings("error", category=ResourceWarning)
 
-from django.conf import settings
-from django.apps import AppConfig
 
 # def setup_project(settings_module):
 #     os.environ['DJANGO_SETTINGS_MODULE'] = settings_module
@@ -110,8 +112,6 @@ def assert_django_code(django_code):
         )
 
 
-from django import VERSION
-
 AFTER17 = True
 AFTER18 = True
 DJANGO2 = True
@@ -197,4 +197,3 @@ class AppConfig(AppConfig):
 default_app_config = "lino.AppConfig"
 
 # deprecated use, only for backwards compat:
-from django.utils.translation import gettext_lazy as _

lino/api/dd.py

@@ -10,6 +10,7 @@ from lino.modlib.system.choicelists import Genders, PeriodEvents, YesNo
 from lino.utils.mldbc.fields import BabelCharField, LanguageField
 from lino.utils.mldbc.fields import BabelTextField
 from lino.utils.format_date import fdl as dtosl
+from lino.utils.fieldutils import get_fields, fields_help
 from lino import logger
 
 # import logging ; logger = logging.getLogger(__name__)

lino/api/doctest.py

@@ -14,6 +14,37 @@ tested document. It includes
 
 """
 
+from lino.utils.fieldutils import get_fields, fields_help
+from lino.core.boundaction import BoundAction
+from lino.core.tables import AbstractTable
+from lino.core.actions import Action
+from django.db.models import Model
+from lino.core.actions import ShowTable
+from lino.core.menus import Menu
+from lino.utils.html import html2text
+from lino.core.utils import full_model_name, get_models
+from lino.utils.diag import visible_for
+from lino.sphinxcontrib.actordoc import menuselection_text
+from lino import logger
+from lino.core.menus import find_menu_item
+from lino.core import constants
+from lino.core import actors, kernel
+from lino.utils.sql import sql_summary
+from lino.utils import diag
+from lino.utils.diag import analyzer
+from lino.utils.html import E, tostring, to_rst
+from lino.utils import i2d
+from lino.utils import AttrDict
+from rstgen.utils import unindent, rmu, sixprint
+from rstgen import attrtable
+import rstgen
+import pytest
+from django.db import connection, reset_queries as reset_sql_queries
+from django.test import Client
+from django.utils.encoding import force_str
+from django.utils import translation
+from lino.api.shell import *
+from lino.core.constants import *
 import os
 import sys
 import datetime
@@ -31,39 +62,11 @@ from urllib.parse import urlencode
 import django
 django.setup()
 
-from lino.core.constants import *
-from lino.api.shell import *
-from django.utils import translation
-from django.utils.encoding import force_str
-from django.test import Client
-from django.db import connection, reset_queries as reset_sql_queries
 
-import pytest
 # from rstgen import table, ul
-import rstgen
-from rstgen import attrtable
-from rstgen.utils import unindent, rmu, sixprint
 
-from lino.utils import AttrDict
-from lino.utils import i2d
-from lino.utils.html import E, tostring, to_rst
-from lino.utils.diag import analyzer
-from lino.utils import diag
-from lino.utils.sql import sql_summary
-from lino.core import actors, kernel
-from lino.core import constants
-from lino.core.menus import find_menu_item
-from lino import logger
-from lino.sphinxcontrib.actordoc import menuselection_text
-from lino.utils.diag import visible_for
-from lino.core.utils import full_model_name, get_models
 
 # from lino.core.utils import PseudoRequest
-from lino.utils.html import html2text
-from lino.core.menus import Menu
-from lino.core.actions import ShowTable
-from lino.core.actions import register_params
-from lino.core.layouts import BaseLayout
 
 test_client = Client()
 """An instance of :class:`django.test.Client`.
@@ -88,7 +91,8 @@ def get_json_dict(username, uri, an="detail", **kwargs):
     #     url += "&{}={}".format(k, v)
     test_client.force_login(rt.login(username).user)
     res = test_client.get(url, REMOTE_USER=username)
-    assert res.status_code == 200
+    if res.status_code != 200:
+        raise Exception(f"GET {url} got status code {res.status_code}")
     s = res.content.decode()
     try:
         return json.loads(s)
@@ -275,12 +279,6 @@ def show_choices(username, url, show_count=False):
         print("{} rows".format(result["count"]))
 
 
-from django.db.models import Model
-from lino.core.actions import Action
-from lino.core.tables import AbstractTable
-from lino.core.boundaction import BoundAction
-
-
 def show_workflow(actions, all=False, language=None):
     """
     Show the given actions as a table.  Usage example in
@@ -320,71 +318,6 @@ def show_workflow(actions, all=False, language=None):
     return doit()
 
 
-def get_fields(model, fieldnames=None, columns=None):
-    if isinstance(model, BoundAction):
-        get_field = model.action.parameters.get
-        if fieldnames is None:
-            fieldnames = model.action.params_layout
-    elif isinstance(model, Action):
-        get_field = model.parameters.get
-        if fieldnames is None:
-            fieldnames = model.params_layout.main
-    elif issubclass(model, Model):
-        get_field = model._meta.get_field
-        # get_field = model.get_data_elem
-        if fieldnames is None:
-            fieldnames = [f.name for f in model._meta.get_fields()]
-    elif issubclass(model, AbstractTable):
-        if columns:
-            get_field = model.get_data_elem
-            if fieldnames is None:
-                fieldnames = model.column_names
-                # get_handle().grid_layout.main.columns
-        else:
-            get_field = model.parameters.get
-            if fieldnames is None:
-                if not isinstance(model.params_layout, BaseLayout):
-                    register_params(model)
-                fieldnames = model.params_layout.main
-    if fieldnames is None:
-        return
-    if isinstance(fieldnames, str):
-        fieldnames = fieldnames.split()
-    for n in fieldnames:
-        yield get_field(n)
-
-
-def fields_help(model, fieldnames=None, columns=False, all=None):
-    """
-    Print an overview description of the specified fields of the
-    specified model.
-
-    If model is an action or table, print the parameter fields of that
-    action or table.
-
-    If model is a table and you want the columns instead of the
-    parameter fields, then specify `columns=True`.
-
-    By default this shows only fields that have a help text.  If you
-    specify `all=True`, then also fields that have no help text will
-    be shown.
-    """
-    if all is None:
-        all = fieldnames is not None
-
-    cells = []
-    # cols = ["Internal name", "Verbose name", "Help text"]
-    for fld in get_fields(model, fieldnames, columns):
-        if fld is not None and hasattr(fld, "verbose_name"):
-            ht = fld.help_text or ""
-            if ht or all:
-                cells.append([fld.name, fld.verbose_name, unindent(ht)])
-
-    # return table(cols, cells).strip()
-    items = ["{} ({}) : {}".format(row[1], row[0], row[2]) for row in cells]
-    return rstgen.ul(items).strip()
-
-
 def show_fields(*args, **kwargs):
     print(fields_help(*args, **kwargs))
 
@@ -768,7 +701,6 @@ def walk_store_fields(only_detail_fields=False):
                 yield a, sf
 
 
-# settings.SITE.kernel.check_virgin()
 def set_log_level(level):
     logger.setLevel(level)
     for handler in logger.handlers:
@@ -800,6 +732,7 @@ def show_change_watchers():
             )
     print(rstgen.table(headers, rows, max_width=40))
 
+
 def show_display_modes():
     """
     Show the availble display modes per actor.
@@ -813,7 +746,7 @@ def show_display_modes():
             rows.append(
                 [str(a)] + [
                     ("x" if dm in a.extra_display_modes else "")
-                        for dm in dml]
+                    for dm in dml]
             )
     print(rstgen.table(headers, rows))
 

lino/api/rt.py

@@ -1,6 +1,8 @@
 # Copyright 2014-2018 Rumma & Ko Ltd
 # License: GNU Affero General Public License v3 (see file COPYING for details)
 
+from lino.core.utils import login, show, shows
+from lino.core.exceptions import ChangedAPI
 from django.conf import settings
 
 from lino.core.utils import models_by_base
@@ -9,7 +11,6 @@ models = settings.SITE.models
 """
 """
 
-from lino.core.exceptions import ChangedAPI
 # actors = modules = ChangedAPI(
 #     "Replace rt.modules and rt.actors by rt.models")
 
@@ -32,9 +33,6 @@ def get_template(*args, **kw):
     return settings.SITE.plugins.jinja.renderer.jinja_env.get_template(*args, **kw)
 
 
-from lino.core.utils import login, show, shows
-
-
 # def send_email(*args, **kw):
 #     "Shortcut to :meth:`lino.core.site.Site.send_email`."
 #     return settings.SITE.send_email(*args, **kw)

lino/core/actors.py

@@ -8,11 +8,8 @@ See :doc:`/dev/actors`.
 
 """
 
-from lino import logger
-
 import copy
-import traceback
-import html
+import warnings
 from types import GeneratorType
 from inspect import getmro
 
@@ -22,6 +19,7 @@ from django.utils.translation import gettext_lazy as _
 from django.utils.html import format_html, mark_safe, SafeString
 from django.core.exceptions import BadRequest
 
+from lino import logger
 from lino.utils import isiterable
 from lino.utils import MissingRow
 from lino.core import fields
@@ -38,8 +36,7 @@ from lino.core.utils import qs2summary
 from lino.core.utils import ParameterPanel
 from lino.core.utils import navinfo, dbfield2params_field
 from lino.utils import curry, AttrDict, is_string
-
-from lino.utils.html import E, forcetext, tostring, Grouper, SAFE_EMPTY
+from lino.utils.html import E, tostring, Grouper, SAFE_EMPTY
 # from lino.utils.html import assert_safe
 
 from .roles import SiteUser
@@ -656,7 +653,6 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
                 try:
                     settings.SITE.kernel.setup_handle(h, ar)
                 except Exception as e:
-                    # traceback.print_exc()
                     logger.warning(
                         "%s setup_handle failed with %s (change actors.py to see more)",
                         self,
@@ -1841,7 +1837,17 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
         return kw
 
     @classmethod
-    def request(cls, master_instance=None, **kwargs):
+    def request(cls, *args, **kwargs):
+        """
+        Old name for :meth:`create_request`. Still does the same but with a
+        deprecation warning.
+        """
+        warnings.warn(
+            "Please call create_request() instead of request()", DeprecationWarning)
+        return cls.create_request(*args, **kwargs)
+
+    @classmethod
+    def create_request(cls, master_instance=None, **kwargs):
         """Return a new :class:`ActionRequest
         <lino.core.requests.ActionRequest>` on this actor.
 
@@ -1867,7 +1873,7 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
 
     @classmethod
     def to_html(self, **kw):
-        return tostring(self.request(**kw).table2xhtml())
+        return tostring(self.create_request(**kw).table2xhtml())
 
     @classmethod
     def get_screenshot_requests(self, language):
@@ -1896,7 +1902,7 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
         kwargs.update(parent=ar)
         kwargs.update(renderer=settings.SITE.kernel.default_renderer)
         try:
-            ar = cls.request(master_instance=master, **kwargs)
+            ar = cls.create_request(master_instance=master, **kwargs)
             el = cls.table_as_html(ar)
         except Exception as e:
             msg = f"20241004 Error in {repr(ar)}: {e}"
@@ -1911,8 +1917,8 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
     @classmethod
     def get_table_as_list(cls, obj, ar):
         # raise Exception("20240316")
-        sar = cls.request(parent=ar, master_instance=obj,
-                          is_on_main_actor=False)
+        sar = cls.create_request(parent=ar, master_instance=obj,
+                                 is_on_main_actor=False)
         grp = Grouper(sar)
         html_text = grp.begin()
         for i, obj in enumerate(sar.data_iterator):
@@ -1946,8 +1952,8 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
 
     @classmethod
     def get_table_story(cls, obj, ar):
-        sar = cls.request(parent=ar, master_instance=obj,
-                          is_on_main_actor=False)
+        sar = cls.create_request(parent=ar, master_instance=obj,
+                                 is_on_main_actor=False)
         html = SAFE_EMPTY
         for i, obj in enumerate(sar.data_iterator):
             if i == cls.preview_limit:
@@ -1973,8 +1979,8 @@ class Actor(actions.Parametrizable, Permittable, metaclass=ActorMetaClass):
         """
         if ar is None:
             return ''
-        sar = cls.request(parent=ar, master_instance=obj,
-                          is_on_main_actor=False)
+        sar = cls.create_request(parent=ar, master_instance=obj,
+                                 is_on_main_actor=False)
         return cls.get_table_summary(sar)
 
     @classmethod

lino/core/boundaction.py

@@ -1,16 +1,17 @@
 # -*- coding: UTF-8 -*-
-# Copyright 2009-2020 Rumma & Ko Ltd
+# Copyright 2009-2025 Rumma & Ko Ltd
 # License: GNU Affero General Public License v3 (see file COPYING for details)
 """
 .. autosummary::
 
 """
 
-from lino import logger
 import os
+import warnings
 
 from django.conf import settings
 
+from lino import logger
 from lino.utils import curry
 # from .actions import Action
 
@@ -21,7 +22,7 @@ from lino.core.permissions import (
 
 
 class BoundAction(object):
-    """An Action that is bound to an Actor.  If an Actor has subclasses,
+    """An action that is bound to an actor.  If an actor has subclasses,
     each subclass "inherits" its actions.
 
     """
@@ -94,15 +95,24 @@ class BoundAction(object):
     def full_name(self):
         return self.action.full_name(self.actor)
 
-    def request(self, *args, **kw):
-        # print("20170116 BoundAction.request()", args, kw)
+    def create_request(self, *args, **kw):
+        # print("20170116 BoundAction.create_request()", args, kw)
         kw.update(action=self)
-        return self.actor.request(*args, **kw)
+        return self.actor.create_request(*args, **kw)
+
+    def request(self, *args, **kwargs):
+        """
+        Old name for :meth:`create_request`. Still does the same but with a
+        deprecation warning.
+        """
+        warnings.warn(
+            "Please call create_request() instead of request()", DeprecationWarning)
+        return self.create_request(*args, **kwargs)
 
     def request_from(self, ar, *args, **kw):
         """Create a request of this action from parent request `ar`."""
         kw.update(parent=ar)
-        return self.request(*args, **kw)
+        return self.create_request(*args, **kw)
 
     def run_from_session(self, ses, **kw):
         ar = self.request_from(ses, **kw)

lino/core/dashboard.py

@@ -5,8 +5,8 @@
 
 """
 
-from django.conf import settings
-from lino.api import _
+# from django.conf import settings
+# from lino.api import _
 from lino.core.permissions import Permittable
 from lino.core.requests import ActionRequest
 from lino.core.tables import AbstractTable
@@ -78,7 +78,7 @@ class DashboardItem(Permittable):
             # TODO 20220930 until now, dashboard was always acting as if
             # display_mode was DISPLAY_MODE_GRID
             if issubclass(sar.actor, AbstractTable):
-            # if isinstance(sar.bound_action.action, ShowTable):
+                # if isinstance(sar.bound_action.action, ShowTable):
                 for e in sar.renderer.table2story(sar, **kwargs):
                     # assert_safe(tostring(e))
                     yield tostring(e)
@@ -149,7 +149,8 @@ class ActorItem(DashboardItem):
         # from lino.core.tables import AbstractTable
         T = self.actor
         # if isinstance(T, AbstractTable):
-        sar = T.request(limit=T.preview_limit, parent=ar)  #, renderer=settings.SITE.kernel.default_renderer)
+        # , renderer=settings.SITE.kernel.default_renderer)
+        sar = T.create_request(limit=T.preview_limit, parent=ar)
         # sar = ar.spawn(T, limit=T.preview_limit)
         # sar = ar.spawn_request(actor=T, limit=T.preview_limit)
         # raise Exception("20230331 {}".format(ar.subst_user))

lino/core/dbtables.py

@@ -4,6 +4,17 @@
 This defines the :class:`Table` class.
 """
 
+from lino.core.gfks import ContentType, GenericForeignKey
+from lino.core.tables import AbstractTable
+from lino.core.utils import resolve_model, get_field, UnresolvedModel
+from .utils import models_by_base
+from lino.core.choicelists import ChoiceListField
+from lino.core import constants
+from lino.core import actors
+from lino.core.model import Model
+from lino.core import actions
+from lino.core import fields
+from lino.utils.html import tostring, assert_safe
 from lino import logger
 
 import datetime
@@ -21,21 +32,9 @@ from django.apps import apps
 
 get_models = apps.get_models
 
-from lino.utils.html import tostring, assert_safe
 
-from lino.core import fields
-from lino.core import actions
-from lino.core.model import Model
-from lino.core import actors
-from lino.core import constants
-
-from lino.core.choicelists import ChoiceListField
-from .utils import models_by_base
 # from .fields import get_data_elem_from_model
 
-from lino.core.utils import resolve_model, get_field, UnresolvedModel
-from lino.core.tables import AbstractTable
-from lino.core.gfks import ContentType, GenericForeignKey
 
 INVALID_MK = "Invalid master_key '{0}' in {1} : {2}"
 
@@ -260,10 +259,10 @@ class Table(AbstractTable):
                 profiles2user[u.user_type] = u
         for user in list(profiles2user.values()):
             # if user.profile.name != 'admin': return
-            # yield self.default_action.request(user=user)
+            # yield self.default_action.create_request(user=user)
             # and self.default_action is not self.detail_action:
             if self.detail_action:
-                yield self.detail_action.request(user=user)
+                yield self.detail_action.create_request(user=user)
 
     # @classmethod
     # def elem_get_printable_target_stem(cls,elem):
@@ -589,7 +588,7 @@ class Table(AbstractTable):
         if self.delete_action is None:
             return "No delete_action"
         if not self.get_row_permission(
-            obj, ar, self.get_row_state(obj), self.delete_action):
+                obj, ar, self.get_row_state(obj), self.delete_action):
             # print "20130222 ar is %r" % ar
             # logger.info("20130225 dbtables.disable_delete no permission")
             return _("You have no permission to delete this row.")
@@ -601,7 +600,7 @@ class Table(AbstractTable):
 
         # raise Exception("20240321 get_request_queryset", self)
         # if not isinstance(ar, TableRequest):
-        #     ar = self.request(parent=ar)
+        #     ar = self.create_request(parent=ar)
 
         def apply(qs):
             # print("20160329 {}".format(qs.query))

lino/core/fields.py

@@ -1663,7 +1663,7 @@ def make_remote_field(model, name):
                         #         fld.related_model, rkw))
                         reltarget = fld.related_model(**rkw)
                         reltarget.save_new_instance(
-                            fld.related_model.get_default_table().request()
+                            fld.related_model.get_default_table().create_request()
                         )
 
                     setattr(target, fld.name, reltarget)
@@ -1774,8 +1774,8 @@ def choices_for_field(ar, holder, field):
     if isinstance(field, models.ForeignKey):
         m = field.remote_field.model
         t = m.get_default_table()
-        # qs = t.request(request=ar.request).data_iterator
-        qs = t.request(parent=ar).data_iterator
+        # qs = t.create_request(request=ar.request).data_iterator
+        qs = t.create_request(parent=ar).data_iterator
 
         # logger.info('20120710 choices_view(FK) %s --> %s', t, qs.query)
 

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

@@ -26,7 +26,6 @@ import atexit
 import signal
 import threading
 from importlib import import_module
-import json
 
 # from django.apps import AppConfig
 from django.apps import apps
@@ -953,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

lino/core/menus.py

@@ -160,7 +160,7 @@ class MenuItem(object):
     #     return False
 
     def openui5Render(self):
-        ar = self.bound_action.request(**self.params)
+        ar = self.bound_action.create_request(**self.params)
         js = settings.SITE.kernel.default_renderer.request_handler(ar)
         return js