Sugar Architecture/API: Difference between revisions
m (Reverted edits by 222.255.31.82 (Talk); changed back to last version by Walter) |
|||
(18 intermediate revisions by 10 users not shown) | |||
Line 41: | Line 41: | ||
</table> |
</table> |
||
</div> |
</div> |
||
''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. |
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. |
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 == |
||
Line 50: | Line 55: | ||
*[[Software_components#Libraries_and_Plugins|Avahi]] - network service discovery system |
*[[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 |
||
*[[Cairo]] - 2-D graphics library |
*[[Cairo]] - 2-D graphics library |
||
*[[D-BUS]] - message bus service |
*[[D-BUS]] - message bus service |
||
*[[Evince]] - document viewer |
*[[Evince]] - document viewer |
||
*[[HippoCanvas]] - generic user interface widget |
*[[HippoCanvas]] - generic user interface widget - ''now deprecated'' use GTK layout managers |
||
*[[Software_components#Libraries_and_Plugins|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 |
||
Line 61: | Line 66: | ||
== Sugar Packs == |
== Sugar Packs == |
||
This details the contents and structure of OLPC Build |
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]] === |
||
Line 74: | Line 79: | ||
* sugar-emulator |
* sugar-emulator |
||
* sugar-emulator-shutdown |
* sugar-emulator-shutdown |
||
* sugar- |
* sugar-install-bundle |
||
* sugar-install-bundle - added [[303]] |
|||
* sugar-presence-service |
* sugar-presence-service |
||
* sugar-presence-service2 - added [[303]] |
|||
* sugar-setup-activity |
* sugar-setup-activity |
||
* sugar-shell |
* sugar-shell |
||
Line 86: | Line 89: | ||
Modules: |
Modules: |
||
* TracebackUtils |
* TracebackUtils |
||
* date |
|||
* emulator |
* emulator |
||
* env |
* env |
||
Line 106: | Line 110: | ||
Modules: |
Modules: |
||
* [[Sugar Architecture/API/sugar.shell.shellservice | sugar.shell.shellservice |
* [[Sugar Architecture/API/sugar.shell.shellservice | sugar.shell.shellservice]] |
||
* [[Sugar Architecture/API/sugar.shell.hardwaremanager | sugar.shell.HardwareManager]] - removed [[303]] |
|||
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.hardware|sugar.shell.hardware]] |
* [[Sugar Architecture/API/sugar.shell.hardware|sugar.shell.hardware]] |
||
* [[Sugar Architecture/API/sugar.shell.intro|sugar.shell.intro]] |
* [[Sugar Architecture/API/sugar.shell.intro|sugar.shell.intro]] |
||
* [[Sugar Architecture/API/sugar.shell.model|sugar.shell.model]] |
* [[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 126: | 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]] - removed [[303]] |
|||
* [[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.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 |
* gtk |
||
gobject |
* gobject |
||
hippo |
* hippo |
||
logging |
* logging |
||
os |
* os |
||
pango |
* pango |
||
pygtk |
* pygtk |
||
sugar.activity.activity |
* sugar.activity.activity |
||
sugar.graphics |
* sugar.graphics |
||
sugar.date |
* sugar.date |
||
[[Category:API]] |
[[Category:API]] |
Latest revision as of 16:53, 10 July 2008
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.services.clipboard
- sugar.services.console
- sugar.services.datastore
- sugar.services.presence
- sugar.services.presence2
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