org.views.people
================

.. py:module:: org.views.people


Functions
---------

.. autoapisummary::

   org.views.people.organisations_as_dict
   org.views.people.get_top_level_organisations
   org.views.people.get_sub_organisations
   org.views.people.view_people
   org.views.people.view_person
   org.views.people.person_functions_by_organization
   org.views.people.handle_new_person
   org.views.people.handle_edit_person
   org.views.people.handle_delete_person
   org.views.people.vcard_export_person


Module Contents
---------------

.. py:function:: organisations_as_dict(person: onegov.people.Person) -> dict[str, list[str]]

.. py:function:: get_top_level_organisations(data: list[dict[str, list[str]] | str]) -> list[str]

.. py:function:: get_sub_organisations(data: list[dict[str, list[str]] | str]) -> list[str]

.. py:function:: view_people(self: onegov.people.PersonCollection, request: onegov.org.request.OrgRequest, layout: onegov.org.layout.PersonCollectionLayout | None = None) -> onegov.core.types.RenderData

.. py:function:: view_person(self: onegov.people.Person, request: onegov.org.request.OrgRequest, layout: onegov.org.layout.PersonLayout | None = None) -> onegov.core.types.RenderData

.. py:function:: person_functions_by_organization(subject_person: onegov.people.Person, topics: collections.abc.Iterable[onegov.org.models.Topic], request: onegov.org.request.OrgRequest) -> collections.abc.Iterable[markupsafe.Markup]

   Collects 1:1 mappings of all context-specific functions and
    organizations for a person. Organizations are pages where `subject_person`
    is listed as a person.

    Returns an Iterable of Markup in the form:

       - Organization 1: Function A
       - Organization 2: Function B
       - ...

   This is not necessarily the same as person.function!


.. py:function:: handle_new_person(self: onegov.people.PersonCollection, request: onegov.org.request.OrgRequest, form: onegov.org.forms.PersonForm, layout: onegov.org.layout.PersonCollectionLayout | None = None) -> onegov.core.types.RenderData | webob.Response

.. py:function:: handle_edit_person(self: onegov.people.Person, request: onegov.org.request.OrgRequest, form: onegov.org.forms.PersonForm, layout: onegov.org.layout.PersonLayout | None = None) -> onegov.core.types.RenderData | webob.Response

.. py:function:: handle_delete_person(self: onegov.people.Person, request: onegov.org.request.OrgRequest) -> None

.. py:function:: vcard_export_person(self: onegov.people.Person, request: onegov.org.request.OrgRequest) -> morepath.request.Response

   Returns the persons vCard.