Ponysearch/searx/engines/deviantart.py

## Deviantart (Images)
#
# @website     https://www.deviantart.com/
# @provide-api yes (https://www.deviantart.com/developers/) (RSS)
#
# @using-api   no (TODO, rewrite to api)
# @results     HTML
# @stable      no (HTML can change)
# @parse       url, title, thumbnail, img_src
#
# @todo        rewrite to api

from urllib import urlencode
from urlparse import urljoin
from lxml import html

# engine dependent config
categories = ['images']
paging = True

# search-url
base_url = 'https://www.deviantart.com/'
search_url = base_url+'search?offset={offset}&{query}'


# do search-request
def request(query, params):
    offset = (params['pageno'] - 1) * 24

    params['url'] = search_url.format(offset=offset,
                                      query=urlencode({'q': query}))

    return params


# get response from search-request
def response(resp):
    results = []

    # return empty array if a redirection code is returned
    if resp.status_code == 302:
        return []

    dom = html.fromstring(resp.text)

    # parse results
    for result in dom.xpath('//div[contains(@class, "tt-a tt-fh")]'):
        link = result.xpath('.//a[contains(@class, "thumb")]')[0]
        url = urljoin(base_url, link.attrib.get('href'))
        title_links = result.xpath('.//span[@class="details"]//a[contains(@class, "t")]')  # noqa
        title = ''.join(title_links[0].xpath('.//text()'))
        img_src = link.xpath('.//img')[0].attrib['src']

        # append result
        results.append({'url': url,
                        'title': title,
                        'img_src': img_src,
                        'template': 'images.html'})

    # return results
    return results