artic.py 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. # SPDX-License-Identifier: AGPL-3.0-or-later
  2. # lint: pylint
  3. """The Art Institute of Chicago
  4. Explore thousands of artworks from The Art Institute of Chicago.
  5. * https://artic.edu
  6. """
  7. # pylint: disable=missing-function-docstring
  8. from json import loads
  9. from urllib.parse import urlencode
  10. about = {
  11. "website": 'https://www.artic.edu',
  12. "wikidata_id": 'Q239303',
  13. "official_api_documentation": 'http://api.artic.edu/docs/',
  14. "use_official_api": True,
  15. "require_api_key": False,
  16. "results": 'JSON',
  17. }
  18. categories = ['images']
  19. paging = True
  20. nb_per_page = 20
  21. search_api = 'https://api.artic.edu/api/v1/artworks/search?'
  22. image_api = 'https://www.artic.edu/iiif/2/'
  23. def request(query, params):
  24. args = urlencode({
  25. 'q' : query,
  26. 'page' : params['pageno'],
  27. 'fields' : 'id,title,artist_display,medium_display,image_id,date_display,dimensions,artist_titles',
  28. 'limit' : nb_per_page,
  29. })
  30. params['url'] = search_api + args
  31. logger.debug("query_url --> %s", params['url'])
  32. return params
  33. def response(resp):
  34. results = []
  35. json_data = loads(resp.text)
  36. for result in json_data['data']:
  37. if not result['image_id']:
  38. continue
  39. results.append({
  40. 'url': 'https://artic.edu/artworks/%(id)s' % result,
  41. 'title': result['title'] + " (%(date_display)s) // %(artist_display)s" % result,
  42. 'content': result['medium_display'],
  43. 'author': ', '.join(result['artist_titles']),
  44. 'img_src': image_api + '/%(image_id)s/full/843,/0/default.jpg' % result,
  45. 'img_format': result['dimensions'],
  46. 'template': 'images.html'
  47. })
  48. return results