lino.core.kernel

This defines the 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).

The kernel is instantiated at the end of the startup process, when the SITE has been instantiated and models have been loaded. It encapsulates a bunch of functionality which becomes available only then.

TODO: Rename "kernel" to "environment". Because "kernel" suggests something which is loaded in first place. That's not true for Lino's "kernel". it should be renamed to lino.core.env (for "environment") because it represents the runtime environment of a Lino application.

(This module's source code is available here.)

Functions

choicelist_choices()

Return a list of all choicelists defined for this application.

get_choicelist(i)

is_candidate(T)

register_actors()

This is being called at startup.

register_choicelist(cl)

register_frame(frm)

register_model_table(rpt)

site_startup(self)

This is being imported and called from lino.core.site.Site.startup().

Classes

Kernel(site)

This is the class of the object stored in Site.kernel.

class lino.core.kernel.Kernel(site)

Bases: object

This is the class of the object stored in Site.kernel.

memo_parser

Obsolete. Was moved to lino.modlib.memo.

kernel_startup(site)

This is a part of a Lino site startup. The Django Model definitions are done, now Lino analyzes them and does certain actions:

protect_foreignkeys(models_list)

Change on_delete from CASCADE (Django's default value) to PROTECT for foreignkeys that need to be protected.

Basically we protect all FK fields that are not listed in their model's allow_cascaded_delete. With one exception: pointers to the MTI parent of a Polymorphic must not become protected (because Lino handles it automatically, see lino.mixins.polymorphic.Polymorphic.disable_delete()).

Yield a series of (gfk, fk_field, queryset) tuples which together will return all database objects for which the given GenericForeignKey gfk points to the object obj. See also GenericForeignKey fields.

Yield all database objects of this model which have some broken GFK field.

This is a slow query which does an additional database request for each row. (Is there a possibility to do this in a single SQL query?)

Each yielded object has two special attributes:

  • _message : a textual description of the problem

  • _todo : 'delete', 'clear' or 'manual'

Note: the "clear" action should not run automatically, at least not for lino.modlib.changes.

run_action(ar)

Run the action, catching some exceptions in order to report them in a user-friendly way.

setup_handle(h, ar)

Additional setup of an actor handle. This is called lazily for every actor handle because it potentially requires other actor handles to be instantiated.

ar is usually None, except for actors with dynamic handle

row_action_button(*args, **kw)

See ExtRenderer.row_action_button()

make_cache_file(fn, write, force=False)

Make the specified cache file. This is used internally at server startup.

lino.core.kernel.site_startup(self)

This is being imported and called from lino.core.site.Site.startup(). It is implemented here in order to avoid local imports.

lino.core.kernel.choicelist_choices()

Return a list of all choicelists defined for this application.

lino.core.kernel.register_actors()

This is being called at startup.

  • Each model can receive a number of "slaves". Slaves are tables whose data depends on an instance of another model (their master).

  • For each model we want to find out the "default table". The "choices table" for a foreignkey field is also currently simply the pointed model's default table. _lino_default_table