Sugar Architecture/API

Table of Contents
API Introduction
Third Party Packages	AbiWord	ATK	Avahi	GTK	gstreamer	Cairo	D-Bus	evince	HippoCanvas
Sugar Packs	Python Scripts	Library Packages	Shell Packages	Services Package	Activity APIs

Sugar is written in Python with a variety of open source packages. Programming in the Sugar environment requires a basic understanding of both the Sugar User Interface, supporting third-party packages, and built-in Sugar packages.

Traditional software packages are built against Application Programming Interfaces. Sugar runs Activities instead of applications, but from a developer's point of view, it's the same thing.

Third Party Packages

• Abiword - Document writer
• ATK - GNOME Accessibility Toolkit
• Avahi - Network Discovery Service
• GTK - GNOME Toolkit
• gstreamer - media player
• Cairo - A 2D graphics Library
• D-BUS - Message Bus service
• Evince - Document viewer
• HippoCanvas - Cairo compatible Drawing tool
• Matchbox - Graphical Windows Manager
• Pango - GTK package for text rendering
• X Window System - the tried-and-true ancient X11 display libraries
• Xul - XML User Interface Language (aka gecko and other identity challenged projects)

Sugar Packs

Sugar Python Scripts

Several Python Scripts reside in /usr/bin

Scripts:

• sugar-activity
• sugar-activity-factory
• sugar-clipboard
• sugar-console
• sugar-data-store
• sugar-emulator
• sugar-emulator-shutdown
• sugar-nm-applet
• sugar-presence-service
• sugar-setup-activity
• sugar-shell

Sugar Library Packages

Many Sugar Library packages reside in /usr/lib/python*/site-packages/sugar

Modules:

• TracebackUtils
• emulator
• env
• logger
• profile
• simulator
• util

Subpackages:

• sugar.activity
• sugar.chat
• sugar.clipboard
• sugar.datastore
• sugar.graphics
• sugar.p2p
• sugar.presence

Package sugar.shell

Most of the Human Interface is implemented in the sugar shell packages located in /usr/share/sugar/shell

Modules:

• sugar.shell.HardwareManager

Subpackages:

• sugar.shell.console
• sugar.shell.Model
• sugar.shell.view

Package sugar.services

Various services are provided in /usr/share/sugar/services

Modules: none

Subpackages:

• sugar.services.clipboard
• sugar.services.console
• sugar.services.datastore
• sugar.services.nm
• sugar.services.presence

Sugar Activity APIs

The previous API sections detail all sugar interfaces. Here is an abbreviated list of the APIs most relevant for activity programming:

• TBD