|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
# lint: pylint
|
|
"""Docker Hub (IT)
|
|
|
|
"""
|
|
|
|
from json import loads
|
|
from urllib.parse import urlencode
|
|
from dateutil import parser
|
|
|
|
about = {
|
|
"website": 'https://hub.docker.com',
|
|
"wikidata_id": 'Q100769064',
|
|
"official_api_documentation": 'https://docs.docker.com/registry/spec/api/',
|
|
"use_official_api": True,
|
|
"require_api_key": False,
|
|
"results": 'JSON',
|
|
}
|
|
|
|
categories = ['it'] # optional
|
|
paging = True
|
|
|
|
base_url = "https://hub.docker.com/"
|
|
search_url = base_url + "api/content/v1/products/search?{query}&type=image&page_size=25"
|
|
|
|
def request(query, params):
|
|
|
|
params['url'] = search_url.format(query=urlencode(dict(q=query, page=params["pageno"])))
|
|
params["headers"]["Search-Version"] = "v3"
|
|
|
|
return params
|
|
|
|
def response(resp):
|
|
'''post-response callback
|
|
resp: requests response object
|
|
'''
|
|
results = []
|
|
body = loads(resp.text)
|
|
|
|
# Make sure `summaries` isn't `null`
|
|
search_res = body.get("summaries")
|
|
if search_res:
|
|
for item in search_res:
|
|
result = {}
|
|
|
|
# Make sure correct URL is set
|
|
filter_type = item.get("filter_type")
|
|
is_official = filter_type in ["store", "official"]
|
|
|
|
if is_official:
|
|
result["url"] = base_url + "_/" + item.get('slug', "")
|
|
else:
|
|
result["url"] = base_url + "r/" + item.get('slug', "")
|
|
result["title"] = item.get("name")
|
|
result["content"] = item.get("short_description")
|
|
result["publishedDate"] = parser.parse(
|
|
item.get("updated_at") or item.get("created_at")
|
|
)
|
|
result["thumbnail"] = (
|
|
item["logo_url"].get("large") or item["logo_url"].get("small")
|
|
)
|
|
results.append(result)
|
|
|
|
return results
|