Functions
None	request (str query, dict[str, t.Any] params)
str\|None	_get_most_common (list[str\|None] items)
	_flatten (xss)
EngineResults	response ('SXNG_Response' resp)

Variables
dict	about
list	categories = ['packages', 'it']
str	base_url = 'https://repology.org'

Detailed Description

Repology_ monitors a huge number of package repositories and other sources
comparing packages versions across them and gathering other information.

Repology_ shows you in which repositories a given project is packaged, which
version is the latest and which needs updating, who maintains the package, and
other related information.

.. _Repology: https://repology.org/docs/about

Configuration
=============

The engine is inactive by default, meaning it is not available in the service.
If you want to offer the engine, the ``inactive`` flag must be set to ``false``.

.. code:: yaml

  - name: repology
    inactive: false

Function Documentation

◆ _flatten()

searx.engines.repology._flatten ( xss )

protected

Definition at line 62 of file repology.py.

def _flatten(xss):
    return [x for xs in xss for x in xs]

Referenced by response().

Here is the caller graph for this function:

◆ _get_most_common()

str | None searx.engines.repology._get_most_common ( list[str | None] items )

protected

Definition at line 51 of file repology.py.

def _get_most_common(items: list[str | None]) -> str | None:
    counts: dict[str | None, int] = {}
    for item in items:
        if item:
            counts[item] = counts.get(item, 0) + 1
 
    if len(counts) == 0:
        return None
    return max(counts, key=counts.get)
 
 

Referenced by response().

Here is the caller graph for this function:

◆ request()

None searx.engines.repology.request	(	str	query,
		dict[str, t.Any]	params )

Definition at line 44 of file repology.py.

def request(query: str, params: dict[str, t.Any]) -> None:
    args = {
        'search': query,
    }
    params['url'] = f"{base_url}/api/v1/projects/?{urlencode(args)}"
 
 

◆ response()

EngineResults searx.engines.repology.response ( 'SXNG_Response' resp )

Definition at line 66 of file repology.py.

def response(resp: 'SXNG_Response') -> EngineResults:
    res = EngineResults()
 
    resp_json = resp.json()
    for pkgname, repositories in resp_json.items():
 
        # either there's a package with status "newest" or we assume that the
        # most commonly used version is the latest released (non-alpha) version
        latest_version = None
        for repo in repositories:
            if repo.get("status") == "newest":
                latest_version = repo["version"]
                break
        else:
            latest_version = _get_most_common([repo.get("version") for repo in repositories])
 
        res.add(
            res.types.LegacyResult(
                template='packages.html',
                url=f"{base_url}/project/{pkgname}/versions",
                title=pkgname,
                content=_get_most_common([pkg.get("summary") for pkg in repositories]),
                package_name=_get_most_common([pkg.get("visiblename") for pkg in repositories]),
                version=latest_version,
                license_name=_get_most_common(_flatten([pkg.get("licenses", []) for pkg in repositories])),
                tags=list({pkg.get("repo") for pkg in repositories}),  # ensure that tags are unique
            )
        )
 
    return res

References _flatten(), and _get_most_common().

Here is the call graph for this function:

Variable Documentation

◆ about

dict searx.engines.repology.about

Initial value:

=  {
    'website': 'https://repology.org',
    'wikidata_id': 'Q107409859',
    'use_official_api': True,
    'official_api_documentation': 'https://repology.org/api/v1',
    'require_api_key': False,
    'results': 'JSON',
}

Definition at line 32 of file repology.py.

◆ base_url

str searx.engines.repology.base_url = 'https://repology.org'

Definition at line 41 of file repology.py.

◆ categories

list searx.engines.repology.categories = ['packages', 'it']

Definition at line 40 of file repology.py.

Functions

Variables