Functions

	aio_read (aio_context, fd, buffer, count, offset)
	aio_write (aio_context, fd, buffer, count, offset)
	bus_get (bus_type)
	dbus_connection_call (connection, bus_name, object_path, interface_name, method_name, parameters, reply_type, flags, timeout_msec)
	dbus_connection_call_with_unix_fd_list (connection, bus_name, object_path, interface_name, method_name, parameters, reply_type, flags, timeout_msec, fd_list)
	dbus_connection_send_message_with_reply (connection, message, flags, timeout_msec)
	error_quark ()
	file_copy (source, destination, flags, io_priority)
	file_enumerate_children (file, attributes, flags, io_priority)
	file_enumerator_next_files (file_enumerator, num_files, io_priority)
	file_load_contents_bytes (file)
	file_make_directory (file, io_priority)
	file_query_exists (file)
	file_query_info (file, attributes, flags, io_priority)
	file_read (file, io_priority)
	file_replace (file, etag, make_backup, flags, io_priority)
	get_min_stack_size ()
	get_page_size ()
	init ()
	input_stream_close (self, io_priority)
	input_stream_read (self, buffer, count, io_priority)
	input_stream_read_bytes (self, count, io_priority)
	input_stream_skip (self, count, io_priority)
	io_stream_close (io_stream, io_priority)
	output_stream_close (self, io_priority)
	output_stream_splice (output, input, flags, io_priority)
	output_stream_write (self, buffer, count, io_priority)
	output_stream_write_bytes (self, bytes, io_priority)
	resolver_lookup_by_name (resolver, address)
	socket_client_connect (socket_client, socket_connectable)
	socket_listener_accept (listener)
	subprocess_wait_check (subprocess)
	value_get_object (value)
	value_set_object (value, object)
	value_take_object (value, object)

Details

Dex.aio_read(aio_context, fd, buffer, count, offset)

Parameters:

• aio_context (Dex.AioContext) –

• fd (int) –

• buffer (object or None) –

• count (int) –

• offset (int) –

Returns:

a future that will resolve when the read completes or rejects with error.

Return type:

Dex.Future

An asynchronous pread() wrapper.

Dex.aio_write(aio_context, fd, buffer, count, offset)

Parameters:

• aio_context (Dex.AioContext) –

• fd (int) –

• buffer (object or None) –

• count (int) –

• offset (int) –

Returns:

a future that will resolve when the write completes or rejects with error.

Return type:

Dex.Future

An asynchronous pwrite() wrapper.

Dex.bus_get(bus_type)

Parameters:

bus_type (Gio.BusType) –

Returns:

a Dex.Future that resolves to a Gio.DBusConnection or rejects with error.

Return type:

Dex.Future

Wrapper for Gio.bus_get().

New in version 0.4.

Dex.dbus_connection_call(connection, bus_name, object_path, interface_name, method_name, parameters, reply_type, flags, timeout_msec)

Parameters:

• connection (Gio.DBusConnection) –

• bus_name (str) –

• object_path (str) –

• interface_name (str) –

• method_name (str) –

• parameters (GLib.Variant) –

• reply_type (GLib.VariantType) –

• flags (Gio.DBusCallFlags) –

• timeout_msec (int) –

Returns:

a Dex.Future that resolves to a GLib.Variant or rejects with error.

Return type:

Dex.Future

Wrapper for Gio.DBusConnection.call().

New in version 0.4.

Dex.dbus_connection_call_with_unix_fd_list(connection, bus_name, object_path, interface_name, method_name, parameters, reply_type, flags, timeout_msec, fd_list)

Parameters:

• connection (Gio.DBusConnection) –

• bus_name (str) –

• object_path (str) –

• interface_name (str) –

• method_name (str) –

• parameters (GLib.Variant) –

• reply_type (GLib.VariantType) –

• flags (Gio.DBusCallFlags) –

• timeout_msec (int) –

• fd_list (Gio.UnixFDList or None) – a Gio.UnixFDList

Returns:

a Dex.FutureSet that resolves to a GLib.Variant. The Dex.Future containing the resulting Gio.UnixFDList can be retrieved with Dex.FutureSet.get_future_at() with an index of 1.

Return type:

Dex.Future

Wrapper for Gio.DBusConnection.call_with_unix_fd_list().

New in version 0.4.

Dex.dbus_connection_send_message_with_reply(connection, message, flags, timeout_msec)

Parameters:

• connection (Gio.DBusConnection) – a Gio.DBusConnection

• message (Gio.DBusMessage) – a Gio.DBusMessage

• flags (Gio.DBusSendMessageFlags) – flags for message

• timeout_msec (int) – timeout in milliseconds, or -1 for default, or GObject.G_MAXINT for no timeout.

Returns:

a Dex.Future that will resolve to a Gio.DBusMessage or reject with failure.

out_serial:

a location for the message serial number

Return type:

(Dex.Future, out_serial: int)

Wrapper for Gio.DBusConnection.send_message_with_reply().

New in version 0.4.

Dex.error_quark()

Return type:

int

Dex.file_copy(source, destination, flags, io_priority)

Parameters:

• source (Gio.File) – a Gio.File

• destination (Gio.File) – a Gio.File

• flags (Gio.FileCopyFlags) – the Gio.FileCopyFlags

• io_priority (int) – IO priority such as GLib.PRIORITY_DEFAULT

Returns:

a Dex.Future

Return type:

Dex.Future

Asynchronously copies a file and returns a Dex.Future which can be observed for the result.

Dex.file_enumerate_children(file, attributes, flags, io_priority)

Parameters:

• file (Gio.File) –

• attributes (str) –

• flags (Gio.FileQueryInfoFlags) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.file_enumerator_next_files(file_enumerator, num_files, io_priority)

Parameters:

• file_enumerator (Gio.FileEnumerator) –

• num_files (int) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.file_load_contents_bytes(file)

Parameters:

file (Gio.File) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.file_make_directory(file, io_priority)

Parameters:

• file (Gio.File) – a Gio.File

• io_priority (int) – IO priority such as GLib.PRIORITY_DEFAULT

Returns:

a Dex.Future

Return type:

Dex.Future

Asynchronously creates a directory and returns Dex.Future which can be observed for the result.

Dex.file_query_exists(file)

Parameters:

file (Gio.File) – a Gio.File

Returns:

a Dex.Future that will resolve with True if the file exists, otherwise reject with error.

Return type:

Dex.Future

Queries to see if file exists asynchronously.

New in version 0.6.

Dex.file_query_info(file, attributes, flags, io_priority)

Parameters:

• file (Gio.File) –

• attributes (str) –

• flags (Gio.FileQueryInfoFlags) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.file_read(file, io_priority)

Parameters:

• file (Gio.File) – a Gio.File

• io_priority (int) – IO priority such as GLib.PRIORITY_DEFAULT

Returns:

a Dex.Future

Return type:

Dex.Future

Asynchronously opens a file for reading.

Dex.file_replace(file, etag, make_backup, flags, io_priority)

Parameters:

• file (Gio.File) –

• etag (str) –

• make_backup (bool) –

• flags (Gio.FileCreateFlags) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.get_min_stack_size()

Return type:

int

Dex.get_page_size()

Return type:

int

Dex.init()

Dex.input_stream_close(self, io_priority)

Parameters:

• self (Gio.InputStream) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.input_stream_read(self, buffer, count, io_priority)

Parameters:

• self (Gio.InputStream) –

• buffer (object or None) –

• count (int) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.input_stream_read_bytes(self, count, io_priority)

Parameters:

• self (Gio.InputStream) –

• count (int) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.input_stream_skip(self, count, io_priority)

Parameters:

• self (Gio.InputStream) –

• count (int) – the number of bytes to skip

• io_priority (int) – GLib.PRIORITY_DEFAULT or similar priority value

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.io_stream_close(io_stream, io_priority)

Parameters:

• io_stream (Gio.IOStream) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.output_stream_close(self, io_priority)

Parameters:

• self (Gio.OutputStream) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.output_stream_splice(output, input, flags, io_priority)

Parameters:

• output (Gio.OutputStream) –

• input (Gio.InputStream) –

• flags (Gio.OutputStreamSpliceFlags) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.output_stream_write(self, buffer, count, io_priority)

Parameters:

• self (Gio.OutputStream) –

• buffer (object or None) –

• count (int) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.output_stream_write_bytes(self, bytes, io_priority)

Parameters:

• self (Gio.OutputStream) –

• bytes (GLib.Bytes) –

• io_priority (int) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.resolver_lookup_by_name(resolver, address)

Parameters:

• resolver (Gio.Resolver) –

• address (str) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.socket_client_connect(socket_client, socket_connectable)

Parameters:

• socket_client (Gio.SocketClient) –

• socket_connectable (Gio.SocketConnectable) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.socket_listener_accept(listener)

Parameters:

listener (Gio.SocketListener) –

Returns:

a Dex.Future

Return type:

Dex.Future

Dex.subprocess_wait_check(subprocess)

Parameters:

subprocess (Gio.Subprocess) – a Gio.Subprocess

Returns:

a Dex.Future that will resolve when subprocess exits cleanly or reject upon signal or non-successful exit.

Return type:

Dex.Future

Creates a future that awaits for subprocess to complete using Gio.Subprocess.wait_check_async().

New in version 0.4.

Dex.value_get_object(value)

Parameters:

value (GObject.Value) – a GValue initialized with type DEX_TYPE_OBJECT

Returns:

a DexObject

Return type:

Dex.Object or None

Retrieves the DexObject stored inside the given value.

New in version 0.4.

Dex.value_set_object(value, object)

Parameters:

• value (GObject.Value) – a [struct`GObject`.Value] initialized with type DEX_TYPE_OBJECT

• object (Dex.Object or None) – a DexObject or None

Stores the given DexObject inside value.

The [struct`GObject`.Value] will acquire a reference to the object.

New in version 0.4.

Dex.value_take_object(value, object)

Parameters:

• value (GObject.Value) – a [struct`GObject`.Value] initialized with type DEX_TYPE_OBJECT

• object (Dex.Object or None) – a DexObject

Stores the given DexObject inside value.

This function transfers the ownership of the object to the GValue.

New in version 0.4.