All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Marc-André Lureau" <mlureau@redhat.com>
To: David Anderson <dave@natulte.net>
Cc: "Eric Blake" <eblake@redhat.com>,
	qemu-devel@nongnu.org, qemu-trivial@nongnu.org,
	"Markus Armbruster" <armbru@redhat.com>,
	"Marc-André Lureau" <marcandre.lureau@redhat.com>
Subject: Re: [Qemu-trivial] [Qemu-devel] [PATCH] qapi: make the json schema files more regular.
Date: Fri, 23 Sep 2016 16:16:04 -0400 (EDT)	[thread overview]
Message-ID: <1102009456.1545865.1474661764218.JavaMail.zimbra@redhat.com> (raw)
In-Reply-To: <CAMx+r7XKTASxhX3N=7n_BxO=9vnNPed2fsSGyQw8wigiGgk65A@mail.gmail.com>

Hi

----- Original Message -----
> On Thu, Sep 22, 2016 at 6:07 AM, Eric Blake <eblake@redhat.com> wrote:
> 
> > On 09/21/2016 11:00 PM, David Anderson wrote:
> > > This makes it easier to parse the schema file for tool generation:
> > > each paragraph is either a non-docstring comment, or a docstring
> > > immediately followed by a Python dict describing an API item.
> > >
> > > Signed-off-by: David Anderson <dave@natulte.net>
> > > ---
> > >  qapi-schema.json     | 3 +--
> > >  qapi/block-core.json | 5 -----
> > >  2 files changed, 1 insertion(+), 7 deletions(-)
> >
> > Related to the work Marc-Andre is already doing, but fine to take now.
> >
> 
> Do you have a link to that work? It sounds like the schema format may be
> changing, which is relevant to my interests since I'm trying to parse it :).
> 

I wrote a schema doc parser/generator: see http://patchew.org/QEMU/20160922155808.8504-1-marcandre.lureau%40redhat.com/.

The format is not changing, just augmented a bit.

> - Dave
> 
> 
> >
> > Reviewed-by: Eric Blake <eblake@redhat.com>
> >
> > >
> > > diff --git a/qapi-schema.json b/qapi-schema.json
> > > index e507061..edd803f 100644
> > > --- a/qapi-schema.json
> > > +++ b/qapi-schema.json
> > > @@ -752,6 +752,7 @@
> > >              'cpu-throttle-increment': 'int',
> > >              'tls-creds': 'str',
> > >              'tls-hostname': 'str'} }
> > > +
> > >  ##
> > >  # @query-migrate-parameters
> > >  #
> > > @@ -4115,7 +4116,6 @@
> > >  #
> > >  # Since 1.6
> > >  ##
> > > -
> > >  { 'struct': 'RxFilterInfo',
> > >    'data': {
> > >      'name':               'str',
> > > @@ -4335,7 +4335,6 @@
> > >  #
> > >  # Since: 2.1
> > >  ##
> > > -
> > >  { 'struct': 'Memdev',
> > >    'data': {
> > >      'size':       'size',
> > > diff --git a/qapi/block-core.json b/qapi/block-core.json
> > > index 24223fd..e12fbd3 100644
> > > --- a/qapi/block-core.json
> > > +++ b/qapi/block-core.json
> > > @@ -25,7 +25,6 @@
> > >  # Since: 1.3
> > >  #
> > >  ##
> > > -
> > >  { 'struct': 'SnapshotInfo',
> > >    'data': { 'id': 'str', 'name': 'str', 'vm-state-size': 'int',
> > >              'date-sec': 'int', 'date-nsec': 'int',
> > > @@ -81,7 +80,6 @@
> > >  #
> > >  # Since: 1.7
> > >  ##
> > > -
> > >  { 'union': 'ImageInfoSpecific',
> > >    'data': {
> > >        'qcow2': 'ImageInfoSpecificQCow2',
> > > @@ -129,7 +127,6 @@
> > >  # Since: 1.3
> > >  #
> > >  ##
> > > -
> > >  { 'struct': 'ImageInfo',
> > >    'data': {'filename': 'str', 'format': 'str', '*dirty-flag': 'bool',
> > >             '*actual-size': 'int', 'virtual-size': 'int',
> > > @@ -181,7 +178,6 @@
> > >  # Since: 1.4
> > >  #
> > >  ##
> > > -
> > >  { 'struct': 'ImageCheck',
> > >    'data': {'filename': 'str', 'format': 'str', 'check-errors': 'int',
> > >             '*image-end-offset': 'int', '*corruptions': 'int', '*leaks':
> > 'int',
> > > @@ -518,7 +514,6 @@
> > >  #
> > >  # Since: 2.5
> > >  ##
> > > -
> > >  { 'struct': 'BlockDeviceTimedStats',
> > >    'data': { 'interval_length': 'int', 'min_rd_latency_ns': 'int',
> > >              'max_rd_latency_ns': 'int', 'avg_rd_latency_ns': 'int',
> > >
> >
> > --
> > Eric Blake   eblake redhat com    +1-919-301-3266
> > Libvirt virtualization library http://libvirt.org
> >
> >
> 


WARNING: multiple messages have this Message-ID (diff)
From: "Marc-André Lureau" <mlureau@redhat.com>
To: David Anderson <dave@natulte.net>
Cc: "Eric Blake" <eblake@redhat.com>,
	qemu-devel@nongnu.org, qemu-trivial@nongnu.org,
	"Markus Armbruster" <armbru@redhat.com>,
	"Marc-André Lureau" <marcandre.lureau@redhat.com>
Subject: Re: [Qemu-devel] [PATCH] qapi: make the json schema files more regular.
Date: Fri, 23 Sep 2016 16:16:04 -0400 (EDT)	[thread overview]
Message-ID: <1102009456.1545865.1474661764218.JavaMail.zimbra@redhat.com> (raw)
In-Reply-To: <CAMx+r7XKTASxhX3N=7n_BxO=9vnNPed2fsSGyQw8wigiGgk65A@mail.gmail.com>

Hi

----- Original Message -----
> On Thu, Sep 22, 2016 at 6:07 AM, Eric Blake <eblake@redhat.com> wrote:
> 
> > On 09/21/2016 11:00 PM, David Anderson wrote:
> > > This makes it easier to parse the schema file for tool generation:
> > > each paragraph is either a non-docstring comment, or a docstring
> > > immediately followed by a Python dict describing an API item.
> > >
> > > Signed-off-by: David Anderson <dave@natulte.net>
> > > ---
> > >  qapi-schema.json     | 3 +--
> > >  qapi/block-core.json | 5 -----
> > >  2 files changed, 1 insertion(+), 7 deletions(-)
> >
> > Related to the work Marc-Andre is already doing, but fine to take now.
> >
> 
> Do you have a link to that work? It sounds like the schema format may be
> changing, which is relevant to my interests since I'm trying to parse it :).
> 

I wrote a schema doc parser/generator: see http://patchew.org/QEMU/20160922155808.8504-1-marcandre.lureau%40redhat.com/.

The format is not changing, just augmented a bit.

> - Dave
> 
> 
> >
> > Reviewed-by: Eric Blake <eblake@redhat.com>
> >
> > >
> > > diff --git a/qapi-schema.json b/qapi-schema.json
> > > index e507061..edd803f 100644
> > > --- a/qapi-schema.json
> > > +++ b/qapi-schema.json
> > > @@ -752,6 +752,7 @@
> > >              'cpu-throttle-increment': 'int',
> > >              'tls-creds': 'str',
> > >              'tls-hostname': 'str'} }
> > > +
> > >  ##
> > >  # @query-migrate-parameters
> > >  #
> > > @@ -4115,7 +4116,6 @@
> > >  #
> > >  # Since 1.6
> > >  ##
> > > -
> > >  { 'struct': 'RxFilterInfo',
> > >    'data': {
> > >      'name':               'str',
> > > @@ -4335,7 +4335,6 @@
> > >  #
> > >  # Since: 2.1
> > >  ##
> > > -
> > >  { 'struct': 'Memdev',
> > >    'data': {
> > >      'size':       'size',
> > > diff --git a/qapi/block-core.json b/qapi/block-core.json
> > > index 24223fd..e12fbd3 100644
> > > --- a/qapi/block-core.json
> > > +++ b/qapi/block-core.json
> > > @@ -25,7 +25,6 @@
> > >  # Since: 1.3
> > >  #
> > >  ##
> > > -
> > >  { 'struct': 'SnapshotInfo',
> > >    'data': { 'id': 'str', 'name': 'str', 'vm-state-size': 'int',
> > >              'date-sec': 'int', 'date-nsec': 'int',
> > > @@ -81,7 +80,6 @@
> > >  #
> > >  # Since: 1.7
> > >  ##
> > > -
> > >  { 'union': 'ImageInfoSpecific',
> > >    'data': {
> > >        'qcow2': 'ImageInfoSpecificQCow2',
> > > @@ -129,7 +127,6 @@
> > >  # Since: 1.3
> > >  #
> > >  ##
> > > -
> > >  { 'struct': 'ImageInfo',
> > >    'data': {'filename': 'str', 'format': 'str', '*dirty-flag': 'bool',
> > >             '*actual-size': 'int', 'virtual-size': 'int',
> > > @@ -181,7 +178,6 @@
> > >  # Since: 1.4
> > >  #
> > >  ##
> > > -
> > >  { 'struct': 'ImageCheck',
> > >    'data': {'filename': 'str', 'format': 'str', 'check-errors': 'int',
> > >             '*image-end-offset': 'int', '*corruptions': 'int', '*leaks':
> > 'int',
> > > @@ -518,7 +514,6 @@
> > >  #
> > >  # Since: 2.5
> > >  ##
> > > -
> > >  { 'struct': 'BlockDeviceTimedStats',
> > >    'data': { 'interval_length': 'int', 'min_rd_latency_ns': 'int',
> > >              'max_rd_latency_ns': 'int', 'avg_rd_latency_ns': 'int',
> > >
> >
> > --
> > Eric Blake   eblake redhat com    +1-919-301-3266
> > Libvirt virtualization library http://libvirt.org
> >
> >
> 

  reply	other threads:[~2016-09-23 20:16 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-09-22  4:00 [Qemu-trivial] [PATCH] qapi: make the json schema files more regular David Anderson
2016-09-22  4:00 ` [Qemu-devel] " David Anderson
2016-09-22 13:07 ` [Qemu-trivial] " Eric Blake
2016-09-22 13:07   ` Eric Blake
2016-09-23 20:04   ` [Qemu-trivial] " David Anderson
2016-09-23 20:04     ` David Anderson
2016-09-23 20:16     ` Marc-André Lureau [this message]
2016-09-23 20:16       ` Marc-André Lureau
2016-09-23 20:17     ` [Qemu-trivial] " Eric Blake
2016-09-23 20:17       ` Eric Blake
2016-09-29 15:52 ` [Qemu-trivial] " Michael Tokarev
2016-09-29 15:52   ` [Qemu-devel] " Michael Tokarev
2016-10-09 22:39   ` [Qemu-trivial] " David Anderson
2016-10-09 22:39     ` [Qemu-devel] " David Anderson

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=1102009456.1545865.1474661764218.JavaMail.zimbra@redhat.com \
    --to=mlureau@redhat.com \
    --cc=armbru@redhat.com \
    --cc=dave@natulte.net \
    --cc=eblake@redhat.com \
    --cc=marcandre.lureau@redhat.com \
    --cc=qemu-devel@nongnu.org \
    --cc=qemu-trivial@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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.