# 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