89def parse_tineye_match(match_json):
90 """Takes parsed JSON from the API server and turns it into a :py:obj:`dict`
91 object.
92
93 Attributes `(class Match) <https://github.com/TinEye/pytineye/blob/main/pytineye/api.py>`__
94
95 - `image_url`, link to the result image.
96 - `domain`, domain this result was found on.
97 - `score`, a number (0 to 100) that indicates how closely the images match.
98 - `width`, image width in pixels.
99 - `height`, image height in pixels.
100 - `size`, image area in pixels.
101 - `format`, image format.
102 - `filesize`, image size in bytes.
103 - `overlay`, overlay URL.
104 - `tags`, whether this match belongs to a collection or stock domain.
105
106 - `backlinks`, a list of Backlink objects pointing to the original websites
107 and image URLs. List items are instances of :py:obj:`dict`, (`Backlink
108 <https://github.com/TinEye/pytineye/blob/main/pytineye/api.py>`__):
109
110 - `url`, the image URL to the image.
111 - `backlink`, the original website URL.
112 - `crawl_date`, the date the image was crawled.
113
114 """
115
116
117
118
119
120 backlinks = []
121 if "backlinks" in match_json:
122
123 for backlink_json in match_json["backlinks"]:
124 if not isinstance(backlink_json, dict):
125 continue
126
127 crawl_date = backlink_json.get("crawl_date")
128 if crawl_date:
129 crawl_date = datetime.strptime(crawl_date, '%Y-%m-%d')
130 else:
131 crawl_date = datetime.min
132
133 backlinks.append(
134 {
135 'url': backlink_json.get("url"),
136 'backlink': backlink_json.get("backlink"),
137 'crawl_date': crawl_date,
138 'image_name': backlink_json.get("image_name"),
139 }
140 )
141
142 return {
143 'image_url': match_json.get("image_url"),
144 'domain': match_json.get("domain"),
145 'score': match_json.get("score"),
146 'width': match_json.get("width"),
147 'height': match_json.get("height"),
148 'size': match_json.get("size"),
149 'image_format': match_json.get("format"),
150 'filesize': match_json.get("filesize"),
151 'overlay': match_json.get("overlay"),
152 'tags': match_json.get("tags"),
153 'backlinks': backlinks,
154 }
155
156