searx.engines.annas_archive Namespace Reference

Functions
None	init (dict[str, t.Any] engine_settings)
None	request (str query, dict[str, t.Any] params)
EngineResults	response ("SXNG_Response" resp)
dict[str, t.Any]	_get_result (ElementBase item)
	fetch_traits (EngineTraits engine_traits)

Variables
dict	about
list	categories = ["files"]
bool	paging = True
str	base_url = "https://annas-archive.org"
str	aa_content = ""
str	aa_sort = ''
str	aa_ext = ''

Detailed Description

`Anna's Archive`_ is a free non-profit online shadow library metasearch
engine providing access to a variety of book resources (also via IPFS), created
by a team of anonymous archivists (AnnaArchivist_).

.. _Anna's Archive: https://annas-archive.org/
.. _AnnaArchivist: https://annas-software.org/AnnaArchivist/annas-archive

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

The engine has the following additional settings:

- :py:obj:`aa_content`
- :py:obj:`aa_ext`
- :py:obj:`aa_sort`

With this options a SearXNG maintainer is able to configure **additional**
engines for specific searches in Anna's Archive.  For example a engine to search
for *newest* articles and journals (PDF) / by shortcut ``!aaa <search-term>``.

.. code:: yaml

  - name: annas articles
    engine: annas_archive
    shortcut: aaa
    aa_content: 'magazine'
    aa_ext: 'pdf'
    aa_sort: 'newest'

Implementations
===============

Function Documentation

_get_result()

dict[str, t.Any] searx.engines.annas_archive._get_result ( ElementBase item )

protected

Definition at line 141 of file annas_archive.py.

def _get_result(item: ElementBase) -> dict[str, t.Any]:
    return {
        'template': 'paper.html',
        'url': base_url + eval_xpath_getindex(item, './a/@href', 0),
        'title': extract_text(eval_xpath(item, './div//a[starts-with(@href, "/md5")]')),
        'authors': [extract_text(eval_xpath_getindex(item, './/a[starts-with(@href, "/search")]', 0))],
        'publisher': extract_text(
            eval_xpath_getindex(item, './/a[starts-with(@href, "/search")]', 1, default=None), allow_none=True
        ),
        'content': extract_text(eval_xpath(item, './/div[contains(@class, "relative")]')),
        'thumbnail': extract_text(eval_xpath_getindex(item, './/img/@src', 0, default=None), allow_none=True),
    }
 
 

Referenced by response().

Here is the caller graph for this function:

fetch_traits()

searx.engines.annas_archive.fetch_traits

(

EngineTraits

engine_traits

)

Fetch languages and other search arguments from Anna's search form.

Definition at line 155 of file annas_archive.py.

def fetch_traits(engine_traits: EngineTraits):
    """Fetch languages and other search arguments from Anna's search form."""
    # pylint: disable=import-outside-toplevel
 
    import babel
    from searx.network import get  # see https://github.com/searxng/searxng/issues/762
    from searx.locales import language_tag
 
    engine_traits.all_locale = ''
    engine_traits.custom['content'] = []
    engine_traits.custom['ext'] = []
    engine_traits.custom['sort'] = []
 
    resp = get(base_url + '/search')
    if not resp.ok:
        raise RuntimeError("Response from Anna's search page is not OK.")
    dom = html.fromstring(resp.text)
 
    # supported language codes
 
    lang_map = {}
    for x in eval_xpath_list(dom, "//form//input[@name='lang']"):
        eng_lang = x.get("value")
        if eng_lang in ('', '_empty', 'nl-BE', 'und') or eng_lang.startswith('anti__'):
            continue
        try:
            locale = babel.Locale.parse(lang_map.get(eng_lang, eng_lang), sep='-')
        except babel.UnknownLocaleError:
            # silently ignore unknown languages
            # print("ERROR: %s -> %s is unknown by babel" % (x.get("data-name"), eng_lang))
            continue
        sxng_lang = language_tag(locale)
        conflict = engine_traits.languages.get(sxng_lang)
        if conflict:
            if conflict != eng_lang:
                print("CONFLICT: babel %s --> %s, %s" % (sxng_lang, conflict, eng_lang))
            continue
        engine_traits.languages[sxng_lang] = eng_lang
 
    for x in eval_xpath_list(dom, "//form//input[@name='content']"):
        if not x.get("value").startswith("anti__"):
            engine_traits.custom['content'].append(x.get("value"))
 
    for x in eval_xpath_list(dom, "//form//input[@name='ext']"):
        if not x.get("value").startswith("anti__"):
            engine_traits.custom['ext'].append(x.get("value"))
 
    for x in eval_xpath_list(dom, "//form//select[@name='sort']//option"):
        engine_traits.custom['sort'].append(x.get("value"))
 
    # for better diff; sort the persistence of these traits
    engine_traits.custom['content'].sort()
    engine_traits.custom['ext'].sort()
    engine_traits.custom['sort'].sort()

init()

None searx.engines.annas_archive.init

(

dict[str, t.Any]

engine_settings

)

Check of engine's settings.

Definition at line 94 of file annas_archive.py.

def init(engine_settings: dict[str, t.Any]) -> None:  # pylint: disable=unused-argument
    """Check of engine's settings."""
    traits = EngineTraits(**ENGINE_TRAITS['annas archive'])
 
    if aa_content and aa_content not in traits.custom['content']:
        raise ValueError(f'invalid setting content: {aa_content}')
 
    if aa_sort and aa_sort not in traits.custom['sort']:
        raise ValueError(f'invalid setting sort: {aa_sort}')
 
    if aa_ext and aa_ext not in traits.custom['ext']:
        raise ValueError(f'invalid setting ext: {aa_ext}')
 
 

request()

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

Definition at line 108 of file annas_archive.py.

def request(query: str, params: dict[str, t.Any]) -> None:
    lang = traits.get_language(params["language"], traits.all_locale)
    args = {
        'lang': lang,
        'content': aa_content,
        'ext': aa_ext,
        'sort': aa_sort,
        'q': query,
        'page': params['pageno'],
    }
    # filter out None and empty values
    filtered_args = dict((k, v) for k, v in args.items() if v)
    params["url"] = f"{base_url}/search?{urlencode(filtered_args)}"
 
 

response()

EngineResults searx.engines.annas_archive.response

(

"SXNG_Response"

resp

)

Definition at line 123 of file annas_archive.py.

def response(resp: "SXNG_Response") -> EngineResults:
    res = EngineResults()
    dom = html.fromstring(resp.text)
 
    # The rendering of the WEB page is strange; positions of Anna's result page
    # are enclosed in SGML comments.  These comments are *uncommented* by some
    # JS code, see query of class '.js-scroll-hidden' in Anna's HTML template:
    #   https://annas-software.org/AnnaArchivist/annas-archive/-/blob/main/allthethings/templates/macros/md5_list.html
 
    for item in eval_xpath_list(dom, '//main//div[contains(@class, "js-aarecord-list-outer")]/div'):
        try:
            kwargs: dict[str, t.Any] = _get_result(item)
        except SearxEngineXPathException:
            continue
        res.add(res.types.LegacyResult(**kwargs))
    return res
 
 

References _get_result().

Here is the call graph for this function:

Variable Documentation

aa_content

str searx.engines.annas_archive.aa_content = ""

Definition at line 67 of file annas_archive.py.

aa_ext

str searx.engines.annas_archive.aa_ext = ''

Definition at line 82 of file annas_archive.py.

aa_sort

str searx.engines.annas_archive.aa_sort = ''

Definition at line 75 of file annas_archive.py.

about

dict searx.engines.annas_archive.about

Initial value:

=  {
    "website": "https://annas-archive.org/",
    "wikidata_id": "Q115288326",
    "official_api_documentation": None,
    "use_official_api": False,
    "require_api_key": False,
    "results": "HTML",
}

Definition at line 52 of file annas_archive.py.

base_url

str searx.engines.annas_archive.base_url = "https://annas-archive.org"

Definition at line 66 of file annas_archive.py.

categories

list searx.engines.annas_archive.categories = ["files"]

Definition at line 62 of file annas_archive.py.

paging

bool searx.engines.annas_archive.paging = True

Definition at line 63 of file annas_archive.py.