information.py

#!/usr/bin/env python3
#
# Copyright (c) 2024 Gareth Palmer <gareth.palmer3@gmail.com>
# This program is free software, distributed under the terms of
# the GNU General Public License Version 2.

import re
from html import escape

from lxml import etree
from flask import Blueprint, Response, request


blueprint = Blueprint('information', __name__)


@blueprint.route('/information')
def help_information():
    id = request.args.get('id', '')

    if not re.search(r'(?x) ^ [0-9]+ $', id):
        return Response('Invalid id', mimetype = 'text/plain'), 500

    document = etree.parse('./phone_help.xml')

    if not document:
        return Response('XML error', mimetype = 'text/plain'), 500

    element = document.find(f'HelpItem[ID="{id}"]')

    if element:
        title = element.find('Title').text
        text = element.find('Text').text
    else:
        title = 'Information'
        text = 'Sorry, no help on that topic.'

    xml = '<?xml version="1.0" encoding="UTF-8"?>' \
        '<CiscoIPPhoneText>' \
          '<Title>' + escape(title) + '</Title>' \
          '<Text>' + escape(text) + '</Text>' \
          '<Prompt>Your current options</Prompt>' \
          '<SoftKeyItem>' \
            '<Name>Exit</Name>' \
            '<Position>3</Position>' \
            '<URL>Key:Info</URL>' \
          '</SoftKeyItem>' \
        '</CiscoIPPhoneText>'

    return Response(xml, mimetype = 'text/xml'), 200


@blueprint.errorhandler(Exception)
def error_handler(error):
    return Response(str(error), mimetype = 'text/plain'), 500