On Mon, May 14, 2018 at 05:15:59PM +0200, Pavel Hrdina wrote: > Hi, > > I would like to make the next libvirt-dbus release with stable APIs, > there is a lot of them already implemented and other projects can start > adapting to use libvirt-dbus. > > The release version would be 1.0.0 and currently libvirt-dbus will > cover APIs up to libvirt-3.0.0 as a start point because that libvirt > version is available in all downstream distributions currently > supported by libvirt. > > So I would like to ask everyone to look at the APIs to check whether it > make sense and whether something is missing or could be excluded.
I'd suggest writing a test that parses libvirt-api.xml and validates that your binary (or source code) contains a reference to each API, so that you know you have full coverage, and also so that CI builds when when new APIs are added to libvirt alerting you to close the gap. Just blacklist the APIs you don't want to expose. There's examples of such a test in the python, perl and go binding repos. > The idea of libvirt-dbus is not to export every API if there is a better > API to do the job, so for example: > > - all APIs that have both versions with and without flags we will > export only the one with flags. > > - some of the Stats APIs can be omitted since the same values are > also exported in the GetStats (virDomainListGetStats) > > I would like to make the release this week so any help or suggestion is > welcome. The API definition is in the data/org.libvirt.*.xml files. > -- > libvir-list mailing list > libvir-list@redhat.com > https://www.redhat.com/mailman/listinfo/libvir-list Regards, Daniel -- |: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :| -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list