Feature[PAM]: Revoke token functionality

Author: 650elx

.github/workflows/run_acceptance_tests.yml

@@ -22,7 +22,10 @@ jobs:
             token: ${{ secrets.GH_TOKEN }}
         - name: Install Python dependencies and run acceptance tests
           run: |
+              cp sdk-specifications/features/access/authorization-failure-reporting.feature tests/acceptance/pam
               cp sdk-specifications/features/access/grant-token.feature tests/acceptance/pam
+              cp sdk-specifications/features/access/revoke-token.feature tests/acceptance/pam
+
               sudo pip3 install -r requirements-dev.txt
               behave --junit tests/acceptance/pam
         - name: Expose acceptance tests reports

.pubnub.yml

@@ -1,5 +1,5 @@
 name: python
-version: 5.4.0
+version: 5.5.0
 schema: 1
 scm: github.com/pubnub/python
 sdks:
@@ -18,7 +18,7 @@ sdks:
         distributions:
           - distribution-type: library
             distribution-repository: package
-            package-name: pubnub-5.1.3
+            package-name: pubnub-5.5.0
             location: https://pypi.org/project/pubnub/
             supported-platforms:
               supported-operating-systems:
@@ -97,8 +97,8 @@ sdks:
           -
             distribution-type: library
             distribution-repository: git release
-            package-name: pubnub-5.1.3
-            location: https://github.com/pubnub/python/releases/download/v5.1.3/pubnub-5.1.3.tar.gz
+            package-name: pubnub-5.5.0
+            location: https://github.com/pubnub/python/releases/download/v5.5.0/pubnub-5.5.0.tar.gz
             supported-platforms:
               supported-operating-systems:
                 Linux:
@@ -169,6 +169,14 @@ sdks:
                 license-url: https://github.com/aio-libs/aiohttp/blob/master/LICENSE.txt
                 is-required: Required
 changelog:
+  - date: 2021-12-16
+    version: v5.5.0
+    changes:
+
+  - date: 2021-12-16
+    version: v5.4.0
+    changes:
+
   - version: v5.4.0
     date: 2021-10-07
     changes:
@@ -479,6 +487,7 @@ features:
     - ACCESS-GRANT-TOKEN
     - ACCESS-PARSE-TOKEN
     - ACCESS-SET-TOKEN
+    - ACCESS-REVOKE-TOKEN
   channel-groups:
     - CHANNEL-GROUPS-ADD-CHANNELS
     - CHANNEL-GROUPS-REMOVE-CHANNELS

CHANGELOG.md

@@ -1,3 +1,9 @@
+## v5.5.0
+December 16 2021
+
+## v5.4.0
+December 16 2021
+
 ## [v5.4.0](https://github.com/pubnub/python/releases/tag/v5.4.0)
 
 [Full Changelog](https://github.com/pubnub/python/compare/v5.3.1...v5.4.0)

pubnub/endpoints/access/revoke.py

@@ -0,0 +1,43 @@
+from pubnub.enums import PNOperationType, HttpMethod
+from pubnub.endpoints.endpoint import Endpoint
+from pubnub.models.consumer.v3.access_manager import PNRevokeTokenResult
+from pubnub import utils
+
+
+class RevokeToken(Endpoint):
+    REVOKE_TOKEN_PATH = "/v3/pam/%s/grant/%s"
+
+    def __init__(self, pubnub, token):
+        Endpoint.__init__(self, pubnub)
+        self.token = token
+
+    def validate_params(self):
+        self.validate_subscribe_key()
+        self.validate_secret_key()
+
+    def create_response(self, envelope):
+        return PNRevokeTokenResult(envelope)
+
+    def is_auth_required(self):
+        return False
+
+    def request_timeout(self):
+        return self.pubnub.config.non_subscribe_request_timeout
+
+    def connect_timeout(self):
+        return self.pubnub.config.connect_timeout
+
+    def http_method(self):
+        return HttpMethod.DELETE
+
+    def custom_params(self):
+        return {}
+
+    def build_path(self):
+        return RevokeToken.REVOKE_TOKEN_PATH % (self.pubnub.config.subscribe_key, utils.url_encode(self.token))
+
+    def operation_type(self):
+        return PNOperationType.PNAccessManagerRevokeToken
+
+    def name(self):
+        return "RevokeToken"

pubnub/endpoints/access/revoke_token.py

@@ -69,7 +69,9 @@ class PNOperationType(object):
     PNFireOperation = 25
     PNSignalOperation = 26
 
+    PNAccessManagerRevokeToken = 40
     PNAccessManagerGrantToken = 41
+
     PNAddMessageAction = 42
     PNGetMessageActions = 43
     PNDeleteMessageAction = 44

pubnub/enums.py

@@ -466,6 +466,9 @@ def endpoint_name_for_operation(operation_type):
             PNOperationType.PNAccessManagerRevoke: 'pam',
             PNOperationType.PNTimeOperation: 'pam',
 
+            PNOperationType.PNAccessManagerGrantToken: 'pamv3',
+            PNOperationType.PNAccessManagerRevokeToken: 'pamv3',
+
             PNOperationType.PNSignalOperation: 'sig',
 
             PNOperationType.PNSetUuidMetadataOperation: 'obj',
@@ -488,8 +491,6 @@ def endpoint_name_for_operation(operation_type):
             PNOperationType.PNRemoveMembershipsOperation: 'obj',
             PNOperationType.PNManageMembershipsOperation: 'obj',
 
-            PNOperationType.PNAccessManagerGrantToken: 'pamv3',
-
             PNOperationType.PNAddMessageAction: 'msga',
             PNOperationType.PNGetMessageActions: 'msga',
             PNOperationType.PNDeleteMessageAction: 'msga',

pubnub/managers.py

@@ -21,3 +21,11 @@ def __str__(self):
 
     def get_token(self):
         return self.token
+
+
+class PNRevokeTokenResult:
+    def __init__(self, result):
+        self.status = result['status']
+
+    def __str__(self):
+        return "Revoke token success with status: %s" % self.status

pubnub/models/consumer/v3/access_manager.py

@@ -27,7 +27,7 @@
 from .endpoints.access.audit import Audit
 from .endpoints.access.grant import Grant
 from .endpoints.access.grant_token import GrantToken
-from .endpoints.access.revoke import Revoke
+from .endpoints.access.revoke_token import RevokeToken
 from .endpoints.channel_groups.add_channel_to_channel_group import AddChannelToChannelGroup
 from .endpoints.channel_groups.list_channels_in_channel_group import ListChannelsInChannelGroup
 from .endpoints.channel_groups.remove_channel_from_channel_group import RemoveChannelFromChannelGroup
@@ -65,7 +65,7 @@
 
 class PubNubCore:
     """A base class for PubNub Python API implementations"""
-    SDK_VERSION = "5.4.0"
+    SDK_VERSION = "5.5.0"
     SDK_NAME = "PubNub-Python"
 
     TIMESTAMP_DIVIDER = 1000
@@ -170,8 +170,8 @@ def grant(self):
     def grant_token(self):
         return GrantToken(self)
 
-    def revoke(self):
-        return Revoke(self)
+    def revoke_token(self, token):
+        return RevokeToken(self, token)
 
     def audit(self):
         return Audit(self)

pubnub/pubnub_core.py

@@ -2,7 +2,7 @@
 
 setup(
     name='pubnub',
-    version='5.4.0',
+    version='5.5.0',
     description='PubNub Real-time push service in the cloud',
     author='PubNub',
     author_email='[email protected]',