Sugar Architecture/API: Difference between revisions
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> |
||
⚫ | |||
''This page describes Sugar's Python programming environment. The API available to non-Python activities is described on the [[Low-level Activity API]] page.'' |
|||
⚫ | |||
⚫ | |||
⚫ | |||
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]] - |
*[[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]] - |
*[[Cairo]] - 2-D graphics library |
||
*[[D-BUS]] - |
*[[D-BUS]] - message bus service |
||
*[[Evince]] - |
*[[Evince]] - document viewer |
||
*[[HippoCanvas]] - |
*[[HippoCanvas]] - generic user interface widget - ''now deprecated'' use GTK layout managers |
||
*[[Matchbox]] - |
*[[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 |
*[[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- |
* 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 |
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 |
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. |
* [[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. |
* [[Sugar Architecture/API/sugar.shell.hardware|sugar.shell.hardware]] |
||
⚫ | |||
* [[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.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 |
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
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