searx.engines.dailymotion Namespace Reference

Functions
	request (query, params)
	response (resp)
	fetch_traits (EngineTraits engine_traits)

Variables
logging	logger .Logger
dict	about
list	categories = ['videos']
bool	paging = True
int	number_of_results = 10
bool	time_range_support = True
dict	time_delta_dict
bool	safesearch = True
dict	safesearch_params
dict	family_filter_map
list	result_fields
str	search_url = 'https://api.dailymotion.com/videos?'
str	iframe_src = "https://www.dailymotion.com/embed/video/{video_id}"

Detailed Description

Dailymotion (Videos)
~~~~~~~~~~~~~~~~~~~~

.. _REST GET: https://developers.dailymotion.com/tools/
.. _Global API Parameters: https://developers.dailymotion.com/api/#global-parameters
.. _Video filters API: https://developers.dailymotion.com/api/#video-filters
.. _Fields selection: https://developers.dailymotion.com/api/#fields-selection

Function Documentation

fetch_traits()

searx.engines.dailymotion.fetch_traits

(

EngineTraits

engine_traits

)

Fetch locales & languages from dailymotion.

Locales fetched from `api/locales <https://api.dailymotion.com/locales>`_.
There are duplications in the locale codes returned from Dailymotion which
can be ignored::

  en_EN --> en_GB, en_US
  ar_AA --> ar_EG, ar_AE, ar_SA

The language list `api/languages <https://api.dailymotion.com/languages>`_
contains over 7000 *languages* codes (see PR1071_).  We use only those
language codes that are used in the locales.

.. _PR1071: https://github.com/searxng/searxng/pull/1071

Definition at line 202 of file dailymotion.py.

def fetch_traits(engine_traits: EngineTraits):
    """Fetch locales & languages from dailymotion.
 
    Locales fetched from `api/locales <https://api.dailymotion.com/locales>`_.
    There are duplications in the locale codes returned from Dailymotion which
    can be ignored::
 
      en_EN --> en_GB, en_US
      ar_AA --> ar_EG, ar_AE, ar_SA
 
    The language list `api/languages <https://api.dailymotion.com/languages>`_
    contains over 7000 *languages* codes (see PR1071_).  We use only those
    language codes that are used in the locales.
 
    .. _PR1071: https://github.com/searxng/searxng/pull/1071
 
    """
 
    resp = get('https://api.dailymotion.com/locales')
    if not resp.ok:  # type: ignore
        print("ERROR: response from dailymotion/locales is not OK.")
 
    for item in resp.json()['list']:  # type: ignore
        eng_tag = item['locale']
        if eng_tag in ('en_EN', 'ar_AA'):
            continue
        try:
            sxng_tag = region_tag(babel.Locale.parse(eng_tag))
        except babel.UnknownLocaleError:
            print("ERROR: item unknown --> %s" % item)
            continue
 
        conflict = engine_traits.regions.get(sxng_tag)
        if conflict:
            if conflict != eng_tag:
                print("CONFLICT: babel %s --> %s, %s" % (sxng_tag, conflict, eng_tag))
            continue
        engine_traits.regions[sxng_tag] = eng_tag
 
    locale_lang_list = [x.split('_')[0] for x in engine_traits.regions.values()]
 
    resp = get('https://api.dailymotion.com/languages')
    if not resp.ok:  # type: ignore
        print("ERROR: response from dailymotion/languages is not OK.")
 
    for item in resp.json()['list']:  # type: ignore
        eng_tag = item['code']
        if eng_tag in locale_lang_list:
            sxng_tag = language_tag(babel.Locale.parse(eng_tag))
            engine_traits.languages[sxng_tag] = eng_tag

request()

searx.engines.dailymotion.request	(		query,
			params )

Definition at line 103 of file dailymotion.py.

def request(query, params):
 
    if not query:
        return False
 
    eng_region: str = traits.get_region(params['searxng_locale'], 'en_US')  # type: ignore
    eng_lang = traits.get_language(params['searxng_locale'], 'en')
 
    args = {
        'search': query,
        'family_filter': family_filter_map.get(params['safesearch'], 'false'),
        'thumbnail_ratio': 'original',  # original|widescreen|square
        # https://developers.dailymotion.com/api/#video-filters
        'languages': eng_lang,
        'page': params['pageno'],
        'password_protected': 'false',
        'private': 'false',
        'sort': 'relevance',
        'limit': number_of_results,
        'fields': ','.join(result_fields),
    }
 
    args.update(safesearch_params.get(params['safesearch'], {}))
 
    # Don't add localization and country arguments if the user does select a
    # language (:de, :en, ..)
 
    if len(params['searxng_locale'].split('-')) > 1:
        # https://developers.dailymotion.com/api/#global-parameters
        args['localization'] = eng_region
        args['country'] = eng_region.split('_')[1]
        # Insufficient rights for the `ams_country' parameter of route `GET /videos'
        # 'ams_country': eng_region.split('_')[1],
 
    time_delta = time_delta_dict.get(params["time_range"])
    if time_delta:
        created_after = datetime.now() - time_delta
        args['created_after'] = datetime.timestamp(created_after)
 
    query_str = urlencode(args)
    params['url'] = search_url + query_str
 
    return params
 
 
# get response from search-request

response()

searx.engines.dailymotion.response

(

resp

)

Definition at line 149 of file dailymotion.py.

def response(resp):
    results = []
 
    search_res = resp.json()
 
    # check for an API error
    if 'error' in search_res:
        raise SearxEngineAPIException(search_res['error'].get('message'))
 
    raise_for_httperror(resp)
 
    # parse results
    for res in search_res.get('list', []):
 
        title = res['title']
        url = res['url']
 
        content = html_to_text(res['description'])
        if len(content) > 300:
            content = content[:300] + '...'
 
        publishedDate = datetime.fromtimestamp(res['created_time'], None)
 
        length = time.gmtime(res.get('duration'))
        if length.tm_hour:
            length = time.strftime("%H:%M:%S", length)
        else:
            length = time.strftime("%M:%S", length)
 
        thumbnail = res['thumbnail_360_url']
        thumbnail = thumbnail.replace("http://", "https://")
 
        item = {
            'template': 'videos.html',
            'url': url,
            'title': title,
            'content': content,
            'publishedDate': publishedDate,
            'length': length,
            'thumbnail': thumbnail,
        }
 
        # HINT: no mater what the value is, without API token videos can't shown
        # embedded
        if res['allow_embed']:
            item['iframe_src'] = iframe_src.format(video_id=res['id'])
 
        results.append(item)
 
    # return results
    return results
 
 

Variable Documentation

about

dict searx.engines.dailymotion.about

Initial value:

=  {
    "website": 'https://www.dailymotion.com',
    "wikidata_id": 'Q769222',
    "official_api_documentation": 'https://www.dailymotion.com/developer',
    "use_official_api": True,
    "require_api_key": False,
    "results": 'JSON',
}

Definition at line 34 of file dailymotion.py.

categories

list searx.engines.dailymotion.categories = ['videos']

Definition at line 44 of file dailymotion.py.

family_filter_map

dict searx.engines.dailymotion.family_filter_map

Initial value:

=  {
    2: 'true',
    1: 'true',
    0: 'false',
}

Definition at line 66 of file dailymotion.py.

iframe_src

str searx.engines.dailymotion.iframe_src = "https://www.dailymotion.com/embed/video/{video_id}"

Definition at line 99 of file dailymotion.py.

logger

logging searx.engines.dailymotion.logger .Logger

Definition at line 29 of file dailymotion.py.

number_of_results

int searx.engines.dailymotion.number_of_results = 10

Definition at line 46 of file dailymotion.py.

paging

bool searx.engines.dailymotion.paging = True

Definition at line 45 of file dailymotion.py.

result_fields

list searx.engines.dailymotion.result_fields

Initial value:

=  [
    'allow_embed',
    'description',
    'title',
    'created_time',
    'duration',
    'url',
    'thumbnail_360_url',
    'id',
]

Definition at line 76 of file dailymotion.py.

safesearch

bool searx.engines.dailymotion.safesearch = True

Definition at line 56 of file dailymotion.py.

safesearch_params

dict searx.engines.dailymotion.safesearch_params

Initial value:

=  {
    2: {'is_created_for_kids': 'true'},
    1: {'is_created_for_kids': 'true'},
    0: {},
}

Definition at line 57 of file dailymotion.py.

search_url

str searx.engines.dailymotion.search_url = 'https://api.dailymotion.com/videos?'

Definition at line 91 of file dailymotion.py.

time_delta_dict

dict searx.engines.dailymotion.time_delta_dict

Initial value:

=  {
    "day": timedelta(days=1),
    "week": timedelta(days=7),
    "month": timedelta(days=31),
    "year": timedelta(days=365),
}

Definition at line 49 of file dailymotion.py.

time_range_support

bool searx.engines.dailymotion.time_range_support = True

Definition at line 48 of file dailymotion.py.