Release 1.5.0 (#127)

* Release 1.5.0

* Bump version: 1.4.0 → 1.5.0

Author: sserrata

HISTORY.rst

@@ -2,6 +2,17 @@
 History
 =======
 
+1.5.0 (2019-02-27)
+------------------
+
+* Added `flush()` method to `EventService` class.
+* Added `auto_refresh` support to `HTTPClient` `_apply_credentials()` method.
+* Removed `auto_retry` feature from `HTTPClient` class.
+* Refactored `HTTPClient` class `request()` method keyword argument overrides.
+* Removed unused `token_revoke_url` keyword argument.
+* Added support for API Explorer Developer Tokens to `Credentials` class.
+* Refactored `Credentials` `refresh()` method.
+
 1.4.0 (2018-10-04)
 ------------------
 

Pipfile

@@ -20,4 +20,4 @@ requests = "*"
 tinydb = "*"
 
 [requires]
-python_version = "3.6"
+python_version = "3.7"

Pipfile.lock

@@ -4,7 +4,7 @@ Palo Alto Networks Cloud Python SDK
 
 Python idiomatic SDK for the Palo Alto Networks Application Framework.
 
-The Palo Alto Networks Cloud Python SDK, or `pancloud`, was created to assist developers with
+The Palo Alto Networks Cloud Python SDK (or `pancloud` for short) was created to assist developers with
 programmatically interacting with the Palo Alto Networks Application Framework.
 
 The primary goal is to provide full, low-level API coverage for the following Application Framework services:
@@ -32,15 +32,16 @@ Features
 --------
 
 - HTTP client wrapper for the popular Requests library with full access to its features.
-- Language bindings for Logging Service, Event Service and Directory-Sync Service.
+- Language bindings for Logging Service, Event Service and Directory Sync Service.
 - Helper methods for performing common tasks, such as log/event pagination.
-- Credentials support for OAuth 2.0.
+- Support for OAuth 2.0 grant code authorization flow.
 - Library of example scripts illustrating how to leverage `pancloud`.
+- Support for API Explorer Developer Tokens (Introduced in v1.5.0).
 
 Status
 ------
 
-The Palo Alto Networks Cloud Python SDK is considered **beta** at this time.
+The Palo Alto Networks Cloud Python SDK is considered **production/stable** at this time.
 
 Installation
 ------------
@@ -72,10 +73,10 @@ Obtaining and Using OAuth 2.0 Tokens
 ------------------------------------
 
 Work with your Developer Relations representative to register your
-application to receive the credentials needed to obtain an `access_token`.
-You'll need a `client_id`, `client_secret`, and `refresh_token`.
-`API Explorer <https://github.com/PaloAltoNetworks/apiexplorer>`__ may optionally be used to perform
-OAuth 2.0 and fetch tokens.
+application and receive the credentials needed to obtain an `access_token`.
+Normally, this requires a `client_id`, `client_secret`, and `refresh_token`.
+API Explorer may optionally be used to generate a Developer Token, which can
+be used in place of the `client_id`, `client_secret`, and `refresh_token`.
 
 For more information visit the following RTD page: `Credentials <https://pancloud.readthedocs.io/en/latest/guides/credentials.html>`__
 

README.rst

@@ -3,7 +3,7 @@
 """Main package for pancloud."""
 
 __author__ = 'Palo Alto Networks'
-__version__ = '1.4.0'
+__version__ = '1.5.0'
 
 from .directorysync import DirectorySyncService
 from .event import EventService

pancloud/__init__.py

@@ -9,4 +9,4 @@ cryptography >= "1.7"
 PyYAML >= "3.11"
 pytest >= "2.9.2"
 pytest-runner >= "2.11.1"
-pancloud >= "1.2.1"
+pancloud >= "1.4.0"

requirements_dev.txt

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.4.0
+current_version = 1.5.0
 commit = True
 tag = True
 

setup.cfg

@@ -24,7 +24,7 @@
 
 setup(
     name='pancloud',
-    version='1.4.0',
+    version='1.5.0',
     description="Python idiomatic SDK for the Palo Alto Networks Application Framework.",
     long_description=readme + '\n\n' + history,
     author="Steven Serrata",
@@ -37,7 +37,7 @@
     zip_safe=False,
     keywords='pancloud',
     classifiers=[
-        'Development Status :: 4 - Beta',
+        'Development Status :: 5 - Production/Stable',
         'Intended Audience :: Developers',
         'License :: OSI Approved :: ISC License (ISCL)',
         'Natural Language :: English',