15.2.134. camcops_server.cc_modules.cc_string


Copyright (C) 2012-2020 Rudolf Cardinal (rudolf@pobox.com).

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/>.

Manage the “extra strings” that the server reads from XML files. The server uses these for displaying tasks, and provides them to client devices.

class camcops_server.cc_modules.cc_string.AS[source]

List of appstrings present in camcops.xml.

Should match appstrings.cpp in the client, and of course camcops.xml itself.

camcops_server.cc_modules.cc_string.all_extra_strings_as_dicts(config_filename: str) → Dict[str, Dict[str, Dict[str, str]]][source]

Returns strings from the all the extra XML string files.

The result is cached (via a proper cache).


config_filename – a CamCOPS config filename

Returns: a dictionary like

    'task1': {
        'stringname1': {
            "en-GB": "a string in British English",
            "da-DK": "a string in Danish",
        'stringname1': {
    'task2: {

… in other words a Dict[taskname: str, Dict[stringname: str, Dict[locale: str, stringvalue: str]]].

For example, result['phq9']['q5'][locale] == "5. Poor appetite or overeating". There is also a top-level dictionary with the key APPSTRING_TASKNAME.

XML format

The extra string files should look like this:

<?xml version="1.0" encoding="UTF-8"?>
    <task name="TASK_1" locale="en_GB">
        <string name="NAME_1">VALUE</string>
        <string name="NAME_2">VALUE WITH\nNEWLINE</string>
        <!-- ... -->
    <!-- ... -->

If the language attribute is not specified, a language tag of "" is used internally and will be the fallback position if nothing else is found.

camcops_server.cc_modules.cc_string.text_contents(e: xml.etree.ElementTree.Element, plain: bool = False, strip: bool = True) → str[source]

Extract the exact text contents of an XML element, including any XML/HTML tags within it.

A normal string looks like

<string name="stringname">words words words</string>

and we extract its contents (“words words words”) with


However, for this:

<string name="stringname">words <b>bold words</b> words</string>

we want to extract words <b>bold words</b> words and that’s a little trickier. This function does that.

  • e – the Element to read

  • plain – remove all HTML/XML tags?

  • strip – strip leading/trailing whitespace?


the text contents of the element