Improve doc strings and add arbitrary range request

Author: jhodges10

frameioclient/client.py

@@ -4,7 +4,7 @@
 from requests.adapters import HTTPAdapter
 from requests.packages.urllib3.util.retry import Retry
 
-from .lib import ClientVersion, PaginatedResponse, Utils, ClientVersion
+from .lib import ClientVersion, PaginatedResponse, Utils, ClientVersion, FrameioDownloader
 
 
 class FrameioConnection(object):
@@ -85,6 +85,10 @@ def _auth(self):
   def _version(self):
     return ClientVersion.version()
 
+  @property
+  def _download(self):
+    return FrameioDownloader
+
   @property
   def users(self):
     from .service import User

frameioclient/lib/download.py

@@ -138,6 +138,7 @@ def multi_part_download(self, url):
         out_byte = offset * (i+1) # Increment by the iterable + 1 so we don't mutiply by zero
         task = (url, in_byte, out_byte, i)
 
+        time.sleep(0.1) # Stagger start for each chunk by 0.1 seconds
         self.futures.append(executor.submit(self.download_chunk, task))
         in_byte = out_byte # Reset new in byte equal to last out byte
 
@@ -180,3 +181,9 @@ def download_chunk(self, task):
       print("Done writing chunk {}/{}".format(chunk_number + 1, self.chunks))
 
     return "Complete!"
+
+  @staticmethod
+  def get_byte_range(url, start_byte=0, end_byte=2048):
+    headers = {"Range": "bytes=%d-%d" % (start_byte, end_byte)}
+    br = requests.get(url, headers=headers).content
+    return br

frameioclient/service/assets.py

@@ -38,7 +38,7 @@ def create(self, parent_asset_id, **kwargs):
 
       Example::
 
-        client.create_asset(
+        client.assets.create(
           parent_asset_id="123abc",
           name="ExampleFile.mp4",
           type="file",
@@ -119,7 +119,7 @@ def bulk_copy(self, destination_folder_id, asset_list=[], copy_comments=False):
       copy_comments (boolean): Whether or not to copy comments: True or False.
 
       Example::
-        client.assets.buly_copy("adeffee123342", asset_list=["7ee008c5-49a2-f8b5-997d-8b64de153c30", \ 
+        client.assets.bulk_copy("adeffee123342", asset_list=["7ee008c5-49a2-f8b5-997d-8b64de153c30", \ 
         "7ee008c5-49a2-f8b5-997d-8b64de153c30"], copy_comments=True)
     """
 
@@ -154,8 +154,7 @@ def _upload(self, asset, file):
       file (file): The file to upload.
 
       Example::
-
-        client.upload(asset, open('example.mp4')) // TODO fix this example (bad way of opening file)
+        client.upload(asset, open('example.mp4'))
     """
 
     uploader = FrameioUploader(asset, file)