Foundry.DBusService¶

Subclasses:: None

Methods¶

Inherited:: Foundry.Service (8), Foundry.Contextual (4), GObject.Object (37), Json.Serializable (8)
Structs:: Foundry.ServiceClass (3), GObject.ObjectClass (5)

	`dup_address` ()
	`query_address` ()

Virtual Methods¶

Inherited:: GObject.Object (7), Json.Serializable (5)

Properties¶

Inherited:: Foundry.Contextual (1)

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class Foundry.DBusService(**kwargs)¶

Bases:: Foundry.Service
Abstract:: No
Structure:: Foundry.DBusServiceClass

Manages D-Bus service for remote command execution.

Foundry.DBusService provides a D-Bus socket for clients to connect to and execute commands within the primary application instance. This is also can be used to execute a subshell and have persistent background work running in between shell commands.

Development environments that wants to allow interacting with the UI instance from a shell are encouraged to give access to terminal emulators with this sockets address in the form of FOUNDRY_ADDRESS= environment variable.

dup_address()¶

Returns:: A D-Bus server address if started successfully otherwise None.
Return type:: str or None

Gets the D-Bus address of the embedded D-Bus server.

Deprecated since version 1.1.

query_address()¶

Returns:: a [class`Dex`.Future] that resolves to a string containing the address, or rejects with error.
Return type:: Dex.Future

Ensures the Gio.DBusServer is running and provides the address.

New in version 1.1.