diff sat/tools/xml_tools.py @ 2625:a55a14c3cbf4

plugin XEP-0070: use a confirm dialog instead of a form + simplified a bit the code
author Goffi <goffi@goffi.org>
date Wed, 27 Jun 2018 21:15:34 +0200
parents 56f94936df1e
children c274201cea94
line wrap: on
line diff
--- a/sat/tools/xml_tools.py	Wed Jun 27 20:14:46 2018 +0200
+++ b/sat/tools/xml_tools.py	Wed Jun 27 21:15:34 2018 +0200
@@ -51,7 +51,8 @@
     """Get data needed to create an XMLUI's Widget from Wokkel's data_form's Field.
 
     The attribute field can be modified (if it's fixed and it has no value).
-    @param field (data_form.Field): a field with attributes "value", "fieldType", "label" and "var"
+    @param field (data_form.Field): a field with attributes "value", "fieldType",
+                                    "label" and "var"
     @param read_only (bool): if True and it makes sense, create a read only input widget
     @return: a tuple (widget_type, widget_args, widget_kwargs)
     """
@@ -749,7 +750,8 @@
         @param selectable: one of:
             'no': nothing is done
             'single': one row can be selected
-        @param auto_index: if True, indexes will be generated by frontends, starting from 0
+        @param auto_index: if True, indexes will be generated by frontends,
+                           starting from 0
         @return: created element
         """
         assert selectable in ("no", "single")
@@ -1049,7 +1051,8 @@
         @param xmlui
         @param options (list[option]): each option can be given as:
             - a single string if the label and the value are the same
-            - a tuple with a couple of string (value,label) if the label and the value differ
+            - a tuple with a couple of string (value,label) if the label and the
+              value differ
         @param selected (list[string]): list of the selected values
         @param styles (iterable[string]): flags to set the behaviour of the list
             can be:
@@ -1058,7 +1061,8 @@
                     useful when only the list itself is needed
                 - extensible: can be extended by user (i.e. new options can be added)
                 - reducible: can be reduced by user (i.e. options can be removed)
-                - inline: hint that this list should be displayed on a single line (e.g. list of labels)
+                - inline: hint that this list should be displayed on a single line
+                          (e.g. list of labels)
         @param name (string)
         @param parent
         """
@@ -1070,7 +1074,8 @@
         if u"noselect" in styles and (u"multi" in styles or selected):
             raise exceptions.DataError(
                 _(
-                    u'"multi" flag and "selected" option are not compatible with "noselect" flag'
+                    u'"multi" flag and "selected" option are not compatible with '
+                    u'"noselect" flag'
                 )
             )
         if not options:
@@ -1210,21 +1215,15 @@
 class XMLUI(object):
     """This class is used to create a user interface (form/window/parameters/etc) using SàT XML"""
 
-    def __init__(
-        self,
-        panel_type="window",
-        container="vertical",
-        dialog_opt=None,
-        title=None,
-        submit_id=None,
-        session_id=None,
-    ):
+    def __init__(self, panel_type="window", container="vertical", dialog_opt=None,
+        title=None, submit_id=None, session_id=None):
         """Init SàT XML Panel
 
         @param panel_type: one of
             - C.XMLUI_WINDOW (new window)
             - C.XMLUI_POPUP
-            - C.XMLUI_FORM (form, depend of the frontend, usually a panel with cancel/submit buttons)
+            - C.XMLUI_FORM (form, depend of the frontend, usually a panel with
+              cancel/submit buttons)
             - C.XMLUI_PARAM (parameters, presentation depend of the frontend)
             - C.XMLUI_DIALOG (one common dialog, presentation depend of frontend)
         @param container: disposition of elements, one of:
@@ -1233,18 +1232,26 @@
             - pairs: elements come on two aligned columns
               (usually one for a label, the next for the element)
             - label: associations of one LabelWidget or EmptyWidget with an other widget
-                similar to pairs but specialized in LabelWidget, and not necessarily arranged in 2 columns
+                similar to pairs but specialized in LabelWidget,
+                and not necessarily arranged in 2 columns
             - tabs: elemens are in categories with tabs (notebook)
-        @param dialog_opt: only used if panel_type == C.XMLUI_DIALOG. Dictionnary (string/string) where key can be:
+        @param dialog_opt: only used if panel_type == C.XMLUI_DIALOG.
+            Dictionnary (string/string) where key can be:
             - C.XMLUI_DATA_TYPE: type of dialog, value can be:
-                - C.XMLUI_DIALOG_MESSAGE (default): an information/error message. Action of user is necessary to close the dialog. Usually the frontend display a classic popup
-                - C.XMLUI_DIALOG_NOTE: like a C.XMLUI_DIALOG_MESSAGE, but action of user is not necessary to close, at frontend choice (it can be closed after a timeout). Usually the frontend display as a timed out notification
+                - C.XMLUI_DIALOG_MESSAGE (default): an information/error message.
+                  Action of user is necessary to close the dialog.
+                  Usually the frontend display a classic popup.
+                - C.XMLUI_DIALOG_NOTE: like a C.XMLUI_DIALOG_MESSAGE, but action of user
+                  is not necessary to close, at frontend choice (it can be closed after
+                  a timeout). Usually the frontend display as a timed out notification
                 - C.XMLUI_DIALOG_CONFIRM: dialog with 2 choices (usualy "Ok"/"Cancel").
                     returned data can contain:
-                        - "answer": "true" if answer is "ok", "yes" or equivalent, "false" else
+                        - "answer": "true" if answer is "ok", "yes" or equivalent,
+                                    "false" else
                 - C.XLMUI_DIALOG_FILE: a file selection dialog
                     returned data can contain:
-                        - "cancelled": "true" if dialog has been cancelled, not present or "false" else
+                        - "cancelled": "true" if dialog has been cancelled, not present
+                                       or "false" else
                         - "path": path of the choosed file/dir
             - C.XMLUI_DATA_MESS: message shown in dialog
             - C.XMLUI_DATA_LVL: one of:
@@ -1252,16 +1259,20 @@
                 - C.XMLUI_DATA_LVL_WARNING: attention of user is important
                 - C.XMLUI_DATA_LVL_ERROR: something went wrong
             - C.XMLUI_DATA_BTNS_SET: one of:
-                - C.XMLUI_DATA_BTNS_SET_OKCANCEL (default): classical "OK" and "Cancel" set
-                - C.XMLUI_DATA_BTNS_SET_YESNO: a translated "yes" for OK, and "no" for Cancel
+                - C.XMLUI_DATA_BTNS_SET_OKCANCEL (default): classical "OK" and "Cancel"
+                  set
+                - C.XMLUI_DATA_BTNS_SET_YESNO: a translated "yes" for OK, and "no" for
+                  Cancel
             - C.XMLUI_DATA_FILETYPE: only used for file dialogs, one of:
                 - C.XMLUI_DATA_FILETYPE_FILE: a file path is requested
                 - C.XMLUI_DATA_FILETYPE_DIR: a dir path is requested
                 - C.XMLUI_DATA_FILETYPE_DEFAULT: same as C.XMLUI_DATA_FILETYPE_FILE
 
         @param title: title or default if None
-        @param submit_id: callback id to call for panel_type we can submit (form, param, dialog)
-        @param session_id: use to keep a session attached to the dialog, must be returned by frontends
+        @param submit_id: callback id to call for panel_type we can submit (form, param,
+                          dialog)
+        @param session_id: use to keep a session attached to the dialog, must be
+                           returned by frontends
         @attribute named_widgets(dict): map from name to widget
         """
         self._introspect()  # FIXME: why doing that on each XMLUI ? should be done once
@@ -1505,14 +1516,8 @@
     return xmlui_d
 
 
-def deferXMLUI(
-    host,
-    xmlui,
-    action_extra=None,
-    security_limit=C.NO_SECURITY_LIMIT,
-    chained=False,
-    profile=C.PROF_KEY_NONE,
-):
+def deferXMLUI(host, xmlui, action_extra=None, security_limit=C.NO_SECURITY_LIMIT,
+    chained=False, profile=C.PROF_KEY_NONE):
     """Create a deferred linked to XMLUI
 
     @param xmlui(XMLUI): instance of the XMLUI
@@ -1538,23 +1543,16 @@
     return xmlui_d
 
 
-def deferDialog(
-    host,
-    message,
-    title=u"Please confirm",
-    type_=C.XMLUI_DIALOG_CONFIRM,
-    options=None,
-    action_extra=None,
-    security_limit=C.NO_SECURITY_LIMIT,
-    chained=False,
-    profile=C.PROF_KEY_NONE,
-):
+def deferDialog(host, message, title=u"Please confirm", type_=C.XMLUI_DIALOG_CONFIRM,
+    options=None, action_extra=None, security_limit=C.NO_SECURITY_LIMIT, chained=False,
+    profile=C.PROF_KEY_NONE):
     """Create a submitable dialog and manage it with a deferred
 
     @param message(unicode): message to display
     @param title(unicode): title of the dialog
     @param type(unicode): dialog type (C.XMLUI_DIALOG_*)
-    @param options(None, dict): if not None, will be used to update (extend) dialog_opt arguments of XMLUI
+    @param options(None, dict): if not None, will be used to update (extend) dialog_opt
+                                arguments of XMLUI
     @param action_extra(None, dict): extra action to merge with xmlui
         mainly used to add meta informations (see actionNew doc)
     @param security_limit: %(doc_security_limit)s
@@ -1601,8 +1599,10 @@
     def __call__(self, raw_xml, force_spaces=False, namespace=None):
         """
         @param raw_xml(unicode): the raw XML
-        @param force_spaces (bool): if True, replace occurrences of '\n' and '\t' with ' '.
-        @param namespace(unicode, None): if set, use this namespace for the wrapping element
+        @param force_spaces (bool): if True, replace occurrences of '\n' and '\t'
+                                    with ' '.
+        @param namespace(unicode, None): if set, use this namespace for the wrapping
+                                         element
         """
         # we need to wrap element in case
         # there is not a unique one on the top