Sugar Architecture/API: Difference between revisions

From OLPC
Jump to navigation Jump to search
m (Reverted edits by 222.255.31.82 (Talk); changed back to last version by Walter)
 
(24 intermediate revisions by 10 users not shown)
Line 41: Line 41:
</table>
</table>
</div>
</div>
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.


''This page describes Sugar's Python programming environment. The API available to non-Python activities is described on the [[Low-level Activity API]] page.''
Traditional software packages are built against Application Programming Interfaces. Sugar runs [[Activity | Activities]] instead of applications, but from a developer's point of view, it's the same thing.

Sugar is written in Python and uses a variety of open source packages. Programming in the Sugar environment requires a basic understanding of the Sugar user interface, supporting third-party packages, and built-in Sugar packages.

Traditional software packages are built against application programming interfaces. Sugar runs [[Activity | Activities]] instead of applications, but from a developer's point of view, it's the same thing.

The platform [[API Reference]] includes a collection of pointers to documentation including automatically generated [http://www.vrplumber.com/sugar-docs PyDoc] documentation for Sugar and related libraries.


== Third Party Packages ==
== Third Party Packages ==
*[[Abiword]] - Document writer
*[[Abiword]] - Document writer
*[[Software_components#Libraries_and_Plugins|ATK]] - GNOME Accessibility Toolkit
*[[Software_components#Libraries_and_Plugins|ATK]] - GNOME Accessibility Toolkit
*[[Software_components#Libraries_and_Plugins|Avahi]] - Network Discovery Service
*[[Software_components#Libraries_and_Plugins|Avahi]] - network service discovery system
*[[GTK for OLPC|GTK]] - GNOME Toolkit
*[[GTK for OLPC|GTK]] - GNOME Toolkit
*[[GStreamer]] - multimedia framework
*[[Software_components#Libraries_and_Plugins|gstreamer]] - media player
*[[Cairo]] - A 2D graphics Library
*[[Cairo]] - 2-D graphics library
*[[D-BUS]] - Message Bus service
*[[D-BUS]] - message bus service
*[[Evince]] - Document viewer
*[[Evince]] - document viewer
*[[HippoCanvas]] - Cairo compatible Drawing tool
*[[HippoCanvas]] - generic user interface widget - ''now deprecated'' use GTK layout managers
*[[Matchbox]] - Graphical Windows Manager
*[[Software_components#Libraries_and_Plugins|Matchbox]] - graphical windows manager
*[[Software_components#Libraries_and_Plugins|Pango]] - GTK package for text rendering
*[[Software_components#Libraries_and_Plugins|Pango]] - GTK package for text rendering
*[[Software_components#Libraries_and_Plugins|X Window System]] - the tried-and-true ancient X11 display libraries
*[[Software_components#Libraries_and_Plugins|X Window System]] - the tried-and-true ancient X11 display libraries
*[[Software_components#Libraries_and_Plugins|Xul]] - XML User Interface Language (aka gecko and other identity challenged projects)
*[[Software_components#Libraries_and_Plugins|Xul]] - XML User Interface Language


== Sugar Packs ==
== Sugar Packs ==
This details the contents and structure of OLPC Build 303.

=== [[Sugar Architecture/API/Sugar Python Scripts|Sugar Python Scripts]] ===
=== [[Sugar Architecture/API/Sugar Python Scripts|Sugar Python Scripts]] ===
Several Python Scripts reside in /usr/bin
Several Python Scripts reside in /usr/bin
Line 72: Line 79:
* sugar-emulator
* sugar-emulator
* sugar-emulator-shutdown
* sugar-emulator-shutdown
* sugar-nm-applet
* sugar-install-bundle
* sugar-presence-service
* sugar-presence-service
* sugar-setup-activity
* sugar-setup-activity
Line 78: Line 85:


=== [[Sugar Architecture/API/Sugar Library Packages|Sugar Library Packages]] ===
=== [[Sugar Architecture/API/Sugar Library Packages|Sugar Library Packages]] ===
Many Sugar Library packages reside in /usr/lib/python*/site-packages/sugar
Many Sugar library packages reside in /usr/lib/python*/site-packages/sugar


Modules:
Modules:
* TracebackUtils
* TracebackUtils
* date
* emulator
* emulator
* env
* env
Line 99: Line 107:


=== Package [[Sugar Architecture/API/sugar.shell | sugar.shell]] ===
=== Package [[Sugar Architecture/API/sugar.shell | sugar.shell]] ===
Most of the Human Interface is implemented in the sugar shell packages located in /usr/share/sugar/shell
Most of the Human Interface is implemented in the sugar.shell packages located in /usr/share/sugar/shell


Modules:
Modules:
* [[Sugar Architecture/API/sugar.shell.hardwaremanager | sugar.shell.HardwareManager]]
* [[Sugar Architecture/API/sugar.shell.shellservice | sugar.shell.shellservice]]


Subpackages:
Subpackages:
* [[Sugar Architecture/API/sugar.shell.console|sugar.shell.console]]
* [[Sugar Architecture/API/sugar.shell.console|sugar.shell.console]]
* [[Sugar Architecture/API/sugar.shell.Model|sugar.shell.Model]]
* [[Sugar Architecture/API/sugar.shell.hardware|sugar.shell.hardware]]
* [[Sugar Architecture/API/sugar.shell.intro|sugar.shell.intro]]
* [[Sugar Architecture/API/sugar.shell.model|sugar.shell.model]]
* [[Sugar Architecture/API/sugar.shell.view|sugar.shell.view]]
* [[Sugar Architecture/API/sugar.shell.view|sugar.shell.view]]


Line 119: Line 129:
* [[Sugar Architecture/API/sugar.services.console |sugar.services.console]]
* [[Sugar Architecture/API/sugar.services.console |sugar.services.console]]
* [[Sugar Architecture/API/sugar.services.datastore |sugar.services.datastore]]
* [[Sugar Architecture/API/sugar.services.datastore |sugar.services.datastore]]
* [[Sugar Architecture/API/sugar.services.nm |sugar.services.nm]]
* [[Sugar Architecture/API/sugar.services.presence |sugar.services.presence]]
* [[Sugar Architecture/API/sugar.services.presence |sugar.services.presence]]
* [[Sugar Architecture/API/sugar.services.presence2 |sugar.services.presence2]]


=== [[Sugar Architecture/API/Sugar Activity APIs|Sugar Activity APIs]] ===
=== [[Sugar Architecture/API/Sugar Activity APIs|Sugar Activity APIs]] ===
The previous API sections detail all sugar interfaces. Here is an abbreviated list of the APIs most relevant for activity programming:
The previous API sections detail all Sugar interfaces. Here is an abbreviated list of the APIs most relevant for activity programming:

* gtk
* gobject
* hippo
* logging
* os
* pango
* pygtk


* sugar.activity.activity
* TBD
* sugar.graphics
* sugar.date


[[Category:API]]
[[Category:API]]

Latest revision as of 16:53, 10 July 2008

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

This page describes Sugar's Python programming environment. The API available to non-Python activities is described on the Low-level Activity API page.

Sugar is written in Python and uses a variety of open source packages. Programming in the Sugar environment requires a basic understanding of 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.

The platform API Reference includes a collection of pointers to documentation including automatically generated PyDoc documentation for Sugar and related libraries.

Third Party Packages

  • Abiword - Document writer
  • ATK - GNOME Accessibility Toolkit
  • Avahi - network service discovery system
  • GTK - GNOME Toolkit
  • GStreamer - multimedia framework
  • Cairo - 2-D graphics library
  • D-BUS - message bus service
  • Evince - document viewer
  • HippoCanvas - generic user interface widget - now deprecated use GTK layout managers
  • 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

Sugar Packs

This details the contents and structure of OLPC Build 303.

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-install-bundle
  • 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
  • date
  • emulator
  • env
  • logger
  • profile
  • simulator
  • util

Subpackages:

Package sugar.shell

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

Modules:

Subpackages:

Package sugar.services

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

Modules: none

Subpackages:

Sugar Activity APIs

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

  • gtk
  • gobject
  • hippo
  • logging
  • os
  • pango
  • pygtk
  • sugar.activity.activity
  • sugar.graphics
  • sugar.date