Changeset 9031

Show
Ignore:
Timestamp:
11/21/07 14:02:06 (13 months ago)
Author:
asterix
Message:

coding standards

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • trunk/src/dataforms_widget.py

    r8959 r9031  
    2020## along with Gajim.  If not, see <http://www.gnu.org/licenses/>. 
    2121## 
    22 """ This module contains widget that can display data form (JEP-0004). 
     22''' This module contains widget that can display data form (JEP-0004). 
    2323Words single and multiple refers here to types of data forms: 
    2424single means these with one record of data (without <reported/> element), 
    25 multiple - these which may contain more data (with <reported/> element).""" 
     25multiple - these which may contain more data (with <reported/> element).''' 
    2626 
    2727import gtk 
     
    3838class DataFormWidget(gtk.Alignment, object): 
    3939# "public" interface 
    40         """ Data Form widget. Use like any other widget. """ 
     40        ''' Data Form widget. Use like any other widget. ''' 
    4141        def __init__(self, dataformnode=None): 
    42                 """ Create a widget. """ 
     42                ''' Create a widget. ''' 
    4343                gtk.Alignment.__init__(self, xscale=1.0, yscale=1.0) 
    4444 
    4545                self._data_form = None 
    4646 
    47                 self.xml=gtkgui_helpers.get_glade('data_form_window.glade', 'data_form_vbox') 
     47                self.xml = gtkgui_helpers.get_glade('data_form_window.glade', 
     48                        'data_form_vbox') 
    4849                self.xml.signal_autoconnect(self) 
    4950                for name in ('instructions_label', 'instructions_hseparator', 
     
    6465 
    6566        def set_data_form(self, dataform): 
    66                 """ Set the data form (xmpp.DataForm) displayed in widget. """ 
     67                ''' Set the data form (xmpp.DataForm) displayed in widget. ''' 
    6768                assert isinstance(dataform, dataforms.DataForm) 
    6869 
     
    7576 
    7677                # create appropriate description for instructions field if there isn't any 
    77                 if dataform.instructions=='': 
     78                if dataform.instructions == '': 
    7879                        self.instructions_label.set_no_show_all(True) 
    7980                        self.instructions_label.hide() 
     
    8283 
    8384        def get_data_form(self): 
    84                 """ Data form displayed in the widget or None if no form. """ 
     85                ''' Data form displayed in the widget or None if no form. ''' 
    8586                return self._data_form 
    8687 
     
    9091 
    9192        data_form = property(get_data_form, set_data_form, del_data_form, 
    92                 "Data form presented in a widget") 
     93                'Data form presented in a widget') 
    9394 
    9495        def get_title(self): 
    95                 """ Get the title of data form, as a unicode object. If no 
    96                 title or no form, returns u''. Useful for setting window title. """ 
     96                ''' Get the title of data form, as a unicode object. If no 
     97                title or no form, returns u''. Useful for setting window title. ''' 
    9798                if self._data_form is not None: 
    9899                        if self._data_form.title is not None: 
     
    100101                return u'' 
    101102 
    102         title = property(get_title, None, None, "Data form title") 
     103        title = property(get_title, None, None, 'Data form title') 
    103104 
    104105        def show(self): 
    105                 """ Treat 'us' as one widget. """ 
     106                ''' Treat 'us' as one widget. ''' 
    106107                self.show_all() 
    107108 
     
    169170 
    170171                # constructing columns... 
    171                 for field, counter in zip(self._data_form.reported.iter_fields(), itertools.count()): 
     172                for field, counter in zip(self._data_form.reported.iter_fields(), 
     173                itertools.count()): 
    172174                        self.records_treeview.append_column( 
    173175                                gtk.TreeViewColumn(field.label, gtk.CellRendererText(), 
     
    238240        def on_remove_button_clicked(self, widget): 
    239241                selection = self.records_treeview.get_selection() 
    240                 model, rowrefs = selection.get_selected_rows()  # rowref is a list of paths 
     242                model, rowrefs = selection.get_selected_rows() 
     243                # rowref is a list of paths 
    241244                for i in xrange(len(rowrefs)): 
    242245                        rowrefs[i] = gtk.TreeRowReference(model, rowrefs[i]) 
    243                 # rowref is a list of row references; need to convert because we will modify the model, 
    244                 # paths would change 
     246                # rowref is a list of row references; need to convert because we will 
     247                # modify the model, paths would change 
    245248                for rowref in rowrefs: 
    246249                        del model[rowref.get_path()] 
    247          
     250 
    248251        def on_up_button_clicked(self, widget): 
    249252                selection = self.records_treeview.get_selection() 
    250253                model, (path,) = selection.get_selected_rows() 
    251254                iter = model.get_iter(path) 
    252                 previter = model.get_iter((path[0]-1,)) # constructing path for previous iter 
     255                # constructing path for previous iter 
     256                previter = model.get_iter((path[0]-1,)) 
    253257                model.swap(iter, previter) 
    254258 
     
    268272 
    269273class SingleForm(gtk.Table, object): 
    270         """ Widget that represent DATAFORM_SINGLE mode form. Because this is used 
     274        ''' Widget that represent DATAFORM_SINGLE mode form. Because this is used 
    271275        not only to display single forms, but to form input windows of multiple-type 
    272         forms, it is in another class.""" 
     276        forms, it is in another class.''' 
    273277        def __init__(self, dataform): 
    274278                assert isinstance(dataform, dataforms.SimpleDataForm) 
     
    281285 
    282286                def decorate_with_tooltip(widget, field): 
    283                         """ Adds a tooltip containing field's description to a widget. 
     287                        ''' Adds a tooltip containing field's description to a widget. 
    284288                        Creates EventBox if widget doesn't have its own gdk window. 
    285                         Returns decorated widget. """ 
    286                         if field.description!='': 
    287                                 if widget.flags()&gtk.NO_WINDOW: 
     289                        Returns decorated widget. ''' 
     290                        if field.description != '': 
     291                                if widget.flags() & gtk.NO_WINDOW: 
    288292                                        evbox = gtk.EventBox() 
    289293                                        evbox.add(widget) 
     
    302306                # for each field... 
    303307                for field in self._data_form.iter_fields(): 
    304                         if field.type=='hidden': continue 
     308                        if field.type == 'hidden': continue 
    305309 
    306310                        commonlabel = True 
     
    309313                        widget = None 
    310314 
    311                         if field.type=='boolean': 
     315                        if field.type == 'boolean': 
    312316                                commonlabelcenter = True 
    313317                                widget = gtk.CheckButton() 
    314                                 widget.connect('toggled', self.on_boolean_checkbutton_toggled, field) 
     318                                widget.connect('toggled', self.on_boolean_checkbutton_toggled, 
     319                                        field) 
    315320                                widget.set_active(field.value) 
    316321 
    317                         elif field.type=='fixed': 
     322                        elif field.type == 'fixed': 
    318323                                leftattach = 1 
    319324                                rightattach = 2 
     
    322327                                        leftattach = 0 
    323328                                 
    324                                 commonwidget=False 
     329                                commonwidget = False 
    325330                                widget = gtk.Label(field.value) 
    326331                                widget.set_line_wrap(True) 
    327                                 self.attach(widget, leftattach, rightattach, linecounter, linecounter+1, 
    328                                         xoptions=gtk.FILL, yoptions=gtk.FILL) 
     332                                self.attach(widget, leftattach, rightattach, linecounter, 
     333                                        linecounter+1, xoptions=gtk.FILL, yoptions=gtk.FILL) 
    329334 
    330335                        elif field.type == 'list-single': 
     
    355360                                                else: 
    356361                                                        f.value = '' 
    357                                         widget = gtkgui_helpers.create_combobox(field.options, field.value) 
     362                                        widget = gtkgui_helpers.create_combobox(field.options, 
     363                                                field.value) 
    358364                                        widget.connect('changed', on_list_single_combobox_changed, field) 
    359365                                widget.set_sensitive(readwrite) 
     
    437443                                textwidget = gtk.TextView() 
    438444                                textwidget.set_wrap_mode(gtk.WRAP_WORD) 
    439                                 textwidget.get_buffer().connect('changed', self.on_text_multi_textbuffer_changed, 
    440                                         field) 
     445                                textwidget.get_buffer().connect('changed', 
     446                                        self.on_text_multi_textbuffer_changed, field) 
    441447                                textwidget.get_buffer().set_text(field.value) 
    442                                  
     448 
    443449                                widget = gtk.ScrolledWindow() 
    444450                                widget.add(textwidget) 
     
    448454                                self.attach(widget, 1, 2, linecounter, linecounter+1) 
    449455 
    450                         else:# field.type == 'text-single' or field.type is nonstandard: 
     456                        else: 
     457                                # field.type == 'text-single' or field.type is nonstandard: 
    451458                                # JEP says that if we don't understand some type, we 
    452459                                # should handle it as text-single 
     
    454461                                if readwrite: 
    455462                                        widget = gtk.Entry() 
    456                                         widget.connect('changed', self.on_text_single_entry_changed, field) 
     463                                        widget.connect('changed', self.on_text_single_entry_changed, 
     464                                                field) 
    457465                                        widget.set_sensitive(readwrite) 
    458466                                        if field.value is None: