Version 1.6.0 - adds support for Cloud Queues (Marconi).

RELEASENOTES.md

@@ -1,5 +1,35 @@
 # Release Notes for pyrax
 
+###2013.10.24 - Version 1.6.0
+ - New:
+    - Added support for **Cloud Queues** (Marconi).
+ - Cloud Files:
+    - Fixed an issue where the `last_modified` datetime values for Cloud Files
+      storage_objects were returned inconsistently.
+    - Added ability to cache `temp_url_key`. GitHub #221
+    - Added ability to do partial downloads. GitHub #150
+    - Fixed an issue where calling `delete_object_in_seconds()` deleted existing
+      metadata. GitHub #135
+ - Cloud Databases:
+    - Added missing pagination parameters to several methods. GitHub #226
+ - Cloud DNS:
+    - Changed the `findall()` method to be case-insensitive.
+    - Fixed some error-handling issues. GitHub #219
+ - Auto Scale:
+    - Added code to force 'flavor' arguments to `str` type.
+    - Fixed creation/retrieval of webhooks with policy ID.
+    - Added several replacement methods for configurations.
+ - Load Balancers:
+    - Removed requirement that nodes be passed when creating a load balancer.
+      GitHub #222
+ - Testing:
+    - Improved the smoketest.py integrated test script by adding more services.
+    - Fixed the smoketest to work when running in multiple regions that don't
+      all offer the same services.
+ - General:
+    - Refactored the `_create_body()` method from the `BaseClient` class to the
+      `BaseManager` class.
+
 ###2013.10.04 - Version 1.5.1
  - Pyrax in general:
      - Moved the `get_limits()` behavior to the base client (Nate House)

docs/cloud_loadbalancers.md

@@ -9,7 +9,7 @@ Once you have authenticated and connected to the load balancer service, you can
 
 For the sake of brevity and convenience, it is common to define abbreviated aliases for the modules. All the code in the document assumes that at the top of your script, you have added the following lines:
 
-    clb = pyrax.cloudloadbalancers
+    clb = pyrax.cloud_loadbalancers
     cs = pyrax.cloudservers
 
 
@@ -149,7 +149,7 @@ DNS_TCP | This protocol works with IPv6 and allows your DNS server to receive tr
 DNS_UDP | This protocol works with IPv6 and allows your DNS server to receive traffic using UDP port 53.
 FTP | The File Transfer Protocol defines how files are transported over the Internet. It is typically used when downloading or uploading files to or from web servers.
 HTTP | The Hypertext Transfer Protocol defines how communications occur on the Internet between clients and web servers. For example, if you request a web page in your browser, HTTP defines how the web server fetches the page and returns it your browser.
-HTTPS | The Hypertext Transfer Protocol over Secure Socket Layer (SSL) provides encrypted communication over the Internet. It securely verifies the authenticity of the web server you are communicating with. 
+HTTPS | The Hypertext Transfer Protocol over Secure Socket Layer (SSL) provides encrypted communication over the Internet. It securely verifies the authenticity of the web server you are communicating with.
 IMAPS | The Internet Message Application Protocol over Secure Socket Layer (SSL) defines how an email client, such as Microsoft Outlook, retrieves and transfers email messages with a mail server.
 IMAPv2 | Version 2 of IMAPS.
 IMAPv3 | Version 3 of IMAPS.
@@ -163,7 +163,7 @@ SFTP | The SSH File Transfer Protocol is a secure file transfer and management p
 SMTP | The Simple Mail Transfer Protocol is used by electronic mail servers to send and receive email messages. Email clients use this protocol to relay messages to another computer or web server, but use IMAP or POP to send and receive messages.
 TCP | The Transmission Control Protocol is a part of the Transport Layer protocol and is one of the core protocols of the Internet Protocol Suite. It provides a reliable, ordered delivery of a stream of bytes from one program on a computer to another program on another computer. Applications that require an ordered and reliable delivery of packets use this protocol.
 TCP_CLIE (TCP_CLIENT_FIRST) | This protocol is similiar to TCP, but is more efficient when a client is expected to write the data first.
-UDP | The User Datagram Protocol provides a datagram service that emphasizes speed over reliability, It works well with applications that provide security through other measures. 
+UDP | The User Datagram Protocol provides a datagram service that emphasizes speed over reliability, It works well with applications that provide security through other measures.
 UDP_STRE (UDP_STREAM) | This protocol is designed to stream media over networks and is built on top of UDP.
 
 

docs/cloud_servers.md

@@ -2,6 +2,8 @@
 
 ----
 
+*Note: pyrax works with OpenStack-based clouds. Rackspace's "First Generation" servers are based on a different API, and are not supported.*
+
 ## Listing Servers
 Start by listing all the servers in your account:
 

docs/getting_started.md

@@ -4,7 +4,7 @@
 
 
 ## Getting Started With pyrax
-**pyrax** is the Python language binding for **OpenStack** and the **Rackspace Cloud**. By installing pyrax, you have the ability to build on any OpenStack cloud using standard Python objects and code.
+**pyrax** is the Python language binding for **OpenStack** and the **Rackspace Cloud**. By installing pyrax, you have the ability to build on any OpenStack cloud using standard Python objects and code. *Note: since pyrax works with the OpenStack API, it does not support Rackspace's "First Generation" Cloud Servers, which are based on a different technology.*
 
 
 ## Prerequisites

docs/html/____init_____8py.html

@@ -143,6 +143,8 @@
 <tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a client for working with cloud monitoring.  <a href="#a56d538a03d4ded8621b4e483c93b5f1a"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a1773238b5af2fb51b54754bbe83b2971">connect_to_autoscale</a></td></tr>
 <tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a client for working with AutoScale.  <a href="#a1773238b5af2fb51b54754bbe83b2971"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#ac8d659180e8fac04349063827198b196">connect_to_queues</a></td></tr>
+<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a client for working with Queues.  <a href="#ac8d659180e8fac04349063827198b196"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a2766ee16854adf9575c29ac661f447fd">get_http_debug</a></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a9d6ec1abac4bb1602676632e096ac945">set_http_debug</a></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a449ca982d93692884375caa2d609b3b0">get_encoding</a></td></tr>
@@ -161,6 +163,7 @@
 <tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#af25ef81616c79ed5da4655185879259f">cloud_networks</a> = None</td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a312b914939298c0bef9d8665edc44646">cloud_monitoring</a> = None</td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a71d7ac858bc96ae6302115ab8fe7095a">autoscale</a> = None</td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a66c651710751cc178b5a5c0f029a9e8f">queues</a> = None</td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#affa3c4afe67ff7c721e823ac8b67fa16">default_region</a> = None</td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#ab8005f4babffb239fd05dbb8c38551b7">default_encoding</a> = &quot;utf-8&quot;</td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">dictionary&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacepyrax.html#a9f379c663a918bd5beb1ed160f2b0c4d">settings</a> = {}</td></tr>
@@ -192,7 +195,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Wed Sep 4 2013 09:51:56 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Thu Oct 24 2013 09:26:02 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
 <img class="footer" src="doxygen.png" alt="doxygen"/>
 </a> 1.7.6.1
 </small></address>

docs/html/annotated.html

@@ -96,6 +96,7 @@
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1base__identity_1_1BaseAuth.html">BaseAuth</a></td><td class="indexvalue">This class handles all of the basic authentication requirements for working with an OpenStack Cloud system </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1client_1_1BaseClient.html">BaseClient</a></td><td class="indexvalue">The base class for all pyrax clients </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td class="indexvalue">Managers interact with a particular type of API (servers, databases, dns, etc.) and provide CRUD operations for them </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1BaseQueueManager.html">BaseQueueManager</a></td><td class="indexvalue">This class attempts to add in all the common deviations from the API standards that the regular base classes are based on </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html">BaseResource</a></td><td class="indexvalue">A resource represents a particular instance of an object (server, flavor, etc) </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1cf__wrapper_1_1client_1_1BulkDeleter.html">BulkDeleter</a></td><td class="indexvalue">Threading class to allow for bulk deletion of objects from a container </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1CDNFailed.html">CDNFailed</a></td><td class="indexvalue"></td></tr>
@@ -151,6 +152,7 @@
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1DomainRecordUpdateFailed.html">DomainRecordUpdateFailed</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1clouddns_1_1DomainResultsIterator.html">DomainResultsIterator</a></td><td class="indexvalue"><a class="el" href="classpyrax_1_1clouddns_1_1ResultsIterator.html" title="This object will iterate over all the results for a given type of listing, no matter how many items e...">ResultsIterator</a> subclass for iterating over all domains </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1DomainUpdateFailed.html">DomainUpdateFailed</a></td><td class="indexvalue"></td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1DuplicateQueue.html">DuplicateQueue</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1DuplicateUser.html">DuplicateUser</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1EndpointNotDefined.html">EndpointNotDefined</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1EndpointNotFound.html">EndpointNotFound</a></td><td class="indexvalue"></td></tr>
@@ -178,6 +180,7 @@
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidNodeCondition.html">InvalidNodeCondition</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidNodeParameters.html">InvalidNodeParameters</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidPTRRecord.html">InvalidPTRRecord</a></td><td class="indexvalue"></td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidQueueName.html">InvalidQueueName</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidSessionPersistenceType.html">InvalidSessionPersistenceType</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidSetting.html">InvalidSetting</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1InvalidSize.html">InvalidSize</a></td><td class="indexvalue"></td></tr>
@@ -191,6 +194,7 @@
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1KeyringUsernameMissing.html">KeyringUsernameMissing</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1identity_1_1keystone__identity_1_1KeystoneIdentity.html">KeystoneIdentity</a></td><td class="indexvalue">Implements the Keystone-specific behaviors for Identity </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1MissingAuthSettings.html">MissingAuthSettings</a></td><td class="indexvalue"></td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1MissingClaimParameters.html">MissingClaimParameters</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1MissingDNSSettings.html">MissingDNSSettings</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1MissingHealthMonitorSettings.html">MissingHealthMonitorSettings</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1MissingLoadBalancerParameters.html">MissingLoadBalancerParameters</a></td><td class="indexvalue"></td></tr>
@@ -226,6 +230,14 @@
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1PTRRecordDeletionFailed.html">PTRRecordDeletionFailed</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1PTRRecordUpdateFailed.html">PTRRecordUpdateFailed</a></td><td class="indexvalue"></td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1PyraxException.html">PyraxException</a></td><td class="indexvalue"></td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1Queue.html">Queue</a></td><td class="indexvalue">This class represents a <a class="el" href="classpyrax_1_1queueing_1_1Queue.html" title="This class represents a Queue.">Queue</a> </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1QueueClaim.html">QueueClaim</a></td><td class="indexvalue">This class represents a Claim for a Message posted by a consumer </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1QueueClaimManager.html">QueueClaimManager</a></td><td class="indexvalue">Manager class for a <a class="el" href="classpyrax_1_1queueing_1_1Queue.html" title="This class represents a Queue.">Queue</a> Claims </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1QueueClient.html">QueueClient</a></td><td class="indexvalue">This is the primary class for interacting with Cloud Queues </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1exceptions_1_1QueueClientIDNotDefined.html">QueueClientIDNotDefined</a></td><td class="indexvalue"></td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1QueueManager.html">QueueManager</a></td><td class="indexvalue">Manager class for a <a class="el" href="classpyrax_1_1queueing_1_1Queue.html" title="This class represents a Queue.">Queue</a> </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html">QueueMessage</a></td><td class="indexvalue">This class represents a Message posted to a <a class="el" href="classpyrax_1_1queueing_1_1Queue.html" title="This class represents a Queue.">Queue</a> </td></tr>
+  <tr><td class="indexkey"><a class="el" href="classpyrax_1_1queueing_1_1QueueMessageManager.html">QueueMessageManager</a></td><td class="indexvalue">Manager class for a <a class="el" href="classpyrax_1_1queueing_1_1Queue.html" title="This class represents a Queue.">Queue</a> Message </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1identity_1_1rax__identity_1_1RaxIdentity.html">RaxIdentity</a></td><td class="indexvalue">This class handles all of the authentication requirements for working with the Rackspace Cloud </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1clouddns_1_1RecordResultsIterator.html">RecordResultsIterator</a></td><td class="indexvalue"><a class="el" href="classpyrax_1_1clouddns_1_1ResultsIterator.html" title="This object will iterate over all the results for a given type of listing, no matter how many items e...">ResultsIterator</a> subclass for iterating over all domain records </td></tr>
   <tr><td class="indexkey"><a class="el" href="classpyrax_1_1clouddns_1_1ResultsIterator.html">ResultsIterator</a></td><td class="indexvalue">This object will iterate over all the results for a given type of listing, no matter how many items exist </td></tr>
@@ -271,7 +283,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Fri Oct 4 2013 13:36:40 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Thu Oct 24 2013 09:26:06 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
 <img class="footer" src="doxygen.png" alt="doxygen"/>
 </a> 1.7.6.1
 </small></address>