mirror of
https://gitlab.com/qemu-project/qemu
synced 2024-10-16 07:52:46 +00:00
dbe75f5566
setuptools doesn't have a formal understanding of development requires, but it has an optional feataures section. Fine; add a "devel" feature and add the requirements to it. To avoid duplication, we can modify pipenv to install qemu[devel] instead. This enables us to run invocations like "pip install -e .[devel]" and test the package on bleeding-edge packages beyond those specified in Pipfile.lock. Importantly, this also allows us to install the qemu development packages in a non-networked mode: `pip3 install --no-index -e .[devel]` will now fail if the proper development dependencies are not already met. This can be useful for automated build scripts where fetching network packages may be undesirable. Signed-off-by: John Snow <jsnow@redhat.com> Reviewed-by: Cleber Rosa <crosa@redhat.com> Message-id: 20210527211715.394144-27-jsnow@redhat.com Signed-off-by: John Snow <jsnow@redhat.com>
38 lines
1.3 KiB
ReStructuredText
38 lines
1.3 KiB
ReStructuredText
QEMU Python Tooling
|
|
===================
|
|
|
|
This package provides QEMU tooling used by the QEMU project to build,
|
|
configure, and test QEMU. It is not a fully-fledged SDK and it is subject
|
|
to change at any time.
|
|
|
|
Usage
|
|
-----
|
|
|
|
The ``qemu.qmp`` subpackage provides a library for communicating with
|
|
QMP servers. The ``qemu.machine`` subpackage offers rudimentary
|
|
facilities for launching and managing QEMU processes. Refer to each
|
|
package's documentation
|
|
(``>>> help(qemu.qmp)``, ``>>> help(qemu.machine)``)
|
|
for more information.
|
|
|
|
Contributing
|
|
------------
|
|
|
|
This package is maintained by John Snow <jsnow@redhat.com> as part of
|
|
the QEMU source tree. Contributions are welcome and follow the `QEMU
|
|
patch submission process
|
|
<https://wiki.qemu.org/Contribute/SubmitAPatch>`_, which involves
|
|
sending patches to the QEMU development mailing list.
|
|
|
|
John maintains a `GitLab staging branch
|
|
<https://gitlab.com/jsnow/qemu/-/tree/python>`_, and there is an
|
|
official `GitLab mirror <https://gitlab.com/qemu-project/qemu>`_.
|
|
|
|
Please report bugs on the `QEMU issue tracker
|
|
<https://gitlab.com/qemu-project/qemu/-/issues>`_ and tag ``@jsnow`` in
|
|
the report.
|
|
|
|
Optional packages necessary for running code quality analysis for this
|
|
package can be installed with the optional dependency group "devel":
|
|
``pip install qemu[devel]``.
|