Functions¶

	`check_version` (required_major, required_minor, required_micro)
	`sparql_error_quark` ()
	`sparql_escape_string` (literal)
	`sparql_escape_uri` (uri)
	`sparql_get_ontology_nepomuk` ()
	`sparql_get_uuid_urn` ()

Details¶

Tracker.check_version(required_major, required_minor, required_micro)¶

Parameters:

required_major (int) – the required major version.
required_minor (int) – the required minor version.
required_micro (int) – the required micro version.

Returns:

None if the Tracker library is compatible with the given version, or a string describing the version mismatch.

Return type:

str

Checks that the Tracker library in use is compatible with the given version.

Generally you would pass in the constants [const`Tracker`.MAJOR_VERSION], [const`Tracker`.MINOR_VERSION], [const`Tracker`.MICRO_VERSION] as the three arguments to this function; that produces a check that the library in use is compatible with the version of Tracker the application or module was compiled against.

Compatibility is defined by two things: first the version of the running library is newer than the version required_major.`required_minor`.`required_micro`. Second the running library must be binary compatible with the version required_major.`required_minor`.`required_micro` (same major version.)

Tracker.sparql_error_quark()¶

Return type:: int

Tracker.sparql_escape_string(literal)¶

Parameters:: literal (str) – a string to escape
Returns:: the escaped string
Return type:: str

Escapes literal so it is suitable for insertion in SPARQL queries as string literals.

Manual construction of query strings based user input is best avoided at all cost, use of Tracker.SparqlStatement is recommended instead.

Tracker.sparql_escape_uri(uri)¶

Parameters:: uri (str) – a string to be escaped, following the tracker sparql rules
Returns:: a newly-allocated string holding the result.
Return type:: str

Escapes a string for use as a URI.

Tracker.sparql_get_ontology_nepomuk()¶

Returns:: a Gio.File instance.
Return type:: Gio.File

Returns a path to the built-in Nepomuk ontologies.

Tracker.sparql_get_uuid_urn()¶

Returns:: A newly generated UUID URN.
Return type:: str

Creates a fresh UUID-based URN.