Version 1.6.2 - several bugfixes.

MANIFEST.in

@@ -2,3 +2,4 @@ include README.md RELEASENOTES.md
 recursive-include docs *.md
 recursive-include samples *.py
 recursive-include tests *.py
+recursive-include tests *.png

RELEASENOTES.md

@@ -1,5 +1,21 @@
 # Release Notes for pyrax
 
+###2013.11.13 - Version 1.6.2
+ - Cloud Databases:
+  - Added missing 'host' parameter. GitHub #246
+ - Cloud Queues:
+  - Removed requirement for Client ID for non-message requests. GitHub #244
+  - Added support for ServiceNet queues. GitHub #240
+  - Added the `claim_id` parameter to message deletion calls. GitHub #243
+  - Fixed a bug when parsing message and claim IDs.
+  - Made several corrections in the docs. - Cloud DNS:
+  - Added handling for an occasional empty body when polling a running request.
+    GitHub #237
+ - General:
+  - Added support for Python Wheel distribution
+  - Fixed missing file spec in MANIFEST.in
+  - Removed unneeded files
+
 ###2013.10.31 - Version 1.6.1
  - Cloud Databases:
     - Added support for Backups. GitHub #216

docs/cloud_blockstorage.md

@@ -55,6 +55,7 @@ Parameter | Description | Required
 
 When you create a volume from a snapshot, the new volume is a copy of the volume from which the snapshot was created. The new volume must be the same size as the original volume used to create the snapshot. If you create a new volume from scratch, it is the equivalent of an unformatted disk drive.
 
+There are additional parameters in the response that are not described in the request parameter table above. **`status`** is typically available although it can be creating if the volume is from a snapshot operation. **`availability_zone`** is always "nova". **`bootable`** is currently always False. **`source_volid`** is currently not used by CBS.
 
 Here is an example of the call to create a new 500 GB volume that uses SSD for high performance:
 

docs/cloud_databases.md

@@ -91,16 +91,16 @@ Both calls return an object representing the newly-created database:
 
 
 ## Create a User
-You can create a user on an instance with its own username/password credentials, with access to one or more databases on that instance. Similar to database creation, you can call `create_user()` either on the instance object, or on the module. To simplify these examples, only the call on the instance is displayed.
+You can create a user on an instance with its own username/password credentials, with access to one or more databases on that instance, and optionally restricted to connecting from particular host addresses. Similar to database creation, you can call `create_user()` either on the instance object, or on the module. To simplify these examples, only the call on the instance is displayed.
 
 Assuming that you have the references `inst` and `db` from the previous examples, you can create a user like this:
 
-    user = inst.create_user(name="groucho", password="top secret", database_names=[db])
+    user = inst.create_user(name="groucho", password="top secret", database_names=[db], host="%")
     print "User:", user
 
 This prints out:
 
-    User: <CloudDatabaseUser databases=[{u'name': u'db_name'}], name=groucho>
+    User: <CloudDatabaseUser databases=[{u'name': u'db_name'}], name=groucho, host="%">
 
 
 ## List Databases or Users in an Instance
@@ -114,7 +114,7 @@ Instances have a `list_databases()` and a `list_users()` method:
 which outputs:
 
     DBs: [<CloudDatabaseDatabase name=db_name>]
-    Users: [<CloudDatabaseUser databases=[{u'name': u'db_name'}], name=groucho>]
+    Users: [<CloudDatabaseUser databases=[{u'name': u'db_name'}], name=groucho>, host="%"]
 
 
 ## Get a `CloudDatabaseDatabase` or `CloudDatabaseUser` Object
@@ -128,7 +128,7 @@ You can get a `CloudDatabaseDatabase` or `CloudDatabaseUser` object from an `Clo
 which outputs:
 
     DB: <CloudDatabaseDatabase name=db_name>
-    User: <CloudDatabaseUser databases=[{u'name': u'db_name'}], name=groucho>
+    User: <CloudDatabaseUser databases=[{u'name': u'db_name'}], name=groucho, host="%">
 
 
 ## Backups

docs/html/classpyrax_1_1clouddatabases_1_1CloudDatabaseClient.html

@@ -342,7 +342,13 @@
           <td class="paramkey"></td>
           <td></td>
           <td class="paramtype">&#160;</td>
-          <td class="paramname"><em>database_names</em>&#160;</td>
+          <td class="paramname"><em>database_names</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">&#160;</td>
+          <td class="paramname"><em>host</em> = <code>None</code>&#160;</td>
         </tr>
         <tr>
           <td></td>
@@ -1142,7 +1148,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 31 2013 10:46:49 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:35 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/classpyrax_1_1clouddatabases_1_1CloudDatabaseInstance.html

@@ -350,7 +350,13 @@
           <td class="paramkey"></td>
           <td></td>
           <td class="paramtype">&#160;</td>
-          <td class="paramname"><em>database_names</em>&#160;</td>
+          <td class="paramname"><em>database_names</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">&#160;</td>
+          <td class="paramname"><em>host</em> = <code>None</code>&#160;</td>
         </tr>
         <tr>
           <td></td>
@@ -918,7 +924,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 31 2013 10:46:49 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:35 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/classpyrax_1_1queueing_1_1Queue.html

@@ -127,7 +127,7 @@
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classpyrax_1_1queueing_1_1Queue.html#a56468e8bf0910ac8be0def8886f1feae">get_message</a></td></tr>
 <tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns the message whose ID matches the supplied msg_id from this queue.  <a href="#a56468e8bf0910ac8be0def8886f1feae"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classpyrax_1_1queueing_1_1Queue.html#acff825cd612230881431faa0b8f1ba64">delete_message</a></td></tr>
-<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Deletes the message whose ID matches the supplied msg_id from this queue.  <a href="#acff825cd612230881431faa0b8f1ba64"></a><br/></td></tr>
+<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Deletes the message whose ID matches the supplied msg_id from the specified queue.  <a href="#acff825cd612230881431faa0b8f1ba64"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classpyrax_1_1queueing_1_1Queue.html#a9b522b4ef7526bfa60b78fe735caa55c">list</a></td></tr>
 <tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns a list of messages for this queue.  <a href="#a9b522b4ef7526bfa60b78fe735caa55c"></a><br/></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classpyrax_1_1queueing_1_1Queue.html#ae6ec4aa7bb7da740187a3039da271f47">list_by_ids</a></td></tr>
@@ -291,7 +291,13 @@
           <td class="paramkey"></td>
           <td></td>
           <td class="paramtype">&#160;</td>
-          <td class="paramname"><em>msg_id</em>&#160;</td>
+          <td class="paramname"><em>msg_id</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">&#160;</td>
+          <td class="paramname"><em>claim_id</em> = <code>None</code>&#160;</td>
         </tr>
         <tr>
           <td></td>
@@ -302,7 +308,8 @@
 </div>
 <div class="memdoc">
 
-<p>Deletes the message whose ID matches the supplied msg_id from this queue. </p>
+<p>Deletes the message whose ID matches the supplied msg_id from the specified queue. </p>
+<p>If the message has been claimed, the ID of that claim must be passed as the 'claim_id' parameter. </p>
 
 </div>
 </div>
@@ -659,7 +666,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 24 2013 09:26:05 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:38 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/classpyrax_1_1queueing_1_1QueueClient.html

@@ -266,7 +266,13 @@
           <td class="paramkey"></td>
           <td></td>
           <td class="paramtype">&#160;</td>
-          <td class="paramname"><em>msg_id</em>&#160;</td>
+          <td class="paramname"><em>msg_id</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">&#160;</td>
+          <td class="paramname"><em>claim_id</em> = <code>None</code>&#160;</td>
         </tr>
         <tr>
           <td></td>
@@ -278,6 +284,7 @@
 <div class="memdoc">
 
 <p>Deletes the message whose ID matches the supplied msg_id from the specified queue. </p>
+<p>If the message has been claimed, the ID of that claim must be passed as the 'claim_id' parameter. </p>
 
 </div>
 </div>
@@ -841,7 +848,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 24 2013 09:26:06 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:38 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/classpyrax_1_1queueing_1_1QueueMessage-members.html

@@ -97,7 +97,8 @@
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#a043a7693e1d2d30988a0f821e0ab5f94">age</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html">QueueMessage</a></td><td><code> [static]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#a14d48c2e9f05d0b03044eb45f308fcb0">body</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html">QueueMessage</a></td><td><code> [static]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#a4fba796dda2883012b75419f84e148ee">claim_id</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html">QueueMessage</a></td><td><code> [static]</code></td></tr>
-  <tr class="memlist"><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html#ab48bde70a0927a83d62464cb0627c34b">delete</a></td><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html">BaseResource</a></td><td></td></tr>
+  <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#ab48bde70a0927a83d62464cb0627c34b">delete</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html">QueueMessage</a></td><td></td></tr>
+  <tr class="memlist"><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html#ab48bde70a0927a83d62464cb0627c34b">pyrax::resource::BaseResource.delete</a></td><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html">BaseResource</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html#a444a1328efb32d5d9d2dcb2efe855d3b">get</a></td><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html">BaseResource</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html#ab6f7bc0828ee3d547e244dd336572d76">get_details</a></td><td><a class="el" href="classpyrax_1_1resource_1_1BaseResource.html">BaseResource</a></td><td><code> [static]</code></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#aecfca4286e302d5d945be6fe76b99c86">href</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html">QueueMessage</a></td><td><code> [static]</code></td></tr>
@@ -127,7 +128,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 24 2013 09:26:05 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:38 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/classpyrax_1_1queueing_1_1QueueMessage.html

@@ -100,6 +100,7 @@
 </div>
 <div class="header">
   <div class="summary">
+<a href="#pub-methods">Public Member Functions</a> &#124;
 <a href="#pub-static-attribs">Static Public Attributes</a>  </div>
   <div class="headertitle">
 <div class="title">QueueMessage Class Reference</div>  </div>
@@ -120,6 +121,10 @@
 
 <p><a href="classpyrax_1_1queueing_1_1QueueMessage-members.html">List of all members.</a></p>
 <table class="memberdecls">
+<tr><td colspan="2"><h2><a name="pub-methods"></a>
+Public Member Functions</h2></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">def&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#ab48bde70a0927a83d62464cb0627c34b">delete</a></td></tr>
+<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Deletes this message from its queue.  <a href="#ab48bde70a0927a83d62464cb0627c34b"></a><br/></td></tr>
 <tr><td colspan="2"><h2><a name="pub-static-attribs"></a>
 Static Public Attributes</h2></td></tr>
 <tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#acf2488b95c97e0378c9bf49de3b50f28">id</a> = None</td></tr>
@@ -131,7 +136,38 @@
 </table>
 <hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
 <div class="textblock"><p>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>. </p>
-</div><hr/><h2>Member Data Documentation</h2>
+</div><hr/><h2>Member Function Documentation</h2>
+<a class="anchor" id="ab48bde70a0927a83d62464cb0627c34b"></a><!-- doxytag: member="pyrax::queueing::QueueMessage::delete" ref="ab48bde70a0927a83d62464cb0627c34b" args="" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">def <a class="el" href="classpyrax_1_1queueing_1_1QueueMessage.html#ab48bde70a0927a83d62464cb0627c34b">delete</a> </td>
+          <td>(</td>
+          <td class="paramtype">&#160;</td>
+          <td class="paramname"><em>self</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">&#160;</td>
+          <td class="paramname"><em>claim_id</em> = <code>None</code>&#160;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>Deletes this message from its queue. </p>
+<p>If the message has been claimed, the ID of that claim must be passed as the 'claim_id' parameter. </p>
+
+</div>
+</div>
+<hr/><h2>Member Data Documentation</h2>
 <a class="anchor" id="a043a7693e1d2d30988a0f821e0ab5f94"></a><!-- doxytag: member="pyrax::queueing::QueueMessage::age" ref="a043a7693e1d2d30988a0f821e0ab5f94" args="" -->
 <div class="memitem">
 <div class="memproto">
@@ -233,7 +269,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 24 2013 09:26:05 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:38 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/classpyrax_1_1queueing_1_1QueueMessageManager-members.html

@@ -95,7 +95,8 @@
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#a59de7bcf6dec48b06d00ff9b771ef6b7">add_hook</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#a6da13b696f737097e0146e47cc0d0985">api</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#a5b7ef0221e471e99fa7f0a87a28ba1ea">create</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
-  <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#ab48bde70a0927a83d62464cb0627c34b">delete</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
+  <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessageManager.html#ab48bde70a0927a83d62464cb0627c34b">delete</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessageManager.html">QueueMessageManager</a></td><td></td></tr>
+  <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#ab48bde70a0927a83d62464cb0627c34b">pyrax::queueing::BaseQueueManager.delete</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessageManager.html#ab3f3c42b68d285259934117c1a8f65e5">delete_by_ids</a></td><td><a class="el" href="classpyrax_1_1queueing_1_1QueueMessageManager.html">QueueMessageManager</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#a01f90f57b7acd55e177611f5d0f7df23">find</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
   <tr class="memlist"><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html#a1bae9ed7d134ea1c1e9a39726adea1e1">findall</a></td><td><a class="el" href="classpyrax_1_1manager_1_1BaseManager.html">BaseManager</a></td><td></td></tr>
@@ -127,7 +128,7 @@
 
 
 <hr class="footer"/><address class="footer"><small>
-Generated on Thu Oct 24 2013 09:26:05 for pyrax by &#160;<a href="http://www.doxygen.org/index.html">
+Generated on Wed Nov 13 2013 15:09:38 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>