Add a roster_group_sort option, which works like roster_sort

- defaults to "name" (sort by group name)
- document it
- also, micro-optimize get_nb_connected_contacts()
This commit is contained in:
mathieui 2012-08-01 01:06:57 +02:00
parent 1625a4f41f
commit 71f813af28
4 changed files with 65 additions and 8 deletions

View file

@ -229,13 +229,24 @@ roster_show_offline = false
# - reverse: reverse the sorting # - reverse: reverse the sorting
# - jid: sort by JID (alphabetical order) # - jid: sort by JID (alphabetical order)
# - show: sort by show (available/away/xa/…) # - show: sort by show (available/away/xa/…)
# - name: Sort by roster name (if no name, then the bare jid is used) # - name: sort by roster name (if no name, then the bare jid is used)
# - resource: Sort by resource number # - resource: sort by resource number
# You can arrange them however you like, and you have to separate them with # You can arrange them however you like, and you have to separate them with
# underscores "_". Keep in mind that if there are more than 3 or 4 your sorting # underscores "_". Keep in mind that if there are more than 3 or 4 your sorting
# is most likely inefficient. # is most likely inefficient.
roster_sort = jid_show roster_sort = jid_show
# How to sort the roster groups.
# The principles are the same as roster_sort.
# Available methods are:
# - reverse: reverse the sorting
# - name: sort by group name (alphabetical order)
# - fold: sort unfolded/folded
# - connected: sort by number of connected contacts
# - size: sort by group size
# - none: put the "none" group (if any) at the end of the list
roster_group_sort = name
# The terminal can beep on various event. Put the event you want in a list # The terminal can beep on various event. Put the event you want in a list
# (separated by spaces). # (separated by spaces).
# The events can be # The events can be

View file

@ -296,6 +296,19 @@ section of this documentation.
separated by underscores ("_"). If there are more than 3 or 4 chained separated by underscores ("_"). If there are more than 3 or 4 chained
sorting methods, your sorting is most likely inefficient. sorting methods, your sorting is most likely inefficient.
*roster_group_sort*:: name
How to sort the roster groups. The principles are the same as _roster_sort_
(see above).
Available methods are:
* reverse: reverse the current sorting
* name: sort by group name (alphabetical order)
* fold: sort by unfolded/folded
* connected: sort by number of connected contacts
* size: sort by group size
* none: put the "none" group (if any) at the end of the list
*beep_on*:: highlight private *beep_on*:: highlight private
The terminal can beep on various event. Put the event you want in a list The terminal can beep on various event. Put the event you want in a list

View file

@ -18,6 +18,30 @@ from contact import Contact
from sleekxmpp.xmlstream.stanzabase import JID from sleekxmpp.xmlstream.stanzabase import JID
from sleekxmpp.exceptions import IqError from sleekxmpp.exceptions import IqError
def sort_group_name(group):
return group.name.lower()
def sort_group_folded(group):
return group.folded
def sort_group_connected(group):
return - group.get_nb_connected_contacts()
def sort_group_size(group):
return - len(group)
def sort_group_none(group):
return 0 if group.name != 'none' else 1
GROUP_SORTING_METHODS = {
'name': sort_group_name,
'fold': sort_group_folded,
'connected': sort_group_connected,
'size': sort_group_size,
'none': sort_group_none,
}
class Roster(object): class Roster(object):
""" """
The proxy class to get the roster from SleekXMPP. The proxy class to get the roster from SleekXMPP.
@ -93,9 +117,17 @@ class Roster(object):
"""Set the SleekXMPP RosterSingle for our roster""" """Set the SleekXMPP RosterSingle for our roster"""
self.__node = value self.__node = value
def get_groups(self): def get_groups(self, sort=''):
"""Return a list of the RosterGroups""" """Return a list of the RosterGroups"""
return [group for group in self.groups.values() if group] group_list = sorted(filter(lambda x: bool(x), self.groups.values()), key=lambda x: x.name.lower())
for sorting in sort.split('_'):
if sorting == 'reverse':
group_list = list(reversed(group_list))
else:
method = GROUP_SORTING_METHODS.get(sorting, lambda x: 0)
group_list = sorted(group_list, key=method)
return group_list
def get_group(self, name): def get_group(self, name):
"""Return a group or create it if not present""" """Return a group or create it if not present"""
@ -273,16 +305,16 @@ class RosterGroup(object):
"""Return the group contacts, filtered and sorted""" """Return the group contacts, filtered and sorted"""
contact_list = self.contacts.copy() if not contact_filter\ contact_list = self.contacts.copy() if not contact_filter\
else [contact for contact in self.contacts.copy() if contact_filter[0](contact, contact_filter[1])] else [contact for contact in self.contacts.copy() if contact_filter[0](contact, contact_filter[1])]
contact_list = sorted(contact_list, key=SORTING_METHODS['name'])
for sorting in sort.split('_'): for sorting in sort.split('_'):
method = SORTING_METHODS.get(sorting, lambda x: 0)
if sorting == 'reverse': if sorting == 'reverse':
contact_list = list(reversed(contact_list)) contact_list = list(reversed(contact_list))
else: else:
method = SORTING_METHODS.get(sorting, lambda x: 0)
contact_list = sorted(contact_list, key=method) contact_list = sorted(contact_list, key=method)
return contact_list return contact_list
def toggle_folded(self): def toggle_folded(self):
"""Fold/unfold the group in the roster""" """Fold/unfold the group in the roster"""
self.folded = not self.folded self.folded = not self.folded
@ -295,7 +327,7 @@ class RosterGroup(object):
def get_nb_connected_contacts(self): def get_nb_connected_contacts(self):
"""Return the number of connected contacts""" """Return the number of connected contacts"""
return len([1 for contact in self.contacts if contact.resources]) return len([1 for contact in self.contacts if len(contact)])
# Shared roster object # Shared roster object

View file

@ -1610,7 +1610,8 @@ class RosterWin(Win):
y = 1 y = 1
show_offline = config.get('roster_show_offline', 'false') == 'true' show_offline = config.get('roster_show_offline', 'false') == 'true'
sort = config.get('roster_sort', 'jid_show') or 'jid_show' sort = config.get('roster_sort', 'jid_show') or 'jid_show'
for group in roster.get_groups()[:]: group_sort = config.get('roster_group_sort', 'name') or 'name'
for group in roster.get_groups(group_sort):
contacts_filtered = group.get_contacts(roster.contact_filter) contacts_filtered = group.get_contacts(roster.contact_filter)
if (not show_offline and group.get_nb_connected_contacts() == 0) or not contacts_filtered: if (not show_offline and group.get_nb_connected_contacts() == 0) or not contacts_filtered:
continue # Ignore empty groups continue # Ignore empty groups