<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<style type="text/css" id="owaParaStyle"></style>
</head>
<body bgcolor="#FFFFFF" fpstyle="1" ocsi="0">
<div style="direction: ltr;font-family: Tahoma;color: #000000;font-size: 10pt;">I certainly use them daily. I actually use an interesting wrapper called Supernova (<a href="http://rackerhacker.github.com/supernova/" target="_blank">http://rackerhacker.github.com/supernova/</a>)
 which allows for multi-user/multi-environment configurations. While the clients may not be as critical as the APIs themselves, they're something I certainly rely on heavily.
<div><br>
</div>
<div>Daryl<br>
<div style="font-family: Times New Roman; color: #000000; font-size: 16px">
<hr tabindex="-1">
<div id="divRpF674103" style="direction: ltr;"><font face="Tahoma" size="2" color="#000000"><b>From:</b> openstack-bounces+daryl.walleck=rackspace.com@lists.launchpad.net [openstack-bounces+daryl.walleck=rackspace.com@lists.launchpad.net] on behalf of David
 Kranz [david.kranz@qrclab.com]<br>
<b>Sent:</b> Friday, March 01, 2013 3:36 PM<br>
<b>To:</b> openstack@lists.launchpad.net<br>
<b>Subject:</b> Re: [Openstack] Are the Python APIs public or internal?<br>
</font><br>
</div>
<div></div>
<div>
<div class="moz-cite-prefix">The Tempest (QA) team certainly considers them to be public and we just started getting some contributions that are testing novaclient. In other work I am also a consumer of several of these APIs so I really hope they don't break.<br>
<br>
 -David<br>
<br>
On 3/1/2013 8:50 AM, Dolph Mathews wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">I believe they should certainly be treated as public API's -- just like any other library. I'd also treat them as stable if they've ever been included in a versioned release. That said, I'm sure it would be easy to find examples of methods &
 attributes within the library that are not intended to be consumed externally, but perhaps either the naming convention or documentation doesn't sufficiently indicate that.
<div>
<div><br>
</div>
<div>In keysoneclient, we're making backwards incompatible changes in a new subpackage (keystoneclient.v3) while maintaing compatibility in the common client code. For example, you should always be able to initialize the client with a tenant_id / tenant_name,
 even though the client will soon be using project_id / project_name internally to reflect our revised lingo.</div>
</div>
</div>
<div class="gmail_extra"><br clear="all">
<div>
<div><br>
</div>
-Dolph</div>
<br>
<br>
<div class="gmail_quote">On Thu, Feb 28, 2013 at 11:07 PM, Lorin Hochstein <span dir="ltr">
<<a href="mailto:lorin@nimbisservices.com" target="_blank">lorin@nimbisservices.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0
            .8ex; border-left:1px #ccc solid; padding-left:1ex">
<div dir="ltr">
<div>Here's an issue that came up in the operators doc sprint this week.</div>
<div><br>
</div>
Let's say I wanted to write some Python scripts using the APIs exposed by the python-*client packages. As a concrete example, let's say I wrote a script that uses the keystone Python API that's exposed in the python-keystoneclient package:
<div><br>
</div>
<div><a href="https://github.com/lorin/openstack-ansible/blob/master/playbooks/keystone/files/keystone-init.py" target="_blank">https://github.com/lorin/openstack-ansible/blob/master/playbooks/keystone/files/keystone-init.py</a><br>
<div><br>
</div>
<div>
<div>Are these APIs "public" or "stable"  in some meaningful way? (i.e., can I count on this script still working across minor release upgrades)? Or should they be treated like "internal" APIs that could be changed at any time in the future? Or is this not
 defined at all? </div>
<span class="HOEnZb"><font color="#888888">
<div><br>
</div>
<div>Lorin<br clear="all">
<div><br>
</div>
</div>
</font></span></div>
</div>
</div>
<br>
_______________________________________________<br>
Mailing list: <a href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
Post to     : <a href="mailto:openstack@lists.launchpad.net" target="_blank">openstack@lists.launchpad.net</a><br>
Unsubscribe : <a href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
More help   : <a href="https://help.launchpad.net/ListHelp" target="_blank">https://help.launchpad.net/ListHelp</a><br>
<br>
</blockquote>
</div>
<br>
</div>
<br>
<fieldset class="mimeAttachmentHeader" target="_blank"></fieldset> <br>
<pre>_______________________________________________
Mailing list: <a class="moz-txt-link-freetext" href="https://launchpad.net/~openstack" target="_blank">https://launchpad.net/~openstack</a>
Post to     : <a class="moz-txt-link-abbreviated" href="mailto:openstack@lists.launchpad.net" target="_blank">openstack@lists.launchpad.net</a>
Unsubscribe : <a class="moz-txt-link-freetext" href="https://launchpad.net/~openstack" target="_blank">https://launchpad.net/~openstack</a>
More help   : <a class="moz-txt-link-freetext" href="https://help.launchpad.net/ListHelp" target="_blank">https://help.launchpad.net/ListHelp</a>
</pre>
</blockquote>
<br>
</div>
</div>
</div>
</div>
</body>
</html>