fixed Pinger in context.py, refactored hydrate.py, updated exception raising and catching to Python 2.6/2.7 compliance

Author: klehman-rally

README.rst

@@ -51,11 +51,11 @@ relevant packages.
 :: 
 
    $ python
-   Python 2.6.5 [other Python interpreter info elided ...]
+   Python 2.6.6 [other Python interpreter info elided ...]
    >> import requests
    >> import pyral
    >> pyral.__version__
-   (0, 9, 2)
+   (0, 9, 3)
 
 
 
@@ -255,41 +255,50 @@ Prerequisites
    There are reports where requests > 0.9.3 resulted in connection problems (as in not being able to connect) that may be related to SSL.  You should be able to use the verify_ssl_cert keyword argument when
    obtaining a pyral Rally instance to overcome this issue.
    If you are using requests >- 0.9.3, you must also have certifi-0.0.8 (available on PyPI)
+
 .. _requests: http://github.com/kennethreitz/requests
 
 Versions
 --------
-   * 0.9.2 -  Fixed getProject to take optional project name argument.
-              Added HTTP header item in config.py to set Content-TYpe to 'application/json'.
-              Added recognition of verify_ssl_cert=True/False as keyword argment to
-              Rally constructor.  Explicit specification results in passing a
-              verify=True/False to the underlying requests package. This can be
-              useful when dealing with an expired SSL certificate.
-              Upped default WSAPI version in config.py to 1.37 to support dyna-types
-              (specifically PortfolioItem and sub-types)..
-              Modified addAttachment to conform with non-backward compatible change in Rally WSAPI 
-              involving how an attachment is related to an artifact.
-              Fixed defect in calculating an Attachment file size 
-                 (use pre-encoded rather than post-encoded size).
-              This release is intended as the final beta before a 1.0 release.
-
-   * 0.9.1 -  Upped default WSAPI version in config.py to 1.30
-              All entities that are subclasses of WorkspaceDomainObject now have a details method
-              that show the attribute values in an easy to read multiline format.
-              Dropped attempted discrimination of server value to determine if it is a name or an IPv4 address    No longer look for http_proxy in environment, only https_proxy.
-              Introduced convenience methods dealing with attachments.
-              Corrected resource URL construction for the major ops (GET, PUT, POST, DEL)
-              when project=None specified (useful for Workspace spanning activities).
+   * 0.9.3 -
+            Fixed Pinger class to use correct ping options on Linux and Windows
+            Updated exception catching and exception raising to Python 2.6/2.7 syntax.            
+
+   * 0.9.2 -  
+            Fixed getProject to take optional project name argument.
+            Added HTTP header item in config.py to set Content-TYpe to 'application/json'.
+            Added recognition of verify_ssl_cert=True/False as keyword argment to
+            Rally constructor.  Explicit specification results in passing a
+            verify=True/False to the underlying requests package. This can be
+            useful when dealing with an expired SSL certificate.
+            Upped default WSAPI version in config.py to 1.37 to support dyna-types
+            (specifically PortfolioItem and sub-types)..
+            Modified addAttachment to conform with non-backward compatible change in Rally WSAPI 
+            involving how an attachment is related to an artifact.
+            Fixed defect in calculating an Attachment file size (use pre-encoded rather than post-encoded size).
+
+            This release is intended as the final beta before a 1.0 release.
+
+   * 0.9.1 -  
+            Upped default WSAPI version in config.py to 1.30
+            All entities that are subclasses of WorkspaceDomainObject now have a details method
+            that show the attribute values in an easy to read multiline format.
+            Dropped attempted discrimination of server value to determine if it is a name or an IPv4 address    No longer look for http_proxy in environment, only https_proxy.
+            Introduced convenience methods dealing with attachments.
+            Corrected resource URL construction for the major ops (GET, PUT, POST, DEL)
+            when project=None specified (useful for Workspace spanning activities).
 
    * 0.8.12 - Fixed premature exercise of iterator in initial response
 
-   * 0.8.11 - Fixed inappropriate error message when initial connect attempt timed out.
-              Message had stated that the target server did not speak the Rally WSAPI.
-              Improved context handling with respect to workspace and project settings.
+   * 0.8.11 -
+            Fixed inappropriate error message when initial connect attempt timed out. 
+            Message had stated that the target server did not speak the Rally WSAPI.  
+            Improved context handling with respect to workspace and project settings.
 
-   * 0.8.10 - Attempted to bolster proxy handling. 
-              Limited success as there is an outstanding issue in
-              requests (urllib3) not implementing CONNECT for https over http.
+   * 0.8.10 - 
+            Attempted to bolster proxy handling.  
+            Limited success as there is an outstanding issue in equests (urllib3) not 
+            implementing CONNECT for https over http.
 
    * 0.8.9 -  initial attempt at providing proxy support
 
@@ -299,7 +308,6 @@ Versions
 
 TODO
 ----
-
 * Python 3.3 + support
 
 * Expand the documentation

README.short

@@ -28,7 +28,7 @@ Installation
 Once requests has been installed, run the setup.py program supplied with 
 this distribution as::
 
-    python setup.py install.
+    python setup.py install
 
 Validation
 ----------

build_dist.py

@@ -11,7 +11,7 @@
 import zipfile
 
 PACKAGE_NAME = "pyral"
-VERSION      = "0.9.2"
+VERSION      = "0.9.3"
 
 AUX_FILES  = ['MANIFEST.in', 
               'LICENSE', 

dists/pyral-0.9.3.tar.gz

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 26696598777bc580c07365a7f6fb1114
+config: 7459fb71318d56c13b8d6940f521b5e4
 tags: fbb0d17656682115ca4d033fb2f83ba1

dists/pyral-0.9.3.zip

@@ -7,13 +7,13 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
-    <title>Index &mdash; pyral v0.9.2 documentation</title>
+    <title>Index &mdash; pyral v0.9.3 documentation</title>
     <link rel="stylesheet" href="_static/default.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.9.2',
+        VERSION:     '0.9.3',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -22,7 +22,7 @@
     <script type="text/javascript" src="_static/jquery.js"></script>
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="top" title="pyral v0.9.2 documentation" href="index.html" /> 
+    <link rel="top" title="pyral v0.9.3 documentation" href="index.html" /> 
   </head>
   <body>
     <div class="related">
@@ -31,7 +31,7 @@ <h3>Navigation</h3>
         <li class="right" style="margin-right: 10px">
           <a href="#" title="General Index"
              accesskey="I">index</a></li>
-        <li><a href="index.html">pyral v0.9.2 documentation</a> &raquo;</li> 
+        <li><a href="index.html">pyral v0.9.3 documentation</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -194,7 +194,7 @@ <h3>Navigation</h3>
         <li class="right" style="margin-right: 10px">
           <a href="#" title="General Index"
              >index</a></li>
-        <li><a href="index.html">pyral v0.9.2 documentation</a> &raquo;</li> 
+        <li><a href="index.html">pyral v0.9.3 documentation</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer">

doc/build/doctrees/environment.pickle

@@ -7,13 +7,13 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
-    <title>pyral documentation! &mdash; pyral v0.9.2 documentation</title>
+    <title>pyral documentation! &mdash; pyral v0.9.3 documentation</title>
     <link rel="stylesheet" href="_static/default.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.9.2',
+        VERSION:     '0.9.3',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -22,7 +22,7 @@
     <script type="text/javascript" src="_static/jquery.js"></script>
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="top" title="pyral v0.9.2 documentation" href="#" />
+    <link rel="top" title="pyral v0.9.3 documentation" href="#" />
     <link rel="next" title="Python toolkit for the Rally REST API" href="overview.html" /> 
   </head>
   <body>
@@ -35,7 +35,7 @@ <h3>Navigation</h3>
         <li class="right" >
           <a href="overview.html" title="Python toolkit for the Rally REST API"
              accesskey="N">next</a> |</li>
-        <li><a href="#">pyral v0.9.2 documentation</a> &raquo;</li> 
+        <li><a href="#">pyral v0.9.3 documentation</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -132,7 +132,7 @@ <h3>Navigation</h3>
         <li class="right" >
           <a href="overview.html" title="Python toolkit for the Rally REST API"
              >next</a> |</li>
-        <li><a href="#">pyral v0.9.2 documentation</a> &raquo;</li> 
+        <li><a href="#">pyral v0.9.3 documentation</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer">

doc/build/html/.buildinfo

@@ -7,13 +7,13 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
-    <title>Primary pyral classes and functions &mdash; pyral v0.9.2 documentation</title>
+    <title>Primary pyral classes and functions &mdash; pyral v0.9.3 documentation</title>
     <link rel="stylesheet" href="_static/default.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.9.2',
+        VERSION:     '0.9.3',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -22,7 +22,7 @@
     <script type="text/javascript" src="_static/jquery.js"></script>
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
-    <link rel="top" title="pyral v0.9.2 documentation" href="index.html" />
+    <link rel="top" title="pyral v0.9.3 documentation" href="index.html" />
     <link rel="prev" title="Python toolkit for the Rally REST API" href="overview.html" /> 
   </head>
   <body>
@@ -35,7 +35,7 @@ <h3>Navigation</h3>
         <li class="right" >
           <a href="overview.html" title="Python toolkit for the Rally REST API"
              accesskey="P">previous</a> |</li>
-        <li><a href="index.html">pyral v0.9.2 documentation</a> &raquo;</li> 
+        <li><a href="index.html">pyral v0.9.3 documentation</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -715,7 +715,7 @@ <h3>Navigation</h3>
         <li class="right" >
           <a href="overview.html" title="Python toolkit for the Rally REST API"
              >previous</a> |</li>
-        <li><a href="index.html">pyral v0.9.2 documentation</a> &raquo;</li> 
+        <li><a href="index.html">pyral v0.9.3 documentation</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer">