TelepathyLogger.LogManager¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`dup_singleton` ()
class	`errors_quark` ()
	`exists` (account, target, type_mask)
	`get_dates_async` (account, target, type_mask, callback, *user_data)
	`get_dates_finish` (result)
	`get_entities_async` (account, callback, *user_data)
	`get_entities_finish` (result)
	`get_events_for_date_async` (account, target, type_mask, date, callback, *user_data)
	`get_events_for_date_finish` (result)
	`get_filtered_events_async` (account, target, type_mask, num_events, filter, filter_user_data, callback, *user_data)
	`get_filtered_events_finish` (result)
	`search_async` (text, type_mask, callback, *user_data)
	`walk_filtered_events` (account, target, type_mask, filter, *filter_data)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r
priv	`object`	r

Class Details¶

class TelepathyLogger.LogManager(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: TelepathyLogger.LogManagerClass

An object used to access logs

classmethod dup_singleton()¶

Returns:: a new reference on the log manager
Return type:: TelepathyLogger.LogManager

classmethod errors_quark()¶

Returns:: the #GQuark associated with the error domain of TelepathyLogger.LogManager
Return type:: int

exists(account, target, type_mask)¶

Parameters:

account (TelepathyGLib.Account) – TelepathyGLib.Account
target (TelepathyLogger.Entity) – a non-None TelepathyLogger.Entity
type_mask (int) – event type filter see TelepathyLogger.EventTypeMask

Returns:

True logs exist for target, otherwise False

Return type:

bool

Checks if logs exist for target.

It applies for any registered TplLogStore with the TplLogStore:readable property True.

get_dates_async(account, target, type_mask, callback, *user_data)¶

Parameters:

account (TelepathyGLib.Account) – a TelepathyGLib.Account
target (TelepathyLogger.Entity) – a non-None TelepathyLogger.Entity
type_mask (int) – event type filter see TelepathyLogger.EventTypeMask
callback (Gio.AsyncReadyCallback or None) – a callback to call when the request is satisfied
user_data (object or None) – data to pass to callback

Retrieves a list of GLib.Date corresponding to each day where at least one event exist for target.

It applies for any registered TplLogStore with the TplLogStore:readable property True.

get_dates_finish(result)¶

Parameters:

result (Gio.AsyncResult) – a Gio.AsyncResult

Raises:

GLib.Error

Returns:

True if the operation was successful, otherwise False

dates:: a pointer to a GLib.List used to return the list of GLib.Date

Return type:

(bool, dates: [GLib.Date])

get_entities_async(account, callback, *user_data)¶

Parameters:

account (TelepathyGLib.Account) – a TelepathyGLib.Account
callback (Gio.AsyncReadyCallback or None) – a callback to call when the request is satisfied
user_data (object or None) – data to pass to callback

Start a query looking for all entities for which you have logs in the account.

get_entities_finish(result)¶

Parameters:

result (Gio.AsyncResult) – a Gio.AsyncResult

Raises:

GLib.Error

Returns:

True if the operation was successful, otherwise False

entities:: a pointer to a GLib.List used to return the list of TelepathyLogger.Entity, to be freed using something like g_list_free_full (lst, GObject.Object.unref)

Return type:

(bool, entities: [TelepathyLogger.Entity])

get_events_for_date_async(account, target, type_mask, date, callback, *user_data)¶

Parameters:

account (TelepathyGLib.Account) – a TelepathyGLib.Account
target (TelepathyLogger.Entity) – a non-None TelepathyLogger.Entity
type_mask (int) – event type filter see TelepathyLogger.EventTypeMask
date (GLib.Date) – a GLib.Date
callback (Gio.AsyncReadyCallback or None) – a callback to call when the request is satisfied
user_data (object or None) – data to pass to callback

Retrieve a list of TelepathyLogger.Event at date with target.

get_events_for_date_finish(result)¶

Parameters:

result (Gio.AsyncResult) – a Gio.AsyncResult

Raises:

GLib.Error

Returns:

True if the operation was successful, otherwise False

events:: a pointer to a GLib.List used to return the list of TelepathyLogger.Event

Return type:

(bool, events: [TelepathyLogger.Event])

get_filtered_events_async(account, target, type_mask, num_events, filter, filter_user_data, callback, *user_data)¶

Parameters:

account (TelepathyGLib.Account) – a TelepathyGLib.Account
target (TelepathyLogger.Entity) – a non-None TelepathyLogger.Entity
type_mask (int) – event type filter see TelepathyLogger.EventTypeMask
num_events (int) – number of maximum events to fetch
filter (TelepathyLogger.LogEventFilter or None) – an optional filter function
filter_user_data (object or None) – user data to pass to filter
callback (Gio.AsyncReadyCallback or None) – a callback to call when the request is satisfied
user_data (object or None) – data to pass to callback

Retrieve the most recent num_event events exchanged with target.

get_filtered_events_finish(result)¶

Parameters:

result (Gio.AsyncResult) – a Gio.AsyncResult

Raises:

GLib.Error

Returns:

True if the operation was successful, otherwise False.

events:: a pointer to a GLib.List used to return the list TelepathyLogger.Event

Return type:

(bool, events: [TelepathyLogger.Event])

search_async(text, type_mask, callback, *user_data)¶

Parameters:

text (str) – the pattern to search
type_mask (int) – event type filter see TelepathyLogger.EventTypeMask
callback (Gio.AsyncReadyCallback or None) – a callback to call when the request is satisfied
user_data (object or None) – data to pass to callback

Search for all the conversations containing text.

walk_filtered_events(account, target, type_mask, filter, *filter_data)¶

Parameters:

account (TelepathyGLib.Account) – a TelepathyGLib.Account
target (TelepathyLogger.Entity) – a non-None TelepathyLogger.Entity
type_mask (int) – event type filter see TelepathyLogger.EventTypeMask
filter (TelepathyLogger.LogEventFilter or None) – an optional filter function
filter_data (object or None) – user data to pass to filter

Returns:

a TelepathyLogger.LogWalker

Return type:

TelepathyLogger.LogWalker

Create a TelepathyLogger.LogWalker to traverse all the events exchanged with target.