<div dir="ltr">Hi Kersten, <div><br></div><div>I think lots of people are trying to solve for automation and small parts do help. Thanks David for noting what's missing.</div><div><br></div><div>Just last week, Cyril Roelandt said he has written a Sphinx extension to create the WADL for the Ceilometer docs, see <a href="https://review.openstack.org/#/c/45592/">https://review.openstack.org/#/c/45592/</a>. He says "<span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif">generated by a Sphinx extension I wrote (I haven't released it yet, because I need to make it's ok with the legal department) from the RST files in Ceilometer." </span></div>
<div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif"><br></span></div><div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif">I do want to make sure solutions between projects are similar so that we have a single process for everyone to follow. But the source files may differ. Kersten, can you take a look at Cyril's work and see if there's similarity? I can't tell where your source comes from -- is it json? How does all this fit into the Pecan and WSME discussions on validation?</span></div>
<div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif"><br></span></div><div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif">Sorry for all the questions, just want to keep an eye on the big picture.</span></div>
<div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif"><br></span></div><div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif">Thanks,</span></div>
<div><span style="color:rgb(0,0,0);font-family:'Arial Unicode MS',Arial,sans-serif">Anne</span></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Oct 22, 2013 at 9:35 AM, Kersten J Richter <span dir="ltr"><<a href="mailto:kersten@us.ibm.com" target="_blank">kersten@us.ibm.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>
<p><font face="sans-serif">Thank you for your response. </font><br>
<br>
<font face="sans-serif">Forgot the opening request! - added that into the logic. This specific example didn't have any parameters so they are not included. I will be looking at that piece later.</font><br>
<br>
<font face="sans-serif">As to this being a fragment, yes I know that. Obviously the methods need to be put together into a single wadl file. That is part of my question - if I created a program that transformed the first bit of code into the second, then is that even helpful? I don't want to spend time on something that isn't going to be useful.</font></p>
<div class="im"><br>
<br>
<br>
<font face="sans-serif">Kersten J. Richter<br>
Software Engineer<br>
IBM, Rochester<br>
Home office: <a href="tel:952-652-5304" value="+19526525304" target="_blank">952-652-5304</a><br>
<br>
If you lend someone $20 and never see that person again, it was probably worth it.</font><br>
<br>
</div><img width="16" height="16" src="cid:1__=09BBF69FDFDD56148f9e8a93df938@us.ibm.com" border="0" alt="Inactive hide details for David Cramer ---10/21/2013 10:14:59 PM---Hi Kersten, You seem to be missing an opening <request> tag."><font color="#424282" face="sans-serif">David Cramer ---10/21/2013 10:14:59 PM---Hi Kersten, You seem to be missing an opening <request> tag. Also, this is a</font><br>
<br>
<font size="1" color="#5F5F5F" face="sans-serif">From: </font><font size="1" face="sans-serif">David Cramer <<a href="mailto:david.cramer@rackspace.com" target="_blank">david.cramer@rackspace.com</a>></font><br>
<font size="1" color="#5F5F5F" face="sans-serif">To: </font><font size="1" face="sans-serif">Kersten J Richter/Rochester/IBM@IBMUS, <<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>>, </font><br>
<font size="1" color="#5F5F5F" face="sans-serif">Date: </font><font size="1" face="sans-serif">10/21/2013 10:14 PM</font><br>
<font size="1" color="#5F5F5F" face="sans-serif">Subject: </font><font size="1" face="sans-serif">Re: [Openstack-docs] code to build api methods</font><br>
<hr width="100%" size="2" align="left" noshade style="color:#8091a5"><div><div class="h5"><br>
<br>
<br>
<tt><font>Hi Kersten,<br>
You seem to be missing an opening <request> tag. Also, this is a<br>
fragment, but presumably in the whole doc you will have declared the<br>
namespaces wadl and xsdxt.<br>
<br>
One thing this example lacks is parameters (header, query, template, and<br>
"plain" or body params).<br>
<br>
Regards,<br>
David<br>
<br>
On 10/21/2013 04:22 PM, Kersten J Richter wrote:<br>
> Hi all,<br>
> Working on a code that will transform this:<br>
> <br>
> {<br>
> "description": "Updates an agent build",<br>
> "extension": "os-agents",<br>
> "extension_description": "Creates, updates, and deletes guest<br>
> agents. Use guest agents to access files on the disk, configure<br>
> networking, or run other applications or scripts in the guest while it<br>
> runs. This hypervisor-specific extension is not currently enabled for<br>
> KVM. Use of guest agents is possible only if the underlying service<br>
> provider uses the Xen driver. ",<br>
> "method": "PUT",<br>
> "request": "agent-update-put-req.json",<br>
> "response": "agent-update-put-resp.json",<br>
> "section_name": "Guest Agents",<br>
> "status": 200,<br>
> "url": "os-agents/{id}"<br>
> }<br>
> <br>
> To this:<br>
> <br>
> <br>
> <method name="PUT" id="os-agents"><br>
> <wadl:doc xml:lang="EN" title="Guest Agents"<br>
> xmlns="</font></tt><tt><font><a href="http://docbook.org/ns/docbook" target="_blank">http://docbook.org/ns/docbook</a></font></tt><tt><font>"><br>
> <para role="shortdesc">Updates an agent build</para><br>
> <para>Creates, updates, and deletes guest<br>
> agents. Use guest agents to access files on the disk, configure<br>
> networking, or run other applications or scripts in the guest while it<br>
> runs. This hypervisor-specific extension is not currently enabled for<br>
> KVM. Use of guest agents is possible only if the underlying service<br>
> provider uses the Xen driver.</para><br>
> </wadl:doc><br>
> <representation mediaType="application/json"><br>
> <doc xml:lang="EN"><br>
> <xsdxt:code<br>
> href="../api_samples/agent-update-put-req.json"/><br>
> </doc><br>
> </representation><br>
> </request><br>
> <response status="200"><br>
> <representation mediaType="application/json"><br>
> <doc xml:lang="EN"><br>
> <xsdxt:code<br>
> href="../api_samples/agent-update-put-resp.json"/><br>
> </doc><br>
> </representation><br>
> </response><br>
> </method><br>
> <br>
> Can someone confirm or deny that I'm on the right track? Does the<br>
> method look correct? Wanted to see if I was on the right track before I<br>
> spend too much time working on the code.<br>
> <br>
> <br>
> Kersten J. Richter<br>
> Software Engineer<br>
> IBM, Rochester<br>
> Home office: <a href="tel:952-652-5304" value="+19526525304" target="_blank">952-652-5304</a><br>
> <br>
> If you lend someone $20 and never see that person again, it was probably<br>
> worth it.<br>
> <br>
> <br>
> _______________________________________________<br>
> Openstack-docs mailing list<br>
> <a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a><br>
> </font></tt><tt><font><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></font></tt><tt><font><br>
> <br>
<br>
</font></tt><br>
</div></div><p></p></div>
<br>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div>