[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 06/10] python/aqmp: copy qmp docstrings to qemu.aqmp.legacy
From: |
John Snow |
Subject: |
Re: [PATCH 06/10] python/aqmp: copy qmp docstrings to qemu.aqmp.legacy |
Date: |
Wed, 23 Mar 2022 15:36:15 -0400 |
On Wed, Mar 23, 2022 at 2:24 PM Hanna Reitz <hreitz@redhat.com> wrote:
>
> On 21.03.22 22:08, John Snow wrote:
> > Copy the docstrings out of qemu.qmp, adjusting them as necessary to
> > more accurately reflect the current state of this class.
> >
> > (Licensing: This is copying and modifying GPLv2-only licensed docstrings
> > into a GPLv2-only file.)
> >
> > Signed-off-by: John Snow <jsnow@redhat.com>
> > Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
> > Reviewed-by: Beraldo Leal <bleal@redhat.com>
> > ---
> > python/qemu/aqmp/legacy.py | 102 ++++++++++++++++++++++++++++++++++---
> > 1 file changed, 94 insertions(+), 8 deletions(-)
> >
> > diff --git a/python/qemu/aqmp/legacy.py b/python/qemu/aqmp/legacy.py
> > index 10c7c99c4f..20ffdd8956 100644
> > --- a/python/qemu/aqmp/legacy.py
> > +++ b/python/qemu/aqmp/legacy.py
>
> [...]
>
> > @@ -60,6 +63,21 @@ class QMPBadPortError(QMPError):
> >
> >
> > class QEMUMonitorProtocol:
> > + """
> > + Provide an API to connect to QEMU via QEMU Monitor Protocol (QMP)
> > + and then allow to handle commands and events.
> > +
> > + :param address: QEMU address, can be either a unix socket path
> > (string)
> > + or a tuple in the form ( address, port ) for a TCP
> > + connection
> > + :param server: Deprecated, ignored. (See 'accept')
>
> Can’t help but notice that this is (technically) just wrong, because it
> isn’t ignored. Are you afraid people might not be sufficiently
> dissuaded by the “deprecated” keyword? (I mean, if that were the case,
> I’d suggest you write “Deprecated, because setting this to true might
> make your computer explode” instead.)
>
Oops, this is outdated. I *did* drop this parameter. once. And then I
re-added it.
Thanks for noticing.
--js
- Re: [PATCH 01/10] python/aqmp: add explicit GPLv2 license to legacy.py, (continued)
[PATCH 03/10] python: temporarily silence pylint duplicate-code warnings, John Snow, 2022/03/21
[PATCH 02/10] python/aqmp: relicense as GPLv2+, John Snow, 2022/03/21
[PATCH 08/10] python: re-enable pylint duplicate-code warnings, John Snow, 2022/03/21
[PATCH 05/10] python/aqmp: fully separate from qmp.QEMUMonitorProtocol, John Snow, 2022/03/21
[PATCH 07/10] python: remove the old QMP package, John Snow, 2022/03/21
[PATCH 06/10] python/aqmp: copy qmp docstrings to qemu.aqmp.legacy, John Snow, 2022/03/21
[PATCH 04/10] python/aqmp: take QMPBadPortError and parse_address from qemu.qmp, John Snow, 2022/03/21
[PATCH 10/10] python: rename 'aqmp-tui' to 'qmp-tui', John Snow, 2022/03/21
[PATCH 09/10] python: rename qemu.aqmp to qemu.qmp, John Snow, 2022/03/21