[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v2 02/15] python: add qemu package installer
From: |
John Snow |
Subject: |
[PATCH v2 02/15] python: add qemu package installer |
Date: |
Wed, 14 Oct 2020 10:29:44 -0400 |
Add setup.cfg and setup.py, necessary for installing a package via
pip. Add a rst document explaining the basics of what this package is
for and who to contact for more information. This document will be used
as the landing page for the package on PyPI.
I am not yet using a pyproject.toml style package manifest, because
using pyproject.toml (and PEP-517) style packages means that pip is not
able to install in "editable" or "develop" mode, which I consider
necessary for the development of this package.
Use a light-weight setup.py instead.
Signed-off-by: John Snow <jsnow@redhat.com>
---
python/PACKAGE.rst | 23 +++++++++++++++++++++++
python/setup.cfg | 18 ++++++++++++++++++
python/setup.py | 23 +++++++++++++++++++++++
3 files changed, 64 insertions(+)
create mode 100644 python/PACKAGE.rst
create mode 100755 python/setup.cfg
create mode 100755 python/setup.py
diff --git a/python/PACKAGE.rst b/python/PACKAGE.rst
new file mode 100644
index 0000000000..6e82f05606
--- /dev/null
+++ b/python/PACKAGE.rst
@@ -0,0 +1,23 @@
+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.core`` subpackage offers rudimentary facilities for launching
+QEMU and communicating with it via QMP. Refer to the module documentation
+(``>>> help(qemu.core)``) 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>`_. There is a `Gitlab
+mirror <https://gitlab.com/jsnow/qemu/-/tree/python>`_, but
+contributions must be sent to the list for inclusion.
diff --git a/python/setup.cfg b/python/setup.cfg
new file mode 100755
index 0000000000..12b99a796e
--- /dev/null
+++ b/python/setup.cfg
@@ -0,0 +1,18 @@
+[metadata]
+name = qemu
+maintainer = QEMU Developer Team
+maintainer_email = qemu-devel@nongnu.org
+url = https://www.qemu.org/
+download_url = https://www.qemu.org/download/
+description = QEMU Python Build, Debug and SDK tooling.
+long_description = file:PACKAGE.rst
+long_description_content_type = text/x-rst
+classifiers =
+ Development Status :: 3 - Alpha
+ License :: OSI Approved :: GNU General Public License v2 (GPLv2)
+ Natural Language :: English
+ Operating System :: OS Independent
+
+[options]
+python_requires = >= 3.6
+packages = find_namespace:
diff --git a/python/setup.py b/python/setup.py
new file mode 100755
index 0000000000..e93d0075d1
--- /dev/null
+++ b/python/setup.py
@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+"""
+QEMU tooling installer script
+Copyright (c) 2020 John Snow for Red Hat, Inc.
+"""
+
+import setuptools
+import pkg_resources
+
+
+def main():
+ """
+ QEMU tooling installer
+ """
+
+ #
https://medium.com/@daveshawley/safely-using-setup-cfg-for-metadata-1babbe54c108
+ pkg_resources.require('setuptools>=39.2')
+
+ setuptools.setup()
+
+
+if __name__ == '__main__':
+ main()
--
2.26.2
- [PATCH v2 00/15] python: create installable package, John Snow, 2020/10/14
- [PATCH v2 01/15] python: create qemu.core package, John Snow, 2020/10/14
- [PATCH v2 02/15] python: add qemu package installer,
John Snow <=
- [PATCH v2 03/15] python: add VERSION file, John Snow, 2020/10/14
- Re: [PATCH v2 03/15] python: add VERSION file, John Snow, 2020/10/14
- Re: [PATCH v2 03/15] python: add VERSION file, Andrea Bolognani, 2020/10/19
- Re: [PATCH v2 03/15] python: add VERSION file, Daniel P . Berrangé, 2020/10/19
- Re: [PATCH v2 03/15] python: add VERSION file, John Snow, 2020/10/19
- Re: [PATCH v2 03/15] python: add VERSION file, Andrea Bolognani, 2020/10/20
- Re: [PATCH v2 03/15] python: add VERSION file, Daniel P . Berrangé, 2020/10/20
- Re: [PATCH v2 03/15] python: add VERSION file, Andrea Bolognani, 2020/10/20
[PATCH v2 04/15] python: add directory structure README.rst files, John Snow, 2020/10/14