merge for 0.9.4 release

Author: Kip Lehman

README.rst

@@ -31,6 +31,10 @@ Installation
 ````````````
 
 Obtain the requests_ package and install it according to that package's directions.
+As of requests-2.0.0, there is support for HTTPS over HTTP proxy via the CONNECT request.
+Use of requests-2.x or better is recommended for use with pyral.
+The requests_ package can be found via the Python Package Index site (http://pypi/python.org/index).
+
 
 Unpack the ``pyral`` distribution file (zip or tar.gz) and then install the pyral_ package. 
 
@@ -51,11 +55,11 @@ relevant packages.
 :: 
 
    $ python
-   Python 2.6.6 [other Python interpreter info elided ...]
+   Python 2.7.5 [other Python interpreter info elided ...]
    >> import requests
    >> import pyral
    >> pyral.__version__
-   (0, 9, 3)
+   (0, 9, 4)
 
 
 
@@ -250,16 +254,27 @@ Prerequisites
 -------------
 
  * Python 2.6 or 2.7
- * The  requests_ package, 0.8.2 or better
+ * The  requests_ package, 0.9.3 or better
+   Recommend using requests 2.0.0 or better. 2.0.0 finally includes support for https proxy.
    Developed using requests 0.9.3.  
    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)
+   If you are using requests < 1.0.0, you must also have certifi-0.0.8 (available on PyPI)
 
 .. _requests: http://github.com/kennethreitz/requests
 
 Versions
 --------
+   * 0.9.4 -
+            Adjusted Rally __init__ to accommodate using requests 0.x, 1.x, 2.x versions.
+            Factored out query building and fixed constructing multi condition queries.
+            Added internal convenience method to handle a list of refs to turn them into a
+            list of single key (_ref) hashes.
+            Added UserIterationCapacity to known entities.
+            Upped default WSAPI version in config to 1.43
+            Support using of https_proxy / HTTPS_PROXY environment variables.
+            Refactored getAllUsers to include UserProfile information with fewer queries.
+
    * 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.            
@@ -310,20 +325,20 @@ TODO
 ----
 * Python 3.3 + support
 
+* Support Rally WSAPI 2.0
+
 * Expand the documentation
 
 * Expand the repertoire of example scripts
 
 * Refactor the source code to make use decorators in pyral.restapi, 
   dynamically construct the Rally schema hierarchy economically.
 
-* Monitor requests/urllib3 for release that fully supports HTTPS over HTTP proxy.
-
 
 License
 -------
 
-BSD3-style license. Copyright (c) 2010-2012 Rally Software Development.
+BSD3-style license. Copyright (c) 2010-2013 Rally Software Development.
 
 See the LICENSE file provided with the source distribution for full details.
 

README.short

@@ -18,7 +18,9 @@ Requirements
 ------------
 
 The pyral package requires the use of Kenneth Reitz's requests package.
-The pyral package was developed and tested using requests-0.9.3.
+The pyral package was originally developed and tested using requests-0.9.3.
+As of requests-2.0.0, there is support for HTTPS over HTTP proxy via the CONNECT request.
+Use of requests-2.x or better is recommended for use with pyral.
 The requests package can be found via the Python Package Index site (http://pypi/python.org/index).
 
 

VERSIONS

@@ -0,0 +1,55 @@
+0.8.7  - Dec 23, 2011
+    First public release (alpha)
+
+0.8.8  - Jan 2012
+    introduced warn=boolean to Rally instantiation
+    removed inflate=boolean in Rally instantiation
+
+0.8.9  - Jan 2012
+    putative fix for proxy support
+
+0.8.10 - Feb 2012
+    better fix for proxy support
+
+0.8.11 - Mar 24, 2012 
+    better support for default workspace/project when user profile doesn't specify
+       a default
+    fixed assignment of ref value in _createShellArtifact (_ref no longer has the .js on end...)
+
+0.8.12 - Mar 26, 2012
+    fixed fatal premature exercise of iterator on response in context check, defer to _getDefaults
+
+0.9.1 - July 9, 2012
+    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
+
+0.9.2 - October 1, 2012 
+    Fixed getProject method to take an optional name parm.
+    Added HTTP header item in config.py to set Content-Type to 'application/json'
+    Added keyword arg to restapi.Rally __init__ method to
+    allow specifying a verify_ssl_cert=True/False value to requests.session creation,
+      This results is passing on the the requests.session call a verify flag that it
+      uses to determine whether or not checking the SSL certificate is desired.
+      Modified the details method in entity.py to be more resilient by bypassing 
+      attributes that an item might have but doesn't have as a query fetch spec 
+      didn't include all potential attributes.
+    Fixed addAttachment to specify Attachment size as size of original attachment file
+    rather than the size of the base64 encoding result.
+
+0.9.3 - October 7, 2012
+    Fixed Pinger class to use correct ping options on Linux and Windows platforms.
+    Updated exception catching and raising to use Python 2.6/2.7 compliant syntax.
+
+0.9.4 - October 2013
+    Upped default WSAPI version to 1.43.
+    Tested against requests 2.0.0 which now support https via proxy.
+    Updated pyral.restapi.Rally to accommodate requests versions 0.x, 1.x and 2.x.
+    Fixed construction of multi-condition queries and broke out query construction into a separate code file.
+    Support for Rally dyna-types (PortfolioItem/<subtype> where subtype is one of Theme, Initiative or Feature.
+    Added UserIterationCapacity, Fixed the *CumulativeFlowData entity names.
+    Added internal facility to accept Rally reference identifiers in a list form and convert them
+    to a list of dicts with each dict containing a key-value pair for '_ref' and associated value.
+    Added a details method for any WorkspaceDomain derived entity instance.

build_dist.py

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