Reimplement PhotosService to use the new ckdatabasews back-end (#137)

README.rst

@@ -243,20 +243,18 @@ You can access the iCloud Photo Library through the ``photos`` property.
 
 Individual albums are available through the ``albums`` property:
 
->>> api.photos.albums['Selfies']
+>>> api.photos.albums['Screenshots']
-<PhotoAlbum: 'Selfies'>
+<PhotoAlbum: 'Screenshots'>
 
-Which you can index or iterate to access the photo assets:
+Which you can iterate to access the photo assets.  The 'All Photos' album is sorted by `added_date` so the most recently added photos are returned first.  All other albums are sorted by `asset_date` (which represents the exif date) :
 
->>> for photo in api.photos.albums['Selfies']:
+>>> for photo in api.photos.albums['Screenshots']:
         print photo, photo.filename
-<PhotoAsset: client_id=4429> IMG_6045.JPG
+<PhotoAsset: id=AVbLPCGkp798nTb9KZozCXtO7jds> IMG_6045.JPG
-
-Metadata about photos is fetched on demand as you access properties of the ``PhotoAsset`` object, and are also prefetched to improve performance.
 
 To download a photo use the `download` method, which will return a `response object <http://www.python-requests.org/en/latest/api/#classes>`_, initialized with ``stream`` set to ``True``, so you can read from the raw response object:
 
->>> photo = api.photos.albums['Selfies'][0]
+>>> photo = next(iter(api.photos.albums['Screenshots']), None)
 >>> download = photo.download()
 >>> with open(photo.filename, 'wb') as opened_file:
         opened_file.write(download.raw.read())
@@ -266,7 +264,7 @@ Note: Consider using ``shutil.copyfile`` or another buffered strategy for downlo
 Information about each version can be accessed through the ``versions`` property:
 
 >>> photo.versions.keys()
-[u'large', u'medium', u'original', u'thumb']
+[u'medium', u'original', u'thumb']
 
 To download a specific version of the photo asset, pass the version to ``download()``:
 

pyicloud/base.py

@@ -13,7 +13,8 @@ from re import match
 from pyicloud.exceptions import (
     PyiCloudFailedLoginException,
     PyiCloudAPIResponseError,
-    PyiCloud2SARequiredError
+    PyiCloud2SARequiredError,
+    PyiCloudServiceNotActivatedErrror
 )
 from pyicloud.services import (
     FindMyiPhoneServiceManager,
@@ -66,11 +67,12 @@ class PyiCloudSession(requests.Session):
 
         response = super(PyiCloudSession, self).request(*args, **kwargs)
 
-        if not response.ok:
-            self._raise_error(response.status_code, response.reason)
-
         content_type = response.headers.get('Content-Type', '').split(';')[0]
         json_mimetypes = ['application/json', 'text/json']
+
+        if not response.ok and content_type not in json_mimetypes:
+            self._raise_error(response.status_code, response.reason)
+
         if content_type not in json_mimetypes:
             return response
 
@@ -91,6 +93,8 @@ class PyiCloudSession(requests.Session):
             reason = "Unknown reason"
 
         code = json.get('errorCode')
+        if not code and json.get('serverErrorCode'):
+            code = json.get('serverErrorCode')
 
         if reason:
             self._raise_error(code, reason)
@@ -101,6 +105,17 @@ class PyiCloudSession(requests.Session):
         if self.service.requires_2fa and \
                 reason == 'Missing X-APPLE-WEBAUTH-TOKEN cookie':
             raise PyiCloud2SARequiredError(response.url)
+        if code == 'ZONE_NOT_FOUND' or code == 'AUTHENTICATION_FAILED':
+            reason = 'Please log into https://icloud.com/ to manually ' \
+                'finish setting up your iCloud service'
+            api_error = PyiCloudServiceNotActivatedErrror(reason, code)
+            logger.error(api_error)
+
+            raise(api_error)
+        if code == 'ACCESS_DENIED':
+            reason = reason + '.  Please wait a few minutes then try ' \
+                'again.  The remote servers might be trying to ' \
+                'throttle requests.'
 
         api_error = PyiCloudAPIResponseError(reason, code)
         logger.error(api_error)
@@ -117,6 +132,7 @@ class PyiCloudService(object):
         pyicloud = PyiCloudService('username@apple.com', 'password')
         pyicloud.iphone.location()
     """
+
     def __init__(
         self, apple_id, password=None, cookie_directory=None, verify=True
     ):
@@ -166,7 +182,10 @@ class PyiCloudService(object):
                 logger.warning("Failed to read cookiejar %s", cookiejar_path)
 
         self.params = {
-            'clientBuildNumber': '14E45',
+            'clientBuildNumber': '17DHotfix5',
+            'clientMasteringNumber': '17DHotfix5',
+            'ckjsBuildVersion': '17DProjectDev77',
+            'ckjsVersion': '2.0.5',
             'clientId': self.client_id,
         }
 
@@ -305,7 +324,7 @@ class PyiCloudService(object):
     @property
     def photos(self):
         if not hasattr(self, '_photos'):
-            service_root = self.webservices['photos']['url']
+            service_root = self.webservices['ckdatabasews']['url']
             self._photos = PhotosService(
                 service_root,
                 self.session,

pyicloud/exceptions.py

@@ -36,9 +36,5 @@ class NoStoredPasswordAvailable(PyiCloudException):
     pass
 
 
-class PyiCloudBinaryFeedParseError(Exception):
+class PyiCloudServiceNotActivatedErrror(PyiCloudAPIResponseError):
-    pass
-
-
-class PyiCloudPhotoLibraryNotActivatedErrror(Exception):
     pass

pyicloud/services/photos.py

@@ -1,175 +1,399 @@
 import sys
 import json
 import logging
+import base64
 
 from datetime import datetime
-from base64 import b64decode
+from pyicloud.exceptions import PyiCloudServiceNotActivatedErrror
-from bitstring import ConstBitStream
-from pyicloud.exceptions import (
-    PyiCloudAPIResponseError,
-    PyiCloudBinaryFeedParseError,
-    PyiCloudPhotoLibraryNotActivatedErrror
-)
 import pytz
 
-from future.moves.urllib.parse import unquote
+from future.moves.urllib.parse import urlencode
-from future.utils import listvalues, listitems
 
 logger = logging.getLogger(__name__)
 
 
 class PhotosService(object):
     """ The 'Photos' iCloud service."""
+    SMART_FOLDERS = {
+        "All Photos": {
+            "obj_type": "CPLAssetByAddedDate",
+            "list_type": "CPLAssetAndMasterByAddedDate",
+            "direction": "ASCENDING",
+            "query_filter": None
+        },
+        "Time-lapse": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Timelapse",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "TIMELAPSE"
+                }
+            }]
+        },
+        "Videos": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Video",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "VIDEO"
+                }
+            }]
+        },
+        "Slo-mo": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Slomo",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "SLOMO"
+                }
+            }]
+        },
+        "Bursts": {
+            "obj_type": "CPLAssetBurstStackAssetByAssetDate",
+            "list_type": "CPLBurstStackAssetAndMasterByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": None
+        },
+        "Favorites": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Favorite",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "FAVORITE"
+                }
+            }]
+        },
+        "Panoramas": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Panorama",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "PANORAMA"
+                }
+            }]
+        },
+        "Screenshots": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Screenshot",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "SCREENSHOT"
+                }
+            }]
+        },
+        "Live": {
+            "obj_type": "CPLAssetInSmartAlbumByAssetDate:Live",
+            "list_type": "CPLAssetAndMasterInSmartAlbumByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": [{
+                "fieldName": "smartAlbum",
+                "comparator": "EQUALS",
+                "fieldValue": {
+                    "type": "STRING",
+                    "value": "LIVE"
+                }
+            }]
+        },
+        "Recently Deleted": {
+            "obj_type": "CPLAssetDeletedByExpungedDate",
+            "list_type": "CPLAssetAndMasterDeletedByExpungedDate",
+            "direction": "ASCENDING",
+            "query_filter": None
+        },
+        "Hidden": {
+            "obj_type": "CPLAssetHiddenByAssetDate",
+            "list_type": "CPLAssetAndMasterHiddenByAssetDate",
+            "direction": "ASCENDING",
+            "query_filter": None
+        },
+    }
 
     def __init__(self, service_root, session, params):
         self.session = session
         self.params = dict(params)
-
-        self.prepostfetch = 200
-
         self._service_root = service_root
-        self._service_endpoint = '%s/ph' % self._service_root
+        self._service_endpoint = \
+            ('%s/database/1/com.apple.photos.cloud/production/private'
+             % self._service_root)
 
-        try:
+        self._albums = None
-            request = self.session.get(
+
-                '%s/startup' % self._service_endpoint,
+        self.params.update({
-                params=self.params
+            'remapEnums': True,
-            )
+            'getCurrentSyncToken': True
-            response = request.json()
+        })
-            self.params.update({
+
-                'syncToken': response['syncToken'],
+        url = ('%s/records/query?%s' %
-                'clientInstanceId': self.params.pop('clientId')
+               (self._service_endpoint, urlencode(self.params)))
-            })
+        json_data = ('{"query":{"recordType":"CheckIndexingState"},'
-        except PyiCloudAPIResponseError as error:
+                     '"zoneID":{"zoneName":"PrimarySync"}}')
-            if error.code == 402:
+        request = self.session.post(
-                raise PyiCloudPhotoLibraryNotActivatedErrror(
+            url,
-                    "iCloud Photo Library has not been activated yet "
+            data=json_data,
-                    "for this user")
+            headers={'Content-type': 'text/plain'}
+        )
+        response = request.json()
+        indexing_state = response['records'][0]['fields']['state']['value']
+        if indexing_state != 'FINISHED':
+            raise PyiCloudServiceNotActivatedErrror(
+                ('iCloud Photo Library not finished indexing.  Please try '
+                 'again in a few minutes'), None)
+
+        # TODO: Does syncToken ever change?
+        # self.params.update({
+        #     'syncToken': response['syncToken'],
+        #     'clientInstanceId': self.params.pop('clientId')
+        # })
 
         self._photo_assets = {}
 
     @property
     def albums(self):
-        albums = {}
+        if not self._albums:
-        for folder in self._fetch_folders():
+            self._albums = {name: PhotoAlbum(self, name, **props)
-            if not folder['type'] == 'album':
+                            for (name, props) in self.SMART_FOLDERS.items()}
+
+            for folder in self._fetch_folders():
                 # FIXME: Handle subfolders
-                continue
+                if folder['recordName'] == '----Root-Folder----' or \
+                    (folder['fields'].get('isDeleted') and
+                     folder['fields']['isDeleted']['value']):
+                    continue
 
-            album = PhotoAlbum(folder, self)
+                folder_id = folder['recordName']
-            albums[album.title] = album
+                folder_obj_type = \
+                    "CPLContainerRelationNotDeletedByAssetDate:%s" % folder_id
+                folder_name = base64.b64decode(
+                    folder['fields']['albumNameEnc']['value']).decode('utf-8')
+                query_filter = [{
+                    "fieldName": "parentId",
+                    "comparator": "EQUALS",
+                    "fieldValue": {
+                        "type": "STRING",
+                        "value": folder_id
+                    }
+                }]
 
-        return albums
+                album = PhotoAlbum(self, folder_name,
+                                   'CPLContainerRelationLiveByAssetDate',
+                                   folder_obj_type, 'ASCENDING', query_filter)
+                self._albums[folder_name] = album
 
-    def _fetch_folders(self, server_ids=[]):
+        return self._albums
-        folders = server_ids if server_ids else ""
-        logger.debug("Fetching folders %s...", folders)
 
-        data = json.dumps({
+    def _fetch_folders(self):
-            'syncToken': self.params.get('syncToken'),
+        url = ('%s/records/query?%s' %
-            'methodOverride': 'GET',
+               (self._service_endpoint, urlencode(self.params)))
-            'serverIds': server_ids,
+        json_data = ('{"query":{"recordType":"CPLAlbumByPositionLive"},'
-        }) if server_ids else None
+                     '"zoneID":{"zoneName":"PrimarySync"}}')
 
-        method = 'POST' if data else 'GET'
+        request = self.session.post(
-        request = self.session.request(
+            url,
-            method,
+            data=json_data,
-            '%s/folders' % self._service_endpoint,
+            headers={'Content-type': 'text/plain'}
-            params=self.params,
-            data=data
         )
         response = request.json()
-        return response['folders']
+
+        return response['records']
 
     @property
     def all(self):
         return self.albums['All Photos']
 
-    def _fetch_asset_data_for(self, client_ids):
-        logger.debug("Fetching data for client IDs %s", client_ids)
-        client_ids = [cid for cid in client_ids
-                      if cid not in self._photo_assets]
-
-        data = json.dumps({
-            'syncToken': self.params.get('syncToken'),
-            'methodOverride': 'GET',
-            'clientIds': client_ids,
-        })
-        request = self.session.post(
-            '%s/assets' % self._service_endpoint,
-            params=self.params,
-            data=data
-        )
-
-        response = request.json()
-
-        for asset in response['assets']:
-            self._photo_assets[asset['clientId']] = asset
-
 
 class PhotoAlbum(object):
-    def __init__(self, data, service):
+
-        self.data = data
+    def __init__(self, service, name, list_type, obj_type, direction,
+                 query_filter=None, page_size=100):
+        self.name = name
         self.service = service
-        self._photo_assets = None
+        self.list_type = list_type
+        self.obj_type = obj_type
+        self.direction = direction
+        self.query_filter = query_filter
+        self.page_size = page_size
+
+        self._len = None
 
     @property
     def title(self):
-        BUILTIN_ALBUMS = {
+        return self.name
-            'recently-added': "Recently Added",
-            'time-lapse': "Time-lapse",
-            'videos': "Videos",
-            'slo-mo': 'Slo-mo',
-            'all-photos': "All Photos",
-            'selfies': "Selfies",
-            'bursts': "Bursts",
-            'favorites': "Favourites",
-            'panoramas': "Panoramas",
-            'deleted-photos': "Recently Deleted",
-            'hidden': "Hidden",
-            'screenshots': "Screenshots"
-        }
-        if self.data.get('isServerGenerated'):
-            return BUILTIN_ALBUMS[self.data.get('serverId')]
-        else:
-            return self.data.get('title')
 
     def __iter__(self):
-        return iter(self.photos)
+        return self.photos
 
-    def __getitem__(self, index):
+    def __len__(self):
-        return self.photos[index]
+        if self._len is None:
+            url = ('%s/internal/records/query/batch?%s' %
+                   (self.service._service_endpoint,
+                    urlencode(self.service.params)))
+            request = self.service.session.post(
+                url,
+                data=json.dumps(self._count_query_gen(self.obj_type)),
+                headers={'Content-type': 'text/plain'}
+            )
+            response = request.json()
+
+            self._len = (response["batch"][0]["records"][0]["fields"]
+                         ["itemCount"]["value"])
+
+        return self._len
 
     @property
     def photos(self):
-        if not self._photo_assets:
+        if self.direction == "DESCENDING":
-            child_assets = self.data.get('childAssetsBinaryFeed')
+            offset = len(self) - 1
-            if not child_assets:
+        else:
-                raise PyiCloudBinaryFeedParseError(
+            offset = 0
-                    "Missing childAssetsBinaryFeed in photo album")
 
-            self._photo_assets = listvalues(_parse_binary_feed(child_assets))
+        while(True):
+            url = ('%s/records/query?' % self.service._service_endpoint) + \
+                urlencode(self.service.params)
+            request = self.service.session.post(
+                url,
+                data=json.dumps(self._list_query_gen(
+                    offset, self.list_type, self.direction,
+                    self.query_filter)),
+                headers={'Content-type': 'text/plain'}
+            )
+            response = request.json()
 
-            for asset in self._photo_assets:
+            asset_records = {}
-                asset.album = self
+            master_records = []
+            for rec in response['records']:
+                if rec['recordType'] == "CPLAsset":
+                    master_id = \
+                        rec['fields']['masterRef']['value']['recordName']
+                    asset_records[master_id] = rec
+                elif rec['recordType'] == "CPLMaster":
+                    master_records.append(rec)
 
-        return self._photo_assets
+            master_records_len = len(master_records)
+            if master_records_len:
+                if self.direction == "DESCENDING":
+                    offset = offset - master_records_len
+                else:
+                    offset = offset + master_records_len
 
-    def _fetch_asset_data_for(self, asset):
+                for master_record in master_records:
-        if asset.client_id in self.service._photo_assets:
+                    record_name = master_record['recordName']
-            return self.service._photo_assets[asset.client_id]
+                    yield PhotoAsset(self.service, master_record,
+                                     asset_records[record_name])
+            else:
+                break
 
-        client_ids = []
+    def _count_query_gen(self, obj_type):
-        prefetch = postfetch = self.service.prepostfetch
+        query = {
-        asset_index = self._photo_assets.index(asset)
+            u'batch': [{
-        for index in range(
+                u'resultsLimit': 1,
-                max(asset_index - prefetch, 0),
+                u'query': {
-                min(asset_index + postfetch + 1,
+                    u'filterBy': {
-                    len(self._photo_assets))):
+                        u'fieldName': u'indexCountID',
-            client_ids.append(self._photo_assets[index].client_id)
+                        u'fieldValue': {
+                            u'type': u'STRING_LIST',
+                            u'value': [
+                                obj_type
+                            ]
+                        },
+                        u'comparator': u'IN'
+                    },
+                    u'recordType': u'HyperionIndexCountLookup'
+                },
+                u'zoneWide': True,
+                u'zoneID': {
+                    u'zoneName': u'PrimarySync'
+                }
+            }]
+        }
 
-        self.service._fetch_asset_data_for(client_ids)
+        return query
-        return self.service._photo_assets[asset.client_id]
+
+    def _list_query_gen(self, offset, list_type, direction, query_filter=None):
+        query = {
+            u'query': {
+                u'filterBy': [
+                    {u'fieldName': u'startRank', u'fieldValue':
+                        {u'type': u'INT64', u'value': offset},
+                        u'comparator': u'EQUALS'},
+                    {u'fieldName': u'direction', u'fieldValue':
+                        {u'type': u'STRING', u'value': direction},
+                        u'comparator': u'EQUALS'}
+                ],
+                u'recordType': list_type
+            },
+            u'resultsLimit': self.page_size * 2,
+            u'desiredKeys': [
+                u'resJPEGFullWidth', u'resJPEGFullHeight',
+                u'resJPEGFullFileType', u'resJPEGFullFingerprint',
+                u'resJPEGFullRes', u'resJPEGLargeWidth',
+                u'resJPEGLargeHeight', u'resJPEGLargeFileType',
+                u'resJPEGLargeFingerprint', u'resJPEGLargeRes',
+                u'resJPEGMedWidth', u'resJPEGMedHeight',
+                u'resJPEGMedFileType', u'resJPEGMedFingerprint',
+                u'resJPEGMedRes', u'resJPEGThumbWidth',
+                u'resJPEGThumbHeight', u'resJPEGThumbFileType',
+                u'resJPEGThumbFingerprint', u'resJPEGThumbRes',
+                u'resVidFullWidth', u'resVidFullHeight',
+                u'resVidFullFileType', u'resVidFullFingerprint',
+                u'resVidFullRes', u'resVidMedWidth', u'resVidMedHeight',
+                u'resVidMedFileType', u'resVidMedFingerprint',
+                u'resVidMedRes', u'resVidSmallWidth', u'resVidSmallHeight',
+                u'resVidSmallFileType', u'resVidSmallFingerprint',
+                u'resVidSmallRes', u'resSidecarWidth', u'resSidecarHeight',
+                u'resSidecarFileType', u'resSidecarFingerprint',
+                u'resSidecarRes', u'itemType', u'dataClassType',
+                u'filenameEnc', u'originalOrientation', u'resOriginalWidth',
+                u'resOriginalHeight', u'resOriginalFileType',
+                u'resOriginalFingerprint', u'resOriginalRes',
+                u'resOriginalAltWidth', u'resOriginalAltHeight',
+                u'resOriginalAltFileType', u'resOriginalAltFingerprint',
+                u'resOriginalAltRes', u'resOriginalVidComplWidth',
+                u'resOriginalVidComplHeight', u'resOriginalVidComplFileType',
+                u'resOriginalVidComplFingerprint', u'resOriginalVidComplRes',
+                u'isDeleted', u'isExpunged', u'dateExpunged', u'remappedRef',
+                u'recordName', u'recordType', u'recordChangeTag',
+                u'masterRef', u'adjustmentRenderType', u'assetDate',
+                u'addedDate', u'isFavorite', u'isHidden', u'orientation',
+                u'duration', u'assetSubtype', u'assetSubtypeV2',
+                u'assetHDRType', u'burstFlags', u'burstFlagsExt', u'burstId',
+                u'captionEnc', u'locationEnc', u'locationV2Enc',
+                u'locationLatitude', u'locationLongitude', u'adjustmentType',
+                u'timeZoneOffset', u'vidComplDurValue', u'vidComplDurScale',
+                u'vidComplDispValue', u'vidComplDispScale',
+                u'vidComplVisibilityState', u'customRenderedValue',
+                u'containerId', u'itemId', u'position', u'isKeyAsset'
+            ],
+            u'zoneID': {u'zoneName': u'PrimarySync'}
+        }
+
+        if query_filter:
+            query['query']['filterBy'].extend(query_filter)
+
+        return query
 
     def __unicode__(self):
         return self.title
@@ -189,142 +413,96 @@ class PhotoAlbum(object):
 
 
 class PhotoAsset(object):
-    def __init__(self, client_id, aspect_ratio, orientation):
+    def __init__(self, service, master_record, asset_record):
-        self.client_id = client_id
+        self._service = service
-        self.aspect_ratio = aspect_ratio
+        self._master_record = master_record
-        self.orientation = orientation
+        self._asset_record = asset_record
-        self._data = None
+
+        self._versions = None
+
+    PHOTO_VERSION_LOOKUP = {
+        u"original": u"resOriginal",
+        u"medium": u"resJPEGMed",
+        u"thumb": u"resJPEGThumb"
+    }
+
+    VIDEO_VERSION_LOOKUP = {
+        u"original": u"resOriginal",
+        u"medium": u"resVidMed",
+        u"thumb": u"resVidSmall"
+    }
 
     @property
-    def data(self):
+    def id(self):
-        if not self._data:
+        return self._master_record['recordName']
-            self._data = self.album._fetch_asset_data_for(self)
-        return self._data
 
     @property
     def filename(self):
-        return self.data['details'].get('filename')
+        return base64.b64decode(
+                self._master_record['fields']['filenameEnc']['value']
+            ).decode('utf-8')
 
     @property
     def size(self):
-        try:
+        return self._master_record['fields']['resOriginalRes']['value']['size']
-            return int(self.data['details'].get('filesize'))
-        except ValueError:
-            return None
 
     @property
     def created(self):
-        dt = datetime.fromtimestamp(self.data.get('createdDate') / 1000.0,
+        return self.asset_date
-                                    tz=pytz.utc)
+
+    @property
+    def asset_date(self):
+        dt = datetime.fromtimestamp(
+            self._asset_record['fields']['assetDate']['value'] / 1000.0,
+            tz=pytz.utc)
+        return dt
+
+    @property
+    def added_date(self):
+        dt = datetime.fromtimestamp(
+            self._asset_record['fields']['addedDate']['value'] / 1000.0,
+            tz=pytz.utc)
         return dt
 
     @property
     def dimensions(self):
-        return self.data.get('dimensions')
+        return (self._master_record['fields']['resOriginalWidth']['value'],
-
+                self._master_record['fields']['resOriginalHeight']['value'])
-    @property
-    def title(self):
-        return self.data.get('title')
-
-    @property
-    def description(self):
-        return self.data.get('description')
 
     @property
     def versions(self):
-        versions = {}
+        if not self._versions:
-        for version in self.data.get('derivativeInfo'):
+            self._versions = {}
-            (version, width, height, size, mimetype,
+            if 'resVidSmallRes' in self._master_record['fields']:
-                u1, u2, u3, url, filename) = version.split(':')
+                typed_version_lookup = self.VIDEO_VERSION_LOOKUP
-            versions[version] = {
+            else:
-                'width': width,
+                typed_version_lookup = self.PHOTO_VERSION_LOOKUP
-                'height': height,
+
-                'size': size,
+            for key, prefix in typed_version_lookup.items():
-                'mimetype': mimetype,
+                if '%sWidth' % prefix in self._master_record['fields']:
-                'url': unquote(url),
+                    f = self._master_record['fields']
-                'filename': filename,
+                    self._versions[key] = {
-            }
+                        'width': f['%sWidth' % prefix]['value'],
-        return versions
+                        'height': f['%sHeight' % prefix]['value'],
+                        'size': f['%sRes' % prefix]['value']['size'],
+                        'type': f['%sFileType' % prefix]['value'],
+                        'url': f['%sRes' % prefix]['value']['downloadURL'],
+                        'filename': self.filename,
+                    }
+        return self._versions
 
     def download(self, version='original', **kwargs):
         if version not in self.versions:
             return None
 
-        return self.album.service.session.get(
+        return self._service.session.get(
             self.versions[version]['url'],
             stream=True,
             **kwargs
         )
 
     def __repr__(self):
-        return "<%s: client_id=%s>" % (
+        return "<%s: id=%s>" % (
             type(self).__name__,
-            self.client_id
+            self.id
         )
-
-
-def _parse_binary_feed(feed):
-    logger.debug("Parsing binary feed %s", feed)
-
-    binaryfeed = bytearray(b64decode(feed))
-    bitstream = ConstBitStream(binaryfeed)
-
-    payload_encoding = binaryfeed[0]
-    if payload_encoding != bitstream.read("uint:8"):
-        raise PyiCloudBinaryFeedParseError(
-            "Missmatch betweeen binaryfeed and bistream payload encoding")
-
-    ASSET_PAYLOAD = 255
-    ASSET_WITH_ORIENTATION_PAYLOAD = 254
-    ASPECT_RATIOS = [
-        0.75,
-        4.0 / 3.0 - 3.0 * (4.0 / 3.0 - 1.0) / 4.0,
-        4.0 / 3.0 - 2.0 * (4.0 / 3.0 - 1.0) / 4.0,
-        1.25,
-        4.0 / 3.0, 1.5 - 2.0 * (1.5 - 4.0 / 3.0) / 3.0,
-        1.5 - 1.0 * (1.5 - 4.0 / 3.0) / 3.0,
-        1.5,
-        1.5694444444444444,
-        1.6388888888888888,
-        1.7083333333333333,
-        16.0 / 9.0,
-        2.0 - 2.0 * (2.0 - 16.0 / 9.0) / 3.0,
-        2.0 - 1.0 * (2.0 - 16.0 / 9.0) / 3.0,
-        2,
-        3
-    ]
-
-    valid_payloads = [ASSET_PAYLOAD, ASSET_WITH_ORIENTATION_PAYLOAD]
-    if payload_encoding not in valid_payloads:
-        raise PyiCloudBinaryFeedParseError(
-            "Unknown payload encoding '%s'" % payload_encoding)
-
-    assets = {}
-    while len(bitstream) - bitstream.pos >= 48:
-        range_start = bitstream.read("uint:24")
-        range_length = bitstream.read("uint:24")
-        range_end = range_start + range_length
-
-        logger.debug("Decoding indexes [%s-%s) (length %s)",
-                     range_start, range_end, range_length)
-
-        previous_asset_id = 0
-        for index in range(range_start, range_end):
-            aspect_ratio = ASPECT_RATIOS[bitstream.read("uint:4")]
-
-            id_size = bitstream.read("uint:2")
-            if id_size:
-                # A size has been reserved for the asset id
-                asset_id = bitstream.read("uint:%s" % (2 + 8 * id_size))
-            else:
-                # The id is just an increment to a previous id
-                asset_id = previous_asset_id + bitstream.read("uint:2") + 1
-
-            orientation = None
-            if payload_encoding == ASSET_WITH_ORIENTATION_PAYLOAD:
-                orientation = bitstream.read("uint:3")
-
-            assets[index] = PhotoAsset(asset_id, aspect_ratio, orientation)
-            previous_asset_id = asset_id
-
-    return assets

requirements.txt

@@ -6,5 +6,4 @@ six>=1.9.0
 tzlocal
 pytz
 certifi
-bitstring
 future