Added image OCR (#52)

* Added method for OCR

* Updated requirements

Author: bkwi

.travis.yml

@@ -5,7 +5,7 @@ python:
   - "3.5"
   - "3.6"
   - "3.7"
-  - "3.8-dev"
+  - "3.8"
 
 install:
   - pip install -r requirements.txt

filestack/mixins/common.py

@@ -98,7 +98,7 @@ def get_content(self, security=None):
 
     def tags(self, security=None):
         """
-        Performs image tagging operation on current object
+        Performs image tagging operation on current object (image)
 
         Args:
             security (:class:`filestack.Security`): Security object that will be used
@@ -125,3 +125,18 @@ def sfw(self, security=None):
         obj = self._add_transform_task('sfw', params={'self': None})
         response = requests.get(obj.signed_url(security=security))
         return response.json()
+
+    def ocr(self, security=None):
+        """
+        Performs OCR on current object (image)
+
+        Args:
+            security (:class:`filestack.Security`): Security object that will be used
+                to run OCR
+
+        Returns:
+            `dict`: dictionary containing OCR data
+        """
+        obj = self._add_transform_task('ocr', params={'self': None})
+        response = requests.get(obj.signed_url(security=security))
+        return response.json()

filestack/models/client.py

@@ -19,7 +19,7 @@ class Client:
     and provide a Security object to sign all your API calls.
 
     >>> from filestack import Client, Security
-    >>> security = Security(policy={'expiry': 1594200833, '<YOUR APP SECRET>'})
+    >>> security = Security(policy={'expiry': 1594200833}, secret='YOUR APP SECRET')
     >>> cli = Client('<FILESTACK_APIKEY>', storage='gcs', security=security)
     """
     def __init__(self, apikey, storage='S3', security=None):

requirements.txt

@@ -2,6 +2,6 @@ coveralls==1.1
 httmock==1.2.6
 pytest==4.6.3
 pytest-cov==2.5.0
-requests==2.22.0
+requests==2.24.0
 responses==0.10.6
-trafaret==1.2.0
+trafaret==2.0.2