Foundry.DocumentationManager

g Foundry.Contextual Foundry.Contextual Foundry.Service Foundry.Service Foundry.Contextual->Foundry.Service Foundry.DocumentationManager Foundry.DocumentationManager Foundry.Service->Foundry.DocumentationManager GObject.GInterface GObject.GInterface Json.Serializable Json.Serializable GObject.GInterface->Json.Serializable GObject.Object GObject.Object GObject.Object->Foundry.Contextual Json.Serializable->Foundry.Contextual

Subclasses:

None

Methods

Inherited:

Foundry.Service (8), Foundry.Contextual (4), GObject.Object (37), Json.Serializable (8)

Structs:

Foundry.ServiceClass (3), GObject.ObjectClass (5)

find_by_uri (uri)

index ()

is_indexing ()

list_bundles ()

list_children (parent)

query (query)

Virtual Methods

Inherited:

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

Properties

Inherited:

Foundry.Contextual (1)

Name

Type

Flags

Short Description

indexing

bool

r

Signals

Inherited:

GObject.Object (1)

Name

Short Description

changed

Fields

Inherited:

GObject.Object (1)

Class Details

class Foundry.DocumentationManager(**kwargs)
Bases:

Foundry.Service

Abstract:

No

Structure:

Foundry.DocumentationManagerClass

Service that manages documentation plugins.

find_by_uri(uri)
Parameters:

uri (str) –

Returns:

a [class`Dex`.Future] that resolves to a [class`Foundry`.Documentation] or rejects with error.

Return type:

Dex.Future

index()
Return type:

Dex.Future

Ensures the documentation manager has indexed.

This happens on demand but can be forced to start earlier by applications which may want to delay operations until this part has completed. Such an example is to now show a window until the initial indexing has completed.

is_indexing()
Return type:

bool

If the documentation manager is currently indexing.

list_bundles()
Returns:

a [class`Dex`.Future] that resolves to a [iface`Gio`.ListModel] of [class`Foundry`.DocumentationBundle] or rejects with error.

Return type:

Dex.Future

list_children(parent)
Parameters:

parent (Foundry.Documentation) –

Returns:

a [class`Dex`.Future] that resolves to a [iface`Gio`.ListModel] or rejects with error.

Return type:

Dex.Future

query(query)
Parameters:

query (Foundry.DocumentationQuery) – a [class`Foundry`.DocumentationQuery]

Returns:

a [class`Dex`.Future] that resolves to [Foundry.DocumentationMatches].

Return type:

Dex.Future

Consumers can call [method`Foundry`.DocumentationMatches.await] to get a future that will complete when all matches have been populated.

Signal Details

Foundry.DocumentationManager.signals.changed(documentation_manager)
Signal Name:

changed

Flags:

RUN_LAST

Parameters:

documentation_manager (Foundry.DocumentationManager) – The object which received the signal

Property Details

Foundry.DocumentationManager.props.indexing
Name:

indexing

Type:

bool

Default Value:

False

Flags:

READABLE

If the documentation is currently indexing documentation.