Merge pull request #118 from klehman-rally/master

auto multithreading for queries returning large result sets

Author: klehman-rally

MANIFEST

@@ -7,6 +7,7 @@ rallyfire.py
 pyral/__init__.py
 pyral/config.py
 pyral/context.py
+pyral/cargotruck.py
 pyral/entity.py
 pyral/hydrate.py
 pyral/rallyresp.py

PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 1.1
 Name: pyral
-Version: 1.2.4
+Version: 1.3.0
 Summary: Python toolkit for Rally REST API
 Home-page: https://github.com/RallyTools/RallyRestToolkitForPython
 Author: Kip Lehman (Rally Software Development)
 License: BSD
-Download-URL: https://github.com/RallyTools/RallyRestToolkitForPython/raw/master/dists/pyral-1.2.4.zip
+Download-URL: https://github.com/RallyTools/RallyRestToolkitForPython/raw/master/dists/pyral-1.3.0.zip
 Description: This is the README file for pyral, a package implementing a 
         Pythonic interface to the Agile Central (formerly Rally) REST API
 
@@ -28,7 +28,7 @@ Description: This is the README file for pyral, a package implementing a
         The pyral package requires the use of Kenneth Reitz's requests package using version 2.8.0 or better.
         As of requests version 2.0.0, there is support for HTTPS over HTTP proxy via the CONNECT request.
         The requests package can be found via the Python Package Index site (http://pypi/python.org/index).
-        The most recent release of pyral (1.2.4) has been tested with requests 2.8.1.
+        The most recent release of pyral (1.3.0) has been tested with requests 2.12.5.
         The six module is also required.
 
 

README.rst

@@ -39,7 +39,7 @@ Obtain the requests_ package and install it according to that package's directio
 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).
-The most recent release of pyral (1.2.4) has been tested using requests 2.8.1.
+The most recent release of pyral (1.3.0) has been tested using requests 2.12.5.
 
 Obtain and install the six_ module (available from PyPI at https://pypi.python.org/pypi/six)
 
@@ -67,7 +67,7 @@ relevant packages.
    >> import requests
    >> import pyral
    >> pyral.__version__
-   (1, 2, 4)
+   (1, 3, 0)
 
 
 
@@ -262,17 +262,24 @@ The item names in config files **are** case sensitive.
 Prerequisites
 -------------
 
- * Python 3.5 (this package not tested with earlier versions of Python 3.x) OR
- * Python 2.6 or 2.7 (2.7 is preferred)
+ * Python 3.5 or 3.6 (this package not tested with earlier versions of Python 3.x) OR
+ * Python 2.6 or 2.7 (of these two, 2.7 is preferred)
  * The requests_ package, 2.0.0 or better (2.0.0 finally includes support for https proxy),
-   requests 2.8.1 is recommended.
+   requests 2.12.5 is recommended.
  * The six_ package.
 
 .. _requests: http://github.com/kennethreitz/requests
 .. _six: https://bitbucket.org/gutworth/six
 
 Versions
 --------
+   **1.3.0**
+       Introduced automatic multi-threading for Rally.get operation to speed up retrieval of large
+       result sets.  Implemented step two of the Pinger deprecation plan, ping=False is the new default.
+       Increased default page size to 500.  Maximum useful page size limit is 2000 but 1000 seems
+       to be the sweet spot for multithreading requests.
+       Fixed Rally.getAllUsers so that non subscription admin accounts can see the user list.
+       Updated recommendation for version of requests package.
 
    **1.2.4**
        Fixed handling of projectScopeUp and projectScopeDown keyword arguments for get operation.
@@ -339,8 +346,8 @@ Support
 
 The use of this package is on an *as-is* basis and there is no official support offered by CA Technologies.
 The author of this module periodically checks the GitHub repository issues for this package in the
- interests of providing defect fixes and small feature enhancements as time permits, but is not obligated to
- respond or take action.
+interests of providing defect fixes and small feature enhancements as time permits, but is not obligated to
+respond or take action.
 Posts to Stack Overflow (http://stackoverflow.com/questions/ask?tags=rally) are another avenue to engage
 others who have some exposure to ``pyral`` and might be able to offer useful information.
 

README.short

@@ -20,7 +20,7 @@ Requirements
 The pyral package requires the use of Kenneth Reitz's requests package using version 2.8.0 or better.
 As of requests version 2.0.0, there is support for HTTPS over HTTP proxy via the CONNECT request.
 The requests package can be found via the Python Package Index site (http://pypi/python.org/index).
-The most recent release of pyral (1.2.4) has been tested with requests 2.8.1.
+The most recent release of pyral (1.3.0) has been tested with requests 2.12.5.
 The six module is also required.
 
 

build_dist.py

@@ -13,7 +13,7 @@
 import re
 
 PACKAGE_NAME = "pyral"
-VERSION      = "1.2.4"
+VERSION      = "1.3.0"
 
 AUX_FILES  = ['MANIFEST.in', 
               'PKG-INFO', 
@@ -70,12 +70,13 @@
               'test/test_convenience.py',
               'test/test_inflation.py',
               'test/test_field_access.py',
-              'test/test_query.py',
-              'test/test_search.py',
+              'test/test_workspaces.py'
               'test/test_wksprj_setting.py',
+              'test/test_query.py',
+              'test/test_big_query.py',
               'test/test_attachments.py',
-              'test/test_workspaces.py'
               'test/test_ranking.py'
+              'test/test_search.py',
              ]
 
 ################################################################################
@@ -104,7 +105,7 @@ def main(args):
 
     # got to use Python 2.7 to be able to run python setup.py bdist_wheel
     os.system('/usr/local/bin/python setup.py bdist_wheel')
-    wheel_file = "pyral-%s-py2.py3-none-any.whl" % VERSION
+    wheel_file = "%s-%s-py2.py3-none-any.whl" % (PACKAGE_NAME, VERSION)
     # the wheel_file gets written into the dist  subdir by default, no need for a copy...
 
     store_packages('dist',  [tarball])

doc/build/doctrees/environment.pickle

@@ -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: 04e7a56dd13ad451ac5cbc4d00acee14
+config: b07c03f625d2f2c1cd442854955e285b
 tags: 645f666f9bcd5a90fca523b33c5a78b7