def put(self, action, params=None, headers=None):
"""Make PUT request
"""
return self.request(util.join_url(self.endpoint, action),
'PUT',
body=params or {},
headers=headers or {})
def get(self, action, headers=None):
"""Make GET request
Usage::
>>> cloudconvertrestclient.get("v2/tasks/TASK-ID")
>>> cloudconvertrestclient.get("v2/jobs/JOB-ID")
"""
return self.request(util.join_url(self.endpoint, action), 'GET', headers=headers or {})
def patch(self, action, params=None, headers=None):
"""Make PATCH request
Usage::
"""
return self.request(util.join_url(self.endpoint, action),
'PATCH',
body=params or {},
headers=headers or {})
def delete(cls, id):
"""Deletes a resource e.g. task
Usage::
>>> Task.delete(TASK_ID)
"""
api_client = default_client()
url = util.join_url(cls.path, str(id))
api_resource = Resource()
new_attributes = api_client.delete(url)
api_resource.error = None
api_resource.merge(new_attributes)
return api_resource.success()
def show(cls, id):
"""show resource e.g. job with given id
Usage::
>>> job = Job.show("s9fsf9-s9f9sf9s-ggfgf9-fg9fg")
"""
api_client = default_client()
url = util.join_url(cls.path, str(id))
res = api_client.get(url)
try:
return res["data"]
except:
return res
def cancel(cls, id):
"""Cancel a resource for given Id e.g. task
Usage::
>>> Task.cancel("4534d-34gsf-54cxv-9cxv") # return True or False
"""
api_client = default_client()
url = util.join_url(cls.path, str(id), "cancel")
api_resource = Resource()
new_attributes = api_client.post(url, {}, {})
api_resource.error = None
api_resource.merge(new_attributes)
return api_resource.success()
def retry(cls, id):
"""Retry a resource for given Id e.g. task
Usage::
>>> Task.retry("4534d-34gsf-54cxv-9cxv")
"""
api_client = default_client()
url = util.join_url(cls.path, str(id), "retry")
res = api_client.post(url)
try:
return res["data"]
except:
return res
def post(self, action, params=None, headers={}):
"""Make POST request
Usage::
>>> cloudconvertrestclient.post("v2/jobs/", {"tasks": {
"task-import-file7": {
"operation": "import/url",
"url": "https://file-examples.com/wp-content/uploads/2017/02/"
}}})
>>> cloudconvertrestclient.post("v2/export/url", {
"input": "f1e276cf-1cfa-4cd5-8c87-1e3d07206cf3",
"file": "file-sample_100kB.doc"})
"""
return self.request(util.join_url(self.endpoint, action), 'POST', body=params or {}, headers= {} or headers)
def create(cls, operation=None, payload={}):
"""Creates a resource e.g. task
Usage::
>>> task = Task({})
>>> task.create(name=TASK_NAME) # return newly created task
"""
api_client = default_client()
url = util.join_url('v2', operation or '')
res = api_client.post(url, payload, headers={})
try:
return res["data"]
except:
return res
def delete(self, action, headers=None):
"""Make DELETE request
"""
return self.request(util.join_url(self.endpoint, action),
'DELETE',
headers=headers or {})
