From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: Peter Maydell <peter.maydell@linaro.org>,
Michael Roth <michael.roth@amd.com>,
Markus Armbruster <armbru@redhat.com>,
John Snow <jsnow@redhat.com>
Subject: [PATCH v4 00/23] qapi: statically type schema.py
Date: Wed, 13 Mar 2024 00:41:04 -0400 [thread overview]
Message-ID: <20240313044127.49089-1-jsnow@redhat.com> (raw)
This is *v4*, for some definitions of "version" and "four".
v4:
- Rebased on top of latest QAPIDoc patches.
- A couple of hotfixes on top of the QAPIDoc patches.
- Adjusted commit message phrasing
- Changed the "split checked into checked and checking" patch and follow-up.
v3:
- 01: fixed alphabetization (... sigh)
- 03: updated docstring, added super calls,
renamed argument to @defn, reflowed long lines
- 04: updated commit message
- 05: updated commit message
- 06: pushed type hints into later commit
- 09: removed default argument and stuffed into next patch
- 10: Added the parts Markus doesn't like (Sorry)
- 11: updated commit message
- 12: updated commit message
- 13: Split into two patches.
Kept stuff Markus doesn't like (Sorry)
- 14: New, split from 13.
v2:
- dropped the resolve_type refactoring patch
- added QAPISchemaDefinition
- misc bits and pieces.
001/19:[down] 'qapi: sort pylint suppressions'
New, Markus's suggestion.
002/19:[0001] [FC] 'qapi/schema: add pylint suppressions'
Added newline, Markus's RB
003/19:[down] 'qapi: create QAPISchemaDefinition'
New, Markus's suggestion.
004/19:[0002] [FC] 'qapi/schema: declare type for QAPISchemaObjectTypeMember.type'
Adjusted commit message and comment.
005/19:[down] 'qapi/schema: declare type for QAPISchemaArrayType.element_type'
Patch renamed; removed @property trick in favor of static type declaration
006/19:[0009] [FC] 'qapi/schema: make c_type() and json_type() abstract methods'
Use abc.ABC and @abstractmethod
007/19:[0001] [FC] 'qapi/schema: adjust type narrowing for mypy's benefit'
Adjusted commit message; left in an assertion that is removed later instead.
008/19:[down] 'qapi/schema: add type narrowing to lookup_type()'
Renamed
removed type hints which get added later in the series instead
simplified logic.
009/19:[down] 'qapi/schema: allow resolve_type to be used for built-in types'
New patch. (Types are added later.)
010/19:[down] 'qapi: use schema.resolve_type instead of schema.lookup_type'
New patch, replaces old 07/19 "assert schema.lookup_type did not fail"
011/19:[0011] [FC] 'qapi/schema: fix QAPISchemaArrayType.check's call to resolve_type'
Dramatically simplified.
012/19:[----] [--] 'qapi/schema: assert info is present when necessary'
013/19:[----] [--] 'qapi/schema: split "checked" field into "checking" and "checked"'
Changed the commit message, but actually struggled finding anything simpler
than what I already had, owing to the fact that q_empty is a valid construct
and I can't seem to avoid adding a new state variable here.
014/19:[----] [-C] 'qapi/schema: fix typing for QAPISchemaVariants.tag_member'
Also unchanged from review, I think this is simplest still...
015/19:[down] 'qapi/schema: assert inner type of QAPISchemaVariants in check_clash()'
Renamed, changed commit message and comment.
016/19:[----] [--] 'qapi/parser: demote QAPIExpression to Dict[str, Any]'
017/19:[0042] [FC] 'qapi/schema: add type hints'
Mostly contextual changes.
018/19:[----] [--] 'qapi/schema: turn on mypy strictness'
019/19:[0006] [FC] 'qapi/schema: remove unnecessary asserts'
Zapped a few more.
John Snow (23):
qapi/parser: fix typo - self.returns.info => self.errors.info
qapi/parser: shush up pylint
qapi: sort pylint suppressions
qapi/schema: add pylint suppressions
qapi: create QAPISchemaDefinition
qapi/schema: declare type for QAPISchemaObjectTypeMember.type
qapi/schema: declare type for QAPISchemaArrayType.element_type
qapi/schema: make c_type() and json_type() abstract methods
qapi/schema: adjust type narrowing for mypy's benefit
qapi/schema: add type narrowing to lookup_type()
qapi/schema: assert resolve_type has 'info' and 'what' args on error
qapi: use schema.resolve_type instead of schema.lookup_type
qapi/schema: fix QAPISchemaArrayType.check's call to resolve_type
qapi/schema: assert info is present when necessary
qapi/schema: add _check_complete flag
qapi/schema: Don't initialize "members" with `None`
qapi/schema: fix typing for QAPISchemaVariants.tag_member
qapi/schema: assert inner type of QAPISchemaVariants in check_clash()
qapi/parser: demote QAPIExpression to Dict[str, Any]
qapi/parser.py: assert member.info is present in connect_member
qapi/schema: add type hints
qapi/schema: turn on mypy strictness
qapi/schema: remove unnecessary asserts
scripts/qapi/introspect.py | 4 +-
scripts/qapi/mypy.ini | 5 -
scripts/qapi/parser.py | 7 +-
scripts/qapi/pylintrc | 11 +-
scripts/qapi/schema.py | 792 ++++++++++++++++++++++++-------------
5 files changed, 534 insertions(+), 285 deletions(-)
--
2.44.0
next reply other threads:[~2024-03-13 4:42 UTC|newest]
Thread overview: 38+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-03-13 4:41 John Snow [this message]
2024-03-13 4:41 ` [PATCH v4 01/23] qapi/parser: fix typo - self.returns.info => self.errors.info John Snow
2024-03-13 10:17 ` Philippe Mathieu-Daudé
2024-03-13 11:06 ` Markus Armbruster
2024-03-13 4:41 ` [PATCH v4 02/23] qapi/parser: shush up pylint John Snow
2024-03-13 4:41 ` [PATCH v4 03/23] qapi: sort pylint suppressions John Snow
2024-03-13 4:41 ` [PATCH v4 04/23] qapi/schema: add " John Snow
2024-03-13 4:41 ` [PATCH v4 05/23] qapi: create QAPISchemaDefinition John Snow
2024-03-14 9:12 ` Markus Armbruster
2024-03-14 13:32 ` John Snow
2024-03-14 14:04 ` Markus Armbruster
2024-03-14 14:20 ` John Snow
2024-03-13 4:41 ` [PATCH v4 06/23] qapi/schema: declare type for QAPISchemaObjectTypeMember.type John Snow
2024-03-13 4:41 ` [PATCH v4 07/23] qapi/schema: declare type for QAPISchemaArrayType.element_type John Snow
2024-03-13 4:41 ` [PATCH v4 08/23] qapi/schema: make c_type() and json_type() abstract methods John Snow
2024-03-13 4:41 ` [PATCH v4 09/23] qapi/schema: adjust type narrowing for mypy's benefit John Snow
2024-03-13 4:41 ` [PATCH v4 10/23] qapi/schema: add type narrowing to lookup_type() John Snow
2024-03-13 4:41 ` [PATCH v4 11/23] qapi/schema: assert resolve_type has 'info' and 'what' args on error John Snow
2024-03-13 4:41 ` [PATCH v4 12/23] qapi: use schema.resolve_type instead of schema.lookup_type John Snow
2024-03-13 4:41 ` [PATCH v4 13/23] qapi/schema: fix QAPISchemaArrayType.check's call to resolve_type John Snow
2024-03-13 4:41 ` [PATCH v4 14/23] qapi/schema: assert info is present when necessary John Snow
2024-03-13 4:41 ` [PATCH v4 15/23] qapi/schema: add _check_complete flag John Snow
2024-03-13 4:41 ` [PATCH v4 16/23] qapi/schema: Don't initialize "members" with `None` John Snow
2024-03-14 13:01 ` Markus Armbruster
2024-03-14 13:35 ` John Snow
2024-03-14 13:58 ` Markus Armbruster
2024-03-14 13:59 ` John Snow
2024-03-13 4:41 ` [PATCH v4 17/23] qapi/schema: fix typing for QAPISchemaVariants.tag_member John Snow
2024-03-13 4:41 ` [PATCH v4 18/23] qapi/schema: assert inner type of QAPISchemaVariants in check_clash() John Snow
2024-03-13 4:41 ` [PATCH v4 19/23] qapi/parser: demote QAPIExpression to Dict[str, Any] John Snow
2024-03-13 4:41 ` [PATCH v4 20/23] qapi/parser.py: assert member.info is present in connect_member John Snow
2024-03-13 4:41 ` [PATCH v4 21/23] qapi/schema: add type hints John Snow
2024-03-15 14:03 ` Markus Armbruster
2024-03-15 17:37 ` John Snow
2024-03-13 4:41 ` [PATCH v4 22/23] qapi/schema: turn on mypy strictness John Snow
2024-03-13 4:41 ` [PATCH v4 23/23] qapi/schema: remove unnecessary asserts John Snow
2024-03-14 14:43 ` [PATCH v4 00/23] qapi: statically type schema.py Markus Armbruster
2024-03-14 14:44 ` John Snow
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240313044127.49089-1-jsnow@redhat.com \
--to=jsnow@redhat.com \
--cc=armbru@redhat.com \
--cc=michael.roth@amd.com \
--cc=peter.maydell@linaro.org \
--cc=qemu-devel@nongnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).