<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<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
cite="mid:CAC=h7gXS0wFC4dy7Y6g4gm6iuRsO1P=3u8SDa89cf4a6V2-Erg@mail.gmail.com"
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 moz-do-not-send="true"
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 moz-do-not-send="true"
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 moz-do-not-send="true"
href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
Post to : <a moz-do-not-send="true"
href="mailto:openstack@lists.launchpad.net">openstack@lists.launchpad.net</a><br>
Unsubscribe : <a moz-do-not-send="true"
href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
More help : <a moz-do-not-send="true"
href="https://help.launchpad.net/ListHelp" target="_blank">https://help.launchpad.net/ListHelp</a><br>
<br>
</blockquote>
</div>
<br>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
Mailing list: <a class="moz-txt-link-freetext" href="https://launchpad.net/~openstack">https://launchpad.net/~openstack</a>
Post to : <a class="moz-txt-link-abbreviated" href="mailto:openstack@lists.launchpad.net">openstack@lists.launchpad.net</a>
Unsubscribe : <a class="moz-txt-link-freetext" href="https://launchpad.net/~openstack">https://launchpad.net/~openstack</a>
More help : <a class="moz-txt-link-freetext" href="https://help.launchpad.net/ListHelp">https://help.launchpad.net/ListHelp</a>
</pre>
</blockquote>
<br>
</body>
</html>