Changes
Development Team/Almanac/Sugar.presence.buddy (view source)
Revision as of 13:37, 14 August 2008
, 13:37, 14 August 2008New page: === How do I get a list of the activities that a particular buddy has shared with me? === The sugar.presence package includes tools to get a list of activities that a buddy. In the class ...
=== How do I get a list of the activities that a particular buddy has shared with me? ===
The sugar.presence package includes tools to get a list of activities that a buddy. In the class Buddy, there is specifically a method called [http://api.sugarlabs.org/sugar.presence.buddy-pysrc.html get_joined_activities()] that will "retrieve the set of all activities which this buddy has joined". It returns these activities as a list of sugar.presence.activitiy.Activity objects. The code below shows a method that prints out the list of activities that the user's XO has joined with another specified user (in this case, someone named 'olpc').
<pre>
from sugar.presence import presenceservice
...
class AnnotateActivity(activity.Activity):
#### Method: __init__, initialize this AnnotateActivity instance
def __init__(self, handle):
...
self._print_buddy_activities('olpc')
...
#### Method: _print_buddy_activities, which takes the name of a buddy and prints
# out the name of the activities that this buddy is sharing with you.
def _print_buddy_activities(self, name):
#self._find_buddy_by_name returns a sugar.presence.buddy.Buddy object whose nickname matches the given name
buddy = self._find_buddy_by_name(name)
activities = buddy.get_joined_activities()
for buddyActivity in activities:
print buddyActivity.get_property('name')
</pre>
The sugar.presence package includes tools to get a list of activities that a buddy. In the class Buddy, there is specifically a method called [http://api.sugarlabs.org/sugar.presence.buddy-pysrc.html get_joined_activities()] that will "retrieve the set of all activities which this buddy has joined". It returns these activities as a list of sugar.presence.activitiy.Activity objects. The code below shows a method that prints out the list of activities that the user's XO has joined with another specified user (in this case, someone named 'olpc').
<pre>
from sugar.presence import presenceservice
...
class AnnotateActivity(activity.Activity):
#### Method: __init__, initialize this AnnotateActivity instance
def __init__(self, handle):
...
self._print_buddy_activities('olpc')
...
#### Method: _print_buddy_activities, which takes the name of a buddy and prints
# out the name of the activities that this buddy is sharing with you.
def _print_buddy_activities(self, name):
#self._find_buddy_by_name returns a sugar.presence.buddy.Buddy object whose nickname matches the given name
buddy = self._find_buddy_by_name(name)
activities = buddy.get_joined_activities()
for buddyActivity in activities:
print buddyActivity.get_property('name')
</pre>