README

COMAR API package offers modules for accessing COMAR over D-Bus without pain and 
common methods/classes for COMAR scripts.

Here are some examples for accessing COMAR:

    import comar
    link = comar.Link()

    # Localize strings
    link.setLocale()

    # Never use authentication agent (GUI)
    link.useAgent(False)

    # Get a list of packages that provide system.service method
    packages = list(link.System.Service)

    # Start a service
    link.System.Service["kdebase"].start()

    # Stop all services and ignore replies from packages.
    link.System.Service.stop(quiet=True)

Asynchronous calls:

    import gobject
    import dbus.mainloop.glib
    dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
    mainloop = gobject.MainLoop()

    import comar
    link = comar.Link()

    # Localize strings
    link.setLocale()

    # Use authentication agent (GUI)
    link.useAgent()

    # Make an asynchronous call to get service information
    def handler(package, exception, result):
        if exception:
            print "%s error: %s" % (package, exception)
        else:
            print "%s result: %s" % (package, result)
    link.System.Service.info(async=handler)

    mainloop.run()

Connecting COMAR service on alternate destination:

    import comar
    link = comar.Link(alternate=True)

This will simply try to connect tr.org.pardus.comar2 instead 
of tr.org.pardus.comar

Connecting to alternative DBus server:

    import comar
    link = comar.Link(socket="/mnt/target/var/run/dbus/system_bus_socket")