lino_xl.lib.reception.models¶

The models.py file for lino_xl.lib.reception.

This injects three fields to cal.Guest and defines three new states in cal.GuestStates.

state —action–> new state

present —checkin–> waiting waiting —receive–> busy busy —checkout–> gone

What	waiting_since	busy_since	gone_since
Visitor checks in	X
Agent receives the visitor	X	X
Visitor leaves	X	X	X

Functions

`beware`(sender[, instance])
`checkout_guest`(obj, ar)	Check a guest out.
`create_prompt_event`(project, partner, user, ...)	Create a "prompt event".

Classes

`AppointmentsByPartner`(args, *kw)	Show the participations in upcoming calendar events for a given partner.
`BusyVisitors`(args, *kw)	Show busy visitors (with any user).
`CheckinVisitor`([label])	Mark this visitor as arrived.
`CheckoutVisitor`([label])	The "Checkout" action on a `Guest`.
`ExpectedGuests`(args, *kw)	General table of all expected guests.
`GoneVisitors`(args, *kw)	Show gone visitors (for any user).
`MyBusyVisitors`(args, *kw)	Show the visitors with whom I am busy.
`MyGoneVisitors`(args, *kw)	Show my visitors who have gone.
`MyVisitorAction`([label])
`MyWaitingVisitors`(args, *kw)	Show visitors waiting for me.
`ReceiveVisitor`([label])	The "Receive" action on a `Guest`.
`Visitors`(args, *kw)	Common base class for the following tables:
`WaitingVisitors`(args, *kw)	Show waiting visitors (for any user).

lino_xl.lib.reception.models.create_prompt_event(project, partner, user, summary, guest_role, now=None, waiting_number='')¶: Create a “prompt event”.

class lino_xl.lib.reception.models.CheckinVisitor(label=None, **kwargs)¶

Bases: NotifyingAction

Mark this visitor as arrived.

To be called on a Guest object.

get_notify_recipients(ar, obj)¶: Yield a list of users to be notified.

class lino_xl.lib.reception.models.ReceiveVisitor(label=None, **kwargs)¶

Bases: MyVisitorAction

The “Receive” action on a Guest.

lino_xl.lib.reception.models.checkout_guest(obj, ar)¶

Check a guest out. This sets the gone_since timestamp to now and the state to gone.

If busy_since is empty, set it to gone_since.

If the related event has no end_time, also set this.

class lino_xl.lib.reception.models.CheckoutVisitor(label=None, **kwargs)¶

Bases: MyVisitorAction

The “Checkout” action on a Guest.

class lino_xl.lib.reception.models.AppointmentsByPartner(*args, **kw)¶

Bases: Table

Show the participations in upcoming calendar events for a given partner.

TODO: rename this to GuestsByPartner or ParticipationsByPartner and add filter parameters.

model¶: alias of Guest

detail_link¶

A single-paragraph of formatted text that describes this database row.

It should begin with a clickable link that opens the detail window.

This is a htmlbox. We don’t recommend to override this field directly.

master¶: alias of Person

class lino_xl.lib.reception.models.ExpectedGuests(*args, **kw)¶

Bases: Guests

General table of all expected guests.

model¶: alias of Guest

class lino_xl.lib.reception.models.Visitors(*args, **kw)¶

Bases: Guests

Common base class for the following tables:

`WaitingVisitors`	`MyWaitingVisitors`
`BusyVisitors`	`MyBusyVisitors`
`GoneVisitors`	`MyGoneVisitors`

No subclass should be editable because deleting would leave the useless cal.Event.

model¶: alias of Guest

class lino_xl.lib.reception.models.BusyVisitors(*args, **kw)¶

Bases: Visitors

Show busy visitors (with any user).

model¶: alias of Guest

class lino_xl.lib.reception.models.WaitingVisitors(*args, **kw)¶

Bases: Visitors

Show waiting visitors (for any user).

model¶: alias of Guest

class lino_xl.lib.reception.models.GoneVisitors(*args, **kw)¶

Bases: Visitors

Show gone visitors (for any user).

model¶: alias of Guest

class lino_xl.lib.reception.models.MyWaitingVisitors(*args, **kw)¶

Bases: My, WaitingVisitors

Show visitors waiting for me.

model¶: alias of Guest

class lino_xl.lib.reception.models.MyBusyVisitors(*args, **kw)¶

Bases: My, BusyVisitors

Show the visitors with whom I am busy.

model¶: alias of Guest

class lino_xl.lib.reception.models.MyGoneVisitors(*args, **kw)¶

Bases: My, GoneVisitors

Show my visitors who have gone.

model¶: alias of Guest