api-site: Add validation check for WADLs

[Diane Fleming]

Can you add a validation check for WADL files to ensure they contain an xml:id at the parent resources level?

Like this – the top "resources" tag – must have an xml:id. This is a new requirement that has to do with the generation of PDFs from WADL files – without this, the paths are not unique across WADL files.

<?xml version="1.0" encoding="UTF-8"?>
<!-- (C) 2014 OpenStack Foundation, All Rights Reserved -->
<application xmlns="http://wadl.dev.java.net/2009/02"
    xmlns:wadl="http://wadl.dev.java.net/2009/02"
    xmlns:xsd="http://docs.rackspacecloud.com/xsd/v1.0"
    xmlns:xsdxt="http://docs.rackspacecloud.com/xsd-ext/v1.0">
    <resources base="https://servers.api.openstack.com" xml:id="os-certificate-v3"> <========
        <resource id="v3" path="v3">
            <resource id="os-certificates" path="os-certificates">
                <method href="#createcertificate"/>
                <resource id="root" path="root">
                    <method href="#returncertificate"/>
                </resource>
            </resource>
        </resource>
    </resources>

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/70403

[Andreas Jaeger (jaegerandi)]

I can do the check for all resources tags, I think there's only one per file, isn't there?

I get these failures in api-site:

Checking syntax of XML files...
  api-ref/src/wadls/identity-api/src/v2.0/wadl/RAX-KSKEY-admin.wadl: resources missing xml:id attribute, line 33
  api-ref/src/wadls/volume-api/src/v1/volume-api.wadl: resources missing xml:id attribute, line 7
  api-ref/src/wadls/compute-api/src/ext/os-floating-ips.wadl: resources missing xml:id attribute, line 9
  api-ref/src/wadls/compute-api/src/ext/os-floating-ips-bulk.wadl: resources missing xml:id attribute, line 8
  api-ref/src/wadls/telemetry-api/src/v2/os-telemetry-api-2.0.wadl: resources missing xml:id attribute, line 15
  api-ref/src/wadls/netconn-api/src/metering-labels.wadl: resources missing xml:id attribute, line 16
Check failed, validated 781 XML files with 6 failures.

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/70407

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/70409

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/70410

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/70412