xref: /qemu/python/setup.cfg (revision 4cd17f375daaa73f0f6fd214e08e2290d86c24be)
1ea1213b7SJohn Snow[metadata]
2ea1213b7SJohn Snowname = qemu
33afc3290SJohn Snowversion = file:VERSION
4ea1213b7SJohn Snowmaintainer = QEMU Developer Team
5ea1213b7SJohn Snowmaintainer_email = qemu-devel@nongnu.org
6ea1213b7SJohn Snowurl = https://www.qemu.org/
7ea1213b7SJohn Snowdownload_url = https://www.qemu.org/download/
8ea1213b7SJohn Snowdescription = QEMU Python Build, Debug and SDK tooling.
9ea1213b7SJohn Snowlong_description = file:PACKAGE.rst
10ea1213b7SJohn Snowlong_description_content_type = text/x-rst
11ea1213b7SJohn Snowclassifiers =
12ea1213b7SJohn Snow    Development Status :: 3 - Alpha
13ea1213b7SJohn Snow    License :: OSI Approved :: GNU General Public License v2 (GPLv2)
14ea1213b7SJohn Snow    Natural Language :: English
15ea1213b7SJohn Snow    Operating System :: OS Independent
16ea1213b7SJohn Snow    Programming Language :: Python :: 3 :: Only
173c8de38cSJohn Snow    Programming Language :: Python :: 3.6
183c8de38cSJohn Snow    Programming Language :: Python :: 3.7
193c8de38cSJohn Snow    Programming Language :: Python :: 3.8
203c8de38cSJohn Snow    Programming Language :: Python :: 3.9
213c8de38cSJohn Snow    Programming Language :: Python :: 3.10
227f179082SJohn Snow    Typing :: Typed
23ea1213b7SJohn Snow
24ea1213b7SJohn Snow[options]
25ea1213b7SJohn Snowpython_requires = >= 3.6
26ea1213b7SJohn Snowpackages =
27ea1213b7SJohn Snow    qemu.qmp
28ea1213b7SJohn Snow    qemu.machine
29ea1213b7SJohn Snow    qemu.utils
30a093a655SJohn Snow    qemu.aqmp
31ef42440dSJohn Snow
327f179082SJohn Snow[options.package_data]
337f179082SJohn Snow* = py.typed
347f179082SJohn Snow
35dbe75f55SJohn Snow[options.extras_require]
363afa3501SJohn Snow# For the devel group, When adding new dependencies or bumping the minimum
373afa3501SJohn Snow# version, use e.g. "pipenv install --dev pylint==3.0.0".
383afa3501SJohn Snow# Subsequently, edit 'Pipfile' to remove e.g. 'pylint = "==3.0.0'.
39dbe75f55SJohn Snowdevel =
4031622b2aSJohn Snow    avocado-framework >= 87.0
41dbe75f55SJohn Snow    flake8 >= 3.6.0
42c63f3b0bSJohn Snow    fusepy >= 2.0.4
43dbe75f55SJohn Snow    isort >= 5.1.2
44dbe75f55SJohn Snow    mypy >= 0.770
45dbe75f55SJohn Snow    pylint >= 2.8.0
463c8de38cSJohn Snow    tox >= 3.18.0
47dbe75f55SJohn Snow
48c63f3b0bSJohn Snow# Provides qom-fuse functionality
49c63f3b0bSJohn Snowfuse =
50c63f3b0bSJohn Snow    fusepy >= 2.0.4
51c63f3b0bSJohn Snow
527c4c595fSJohn Snow[options.entry_points]
537c4c595fSJohn Snowconsole_scripts =
547c4c595fSJohn Snow    qom = qemu.qmp.qom:main
557c4c595fSJohn Snow    qom-set = qemu.qmp.qom:QOMSet.entry_point
567c4c595fSJohn Snow    qom-get = qemu.qmp.qom:QOMGet.entry_point
577c4c595fSJohn Snow    qom-list = qemu.qmp.qom:QOMList.entry_point
587c4c595fSJohn Snow    qom-tree = qemu.qmp.qom:QOMTree.entry_point
59176c5490SJohn Snow    qom-fuse = qemu.qmp.qom_fuse:QOMFuse.entry_point [fuse]
607e7c2a0dSJohn Snow    qemu-ga-client = qemu.qmp.qemu_ga_client:main
61957f3c5cSJohn Snow    qmp-shell = qemu.qmp.qmp_shell:main
627c4c595fSJohn Snow
6381f8c446SJohn Snow[flake8]
6481f8c446SJohn Snowextend-ignore = E722  # Prefer pylint's bare-except checks to flake8's
6521d0b866SJohn Snowexclude = __pycache__,
6681f8c446SJohn Snow
67e941c844SJohn Snow[mypy]
68e941c844SJohn Snowstrict = True
69e941c844SJohn Snowpython_version = 3.6
70e941c844SJohn Snowwarn_unused_configs = True
710542a4c9SJohn Snownamespace_packages = True
72e941c844SJohn Snow
7330ec845cSJohn Snow[mypy-qemu.qmp.qom_fuse]
7430ec845cSJohn Snow# fusepy has no type stubs:
7530ec845cSJohn Snowallow_subclassing_any = True
7630ec845cSJohn Snow
7730ec845cSJohn Snow[mypy-fuse]
7830ec845cSJohn Snow# fusepy has no type stubs:
7930ec845cSJohn Snowignore_missing_imports = True
8030ec845cSJohn Snow
81ef42440dSJohn Snow[pylint.messages control]
82ef42440dSJohn Snow# Disable the message, report, category or checker with the given id(s). You
83ef42440dSJohn Snow# can either give multiple identifiers separated by comma (,) or put this
84ef42440dSJohn Snow# option multiple times (only on the command line, not in the configuration
85ef42440dSJohn Snow# file where it should appear only once). You can also use "--disable=all" to
86ef42440dSJohn Snow# disable everything first and then reenable specific checks. For example, if
87ef42440dSJohn Snow# you want to run only the similarities checker, you can use "--disable=all
88ef42440dSJohn Snow# --enable=similarities". If you want to run only the classes checker, but have
89ef42440dSJohn Snow# no Warning level messages displayed, use "--disable=all --enable=classes
90ef42440dSJohn Snow# --disable=W".
91eb8033f6SJohn Snowdisable=consider-using-f-string,
9229a8ea9bSJohn Snow        too-many-function-args,  # mypy handles this with less false positives.
93*4cd17f37SJohn Snow        no-member,  # mypy also handles this better.
94ef42440dSJohn Snow
95ef42440dSJohn Snow[pylint.basic]
96ef42440dSJohn Snow# Good variable names which should always be accepted, separated by a comma.
97ef42440dSJohn Snowgood-names=i,
98ef42440dSJohn Snow           j,
99ef42440dSJohn Snow           k,
100ef42440dSJohn Snow           ex,
101ef42440dSJohn Snow           Run,
102d229f1c8SJohn Snow           _,   # By convention: Unused variable
103d229f1c8SJohn Snow           fh,  # fh = open(...)
104d229f1c8SJohn Snow           fd,  # fd = os.open(...)
105d229f1c8SJohn Snow           c,   # for c in string: ...
10635b9a85aSJohn Snow           T,   # for TypeVars. See pylint#3401
107ef42440dSJohn Snow
108ef42440dSJohn Snow[pylint.similarities]
109ef42440dSJohn Snow# Ignore imports when computing similarities.
110ef42440dSJohn Snowignore-imports=yes
1115690b437SJohn Snowignore-signatures=yes
112158ac451SJohn Snow
11322305c2aSJohn Snow# Minimum lines number of a similarity.
11422305c2aSJohn Snow# TODO: Remove after we opt in to Pylint 2.8.3. See commit msg.
11522305c2aSJohn Snowmin-similarity-lines=6
11622305c2aSJohn Snow
11722305c2aSJohn Snow
118158ac451SJohn Snow[isort]
119158ac451SJohn Snowforce_grid_wrap=4
120158ac451SJohn Snowforce_sort_within_sections=True
121158ac451SJohn Snowinclude_trailing_comma=True
122158ac451SJohn Snowline_length=72
123158ac451SJohn Snowlines_after_imports=2
124158ac451SJohn Snowmulti_line_output=3
1253c8de38cSJohn Snow
1263c8de38cSJohn Snow# tox (https://tox.readthedocs.io/) is a tool for running tests in
1273c8de38cSJohn Snow# multiple virtualenvs. This configuration file will run the test suite
1283c8de38cSJohn Snow# on all supported python versions. To use it, "pip install tox" and
1293c8de38cSJohn Snow# then run "tox" from this directory. You will need all of these versions
1303c8de38cSJohn Snow# of python available on your system to run this test.
1313c8de38cSJohn Snow
1323c8de38cSJohn Snow[tox:tox]
1333c8de38cSJohn Snowenvlist = py36, py37, py38, py39, py310
1346f651a6dSWainer dos Santos Moschettaskip_missing_interpreters = true
1353c8de38cSJohn Snow
1363c8de38cSJohn Snow[testenv]
1373c8de38cSJohn Snowallowlist_externals = make
138c63f3b0bSJohn Snowdeps =
139c63f3b0bSJohn Snow    .[devel]
140c63f3b0bSJohn Snow    .[fuse]  # Workaround to trigger tox venv rebuild
1413c8de38cSJohn Snowcommands =
1423c8de38cSJohn Snow    make check
143