Merge branch 'wsapi2'

Author: klehman-rally

LICENSE

@@ -1,4 +1,4 @@
-Copyright © 2010-2012, Rally Software Development Corp.  Boulder, Colorado USA
+Copyright © 2010-2014, Rally Software Development Corp.  Boulder, Colorado USA
 All rights reserved.
 
 License for pyral (a Python toolkit for the Rally REST API)

MANIFEST

@@ -23,3 +23,5 @@ examples/wkspcounts.py
 examples/builddefs.py
 examples/creattach.py
 examples/get_attachments.py
+examples/get_schema.py
+examples/add_tcrs.py

MANIFEST.in

@@ -11,15 +11,17 @@ pyral/entity.py
 pyral/hydrate.py
 pyral/rallyresp.py
 pyral/restapi.py
-examples/getitem.py
+examples/typedef.py
+examples/get_schema.py
 examples/periscope.py
+examples/getitem.py
 examples/showdefects.py
 examples/statecounts.py
+examples/wkspcounts.py
 examples/crtask.py
 examples/uptask.py
-examples/typedefs.py
 examples/repoitems.py
-examples/wkspcounts.py
 examples/builddefs.py
 examples/creattach.py
 examples/get_attachments.py
+examples/add_tcrs.py

README.rst

@@ -2,7 +2,7 @@ pyral - A Python toolkit for the Rally REST API
 ===============================================
 
 
-The `pyral <http://github.com/Rallydev/pyral>`_ package enables you to push, pull
+The `pyral <http://github.com/RallyTools/RallyRestToolkitForPython>`_ package enables you to push, pull
 and otherwise wrangle the data in your Rally subscription using the popular
 and productive Python language.
 The ``pyral`` package provides a smooth and easy to use veneer on top
@@ -24,7 +24,7 @@ Files are available at the `download page`_ .
 
 .. _download page: http://pypi.python.org/pypi/pyral
 
-The git repository is available at http://github.com/Rallydev/pyral
+The git repository is available at https://github.com/RallyTools/RallyRestToolkitForPython
 
 
 Installation
@@ -59,7 +59,7 @@ relevant packages.
    >> import requests
    >> import pyral
    >> pyral.__version__
-   (0, 9, 4)
+   (1, 0, 0)
 
 
 
@@ -228,7 +228,6 @@ create an instance of the Rally class.
   PASSWORD                             password for the Rally subscription UserName
   WORKSPACE                            Rally Workspace
   PROJECT                              Rally Project
-  VERSION                              Rally REST Web Services API version
 ====================================== =========================================
 
 The item names in config files **are** case sensitive.
@@ -246,25 +245,28 @@ The item names in config files **are** case sensitive.
   --rallyPassword=<bar>                 password associated with the Rally UserName
   --rallyWorkspace=<bar>                Workspace in Rally you want to interact with
   --rallyProject=<bar>                  Project in Rally you want to interact with
-  --rallyVersion=<bar>                  Rally REST Web Services API version
 ====================================== =========================================
 
 
 Prerequisites
 -------------
 
- * Python 2.6 or 2.7
- * 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 < 1.0.0, you must also have certifi-0.0.8 (available on PyPI)
+ * Python 2.6 or 2.7 (2.7 is preferred)
+ * The requests_ package, 2.0.0 or better (2.0.0 finally includes support for https proxy)
 
 .. _requests: http://github.com/kennethreitz/requests
 
 Versions
 --------
+
+   * 1.0.0 - 
+            Default WSAPI version in config is v2.0. This version is not compatible 
+            with Rally WSAPI version 1.x.  
+            Adjusted the RallyUrlBuilder (via RallyQueryFormatter) to be more resilient
+            with respect to many more "special" characters (non-alphanumeric).
+            Retrieving the meta data uses the v2.0 schema endpoint.
+            No longer support a version keyword argument when obtaining a Rally instance.
+
    * 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.
@@ -323,22 +325,15 @@ Versions
 
 TODO
 ----
-* Python 3.3 + support
-
-* Support Rally WSAPI 2.0
-
-* Expand the documentation
-
-* Expand the repertoire of example scripts
+* Python 3.3+ support
 
-* Refactor the source code to make use decorators in pyral.restapi, 
-  dynamically construct the Rally schema hierarchy economically.
+* Dynamically construct the Rally schema hierarchy economically.
 
 
 License
 -------
 
-BSD3-style license. Copyright (c) 2010-2013 Rally Software Development.
+BSD3-style license. Copyright (c) 2010-2014 Rally Software Development.
 
 See the LICENSE file provided with the source distribution for full details.
 

README.short

@@ -17,10 +17,8 @@ that may be references or collections via the familiar dot '.' notation.
 Requirements
 ------------
 
-The pyral package requires the use of Kenneth Reitz's requests package.
-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 pyral package requires the use of Kenneth Reitz's requests package using version 2.0.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).
 
 

build_dist.py

@@ -1,4 +1,4 @@
-#!/opt/local/bin/python2.6
+#!/usr/bin/env python
 
 #############################################################################
 #
@@ -11,7 +11,7 @@
 import zipfile
 
 PACKAGE_NAME = "pyral"
-VERSION      = "0.9.4"
+VERSION      = "1.0.0"
 
 AUX_FILES  = ['MANIFEST.in', 
               'LICENSE', 
@@ -28,11 +28,13 @@
               'uptask.py',
               'statecounts.py',
               'repoitems.py',
-              'typedefs.py',
+              'get_schema.py',
+              'typedef.py',
               'wkspcounts.py',
               'builddefs.py',
               'creattach.py',
               'get_attachments.py',
+              'add_tcrs.py'
              ]
 DOC_FILES  = ['doc/Makefile',
               'doc/source/conf.py',
@@ -53,10 +55,12 @@
 #
 # The TEST_FILES are **NOT** placed into the distribution packages
 #
-TEST_FILES = ['test/test_conn.py',
+TEST_FILES = ['test/rally_targets.py', 
+              'test/test_conn.py',
               'test/test_context.py',
               'test/test_convenience.py',
               'test/test_inflation.py',
+              'test/test_field_access.py',
               'test/test_query.py',
               'test/test_wksprj_setting.py',
               'test/test_attachments.py',