view sat/tools/common/ @ 3054:92f8baec5e4f

doc (jp): typos (thanks tbart)
author Goffi <>
date Fri, 11 Oct 2019 16:15:09 +0200
parents ab2696e34d29
children 9d0df638c8b4
line wrap: on
line source

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# SAT: a jabber client
# Copyright (C) 2009-2019 Jérôme Poisson (

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

# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU Affero General Public License for more details.

# You should have received a copy of the GNU Affero General Public License
# along with this program.  If not, see <>.

""" template XMLUI parsing

XMLUI classes from this modules can then be iterated to create the template

from sat.core.log import getLogger

log = getLogger(__name__)
from import xmlui
from functools import partial
    from jinja2 import Markup as safe
except ImportError:
    # Safe marks XHTML values as usable as it.
    # If jinja2 is not there, we can use a simple lamba
    safe = lambda x: x

## Widgets ##

class Widget(object):
    category = "widget"
    type = None
    enabled = True
    read_only = True

    def __init__(self, xmlui_parent):
        self.xmlui_parent = xmlui_parent

    def name(self):
        return self._xmlui_name

class ValueWidget(Widget):
    def __init__(self, xmlui_parent, value):
        super(ValueWidget, self).__init__(xmlui_parent)
        self.value = value

    def values(self):
        return [self.value]

    def labels(self):
        #  helper property, there is not label for ValueWidget
        # but using labels make rendering more easy (one single method to call)
        #  values are actually returned
        return [self.value]

class InputWidget(ValueWidget):
    def __init__(self, xmlui_parent, value, read_only=False):
        super(InputWidget, self).__init__(xmlui_parent, value)
        self.read_only = read_only

class OptionsWidget(Widget):
    def __init__(self, xmlui_parent, options, selected, style):
        super(OptionsWidget, self).__init__(xmlui_parent)
        self.options = options
        self.selected = selected = style

    def values(self):
        for value, label in self.items:
            yield value

    def labels(self):
        """return only labels from self.items"""
        for value, label in self.items:
            yield label

    def items(self):
        """return suitable items, according to style"""
        no_select = self.no_select
        for value, label in self.options:
            if no_select or value in self.selected:
                yield value, label

    def inline(self):
        return "inline" in

    def no_select(self):
        return "noselect" in

class EmptyWidget(xmlui.EmptyWidget, Widget):
    def __init__(self, _xmlui_parent):

class TextWidget(xmlui.TextWidget, ValueWidget):
    type = "text"

class LabelWidget(xmlui.LabelWidget, ValueWidget):
    type = "label"

    def for_name(self):
            return self._xmlui_for_name
        except AttributeError:
            return None

class StringWidget(xmlui.StringWidget, InputWidget):
    type = "string"

class JidInputWidget(xmlui.JidInputWidget, StringWidget):
    type = "jid"

class TextBoxWidget(xmlui.TextWidget, InputWidget):
    type = "textbox"

class XHTMLBoxWidget(xmlui.XHTMLBoxWidget, InputWidget):
    type = "xhtmlbox"

    def __init__(self, xmlui_parent, value, read_only=False):
        # XXX: XHTMLBoxWidget value must be cleaned (harmful XHTML must be removed)
        #      This is normally done in the backend, the frontends should not need to
        #      worry about it.
        super(XHTMLBoxWidget, self).__init__(
            xmlui_parent=xmlui_parent, value=safe(value), read_only=read_only)

class ListWidget(xmlui.ListWidget, OptionsWidget):
    type = "list"

## Containers ##

class Container(object):
    category = "container"
    type = None

    def __init__(self, xmlui_parent):
        self.xmlui_parent = xmlui_parent
        self.children = []

    def __iter__(self):
        return iter(self.children)

    def _xmluiAppend(self, widget):

    def _xmluiRemove(self, widget):

class VerticalContainer(xmlui.VerticalContainer, Container):
    type = "vertical"

class PairsContainer(xmlui.PairsContainer, Container):
    type = "pairs"

class LabelContainer(xmlui.PairsContainer, Container):
    type = "label"

## Factory ##

class WidgetFactory(object):

    def __getattr__(self, attr):
        if attr.startswith("create"):
            cls = globals()[attr[6:]]
            return cls

## Core ##

class XMLUIPanel(xmlui.XMLUIPanel):
    widget_factory = WidgetFactory()

    def show(self, *args, **kwargs):
        raise NotImplementedError

class XMLUIDialog(xmlui.XMLUIDialog):
    dialog_factory = WidgetFactory()

    def __init__(*args, **kwargs):
        raise NotImplementedError

create = partial(xmlui.create, class_map={
    xmlui.CLASS_PANEL: XMLUIPanel,
    xmlui.CLASS_DIALOG: XMLUIDialog})