sugar-toolkit-gtk3/shell/ActivityRegistry.py

import logging

class ActivityModule:
	"""Info about an activity module. Wraps a .activity file."""
	
	def __init__(self, name, activity_id, activity_exec, directory):
		self._name = name
		self._id = activity_id
		self._directory = directory
		self._exec = activity_exec
	
	def get_name(self):
		"""Get the activity user visible name."""
		return self._name

	def get_id(self):
		"""Get the activity identifier"""
		return self._id

	def get_class(self):
		"""Get the activity executable"""
		return self._class

	def get_directory(self):
		"""Get the path to activity directory."""
		return self._directory

class ActivityRegistry:
	"""Service that tracks the available activities"""

	def __init__(self):
		self._activities = []
	
	def scan_directory(self, path):
		"""Scan a directory for activities and add them to the registry.""" 
		if os.path.isdir(base_dir):
			for filename in os.listdir(base_dir):
				activity_dir = os.path.join(base_dir, filename)
				if os.path.isdir(activity_dir):
					for filename in os.listdir(activity_dir):
						if filename.endswith(".activity"):
							self.add(os.path.join(activity_dir, filename))

	def add(self, path):
		"""Add an activity to the registry. The path points to a .activity file."""
		cp = ConfigParser()
		cp.read([path])

		directory = os.path.dirname(path)

		try:
			activity_id = cp.get('Activity', 'id')
			name = cp.get('Activity', 'name')
		except NoOptionError:
			logging.error('%s miss a required option' % (path))

		if cp.has_option('Activity', 'exec'):
			activity_exec = cp.get('Activity', 'exec')
		elif cp.has_option('Activity', 'python_module'):
			python_module = cp.get('Activity', 'python_module')
			activity_exec = 'python -m sugar/activity/Activity %s %s' \
							% (name, python_module)
		else:
			logging.error('%s must specifiy exec or python_module' % (path))

		module = ActivityModule(name, activity_id, activity_exec, directory)
		self._activities.append(module)

		return True

	def list_activities(self):
		"""Enumerate the registered activities as an ActivityModule list."""
		return self._activities