lino.core.plugin¶

This defines the Plugin class.

See Introduction to plugins.

Classes

Plugin(site, app_label, app_name, ...)

The base class for all plugin descriptors.

class lino.core.plugin.Plugin(site, app_label, app_name, app_module, needed_by, configs: dict)¶

Bases: object

The base class for all plugin descriptors.

needs_plugins = []¶

A list of names of plugins needed by this plugin.

The default implementation of get_required_plugins() returns this list.

extends_models = None¶

If specified, a list of model names for which this app provides a subclass.

For backwards compatibility this has no effect when override_modlib_models is set.

ui_handle_attr_name = None¶: Currently implemented by lino.modlib.extjs, lino.modlib.bootstrap3.

menu_group = None¶

The name of another plugin to be used as menu group.

See get_menu_group(), How plugins build the application menu.

media_base_url = None¶: Remote URL base for media files.

media_name = None¶

Either None (default) or a non-empty string with the name of the subdirectory of your media directory which is expected to contain media files for this app.

None means that there this app has no media files of her own.

Best practice is to set this to the app_label. Will be ignored if media_base_url is nonempty.

url_prefix = None¶: The url prefix under which this plugin should ask to install its url patterns.

site_js_snippets = []¶: List of js snippets to be injected into the lino_*.js file.

support_async = False¶: Whether this plugin uses lino.core.utils.DelayedValue.

renderer = None¶: The renderer used by this plugin. See Introduction to Front end Renderers.

hidden = False¶: Whether this plugin is hidden.

needed_by = None¶: If not None, then it is the Plugin instance that caused this plugin to automatically install. As the application developer you do not set this yourself

verbose_name = None¶: The verbose name of this plugin, as shown to the user. This can be a lazily translated string.

short_name = None¶: The abbreviated name of this plugin, shown to the user in places where shortness is important, e.g. as the label of the tabs of a detail layout. This can be a lazily translated string. Defaults to verbose_name.

configure(**kw)¶

Set the given parameter(s) of this Plugin instance. Any number of parameters can be specified as keyword arguments.

Raise an exception if caller specified a key that does not have a corresponding attribute.

get_required_plugins()¶

Return a list of names of plugins needed by this plugin.

The default implementation returns needs_plugins.

Lino will automatically install these plugins if necessary.

Note that Lino will add them before your plugin.

Note that only the app_label (not the full plugin name) is used when testing whether a plugin is installed. In other words, if a plugin says it requires a plugin "stdlib.foo" and an application already has some plugin "mylib.foo" installed, then "mylib.foo" satisfies "stdlib.foo".

get_used_libs(html=None)¶: Yield a series of tuples (verbose_name, version, url) that describe the libraries used by this Lino site.

on_init()¶: This will be called when the Plugin is being instantiated (i.e. even before the Site instantiation has finished. Used by lino.modlib.users to set user_model.

on_plugins_loaded(site)¶

Called exactly once on each installed plugin, when the Site has loaded all plugins, but before calling setup_plugins(). All this happens before settings are ready and long before the models modules start to load.

This is used for initializing default values of plugin attributes that (a) depend on other plugins but (b) should be overridable in lino.core.site.Site.setup_plugins().

For example groups uses this to set a default value to the commentable_model for comments plugin.

Or lino.modlib.checkdata uses it to set responsible_user to "robin" when it is a demo site.

on_site_startup(site)¶: This is called exactly once when models are ready.

before_actors_discover()¶: This is called exactly once during site startup, when models are ready. Used by lino.modlib.help

post_site_startup(site)¶: This will be called exactly once, when models are ready.

classmethod extends_from()¶: Return the plugin from which this plugin inherits.

classmethod get_subdir(name)¶: Get the absolute path of the named subdirectory if it exists.

before_analyze()¶: This is called during startup, when all models modules have been imported, and before Lino starts to analyze them.

on_ui_init(kernel)¶: This is called when the kernel is being instantiated.

get_patterns()¶: Override this to return a list of url patterns to be added to the Site's patterns.

get_requirements(site) → Iterable[str]¶

Return a list of optionally required Python packages to be installed during install.