[libvirt] ANNOUNCE: Plans for the next release

[Daniel P. Berrangé]

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 at 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 :|