2018-12-25 18:59:11 +01:00
|
|
|
=============================
|
|
|
|
Working with external plugins
|
|
|
|
=============================
|
2018-11-20 11:33:07 +01:00
|
|
|
|
|
|
|
|
2018-12-25 19:11:56 +01:00
|
|
|
|qp| has very few executables out of the box. Most of the time, external
|
|
|
|
plugins need to be downloaded and installed in the ``$QP_ROOT/plugins``
|
|
|
|
directory.
|
2018-11-20 11:33:07 +01:00
|
|
|
|
2019-01-10 18:57:58 +01:00
|
|
|
Plugins are usually hosted in external repositories. To download a plugin,
|
2018-12-25 19:11:56 +01:00
|
|
|
the remote repository needs to be downloaded, and the plugins of the
|
|
|
|
repository can be selected for installation.
|
2018-11-20 11:33:07 +01:00
|
|
|
|
2018-12-25 19:11:56 +01:00
|
|
|
To download an external repository of plugins, run the following command:
|
2018-11-20 11:33:07 +01:00
|
|
|
|
2018-12-25 19:11:56 +01:00
|
|
|
.. code-block:: bash
|
2018-11-20 11:33:07 +01:00
|
|
|
|
2018-12-25 19:11:56 +01:00
|
|
|
qp_plugins download http://somewhere/over/the/rainbow/ext_repo
|
|
|
|
|
|
|
|
|
|
|
|
This downloads a copy of the repository of external plugins :file:`ext_repo`
|
|
|
|
in :file:`$QP_ROOT/plugins`.
|
|
|
|
|
|
|
|
The list of available uninstalled plugins can be seen using:
|
|
|
|
|
2018-12-28 19:50:28 +01:00
|
|
|
.. code-block:: bash
|
2018-12-25 19:11:56 +01:00
|
|
|
|
|
|
|
qp_plugins list -u
|
|
|
|
|
|
|
|
|
|
|
|
Now, the specific plugin :file:`ext_module` contained in the repository
|
|
|
|
:file:`ext_repo` can be installed using:
|
|
|
|
|
2018-12-28 19:50:28 +01:00
|
|
|
.. code-block:: bash
|
2018-12-25 19:11:56 +01:00
|
|
|
|
|
|
|
qp_plugins install ext_module
|
|
|
|
|
|
|
|
|
|
|
|
The module is now accessible via a symbolic link in :file:`$QP_ROOT/src`,
|
|
|
|
and can be compiled as any module, running |Ninja|.
|
|
|
|
|
|
|
|
|
|
|
|
To remove the module, run
|
|
|
|
|
2018-12-28 19:50:28 +01:00
|
|
|
.. code-block:: bash
|
2018-12-25 19:11:56 +01:00
|
|
|
|
|
|
|
qp_plugins uninstall ext_module
|
2018-11-20 11:33:07 +01:00
|
|
|
|
|
|
|
|
2019-01-10 18:57:58 +01:00
|
|
|
For a more detailed explanation and an example, see :ref:`qp_plugins`.
|
2018-11-20 11:33:07 +01:00
|
|
|
|