mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-22 21:55:25 +00:00
1832c0a02b
Currently we expose libvirt Go packages at libvirt.org/libvirt-go libvirt.org/libvirt-go-xml These packages have not supported Go modules historically and when we tried to introduce modules, we hit the problem that we're not using semver for versioning. The only way around this is to introduce new packages under a different namespace, that will have the exact same code, but be tagged with a different version numbering scheme. This change proposes: libvirt.org/go/libvirt libvirt.org/go/libvirtxml Note the hyphen is removed so that the import basename matches the Go package name. Reviewed-by: Andrea Bolognani <abologna@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
23 lines
1.1 KiB
ReStructuredText
23 lines
1.1 KiB
ReStructuredText
===================================================
|
|
Obsolete libvirt Go XML parsing API (no Go modules)
|
|
===================================================
|
|
|
|
The obsolete `Go <https://golang.org/>`__ package ``libvirt.org/libvirt-go-xml``
|
|
provided annotated Go struct definitions for parsing (and formatting) XML
|
|
documents used with libvirt APIs.
|
|
|
|
This package is replaced by the new `libvirt.org/go/libvirtxml
|
|
<go/libvirtxml.html>`__ package in order to switch to using `semver
|
|
<https://semver.org/>`__ and `Go modules <https://golang.org/ref/mod>`__.
|
|
Aside from the changed import path and versioning scheme, the new package API
|
|
is fully compatible with this legacy package.
|
|
|
|
Software currently using this package will keep working, but no further
|
|
development will take place. libvirt XML scheme elements/attributes introduced
|
|
after 7.4.0 will never be available. Authors are strongly recommended to switch
|
|
imports to point to the new package, to prepare for future Go toolchains
|
|
which will mandate Go module support and semver.
|
|
|
|
For details of Go specific behaviour consult the
|
|
`Go package documentation <https://pkg.go.dev/libvirt.org/libvirt-go-xml>`__.
|