Public Member Functions
	__init__ (self)

	extend (self, engine_name, results)

	close (self)

	get_ordered_results (self)

	results_length (self)

int	number_of_results (self)

	add_unresponsive_engine (self, str engine_name, str error_type, bool suspended=False)

	add_timing (self, str engine_name, float engine_time, float page_load_time)

	get_timings (self)

Public Attributes
	infoboxes

	suggestions

	answers

	corrections

	engine_data

	paging

	redirect_url

	on_result

Protected Member Functions
	_merge_infobox (self, infobox)

	_is_valid_url_result (self, result, error_msgs)

	_normalize_url_result (self, result)

Protected Attributes
	_merged_results

	_number_of_results

	_closed

	_lock

Private Member Functions
	__merge_url_result (self, result, position)

	__find_duplicated_http_result (self, result)

	__merge_duplicated_http_result (self, duplicated, result, position)

	__merge_result_no_url (self, result, position)

Static Private Attributes
tuple	__slots__

Detailed Description

docstring for ResultContainer

Definition at line 157 of file results.py.

Constructor & Destructor Documentation

◆ init()

searx.results.ResultContainer.__init__ ( self )

Definition at line 177 of file results.py.

    def __init__(self):
        super().__init__()
        self._merged_results = []
        self.infoboxes = []
        self.suggestions = set()
        self.answers = {}
        self.corrections = set()
        self._number_of_results = []
        self.engine_data = defaultdict(dict)
        self._closed = False
        self.paging = False
        self.unresponsive_engines: Set[UnresponsiveEngine] = set()
        self.timings: List[Timing] = []
        self.redirect_url = None
        self.on_result = lambda _: True
        self._lock = RLock()
 

Member Function Documentation

◆ __find_duplicated_http_result()

searx.results.ResultContainer.__find_duplicated_http_result	(		self,
			result )

private

Definition at line 308 of file results.py.

    def __find_duplicated_http_result(self, result):
        result_template = result.get('template')
        for merged_result in self._merged_results:
            if 'parsed_url' not in merged_result:
                continue
            if compare_urls(result['parsed_url'], merged_result['parsed_url']) and result_template == merged_result.get(
                'template'
            ):
                if result_template != 'images.html':
                    # not an image, same template, same url : it's a duplicate
                    return merged_result
 
                # it's an image
                # it's a duplicate if the parsed_url, template and img_src are different
                if result.get('img_src', '') == merged_result.get('img_src', ''):
                    return merged_result
        return None
 

◆ __merge_duplicated_http_result()

searx.results.ResultContainer.__merge_duplicated_http_result	(	self,
		duplicated,
		result,
		position )

private

Definition at line 326 of file results.py.

    def __merge_duplicated_http_result(self, duplicated, result, position):
        # using content with more text
        if result_content_len(result.get('content', '')) > result_content_len(duplicated.get('content', '')):
            duplicated['content'] = result['content']
 
        # merge all result's parameters not found in duplicate
        for key in result.keys():
            if not duplicated.get(key):
                duplicated[key] = result.get(key)
 
        # add the new position
        duplicated['positions'].append(position)
 
        # add engine to list of result-engines
        duplicated['engines'].add(result['engine'])
 
        # using https if possible
        if duplicated['parsed_url'].scheme != 'https' and result['parsed_url'].scheme == 'https':
            duplicated['url'] = result['parsed_url'].geturl()
            duplicated['parsed_url'] = result['parsed_url']
 

◆ __merge_result_no_url()

searx.results.ResultContainer.__merge_result_no_url	(	self,
		result,
		position )

private

Definition at line 347 of file results.py.

    def __merge_result_no_url(self, result, position):
        result['engines'] = set([result['engine']])
        result['positions'] = [position]
        with self._lock:
            self._merged_results.append(result)
 

◆ __merge_url_result()

searx.results.ResultContainer.__merge_url_result	(	self,
		result,
		position )

private

Definition at line 296 of file results.py.

    def __merge_url_result(self, result, position):
        result['engines'] = set([result['engine']])
        with self._lock:
            duplicated = self.__find_duplicated_http_result(result)
            if duplicated:
                self.__merge_duplicated_http_result(duplicated, result, position)
                return
 
            # if there is no duplicate found, append result
            result['positions'] = [position]
            self._merged_results.append(result)
 

◆ _is_valid_url_result()

searx.results.ResultContainer._is_valid_url_result	(	self,
		result,
		error_msgs )

protected

Definition at line 255 of file results.py.

    def _is_valid_url_result(self, result, error_msgs):
        if 'url' in result:
            if not isinstance(result['url'], str):
                logger.debug('result: invalid URL: %s', str(result))
                error_msgs.add('invalid URL')
                return False
 
        if 'title' in result and not isinstance(result['title'], str):
            logger.debug('result: invalid title: %s', str(result))
            error_msgs.add('invalid title')
            return False
 
        if 'content' in result:
            if not isinstance(result['content'], str):
                logger.debug('result: invalid content: %s', str(result))
                error_msgs.add('invalid content')
                return False
 
        return True
 

◆ _merge_infobox()

searx.results.ResultContainer._merge_infobox	(		self,
			infobox )

protected

Definition at line 240 of file results.py.

    def _merge_infobox(self, infobox):
        add_infobox = True
        infobox_id = infobox.get('id', None)
        infobox['engines'] = set([infobox['engine']])
        if infobox_id is not None:
            parsed_url_infobox_id = urlparse(infobox_id)
            with self._lock:
                for existingIndex in self.infoboxes:
                    if compare_urls(urlparse(existingIndex.get('id', '')), parsed_url_infobox_id):
                        merge_two_infoboxes(existingIndex, infobox)
                        add_infobox = False
 
        if add_infobox:
            self.infoboxes.append(infobox)
 

◆ _normalize_url_result()

searx.results.ResultContainer._normalize_url_result	(		self,
			result )

protected

Return True if the result is valid

Definition at line 275 of file results.py.

    def _normalize_url_result(self, result):
        """Return True if the result is valid"""
        result['parsed_url'] = urlparse(result['url'])
 
        # if the result has no scheme, use http as default
        if not result['parsed_url'].scheme:
            result['parsed_url'] = result['parsed_url']._replace(scheme="http")
            result['url'] = result['parsed_url'].geturl()
 
        # avoid duplicate content between the content and title fields
        if result.get('content') == result.get('title'):
            del result['content']
 
        # make sure there is a template
        if 'template' not in result:
            result['template'] = 'default.html'
 
        # strip multiple spaces and carriage returns from content
        if result.get('content'):
            result['content'] = WHITESPACE_REGEX.sub(' ', result['content'])
 

◆ add_timing()

searx.results.ResultContainer.add_timing	(		self,
		str	engine_name,
		float	engine_time,
		float	page_load_time )

Definition at line 446 of file results.py.

    def add_timing(self, engine_name: str, engine_time: float, page_load_time: float):
        self.timings.append(Timing(engine_name, total=engine_time, load=page_load_time))
 

◆ add_unresponsive_engine()

searx.results.ResultContainer.add_unresponsive_engine	(		self,
		str	engine_name,
		str	error_type,
		bool	suspended = False )

Definition at line 442 of file results.py.

    def add_unresponsive_engine(self, engine_name: str, error_type: str, suspended: bool = False):
        if engines[engine_name].display_error_messages:
            self.unresponsive_engines.add(UnresponsiveEngine(engine_name, error_type, suspended))
 

◆ close()

searx.results.ResultContainer.close ( self )

Definition at line 353 of file results.py.

    def close(self):
        self._closed = True
 
        for result in self._merged_results:
            score = result_score(result)
            result['score'] = score
 
            # removing html content and whitespace duplications
            if result.get('content'):
                result['content'] = utils.html_to_text(result['content']).strip()
            if result.get('title'):
                result['title'] = ' '.join(utils.html_to_text(result['title']).strip().split())
 
            for result_engine in result['engines']:
                counter_add(score, 'engine', result_engine, 'score')
 
        results = sorted(self._merged_results, key=itemgetter('score'), reverse=True)
 
        # pass 2 : group results by category and template
        gresults = []
        categoryPositions = {}
 
        for res in results:
            # do we need to handle more than one category per engine?
            engine = engines[res['engine']]
            res['category'] = engine.categories[0] if len(engine.categories) > 0 else ''
 
            # do we need to handle more than one category per engine?
            category = (
                res['category']
                + ':'
                + res.get('template', '')
                + ':'
                + ('img_src' if 'img_src' in res or 'thumbnail' in res else '')
            )
 
            current = None if category not in categoryPositions else categoryPositions[category]
 
            # group with previous results using the same category
            # if the group can accept more result and is not too far
            # from the current position
            if current is not None and (current['count'] > 0) and (len(gresults) - current['index'] < 20):
                # group with the previous results using
                # the same category with this one
                index = current['index']
                gresults.insert(index, res)
 
                # update every index after the current one
                # (including the current one)
                for k in categoryPositions:  # pylint: disable=consider-using-dict-items
                    v = categoryPositions[k]['index']
                    if v >= index:
                        categoryPositions[k]['index'] = v + 1
 
                # update this category
                current['count'] -= 1
 
            else:
                # same category
                gresults.append(res)
 
                # update categoryIndex
                categoryPositions[category] = {'index': len(gresults), 'count': 8}
 
        # update _merged_results
        self._merged_results = gresults
 

◆ extend()

searx.results.ResultContainer.extend	(	self,
		engine_name,
		results )

Definition at line 194 of file results.py.

    def extend(self, engine_name, results):  # pylint: disable=too-many-branches
        if self._closed:
            return
 
        standard_result_count = 0
        error_msgs = set()
        for result in list(results):
            result['engine'] = engine_name
            if 'suggestion' in result and self.on_result(result):
                self.suggestions.add(result['suggestion'])
            elif 'answer' in result and self.on_result(result):
                self.answers[result['answer']] = result
            elif 'correction' in result and self.on_result(result):
                self.corrections.add(result['correction'])
            elif 'infobox' in result and self.on_result(result):
                self._merge_infobox(result)
            elif 'number_of_results' in result and self.on_result(result):
                self._number_of_results.append(result['number_of_results'])
            elif 'engine_data' in result and self.on_result(result):
                self.engine_data[engine_name][result['key']] = result['engine_data']
            elif 'url' in result:
                # standard result (url, title, content)
                if not self._is_valid_url_result(result, error_msgs):
                    continue
                # normalize the result
                self._normalize_url_result(result)
                # call on_result call searx.search.SearchWithPlugins._on_result
                # which calls the plugins
                if not self.on_result(result):
                    continue
                self.__merge_url_result(result, standard_result_count + 1)
                standard_result_count += 1
            elif self.on_result(result):
                self.__merge_result_no_url(result, standard_result_count + 1)
                standard_result_count += 1
 
        if len(error_msgs) > 0:
            for msg in error_msgs:
                count_error(engine_name, 'some results are invalids: ' + msg, secondary=True)
 
        if engine_name in engines:
            histogram_observe(standard_result_count, 'engine', engine_name, 'result', 'count')
 
        if not self.paging and engine_name in engines and engines[engine_name].paging:
            self.paging = True
 

◆ get_ordered_results()

searx.results.ResultContainer.get_ordered_results ( self )

Definition at line 420 of file results.py.

    def get_ordered_results(self):
        if not self._closed:
            self.close()
        return self._merged_results
 

◆ get_timings()

searx.results.ResultContainer.get_timings ( self )

Definition at line 449 of file results.py.

449 def get_timings(self):

450 return self.timings

◆ number_of_results()

int searx.results.ResultContainer.number_of_results ( self )

Returns the average of results number, returns zero if the average
result number is smaller than the actual result count.

Definition at line 429 of file results.py.

    def number_of_results(self) -> int:
        """Returns the average of results number, returns zero if the average
        result number is smaller than the actual result count."""
 
        resultnum_sum = sum(self._number_of_results)
        if not resultnum_sum or not self._number_of_results:
            return 0
 
        average = int(resultnum_sum / len(self._number_of_results))
        if average < self.results_length():
            average = 0
        return average
 

◆ results_length()

searx.results.ResultContainer.results_length ( self )

Definition at line 425 of file results.py.

    def results_length(self):
        return len(self._merged_results)
 

Member Data Documentation

◆ slots

tuple searx.results.ResultContainer.__slots__

staticprivate

Initial value:

=  (
        '_merged_results',
        'infoboxes',
        'suggestions',
        'answers',
        'corrections',
        '_number_of_results',
        '_closed',
        'paging',
        'unresponsive_engines',
        'timings',
        'redirect_url',
        'engine_data',
        'on_result',
        '_lock',
    )

Definition at line 160 of file results.py.

◆ _closed

searx.results.ResultContainer._closed

protected

Definition at line 186 of file results.py.

◆ _lock

searx.results.ResultContainer._lock

protected

Definition at line 192 of file results.py.

Referenced by searx.metrics.models.Histogram.average(), searx.metrics.models.Histogram.observe(), searx.metrics.models.Histogram.percentage(), searx.metrics.models.Histogram.quartile_percentage(), and searx.metrics.models.Histogram.quartile_percentage_map().

◆ _merged_results

searx.results.ResultContainer._merged_results

protected

Definition at line 179 of file results.py.

◆ _number_of_results

searx.results.ResultContainer._number_of_results

protected

Definition at line 184 of file results.py.

◆ answers

searx.results.ResultContainer.answers

Definition at line 182 of file results.py.

◆ corrections

searx.results.ResultContainer.corrections

Definition at line 183 of file results.py.

◆ engine_data

searx.results.ResultContainer.engine_data

Definition at line 185 of file results.py.

Referenced by searx.search.models.SearchQuery.__copy__().

◆ infoboxes

searx.results.ResultContainer.infoboxes

Definition at line 180 of file results.py.

◆ on_result

searx.results.ResultContainer.on_result

Definition at line 191 of file results.py.

◆ paging

searx.results.ResultContainer.paging

Definition at line 187 of file results.py.

◆ redirect_url

searx.results.ResultContainer.redirect_url

Definition at line 190 of file results.py.

◆ suggestions

searx.results.ResultContainer.suggestions

Definition at line 181 of file results.py.

The documentation for this class was generated from the following file:

/home/andrew/Documents/code/public/searxng/searx/results.py

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

Member Function Documentation

◆ __find_duplicated_http_result()

◆ __merge_duplicated_http_result()

◆ __merge_result_no_url()

◆ __merge_url_result()

◆ _is_valid_url_result()

◆ _merge_infobox()

◆ _normalize_url_result()

◆ add_timing()

◆ add_unresponsive_engine()

◆ close()

◆ extend()

◆ get_ordered_results()

◆ get_timings()

◆ number_of_results()

◆ results_length()

Member Data Documentation

◆ __slots__

◆ _closed

◆ _lock

◆ _merged_results

◆ _number_of_results

◆ answers

◆ corrections

◆ engine_data

◆ infoboxes

◆ on_result

◆ paging

◆ redirect_url

◆ suggestions

◆ init()

◆ slots