agency.utils
============

.. py:module:: agency.utils


Attributes
----------

.. autoapisummary::

   agency.utils._T


Functions
---------

.. autoapisummary::

   agency.utils.handle_empty_p_tags
   agency.utils.emails_for_new_ticket
   agency.utils.ticket_groups
   agency.utils.get_html_paragraph_with_line_breaks
   agency.utils.filter_modified_or_created


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

.. py:data:: _T

.. py:function:: handle_empty_p_tags(html: markupsafe.Markup) -> markupsafe.Markup

.. py:function:: emails_for_new_ticket(model: onegov.people.models.Agency | onegov.people.models.Person, request: onegov.agency.request.AgencyRequest) -> collections.abc.Iterator[email.headerregistry.Address]

   Returns an iterator with all the unique email addresses
   that need to be notified for a new ticket of this type


.. py:function:: ticket_groups(agency: onegov.people.models.Agency, groupids: list[str] | None) -> list[onegov.user.UserGroup]

.. py:function:: get_html_paragraph_with_line_breaks(text: str | None) -> markupsafe.Markup

.. py:function:: filter_modified_or_created(query: sqlalchemy.orm.Query[_T], relate: Literal['>', '<', '>=', '<=', '=='], comparison_property: datetime.datetime | str, collection_class: type[onegov.core.orm.mixins.TimestampMixin]) -> sqlalchemy.orm.Query[_T]