Skip to content

Log activity for the Sugar learning environment

License

Notifications You must be signed in to change notification settings

sugarlabs/log-activity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is this?

The Log Activity allows you to troubleshoot problems with your computer. You can view the log files of Sugar and Activities.

How to use?

Log is part of the Sugar desktop.

Log is used when looking for why an activity or Sugar is not working properly.

For an activity, start the activity, make the activity do something wrong, then stop the activity. Check that the activity is stopped by opening the Frame (F6). Start the Log activity (F3, log, enter). Click on the log file for the activity; it will be named according to the activity bundle_id. Compare the log against what used to happen, or what happens when the activity does not do something wrong. Write to the maintainer of the activity or create an issue on GitHub in the activity repository. Explain how you made the activity do something wrong. Include the log as quoted text. Include the activity version.

For Sugar, make Sugar do something wrong, then stop Sugar by logging out. Log back in. Start the Log activity (F3, log, enter). Click on the date and time for when you logged out. Click on the shell.log or datastore.log files. Compare the log against what used to happen, or what happens when Sugar does not do something wrong. Write to the Sugar mailing list or create an issue on GitHub in the sugar repository. Explain how you made Sugar do something wrong. Include the log as quoted text. Include the Sugar version.

Please refer to;

How to integrate?

On Debian and Ubuntu systems;

apt install sugar-log-activity

On Fedora systems;

dnf install sugar-log

Log depends on Python, Sugar Toolkit, D-Bus, GTK+ 3, Pango, Python urllib. Log also runs several Linux utilities; ifconfig, route, df, ps, free, and top.

Log is started by Sugar.

Log is packaged by Linux distributions;

How to develop?

  • setup a development environment for Sugar desktop,
  • clone this repository,
  • edit source files,
  • test in Terminal by typing sugar-activity3

APIs

Code inside Log depends on several APIs, including;

Branch master

The master branch targets an environment with latest stable release of Sugar, with dependencies on latest stable release of Fedora and Debian distributions.

Release tags are v41 and higher.

Branch python2

The python2 branch is a backport of features and bug fixes from the master branch for ongoing maintenance of the activity on Fedora 18, Ubuntu 16.04 and Ubuntu 18.04 systems which don't have a Python 3 capable release of Sugar.

Release tags are v40.1 and higher, but lower than v41.

About

Log activity for the Sugar learning environment

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages