API

This section has been automatically generated from the source code.

The lino package

See The lino package for non-technical documentation.

The lino package itself is the first plugin for all Lino applications, added automatically to your INSTALLED_APPS. It defines no models, but some template files, django admin commands, translation messages and the core help_texts.py file.

The lino package is the root for the subpackages that define core functionalites:

core

Contains Lino's core functionalities.

hello

If you want to see which version of Lino you have, you can say "hello" to Lino:

api

A series of wrapper modules to encapsulate Lino's core functionalities.

utils

lino.utils (the top-level module) contains a few often-used function for general use.

mixins

This package contains model mixins, some of which are heavily used by applications and the Lino Extensions Library.

projects

Most of this package has been moved to lino_book.

modlib

The standard model library included with Lino.

sphinxcontrib

Some extensions for Sphinx.

management.commands

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

lino.startup(settings_module=None)

Start up Django and Lino.

Optional settings_module is the name of a Django settings module. If this is specified, set the DJANGO_SETTINGS_MODULE environment variable.

This is called automatically when a process is invoked by an admin command.

In a document to be tested using doctest you need to call it manually using e.g.:

>>> import lino
>>> lino.startup('my.project.settings')

Above two lines are recommended over the old-style method (the only one only until Django 1.6):

>>> import os
>>> os.environ['DJANGO_SETTINGS_MODULE'] = 'my.project.settings'
class lino.AppConfig(app_name, app_module)

Bases: django.apps.config.AppConfig

This is the only django.apps.AppConfig object used by Lino.

Lino applications use the lino.core.plugins.Plugin because it has some additional functionality.

The lino-xl package

This package contains the code of the Lino Extensions Library.

See Plugins of the Extensions library for the list of plugins.

lib

These are the plugins included with Lino XL.

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

The lino-book package

https://readthedocs.org/projects/lino/badge/?version=latest https://coveralls.io/repos/github/lino-framework/book/badge.svg?branch=master https://travis-ci.org/lino-framework/book.svg?branch=stable https://img.shields.io/pypi/v/lino.svg https://img.shields.io/pypi/l/lino.svg

This is the code repository that contains (1) the Sphinx source files of the Lino Book, (2) the lino_book Python package and (3) a test suite with doctest-based tests for the Lino framework.

The Lino Book is the central documentation tree of the Lino framework. It is visible on www.lino-framework.org and on lino.readthedocs.io.

The lino_book Python package is a collection of small example Lino applications used for educational and testing purposes.

The code repositories for the lino and lino_xl Python packages have no documentation tree on their own and almost no unit tests, they are tested and documented here.

Your feedback is welcome. Our community page explains how to contact us.

The lino_book package contains a set of example projects used both for testing and explaining Lino framework.

It is not published on PyPI because that would make no sense. You use it by cloning the repository from GitHub (which is done automatically by getlino).

projects

This package contains example applications included with the Lino book.

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

Maintained Lino applications

The following Lino applications are maintained by the Lino team and form an integral part of the project. Besides being independant applications, they also serve for testing purposes.

Lino Noi

Documentation Status https://coveralls.io/repos/github/lino-framework/noi/badge.svg?branch=master https://travis-ci.org/lino-framework/noi.svg?branch=stable https://img.shields.io/pypi/v/lino-noi.svg https://img.shields.io/pypi/l/lino-noi.svg

Lino Noi is a customizable ticket management and time tracking system to use when time is more than money.

This is the main module of Lino Noi.

lib

Extended and specific plugins for Lino Noi.

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

Lino Così

Lino Così is a Lino application for accounting (more).

lib

Plugins

migrate

This is a real-world example of how the application developer can provide automatic data migrations for Python dumps.

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

Lino Avanti

Lino Avanti is a free Lino application used by social workers in East Belgium for helping immigrants with their integration course.

The integration course is a Belgian administrative procedure consisting in an individual mentoring and a series of courses with the goal of helping new residents to acquire the base knowledge about society and social relations in Belgium in order to ease their integration on the territory. Read more about the procedure in Parcours d’intégration des primo-arrivants (French) or Integrationsparcours: Der Einstiegsweg für Migranten (German).

Lino Avanti is being developed by order of Ministerium der Deutschsprachigen Gemeinschaft (Ministery of the German-speaking Community of Belgium).

This is the main module of Lino Avanti.

lib

Plugins for Lino Avanti.

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

Lino Vilma

Documentation Status https://coveralls.io/repos/github/lino-framework/noi/badge.svg?branch=master https://travis-ci.org/lino-framework/noi.svg?branch=stable https://img.shields.io/pypi/v/lino-noi.svg https://img.shields.io/pypi/l/lino-noi.svg

Lino Vilma is a customizable contact management system for villages.

This is the main module of Lino Vilma.

lib

Extended and specific plugins for Lino Noi.

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

Lino Care

Documentation Status https://coveralls.io/repos/github/lino-framework/care/badge.svg?branch=master https://travis-ci.org/lino-framework/care.svg?branch=stable https://img.shields.io/pypi/v/lino-care.svg https://img.shields.io/pypi/l/lino-care.svg

Lino Care is for managing a catalog of people who care.

This is the main module of Lino Care.

lib

Extended and specific plugins for Lino Care.

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

Lino Tera

Documentation Status https://coveralls.io/repos/github/lino-framework/tera/badge.svg?branch=master https://travis-ci.org/lino-framework/tera.svg?branch=stable https://img.shields.io/pypi/v/lino-tera.svg https://img.shields.io/pypi/l/lino-tera.svg

Lino Tera is a customizable management system for therapeutic centres.

This is the main module of Lino Tera.

lib

Plugins specific to Lino Psico.

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

Lino Voga

Lino Voga is a Lino application for managing courses, participants and meeting rooms.

The main module of Lino Voga.

lib

This package contains apps which are specific to Lino Voga.

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