Merge pull request #45 from Frameio/DEVREL-327-presentation-links

Add create_presentation_link()

Author: jhodges10

frameioclient/client.py

@@ -1,9 +1,11 @@
+import re
 import sys
 import requests
 import warnings
 from requests.adapters import HTTPAdapter
 from requests.packages.urllib3.util.retry import Retry
 from .download import FrameioDownloader
+from .exceptions import PresentationException
 
 if sys.version_info.major >= 3:
   from .py3_uploader import FrameioUploader
@@ -75,6 +77,9 @@ def _api_call(self, method, endpoint, payload={}):
           )
 
       return r.json()
+    
+    if r.status_code == 422 and "presentation" in endpoint:
+      raise PresentationException
 
     return r.raise_for_status()
 
@@ -411,6 +416,26 @@ def get_review_links(self, project_id):
     endpoint = '/projects/{}/review_links'.format(project_id)
     return self._api_call('get', endpoint)
 
+  def create_presentation_link(self, asset_id, **kwargs):
+    """
+    Create a presentation link.
+
+    :Args:
+      asset_id (string): The asset id.
+    :Kwargs:
+      kwargs: additional request parameters.
+
+      Example::
+
+        client.create_presentation_link(
+          asset_id="9cee7966-4066-b326-7db1-f9e6f5e929e4",
+          title="My fresh presentation",
+          password="abc123"
+        )
+    """
+    endpoint = '/assets/{}/presentations'.format(asset_id)
+    return self._api_call('post', endpoint, payload=kwargs)
+
   def create_review_link(self, project_id, **kwargs):
     """
     Create a review link.

frameioclient/exceptions.py

@@ -0,0 +1,12 @@
+
+class PresentationException(Exception):
+    """Exception raised when you try to create a Presentation Link for an asset
+    that already has one.
+    """
+
+    def __init__(
+        self, 
+        message="Your asset already has a presentation link associated with it."
+    ):
+        self.message = message
+        super().__init__(self.message)