Mailing-List: contact libcloud-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: libcloud@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of ferncam1@gmail.com designates
 209.85.160.47 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :content-type;
        b=GSvcxTcnSspqyFnC2IP705EphmgZioeeWi4juA5KHKEVbeuAQ9wcfe+9OfndTdEqRB
         1mRlrxTF59WgAeHOMmqOsDcstbAR4OwBh0Wnt4EjW+Zow2U9Mu19eUU++xACkSqB6b12
         QNnoqrs+hTI508KXXFRsGxrIpTItxdkzFkONQ=
MIME-Version: 1.0
In-Reply-To: <k2l4239a4321004231200w9a8ec27bkc1f5dfe91e35403f@mail.gmail.com>
References: <k2l4239a4321004231200w9a8ec27bkc1f5dfe91e35403f@mail.gmail.com>
Date: Fri, 23 Apr 2010 12:09:16 -0700
Message-ID: <n2u6c6be1ae1004231209h6e184c2cm8b1e589db4f8e6d1@mail.gmail.com>
From: Adrian Cole <ferncam1@gmail.com>
To: libcloud@incubator.apache.org
Content-Type: multipart/alternative; boundary=000e0cd13b6edafac30484ec29a2
Subject: Re: [libcloud] "extended" APIs

--000e0cd13b6edafac30484ec29a2
Content-Type: text/plain; charset=ISO-8859-1

Good idea, Paul. Mixing and matching in the same class may get messy,
though. Perhaps you could expose a provider interface where all usage is
implicitly proprietary.

Wdyt?
Adrian

On Apr 23, 2010 12:00 PM, "Paul Querna" <paul@querna.org> wrote:

Hi,

Right now we have several drivers that have more API calls available,
than what is in the standardized libcloud API.

I think we should embrace these, and let drivers be more useful to
people, and if there is ever enough drivers doing something, we should
move the function to a 'standard' API.

I think they do need to be clear to a user/developer that a specific
API is an extension though, and isn't reliable between different
providers, so I believe we should require two things:
 * All extensions have a specific prefix.  For example "ex_", would
mean, "ex_resize_node".
 * In the documentation for an extension function, it should include
something like:
       @warning This is a non-standard extension API, and only works
for driver X.

Thoughts?

Thanks,

Paul

--000e0cd13b6edafac30484ec29a2--