2007-04-10 04:47:37 +02:00
|
|
|
"""Base class for Python-coded activities
|
|
|
|
|
|
|
|
This is currently the only reference for what an
|
|
|
|
activity must do to participate in the Sugar desktop.
|
|
|
|
"""
|
2006-10-15 01:08:44 +02:00
|
|
|
# Copyright (C) 2006, Red Hat, Inc.
|
|
|
|
#
|
|
|
|
# This library is free software; you can redistribute it and/or
|
|
|
|
# modify it under the terms of the GNU Lesser General Public
|
|
|
|
# License as published by the Free Software Foundation; either
|
|
|
|
# version 2 of the License, or (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This library is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
# Lesser General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU Lesser General Public
|
|
|
|
# License along with this library; if not, write to the
|
|
|
|
# Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
# Boston, MA 02111-1307, USA.
|
|
|
|
|
2006-08-11 17:05:06 +02:00
|
|
|
import logging
|
2007-02-22 17:27:00 +01:00
|
|
|
import os
|
2006-08-09 18:29:33 +02:00
|
|
|
|
2006-07-15 12:31:06 +02:00
|
|
|
import gtk
|
2007-02-27 15:05:44 +01:00
|
|
|
import hippo
|
2006-05-12 08:34:20 +02:00
|
|
|
|
2007-04-09 20:40:56 +02:00
|
|
|
from sugar.presence import presenceservice
|
2007-02-21 20:15:39 +01:00
|
|
|
from sugar.activity.activityservice import ActivityService
|
2007-02-27 15:05:44 +01:00
|
|
|
from sugar.graphics.window import Window
|
2006-08-09 15:53:10 +02:00
|
|
|
|
2007-02-27 15:05:44 +01:00
|
|
|
class Activity(Window, gtk.Container):
|
2006-12-04 20:12:24 +01:00
|
|
|
"""Base Activity class that all other Activities derive from."""
|
2007-02-27 15:05:44 +01:00
|
|
|
__gtype_name__ = 'SugarActivity'
|
2007-02-22 00:57:49 +01:00
|
|
|
def __init__(self, handle):
|
2007-04-10 04:47:37 +02:00
|
|
|
"""Initialise the Activity
|
|
|
|
|
|
|
|
handle -- sugar.activity.activityhandle.ActivityHandle
|
|
|
|
instance providing the activity id and access to the
|
|
|
|
presence service which *may* provide sharing for this
|
|
|
|
application
|
|
|
|
|
|
|
|
Side effects:
|
|
|
|
|
|
|
|
Sets the gdk screen DPI setting (resolution) to the
|
|
|
|
Sugar screen resolution.
|
|
|
|
|
|
|
|
Connects our "destroy" message to our _destroy_cb
|
|
|
|
method.
|
|
|
|
|
|
|
|
Creates a base gtk.Window within this window.
|
|
|
|
|
|
|
|
Creates an ActivityService (self._bus) servicing
|
|
|
|
this application.
|
|
|
|
"""
|
2007-02-27 15:05:44 +01:00
|
|
|
Window.__init__(self)
|
2006-12-04 20:12:24 +01:00
|
|
|
|
2006-12-24 02:51:37 +01:00
|
|
|
self.connect('destroy', self._destroy_cb)
|
2006-12-04 20:12:24 +01:00
|
|
|
|
|
|
|
self._shared = False
|
2007-02-22 00:57:49 +01:00
|
|
|
self._activity_id = handle.activity_id
|
2007-04-09 20:40:56 +02:00
|
|
|
self._pservice = presenceservice.get_instance()
|
2007-03-07 10:59:48 +01:00
|
|
|
self._service = None
|
2007-04-13 22:27:58 +02:00
|
|
|
self._share_sigid = None
|
2006-12-04 20:12:24 +01:00
|
|
|
|
2007-02-22 00:57:49 +01:00
|
|
|
service = handle.get_presence_service()
|
|
|
|
if service:
|
|
|
|
self._join(service)
|
|
|
|
|
2007-02-21 20:15:39 +01:00
|
|
|
self._bus = ActivityService(self)
|
2006-12-04 20:12:24 +01:00
|
|
|
|
2007-04-26 11:31:41 +02:00
|
|
|
activity_toolbar = ActivityToolbar()
|
|
|
|
self.toolbox.add_toolbar('Activity', activity_toolbar)
|
|
|
|
activity_toolbar.show()
|
|
|
|
|
2007-02-27 15:05:44 +01:00
|
|
|
# DEPRECATED It will be removed after 3-6-2007 stable image
|
|
|
|
def do_add(self, widget):
|
|
|
|
if self.child:
|
|
|
|
self.remove(self.child)
|
|
|
|
gtk.Window.do_add(self, widget)
|
|
|
|
|
2007-02-22 15:55:07 +01:00
|
|
|
def get_service_name(self):
|
|
|
|
"""Gets the activity service name."""
|
|
|
|
return os.environ['SUGAR_BUNDLE_SERVICE_NAME']
|
2006-12-04 20:12:24 +01:00
|
|
|
|
|
|
|
def get_shared(self):
|
|
|
|
"""Returns TRUE if the activity is shared on the mesh."""
|
|
|
|
return self._shared
|
|
|
|
|
|
|
|
def get_id(self):
|
|
|
|
"""Get the unique activity identifier."""
|
|
|
|
return self._activity_id
|
|
|
|
|
2007-02-22 00:57:49 +01:00
|
|
|
def _join(self, service):
|
2007-04-11 21:08:40 +02:00
|
|
|
"""Join an existing instance of this activity on the network."""
|
2007-02-22 00:57:49 +01:00
|
|
|
self._service = service
|
2006-12-04 20:12:24 +01:00
|
|
|
self._shared = True
|
2007-04-11 21:08:40 +02:00
|
|
|
self._service.join()
|
2006-12-20 00:53:27 +01:00
|
|
|
self.present()
|
|
|
|
|
2007-04-13 22:27:58 +02:00
|
|
|
def _share_cb(self, ps, success, service, err):
|
|
|
|
self._pservice.disconnect(self._share_sigid)
|
2007-04-13 22:58:32 +02:00
|
|
|
self._share_sigid = None
|
2007-04-13 22:27:58 +02:00
|
|
|
if success:
|
|
|
|
logging.debug('Share of activity %s successful.' % self.get_id())
|
|
|
|
self._service = service
|
|
|
|
self._shared = True
|
|
|
|
else:
|
|
|
|
logging.debug('Share of activity %s failed: %s.' % (self.get_id(), err))
|
|
|
|
|
2006-12-04 20:12:24 +01:00
|
|
|
def share(self):
|
2007-04-13 22:27:58 +02:00
|
|
|
"""Request that the activity be shared on the network."""
|
|
|
|
logging.debug('Requesting share of activity %s.' % self.get_id())
|
|
|
|
self._share_sigid = self._pservice.connect("activity-shared", self._share_cb)
|
|
|
|
self._pservice.share_activity(self)
|
2006-12-04 20:12:24 +01:00
|
|
|
|
2007-02-22 01:23:58 +01:00
|
|
|
def execute(self, command, args):
|
|
|
|
"""Execute the given command with args"""
|
|
|
|
return False
|
|
|
|
|
2006-12-24 02:51:37 +01:00
|
|
|
def _destroy_cb(self, window):
|
2007-04-10 04:47:37 +02:00
|
|
|
"""Destroys our ActivityService and sharing service"""
|
2006-12-04 20:12:24 +01:00
|
|
|
if self._bus:
|
|
|
|
del self._bus
|
|
|
|
self._bus = None
|
|
|
|
if self._service:
|
|
|
|
self._pservice.unregister_service(self._service)
|
2007-02-22 15:55:07 +01:00
|
|
|
|
|
|
|
def get_bundle_path():
|
2007-04-10 04:47:37 +02:00
|
|
|
"""Return the bundle path for the current process' bundle
|
|
|
|
"""
|
2007-02-23 17:08:37 +01:00
|
|
|
return os.environ['SUGAR_BUNDLE_PATH']
|