Welcome | Get started | Dive | Contribute | Topics | Reference | Changes | More

comments (comments in Avanti)

The lino.modlib.comments in Lino Avanti is configured and used to satisfy the application requirements.

This page contains code snippets (lines starting with >>>), which are being tested during our development workflow. The following snippet initializes the demo project used throughout this page.

>>> from lino_book.projects.avanti1.startup import *

Overview

Comments in Lino Avanti are considered confidential data and can be seen only by users with appropriate permission.

See also User types in Lino Avanti.

Private comments are seen only by their respective author.

Public comments are shown to other social workers. Comments are never shown to the external supervisor.

A system administrator can see all comments (it makes no sense to hide them because a system admin can easily create or use a user account with the permissions they want).

Comments are private by default:

>>> dd.plugins.users.private_default
True

All partners are Commentable, but in Lino Avanti: we use comments only on Client.

>>> list(rt.models_by_base(comments.Commentable))
[<class 'lino_avanti.lib.avanti.models.Client'>, <class
'lino_xl.lib.contacts.models.Company'>, <class
'lino_xl.lib.contacts.models.Partner'>, <class
'lino_xl.lib.contacts.models.Person'>, <class
'lino_xl.lib.households.models.Household'>, <class
'lino_xl.lib.uploads.models.Upload'>,  <class 'lino.modlib.users.models.User'>]

Tests

The demo database contains 108 comments, and they are all private.

>>> rt.models.comments.Comment.objects.all().count()
108
>>> rt.models.comments.Comment.objects.filter(private=True).count()
108

Robin can see them all.

>>> kwargs = dict(column_names="id user owner", limit=6,
...     display_mode=DISPLAY_MODE_GRID)

>>> rt.login("robin").show(comments.Comments, **kwargs)
...
==== =============== ==================================
 ID   Author          Topic
---- --------------- ----------------------------------
 1    audrey          `BALLO Armáni (80/romain) <…>`__
 2    martina         `BALLO Armáni (80/romain) <…>`__
 3    nathalie        `BALLO Armáni (80/romain) <…>`__
 4    nelly           `BALLO Armáni (80/romain) <…>`__
 5    sandra          `BALLO Armáni (80/romain) <…>`__
 6    Laura Lieblig   `BALLO Armáni (80/romain) <…>`__
==== =============== ==================================

Nathalie sees only her own comments:

>>> rt.login("nathalie").show(comments.Comments, **kwargs)
...
==== ========== ======================================
 ID   Author     Topic
---- ---------- --------------------------------------
 3    nathalie   `BALLO Armáni (80/romain) <…>`__
 12   nathalie   `ALVANG Aleksándr (79/romain) <…>`__
 21   nathalie   `ABDOO Aátif (78/nathalie) <…>`__
 30   nathalie   `CHAHINE Bánji (75/nelly) <…>`__
 39   nathalie   `BELSKAIA Anton (73/rolf) <…>`__
 48   nathalie   `ABDUL Abbáád (72/romain) <…>`__
==== ========== ======================================

>>> rt.login("nathalie").show(comments.RecentComments, **kwargs)
...
===== ========== =======================================
 ID    Author     Topic
----- ---------- ---------------------------------------
 102   nathalie   `KEITA Cácey (62/nathalie) <…>`__
 93    nathalie   `ABID Abdul Báásid (63/romain) <…>`__
 84    nathalie   `KONE Duánte (65/nelly) <…>`__
 75    nathalie   `BERENDT Antoshá (66/robin) <…>`__
 66    nathalie   `ABOUD Ahláám (67/robin) <…>`__
 57    nathalie   `BERNDT Armán (68/nathalie) <…>`__
===== ========== =======================================

>>> rt.login('').show(comments.RecentComments, **kwargs)
...
Traceback (most recent call last):
...
django.core.exceptions.PermissionDenied: Not permitted for anonymous

Summary:

>>> rows = []
>>> views = (comments.Comments, avanti.Clients)
>>> headers = ["User", "type"] + [i.__name__ for i in views]
>>> user_list = [users.User.get_anonymous_user()] + list(users.User.objects.all())
>>> for u in user_list:
...    cells = [str(u.username), u.user_type.name]
...    for dv in views:
...       qs = dv.create_request(user=u).data_iterator
...       cells.append(str(qs.count()))
...    rows.append(cells)
>>> print(rstgen.table(headers, rows))
...
=========== ============= ========== =========
 User        type          Comments   Clients
----------- ------------- ---------- ---------
 anonymous   anonymous     0          58
 audrey      auditor       0          58
 martina     coordinator   0          58
 nathalie    user          12         58
 nelly       user          12         58
 sandra      secretary     0          58
 laura       teacher       0          58
 romain      admin         108        58
 rolf        admin         108        58
 robin       admin         108        58
=========== ============= ========== =========