GI Documentation¶
This is the API provided by the toplevel “gi” package.
-
gi.require_version(namespace, version)¶ Parameters: - namespace (str) – The namespace
- version (str) – The version of the namespace which should be loaded
Raises: ValueErrorEnsures the namespace gets loaded with the given version. If the namespace was already loaded with a different version or a different version was required previously raises ValueError.
import gi gi.require_version('Gtk', '3.0')
-
gi.require_foreign(namespace, symbol=None)¶ Parameters: - namespace (str) – Introspection namespace of the foreign module (e.g. “cairo”)
- symbol (
strorNone) – Optional symbol typename to ensure a converter exists.
Raises: ImportErrorEnsure the given foreign marshaling module is available and loaded.
Example:
import gi import cairo gi.require_foreign('cairo') gi.require_foreign('cairo', 'Surface')
-
gi.check_version(version)¶ Parameters: version (tuple) – A version tuple Raises: ValueErrorCompares the passed in version tuple with the gi version and does nothing if gi version is the same or newer. Otherwise raises ValueError.
-
gi.get_required_version(namespace)¶ Returns: The version successfully required previously by gi.require_version()orNoneReturn type: str or None
-
gi.version_info= (3, 18, 1)¶ The version of PyGObject
-
class
gi.PyGIDeprecationWarning¶ The warning class used for deprecations in PyGObject and the included Python overrides. It inherits from DeprecationWarning and is hidden by default.
-
class
gi.PyGIWarning¶ Like
gi.PyGIDeprecationWarningbut visible by default.