## -*- coding: utf-8 -*-
<%doc>

camcops_server/templates/snippets/displayfunc.mako

===============================================================================

    Copyright (C) 2012, University of Cambridge, Department of Psychiatry.
    Created by Rudolf Cardinal (rnc1001@cam.ac.uk).

    This file is part of CamCOPS.

    CamCOPS is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    CamCOPS is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with CamCOPS. If not, see <https://www.gnu.org/licenses/>.

===============================================================================

</%doc>

<%def name="one_per_line(iterable, escape=True)">
    ## Don't escape the output of this function (i.e. prevent escaping using
    ## "| n"), because it returns HTML <br> tags. However, you should ask it to
    ## escape the inputs, using escape=True, unless you have already done that
    ## or want to pass raw HTML in.
    %for idx, x in enumerate(iterable):
        %if idx > 0:
            <br>
        %endif
        %if escape:
            ${ x }
        %else:
            ${ x | n, str }
        %endif
    %endfor
</%def>
