4 maintainer = QEMU Developer Team
5 maintainer_email = qemu-devel@nongnu.org
6 url = https://www.qemu.org/
7 download_url = https://www.qemu.org/download/
8 description = QEMU Python Build, Debug and SDK tooling.
9 long_description = file:PACKAGE.rst
10 long_description_content_type = text/x-rst
12 Development Status :: 3 - Alpha
13 License :: OSI Approved :: GNU General Public License v2 (GPLv2)
14 Natural Language :: English
15 Operating System :: OS Independent
16 Programming Language :: Python :: 3 :: Only
17 Programming Language :: Python :: 3.7
18 Programming Language :: Python :: 3.8
19 Programming Language :: Python :: 3.9
20 Programming Language :: Python :: 3.10
21 Programming Language :: Python :: 3.11
25 python_requires = >= 3.7
31 [options.package_data]
34 [options.extras_require]
35 # Remember to update tests/minreqs.txt if changing anything below:
37 avocado-framework >= 90.0
46 urwid-readline >= 0.13
49 # Provides qom-fuse functionality
53 # QMP TUI dependencies
56 urwid-readline >= 0.13
59 [options.entry_points]
61 qom = qemu.utils.qom:main
62 qom-set = qemu.utils.qom:QOMSet.entry_point
63 qom-get = qemu.utils.qom:QOMGet.entry_point
64 qom-list = qemu.utils.qom:QOMList.entry_point
65 qom-tree = qemu.utils.qom:QOMTree.entry_point
66 qom-fuse = qemu.utils.qom_fuse:QOMFuse.entry_point [fuse]
67 qemu-ga-client = qemu.utils.qemu_ga_client:main
68 qmp-shell = qemu.qmp.qmp_shell:main
69 qmp-shell-wrap = qemu.qmp.qmp_shell:main_wrap
70 qmp-tui = qemu.qmp.qmp_tui:main [tui]
73 # Prefer pylint's bare-except checks to flake8's
75 exclude = __pycache__,
80 warn_unused_configs = True
81 namespace_packages = True
82 warn_unused_ignores = False
84 [mypy-qemu.utils.qom_fuse]
85 # fusepy has no type stubs:
86 allow_subclassing_any = True
88 [mypy-qemu.qmp.qmp_tui]
89 # urwid and urwid_readline have no type stubs:
90 allow_subclassing_any = True
92 # The following missing import directives are because these libraries do not
93 # provide type stubs. Allow them on an as-needed basis for mypy.
95 ignore_missing_imports = True
98 ignore_missing_imports = True
100 [mypy-urwid_readline]
101 ignore_missing_imports = True
104 ignore_missing_imports = True
106 [mypy-importlib.metadata]
107 ignore_missing_imports = True
109 [mypy-importlib_metadata]
110 ignore_missing_imports = True
113 ignore_missing_imports = True
116 ignore_missing_imports = True
118 [mypy-distlib.database]
119 ignore_missing_imports = True
121 [mypy-distlib.scripts]
122 ignore_missing_imports = True
124 [mypy-distlib.version]
125 ignore_missing_imports = True
128 ignore_missing_imports = True
131 ignore_missing_imports = True
133 [mypy-pip._vendor.distlib]
134 ignore_missing_imports = True
136 [mypy-pip._vendor.distlib.database]
137 ignore_missing_imports = True
139 [mypy-pip._vendor.distlib.scripts]
140 ignore_missing_imports = True
142 [mypy-pip._vendor.distlib.version]
143 ignore_missing_imports = True
145 [pylint.messages control]
146 # Disable the message, report, category or checker with the given id(s). You
147 # can either give multiple identifiers separated by comma (,) or put this
148 # option multiple times (only on the command line, not in the configuration
149 # file where it should appear only once). You can also use "--disable=all" to
150 # disable everything first and then reenable specific checks. For example, if
151 # you want to run only the similarities checker, you can use "--disable=all
152 # --enable=similarities". If you want to run only the classes checker, but have
153 # no Warning level messages displayed, use "--disable=all --enable=classes
155 disable=consider-using-f-string,
158 too-many-function-args, # mypy handles this with less false positives.
159 too-many-instance-attributes,
160 no-member, # mypy also handles this better.
163 # Good variable names which should always be accepted, separated by a comma.
169 _, # By convention: Unused variable
171 fd, # fd = os.open(...)
172 c, # for c in string: ...
173 T, # for TypeVars. See pylint#3401
174 SocketAddrT, # Not sure why this is invalid.
176 [pylint.similarities]
177 # Ignore imports when computing similarities.
179 ignore-signatures=yes
181 # Minimum lines number of a similarity.
182 # TODO: Remove after we opt in to Pylint 2.8.3. See commit msg.
183 min-similarity-lines=6
188 force_sort_within_sections=True
189 include_trailing_comma=True
191 lines_after_imports=2
194 # tox (https://tox.readthedocs.io/) is a tool for running tests in
195 # multiple virtualenvs. This configuration file will run the test suite
196 # on all supported python versions. To use it, "pip install tox" and
197 # then run "tox" from this directory. You will need all of these versions
198 # of python available on your system to run this test.
201 envlist = py37, py38, py39, py310, py311
202 skip_missing_interpreters = true
205 allowlist_externals = make
208 .[fuse] # Workaround to trigger tox venv rebuild
209 .[tui] # Workaround to trigger tox venv rebuild
213 # Coverage.py [https://coverage.readthedocs.io/en/latest/] is a tool for
214 # measuring code coverage of Python programs. It monitors your program,
215 # noting which parts of the code have been executed, then analyzes the
216 # source to identify code that could have been executed but was not.
219 concurrency = multiprocessing