feat: implement get_remote_url_metadata

Author: kernelshard

README.md

@@ -456,6 +456,14 @@ Accepts the file ID and fetches the metadata as per the [API documentation here]
 imagekit.get_metadata(file_id)
 ```
 
+
+**3. Get File Metadata from remote url**
+Accepts the remote file url and fetches the metadata as per the [API documentation here](https://docs.imagekit.io/api-reference/metadata-api/get-image-metadata-from-remote-url)
+
+```python
+imagekit.get_remote_url_metadata(remote_file_url)
+```
+
 **4. Update File Details**
 Update parameters associated with the file as per the [API documentation here](https://docs.imagekit.io/imagekit-docs).
 The first argument to the `update_field_details` method is the file ID and the second argument is an object with the

imagekitio/client.py

@@ -72,6 +72,9 @@ def get_metadata(self, file_id: str = None) -> Dict[str, Any]:
         """
         return self.file.get_metadata(str(file_id))
 
+    def get_remote_url_metadata(self, remote_file_url: str = ""):
+        return self.file.get_metadata_from_remote_url(remote_file_url)
+
     def url(self, options: Dict[str, Any]) -> str:
         """Get generated Url from options parameter
         """

imagekitio/constants/defaults.py

@@ -9,3 +9,4 @@ class Default(enum.Enum):
         QUERY_TRANSFORMATION_POSITION,
     ]
     DEFAULT_TIMESTAMP = "9999999999"
+    SDK_VERSION_PARAM = "python-1.0.0"

imagekitio/constants/url.py

@@ -6,3 +6,4 @@ class URL(Enum):
     PURGE_CACHE = "/purge"
     UPLOAD_URL = "https://upload.imagekit.io/api/v1/files/upload"
     BULK_FILE_DELETE = "/batch/deleteByFileIds"
+    REMOTE_METADATA_FULL_URL = "https://api.imagekit.io/v1/metadata"

imagekitio/file.py

@@ -150,7 +150,10 @@ def batch_delete(self, file_ids: list = None):
             raise ValueError("Need to pass ids in list")
         url = URL.BASE_URL.value + URL.BULK_FILE_DELETE.value
         resp = self.request.request(
-            method="POST", url=url, headers=self.request.create_headers(), data={"fileIds": file_ids}
+            method="POST",
+            url=url,
+            headers=self.request.create_headers(),
+            data={"fileIds": file_ids},
         )
 
         if resp.status_code > 204:
@@ -168,7 +171,7 @@ def purge_cache(self, file_url: str = None) -> Dict[str, Any]:
         """
         if not file_url:
             raise TypeError(ERRORS.MISSING_FILE_URL.value)
-        url = URL.BASE_URL.value + "/purge"
+        url = URL.BASE_URL.value + URL.PURGE_CACHE.value
         headers = {"Content-Type": "application/json"}
         headers.update(self.request.get_auth_headers())
         body = {"url": file_url}
@@ -216,11 +219,29 @@ def get_metadata(self, file_id: str = None):
         resp = self.request.request("GET", url, headers=self.request.create_headers())
         formatted_resp = camel_dict_to_snake_dict(resp.json())
         if resp.status_code > 200:
-            error = formatted_resp
+            error = resp.json()
             response = None
         else:
             error = None
-            response = formatted_resp
+            response = resp.json()
+        response = {"error": error, "response": response}
+        return response
+
+    def get_metadata_from_remote_url(self, remote_file_url: str):
+        if not remote_file_url:
+            raise ValueError("You must provide remote url")
+        url = URL.REMOTE_METADATA_FULL_URL.value
+        param = {"url": remote_file_url}
+        resp = self.request.request(
+            "GET", url, headers=self.request.create_headers(), params=param
+        )
+
+        if resp.status_code > 204:
+            error = resp.json()
+            response = None
+        else:
+            error = None
+            response = resp.json()
         response = {"error": error, "response": response}
         return response
 

sample/sample.py

@@ -90,10 +90,10 @@
     print("Signed url-", image_url, end="\n\n")
 
     print("-------------------------------------")
-    list_files = imagekit.list_files({"skip": 0, "limit": 2})
+    list_files = imagekit.list_files({"skip": 0, "limit": 5})
     bulk_ids = [
-        list_files["response"][0]["fileId"],
-        list_files["response"][1]["fileId"],
+        list_files["response"][3]["fileId"],
+        list_files["response"][4]["fileId"],
     ]
     print("List files-", "\n", list_files)
 
@@ -185,5 +185,9 @@
 
 print("-------------------------------------")
 
-
 print("Bulk File delete-", imagekit.bulk_delete(bulk_ids))
+
+print("-----------------------------")
+
+remote_file_url = upload["response"]["url"]
+print("Get metadata-", imagekit.get_remote_url_metadata(remote_file_url))