Merge branch 'develop' into fross/test-timing

Author: Frederick Ross

.gitignore

@@ -12,3 +12,4 @@ proxypid
 proxy.log
 MANIFEST
 coverage_report
+test.log

CHANGELOG.md

@@ -5,6 +5,8 @@
 ### New features and APIs
 
 * An `AuthenticationError` exception has been added.
+  This exception is a subclass of `HTTPError`, so existing code that expects 
+  HTTP 401 (Unauthorized) will continue to work.
 
 * An `"autologin"` argument has been added to the `splunklib.client.connect` and
   `splunklib.binding.connect` functions. When set to true, Splunk automatically 
@@ -57,9 +59,6 @@
 
 ### Breaking changes
 
-* Authentication errors are now reported as `AuthenticationError` instead of as
-  `HTTPError` with code 401.
-  
 * `Job` objects are no longer guaranteed to be ready for querying.
   Client code should call the `Job.is_ready` method to determine when it is safe
   to access properties on the job.

README.md

@@ -71,7 +71,8 @@ examples and unit tests from the SDK.
 ### Running the examples and unit tests
 
 To run the examples and unit tests, you must put the root of
-the SDK on your PYTHONPATH. For example, add the following line to your 
+the SDK on your PYTHONPATH. For example, if you have downloaded the SDK to your
+home folder and are running Mac OS X or Linux, add the following line to your
 **.bash_profile**:
 
     export PYTHONPATH=~/splunk-sdk-python

docs/binding.rst

@@ -21,12 +21,5 @@ splunklib.binding
 .. autoclass:: HttpLib
     :members: delete, get, post, request
 
-.. autoclass:: NoAuthenticationToken
-    :members:
-
 .. autoclass:: ResponseReader
     :members: close, empty, peek, read
-
-.. autoclass:: UrlEncoded
-    :members:
-

docs/client.rst

@@ -64,9 +64,6 @@ splunklib.client
     :members: cancel, disable_preview, enable_preview, events, finalize, is_done, is_ready, name, pause, refresh, results, preview, searchlog, set_priority, summary, timeline, touch, set_ttl, unpause
     :inherited-members:
 
-.. autoclass:: JobNotReadyException
-    :members:
-
 .. autoclass:: Jobs
     :members: create, export, itemmeta, oneshot
     :inherited-members:
@@ -83,24 +80,15 @@ splunklib.client
     :members: arguments, update
     :inherited-members:
 
-.. autoclass:: NoSuchApplicationException
-    :members:
-
 .. autoclass:: NoSuchCapability
     :members:
 
-.. autoclass:: NoSuchUserException
-    :members:
-
 .. autoclass:: NotSupportedError
     :members:
 
 .. autoclass:: OperationError
     :members:
 
-.. autoclass:: OperationFailedException
-    :members:
-
 .. autoclass:: ReadOnlyCollection
     :members: itemmeta, iter, list, names
     :inherited-members:

docs/index.rst

@@ -15,17 +15,13 @@ For more information about the SDK, see the `Splunk Developer Portal <http://dev
 
     :class:`~splunklib.binding.ResponseReader` class
 
-    :class:`~splunklib.binding.UrlEncoded` class
-
 
     **Exceptions**
 
     :func:`~splunklib.binding.handler` function
 
     :class:`~splunklib.binding.AuthenticationError` class
 
-    :class:`~splunklib.binding.NoAuthenticationToken` class
-
     **Custom HTTP handler**
 
     :class:`~splunklib.binding.HTTPError` class 
@@ -104,20 +100,12 @@ For more information about the SDK, see the `Splunk Developer Portal <http://dev
 
     :class:`~splunklib.client.InvalidNameException` class
 
-    :class:`~splunklib.client.JobNotReadyException` class
-
-    :class:`~splunklib.client.NoSuchApplicationException` class
-
     :class:`~splunklib.client.NoSuchCapability` class
 
-    :class:`~splunklib.client.NoSuchUserException` class
-
     :class:`~splunklib.client.NotSupportedError` class
 
     :class:`~splunklib.client.OperationError` class
 
-    :class:`~splunklib.client.OperationFailedException` class
-    
 
 :doc:`data`
 -----------