dbus - D-Bus integration and optional local-LAN commit broadcasting

Version 0.1.0dev
Branch lp:bzr-dbus
Home page https://launchpad.net/bzr-dbus
Owner lifeless
GNU/Linux Yes
Windows No
Mac OS X No

D-Bus integration for bzr/bzrlib.

This plugin provides integration with D-Bus and optional local-LAN commit broadcasting. Please see README for installation instructions which will correctly configure the D-Bus service included in the plugin.

The integration involves a D-Bus advertising daemon and hooks into the bzr library to reflect events (e.g. push/pull/commit/uncommit) across to D-Bus. This should be useful for IDE’s and other editors working in the same space as bzr, or for integration with network services.

Commands provided:

  • dbus-broadcast: D-Bus commit/branch advertising daemon. The D-Bus service which is activated on demand if it has been correctly installed. If for some reason you cannot correctly install the .service file this command can be run by hand. This service is fully documented in its python code - see ‘pydoc bzrlib.plugins.dbus.activity.Broadcast’.
  • lan-notify: Provide a bi-directional gateway of commit-notifications to the local LAN. Only the URL and revision-id are disclosed, no commit content is transmitted. This command is typically put into the background - e.g. bzr lan-notify &. lan-notify is very useful in local LAN collaboration to keep multiple developers in sync.

dbus-broadcast

Purpose

A dbus service to reflect revisions to subscribers.

Usage

bzr dbus-broadcast

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Description

This service runs the bzrlib.plugins.dbus.activity.Broadcast service on the session dbus.

It can be contacted on org.bazaarvcs.plugins.dbus.Broadcast, as /org/bazaarvcs/plugins/dbus/Broadcast with interface org.bazaarvcs.plugins.dbus.Broadcast.

The method announce_revision(revision_id, url) will cause the signal ‘Revision’ to be raised with two parameters - revision_id and url.

lan-notify

Purpose

Reflect dbus commit notifications onto a LAN.

Usage

bzr lan-notify

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.