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.8
18 Programming Language :: Python :: 3.9
19 Programming Language :: Python :: 3.10
20 Programming Language :: Python :: 3.11
21 Programming Language :: Python :: 3.12
22 Programming Language :: Python :: 3.13
26 python_requires = >= 3.8
32 [options.package_data]
35 [options.extras_require]
36 # Remember to update tests/minreqs.txt if changing anything below:
38 avocado-framework >= 90.0
45 pylint != 3.2.4; python_version<"3.9"
48 urwid-readline >= 0.13
51 # Provides qom-fuse functionality
55 # QMP TUI dependencies
58 urwid-readline >= 0.13
61 [options.entry_points]
63 qom = qemu.utils.qom:main
64 qom-set = qemu.utils.qom:QOMSet.entry_point
65 qom-get = qemu.utils.qom:QOMGet.entry_point
66 qom-list = qemu.utils.qom:QOMList.entry_point
67 qom-tree = qemu.utils.qom:QOMTree.entry_point
68 qom-fuse = qemu.utils.qom_fuse:QOMFuse.entry_point [fuse]
69 qemu-ga-client = qemu.utils.qemu_ga_client:main
70 qmp-shell = qemu.qmp.qmp_shell:main
71 qmp-shell-wrap = qemu.qmp.qmp_shell:main_wrap
72 qmp-tui = qemu.qmp.qmp_tui:main [tui]
75 # Prefer pylint's bare-except checks to flake8's
77 exclude = __pycache__,
82 warn_unused_configs = True
83 namespace_packages = True
84 warn_unused_ignores = False
86 [mypy-qemu.utils.qom_fuse]
87 # fusepy has no type stubs:
88 allow_subclassing_any = True
90 [mypy-qemu.qmp.qmp_tui]
91 # urwid and urwid_readline have no type stubs:
92 allow_subclassing_any = True
94 # The following missing import directives are because these libraries do not
95 # provide type stubs. Allow them on an as-needed basis for mypy.
97 ignore_missing_imports = True
100 ignore_missing_imports = True
103 ignore_missing_imports = True
106 ignore_missing_imports = True
108 [mypy-urwid_readline]
109 ignore_missing_imports = True
112 ignore_missing_imports = True
115 ignore_missing_imports = True
117 [mypy-distlib.scripts]
118 ignore_missing_imports = True
120 [mypy-distlib.version]
121 ignore_missing_imports = True
123 [mypy-pip._vendor.distlib]
124 ignore_missing_imports = True
126 [mypy-pip._vendor.distlib.scripts]
127 ignore_missing_imports = True
129 [mypy-pip._vendor.distlib.version]
130 ignore_missing_imports = True
132 [pylint.messages control]
133 # Disable the message, report, category or checker with the given id(s). You
134 # can either give multiple identifiers separated by comma (,) or put this
135 # option multiple times (only on the command line, not in the configuration
136 # file where it should appear only once). You can also use "--disable=all" to
137 # disable everything first and then reenable specific checks. For example, if
138 # you want to run only the similarities checker, you can use "--disable=all
139 # --enable=similarities". If you want to run only the classes checker, but have
140 # no Warning level messages displayed, use "--disable=all --enable=classes
142 disable=consider-using-f-string,
145 too-many-function-args, # mypy handles this with less false positives.
146 too-many-instance-attributes,
147 no-member, # mypy also handles this better.
150 # Good variable names which should always be accepted, separated by a comma.
156 _, # By convention: Unused variable
158 fd, # fd = os.open(...)
159 c, # for c in string: ...
160 T, # for TypeVars. See pylint#3401
161 SocketAddrT, # Not sure why this is invalid.
163 [pylint.similarities]
164 # Ignore imports when computing similarities.
166 ignore-signatures=yes
168 # Minimum lines number of a similarity.
169 # TODO: Remove after we opt in to Pylint 2.8.3. See commit msg.
170 min-similarity-lines=6
175 force_sort_within_sections=True
176 include_trailing_comma=True
178 lines_after_imports=2
181 # tox (https://tox.readthedocs.io/) is a tool for running tests in
182 # multiple virtualenvs. This configuration file will run the test suite
183 # on all supported python versions. To use it, "pip install tox" and
184 # then run "tox" from this directory. You will need all of these versions
185 # of python available on your system to run this test.
188 envlist = py38, py39, py310, py311, py312, py313
189 skip_missing_interpreters = true
192 allowlist_externals = make
195 .[fuse] # Workaround to trigger tox venv rebuild
196 .[tui] # Workaround to trigger tox venv rebuild
200 # Coverage.py [https://coverage.readthedocs.io/en/latest/] is a tool for
201 # measuring code coverage of Python programs. It monitors your program,
202 # noting which parts of the code have been executed, then analyzes the
203 # source to identify code that could have been executed but was not.
206 concurrency = multiprocessing