Class
IdePipeline
Instance methods
ide_pipeline_add_error_format
This can be used to add a regex that will extract errors from standard output. This is similar to the “errorformat” feature of vim to extract warnings from standard output.
Available since: 3.32
ide_pipeline_add_log_observer
ide_pipeline_addin_find_by_module_name
Finds the addin (if any) matching the plugin’s module_name
.
Available since: 3.40
ide_pipeline_attach
Insert stage
into the pipeline as part of the phase denoted by phase
.
Available since: 3.32
ide_pipeline_attach_launcher
This creates a new stage that will spawn a process using launcher
and log
the output of stdin/stdout.
Available since: 3.32
ide_pipeline_attach_pty
Attaches a PTY to stdin/stdout/stderr of the IdeSubprocessLauncher
.
This is useful if the application can take advantage of a PTY for
features like colors and other escape sequences.
Available since: 3.32
ide_pipeline_build_builddir_path
This is a convenience function to create a new path that starts with the build directory for this build configuration.
Available since: 3.32
ide_pipeline_build_finish
This function completes the asynchronous request to build up to a particular phase of the build pipeline.
Available since: 3.32
ide_pipeline_build_srcdir_path
This is a convenience function to create a new path that starts with the source directory of the project.
Available since: 3.32
ide_pipeline_build_targets_finish
This function completes the asynchronous request to build up to a particular phase and targets of the build pipeline.
Available since: 3.32
ide_pipeline_clean_async
ide_pipeline_clean_finish
ide_pipeline_contains_program_in_path
Looks through the runtime and SDK extensions for binaries matching
name
that may be executed.
Available since: 3.34
ide_pipeline_create_launcher
This is a convenience function to create a new IdeSubprocessLauncher
using the configuration and runtime associated with the pipeline.
Available since: 3.32
ide_pipeline_detach
This removes the stage matching stage_id
. You are returned a stage_id
when
inserting a stage with functions such as ide_pipeline_attach()
or ide_pipeline_attach_launcher().
Available since: 3.32
ide_pipeline_emit_diagnostic
ide_pipeline_foreach_stage
This function will call stage_callback
for every IdePipelineStage
registered
in the pipeline.
Available since: 3.32
ide_pipeline_get_arch
ide_pipeline_get_builddir
Gets the “builddir” to be used for the build process. This is generally the location that build systems will use for out-of-tree builds.
Available since: 3.32
ide_pipeline_get_busy
ide_pipeline_get_can_export
This function is useful to discover if there are any pipeline addins which implement the export phase. UI or GAction implementations may want to use this value to set the enabled state of the action or sensitivity of a button.
Available since: 3.32
ide_pipeline_get_host_triplet
Gets the “host” triplet which specifies where the build results will run.
Available since: 3.32
ide_pipeline_get_message
Gets the current message for the build pipeline. This can be shown to users in UI elements to signify progress in the build.
Available since: 3.32
ide_pipeline_get_phase
Gets the current phase that is executing. This is only useful during execution of the pipeline.
Available since: 3.32
ide_pipeline_get_requested_phase
Gets the phase that has been requested. This can be useful when you want to get an idea of where the build pipeline will attempt to advance.
Available since: 3.32
ide_pipeline_get_runtime
A convenience function to get the runtime for a build pipeline.
Available since: 3.32
ide_pipeline_get_srcdir
Gets the “srcdir” of the project. This is equivalent to the IdeVcs:working-directory property as a string.
Available since: 3.32
ide_pipeline_get_stage_by_id
Gets the stage matching the identifier stage_id
as returned from ide_pipeline_attach().
Available since: 3.32
ide_pipeline_get_toolchain
A convenience function to get the toolchain for a build pipeline.
Available since: 3.32
ide_pipeline_has_configured
Checks to see if the pipeline has advanced far enough to ensure that the configure stage has been reached.
Available since: 3.32
ide_pipeline_is_native
This is a helper to check if the triplet that we are compiling for matches the host system. That allows some plugins to do less work by avoiding some cross-compiling work.
Available since: 3.32
ide_pipeline_is_ready
Checks to see if the pipeline has been loaded. Loading may be delayed due to various initialization routines that need to complete.
Available since: 3.32
ide_pipeline_rebuild_async
Asynchronously starts the build pipeline after cleaning any existing build artifacts.
Available since: 3.32
ide_pipeline_rebuild_finish
ide_pipeline_ref_toolchain
Thread-safe variant of ide_pipeline_get_toolchain().
Available since: 3.32
ide_pipeline_remove_error_format
Removes an error format that was registered with ide_pipeline_add_error_format().
Available since: 3.32
ide_pipeline_remove_log_observer
ide_pipeline_request_phase
Requests that the next execution of the pipeline will build up to phase
including all stages that were previously invalidated.
Available since: 3.32
Methods inherited from IdeObject (28)
Methods inherited from GObject (43)
Methods inherited from GInitable (1)
Methods inherited from GListModel (5)
g_list_model_get_item
Get the item at position
. If position
is greater than the number of
items in list
, NULL
is returned.
Available since: 2.44
g_list_model_get_item_type
Gets the type of the items in list
. All items returned from
g_list_model_get_type()
are of that type or a subtype, or are an
implementation of that interface.
Available since: 2.44
g_list_model_get_n_items
Gets the number of items in list
.
Available since: 2.44
g_list_model_get_object
Get the item at position
. If position
is greater than the number of
items in list
, NULL
is returned.
Available since: 2.44
g_list_model_items_changed
Emits the GListModel::items-changed
signal on list
.
Available since: 2.44
Properties
Ide.Pipeline:busy
Gets the “busy” property. If TRUE
, the pipeline is busy executing.
Available since: 3.32
Ide.Pipeline:config
Ide.Pipeline:message
The “message” property is descriptive text about what the the pipeline is doing or it’s readiness status.
Available since: 3.32
Ide.Pipeline:pty
The “pty” property is the VtePty
that is used by build stages that
build subprocesses with a pseudo terminal.
Available since: 3.32
Properties inherited from IdeObject (2)
Ide.Object:cancellable
The “cancellable” property is a GCancellable
that can be used by operations
that will be cancelled when the IdeObject::destroy
signal is emitted on self
.
Available since: 3.32
Ide.Object:parent
The parent IdeObject
, if any.
Available since: 3.32
Signals
Ide.Pipeline::diagnostic
This signal is emitted when a plugin has detected a diagnostic while building the pipeline.
Available since: 3.32
Ide.Pipeline::finished
This signal is emitted when the build process has finished executing.
If the build failed to complete all requested stages, then failed
will
be set to TRUE
, otherwise FALSE
.
Available since: 3.32
Ide.Pipeline::launcher-created
The “launcher-created” signal is emitted when a new
IdeSubprocessLauncher
is created by the pipeline. This may be useful
to plugins that wan to modify the launcher in a consistent way for all
pipeline consumers.
Available since: 3.34
Ide.Pipeline::loaded
The “loaded” signal is emitted after the pipeline has finished loading addins.
Available since: 3.32
Ide.Pipeline::started
This signal is emitted when the pipeline has started executing in
response to ide_pipeline_build_async()
being called.
Available since: 3.32
Signals inherited from IdeObject (1)
Ide.Object::destroy
The “destroy” signal is emitted when the object should destroy itself and cleanup any state that is no longer necessary. This happens when the object has been removed from the because it was requested to be destroyed, or because a parent object is being destroyed.
Available since: 3.32
Signals inherited from GObject (1)
GObject.Object::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.
Signals inherited from GListModel (1)
Gio.ListModel::items-changed
This signal is emitted whenever items were added to or removed
from list
. At position
, removed
items were removed and added
items were added in their place.
Available since: 2.44