Repository: jclouds-labs-openstack Updated Branches: refs/heads/master 052e6cc80 -> ab188ef80
Better explanation of Beta APIs Project: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/repo Commit: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/commit/ab188ef8 Tree: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/tree/ab188ef8 Diff: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/diff/ab188ef8 Branch: refs/heads/master Commit: ab188ef803fc002ceed86bd6d86c12dedde95069 Parents: 052e6cc Author: Everett Toews <[email protected]> Authored: Thu Apr 3 17:17:55 2014 -0500 Committer: Everett Toews <[email protected]> Committed: Thu Apr 3 17:33:22 2014 -0500 ---------------------------------------------------------------------- README.md | 14 +++++++++----- openstack-swift/README.md | 5 ++++- .../java/org/jclouds/openstack/swift/v1/SwiftApi.java | 6 +++++- .../openstack/swift/v1/features/AccountApi.java | 4 ++++ .../jclouds/openstack/swift/v1/features/BulkApi.java | 6 +++++- .../openstack/swift/v1/features/ContainerApi.java | 6 +++++- .../openstack/swift/v1/features/ObjectApi.java | 6 +++++- .../swift/v1/features/StaticLargeObjectApi.java | 6 +++++- rackspace-cloudfiles-uk/README.md | 4 +++- rackspace-cloudfiles-us/README.md | 4 +++- rackspace-cloudfiles/README.md | 4 +++- 11 files changed, 51 insertions(+), 14 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index c0c5f08..8304294 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ jclouds Labs OpenStack Repository for developing OpenStack providers and APIs -Although this is a "labs" repository, some of the providers and APIs here are production ready. The reason they have not been merged into into jclouds core is because there isn't a suitable abstraction layer for them yet. Please review the README in each sub-directory to determine if the provider or API is production ready. +Although this is a "labs" repository, some of the providers and APIs here are production ready. The reason they have not been merged into into jclouds repository is because there isn't a suitable abstraction layer for them yet. Please review the README in each sub-directory to determine if the provider or API is production ready. ### Summary @@ -12,16 +12,20 @@ Although this is a "labs" repository, some of the providers and APIs here are pr | openstack-glance | API | No | | openstack-marconi | API | No | | openstack-neutron | API | Yes | -| openstack-swift | API | No | +| openstack-swift | API | Beta | | rackspace-autoscale | API | No | | rackspace-cloudfiles | API | No | | rackspace-autoscale-us | Provider | No | -| rackspace-cloudfiles-uk | Provider | No | -| rackspace-cloudfiles-us | Provider | No | +| rackspace-cloudfiles-uk | Provider | Beta | +| rackspace-cloudfiles-us | Provider | Beta | | rackspace-cloudqueues-us | Provider | No | +APIs new to jclouds are marked as Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. It is recommended you adopt this code sooner than later. + +How long APIs are in Beta is variable but it will be at minimum one release. + License ------- -Copyright (C) 2009-2013 jclouds, Inc. +Copyright (C) 2009-2014 The Apache Software Foundation Licensed under the Apache License, Version 2.0 http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/README.md ---------------------------------------------------------------------- diff --git a/openstack-swift/README.md b/openstack-swift/README.md index c30eb1e..59bd846 100644 --- a/openstack-swift/README.md +++ b/openstack-swift/README.md @@ -4,4 +4,7 @@ OpenStack Swift Swift is a distributed object storage system designed to scale from a single machine to thousands of servers. Production ready? -No +Beta + +This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. This code will replace org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. + http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java index 5a77dce..7874403 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java @@ -41,7 +41,11 @@ import com.google.inject.Provides; * <p/> * OpenStack Object Storage is an object-based storage system that stores content and metadata * as objects. You create, modify, and get objects and metadata using this API. - * + * <p/> + * This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based + * on that feedback, minor changes to the interfaces may happen. This code will replace + * org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. + * * @author Adrian Cole * @author Jeremy Daggett * @author Zack Shoylev http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java index 3d4dcbf..ede3dc9 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java @@ -47,6 +47,10 @@ import com.google.common.annotations.Beta; * <p/> * Account metadata prefixed with {@code X-Account-Meta-} will be converted * appropriately using a binder/parser. + * <p/> + * This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based + * on that feedback, minor changes to the interfaces may happen. This code will replace + * org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. * * @author Jeremy Daggett * http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java index e227c54..ac7677e 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java @@ -46,7 +46,11 @@ import com.google.common.base.Joiner; /** * Provides access to the Swift Bulk API. - * + * <p/> + * This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based + * on that feedback, minor changes to the interfaces may happen. This code will replace + * org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. + * * @author Adrian Cole * @author Jeremy Daggett */ http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java index aee16c9..c98f2bc 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java @@ -53,7 +53,11 @@ import com.google.common.collect.FluentIterable; /** * Provides access to the Swift Container API features. - * + * <p/> + * This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based + * on that feedback, minor changes to the interfaces may happen. This code will replace + * org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. + * * @author Adrian Cole * @author Zack Shoylev * @author Jeremy Daggett http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java index e43fb1b..ec0217b 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java @@ -59,7 +59,11 @@ import com.google.common.annotations.Beta; /** * Provides access to the Swift Object API features. - * + * <p/> + * This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based + * on that feedback, minor changes to the interfaces may happen. This code will replace + * org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. + * * @author Adrian Cole * @author Jeremy Daggett */ http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java index 5414893..c230fa0 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java @@ -44,7 +44,11 @@ import com.google.common.annotations.Beta; /** * Provides access to the Swift Static Large Object API features. - * + * <p/> + * This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based + * on that feedback, minor changes to the interfaces may happen. This code will replace + * org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. + * * @author Adrian Cole * @author Jeremy Daggett */ http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/rackspace-cloudfiles-uk/README.md ---------------------------------------------------------------------- diff --git a/rackspace-cloudfiles-uk/README.md b/rackspace-cloudfiles-uk/README.md index 52ea6ec..71d04bb 100644 --- a/rackspace-cloudfiles-uk/README.md +++ b/rackspace-cloudfiles-uk/README.md @@ -16,4 +16,6 @@ With this multi-region support, a BlobStore can be isolated to a specific region BlobStore dfwBlobStore = ctx.blobStoreInRegion("LON"); Production ready? -No +Beta + +This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. This code will replace org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/rackspace-cloudfiles-us/README.md ---------------------------------------------------------------------- diff --git a/rackspace-cloudfiles-us/README.md b/rackspace-cloudfiles-us/README.md index 25ded8c..9bd50c2 100644 --- a/rackspace-cloudfiles-us/README.md +++ b/rackspace-cloudfiles-us/README.md @@ -17,4 +17,6 @@ With this multi-region support, each BlobStore can be isolated to a specific reg BlobStore iadBlobStore = ctx.blobStoreInRegion("IAD"); Production ready? -No +Beta + +This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. This code will replace org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later. http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/ab188ef8/rackspace-cloudfiles/README.md ---------------------------------------------------------------------- diff --git a/rackspace-cloudfiles/README.md b/rackspace-cloudfiles/README.md index 1142323..3da83d2 100644 --- a/rackspace-cloudfiles/README.md +++ b/rackspace-cloudfiles/README.md @@ -17,4 +17,6 @@ With this multi-region support, each BlobStore can be isolated to a specific reg BlobStore iadBlobStore = ctx.blobStoreInRegion("IAD"); Production ready? -No +Beta + +This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. This code will replace org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later.
