Functions
None	init (engine_settings=None)

Dict[str, Any]	request (str query, Dict[str, Any] params)

	domain_is_seized (dom)

List[Dict[str, Any]]	response (httpx.Response resp)

str\|None	_text (item, str selector)

Dict[str, Any]	_parse_result (item)

None	fetch_traits (EngineTraits engine_traits)

Variables
logging	logger .Logger

dict	about

list	categories = ["files"]

bool	paging = True

str	base_url = "https://zlibrary-global.se"

str	zlib_year_from = ""

str	zlib_year_to = ""

str	zlib_ext = ""

	i18n_language = gettext("Language")

	i18n_book_rating = gettext("Book rating")

	i18n_file_quality = gettext("File quality")

Detailed Description

`Z-Library`_ (abbreviated as z-lib, formerly BookFinder) is a shadow library
project for file-sharing access to scholarly journal articles, academic texts
and general-interest books.  It began as a mirror of Library Genesis, from which
most of its books originate.

.. _Z-Library: https://zlibrary-global.se/

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

The engine has the following additional settings:

- :py:obj:`zlib_year_from`
- :py:obj:`zlib_year_to`
- :py:obj:`zlib_ext`

With this options a SearXNG maintainer is able to configure **additional**
engines for specific searches in Z-Library.  For example a engine to search
only for EPUB from 2010 to 2020.

.. code:: yaml

   - name: z-library 2010s epub
     engine: zlibrary
     shortcut: zlib2010s
     zlib_year_from: '2010'
     zlib_year_to: '2020'
     zlib_ext: 'EPUB'

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

Function Documentation

◆ _parse_result()

Dict[str, Any] searx.engines.zlibrary._parse_result ( item )

protected

Definition at line 142 of file zlibrary.py.

def _parse_result(item) -> Dict[str, Any]:
 
    author_elements = eval_xpath_list(item, './/div[@class="authors"]//a[@itemprop="author"]')
 
    result = {
        "template": "paper.html",
        "url": base_url + item.xpath('(.//a[starts-with(@href, "/book/")])[1]/@href')[0],
        "title": _text(item, './/*[@itemprop="name"]'),
        "authors": [extract_text(author) for author in author_elements],
        "publisher": _text(item, './/a[@title="Publisher"]'),
        "type": _text(item, './/div[contains(@class, "property__file")]//div[contains(@class, "property_value")]'),
    }
 
    thumbnail = _text(item, './/img[contains(@class, "cover")]/@data-src')
    if not thumbnail.startswith('/'):
        result["thumbnail"] = thumbnail
 
    year = _text(item, './/div[contains(@class, "property_year")]//div[contains(@class, "property_value")]')
    if year:
        result["publishedDate"] = datetime.strptime(year, '%Y')
 
    content = []
    language = _text(item, './/div[contains(@class, "property_language")]//div[contains(@class, "property_value")]')
    if language:
        content.append(f"{i18n_language}: {language.capitalize()}")
    book_rating = _text(item, './/span[contains(@class, "book-rating-interest-score")]')
    if book_rating and float(book_rating):
        content.append(f"{i18n_book_rating}: {book_rating}")
    file_quality = _text(item, './/span[contains(@class, "book-rating-quality-score")]')
    if file_quality and float(file_quality):
        content.append(f"{i18n_file_quality}: {file_quality}")
    result["content"] = " | ".join(content)
 
    return result
 
 

References searx.engines.zlibrary._text().

Referenced by searx.engines.zlibrary.response().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _text()

str \| None searx.engines.zlibrary._text	(		item,
		str	selector )

protected

Definition at line 133 of file zlibrary.py.

def _text(item, selector: str) -> str | None:
    return extract_text(eval_xpath(item, selector))

Referenced by searx.engines.zlibrary._parse_result().

Here is the caller graph for this function:

◆ domain_is_seized()

searx.engines.zlibrary.domain_is_seized ( dom )

Definition at line 116 of file zlibrary.py.

def domain_is_seized(dom):
    return bool(dom.xpath('//title') and "seized" in dom.xpath('//title')[0].text.lower())

Referenced by searx.engines.zlibrary.fetch_traits(), and searx.engines.zlibrary.response().

Here is the caller graph for this function:

◆ fetch_traits()

None searx.engines.zlibrary.fetch_traits ( EngineTraits engine_traits )

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

Definition at line 178 of file zlibrary.py.

def fetch_traits(engine_traits: EngineTraits) -> None:
    """Fetch languages and other search arguments from zlibrary's search form."""
    # pylint: disable=import-outside-toplevel, too-many-branches
 
    import babel
    from searx.network import get  # see https://github.com/searxng/searxng/issues/762
    from searx.locales import language_tag
 
    resp = get(base_url, verify=False)
    if not resp.ok:  # type: ignore
        raise RuntimeError("Response from zlibrary's search page is not OK.")
    dom = html.fromstring(resp.text)  # type: ignore
 
    if domain_is_seized(dom):
        print(f"ERROR: zlibrary domain is seized: {base_url}")
        # don't change anything, re-use the existing values
        engine_traits.all_locale = ENGINE_TRAITS["z-library"]["all_locale"]
        engine_traits.custom = ENGINE_TRAITS["z-library"]["custom"]
        engine_traits.languages = ENGINE_TRAITS["z-library"]["languages"]
        return
 
    engine_traits.all_locale = ""
    engine_traits.custom["ext"] = []
    engine_traits.custom["year_from"] = []
    engine_traits.custom["year_to"] = []
 
    for year in eval_xpath_list(dom, "//div[@id='advSearch-noJS']//select[@id='sf_yearFrom']/option"):
        engine_traits.custom["year_from"].append(year.get("value"))
 
    for year in eval_xpath_list(dom, "//div[@id='advSearch-noJS']//select[@id='sf_yearTo']/option"):
        engine_traits.custom["year_to"].append(year.get("value"))
 
    for ext in eval_xpath_list(dom, "//div[@id='advSearch-noJS']//select[@id='sf_extensions']/option"):
        value: Optional[str] = ext.get("value")
        if value is None:
            value = ""
        engine_traits.custom["ext"].append(value)
 
    # Handle languages
    # Z-library uses English names for languages, so we need to map them to their respective locales
    language_name_locale_map: Dict[str, babel.Locale] = {}
    for locale in babel.core.localedata.locale_identifiers():  # type: ignore
        # Create a Locale object for the current locale
        loc = babel.Locale.parse(locale)
        if loc.english_name is None:
            continue
        language_name_locale_map[loc.english_name.lower()] = loc  # type: ignore
 
    for x in eval_xpath_list(dom, "//div[@id='advSearch-noJS']//select[@id='sf_languages']/option"):
        eng_lang = x.get("value")
        if eng_lang is None:
            continue
        try:
            locale = language_name_locale_map[eng_lang.lower()]
        except KeyError:
            # silently ignore unknown languages
            # print("ERROR: %s is unknown by babel" % (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

References searx.engines.zlibrary.domain_is_seized().

Here is the call graph for this function:

◆ init()

None searx.engines.zlibrary.init ( engine_settings = None )

Check of engine's settings.

Definition at line 82 of file zlibrary.py.

def init(engine_settings=None) -> None:  # pylint: disable=unused-argument
    """Check of engine's settings."""
    traits: EngineTraits = EngineTraits(**ENGINE_TRAITS["z-library"])
 
    if zlib_ext and zlib_ext not in traits.custom["ext"]:
        raise ValueError(f"invalid setting ext: {zlib_ext}")
    if zlib_year_from and zlib_year_from not in traits.custom["year_from"]:
        raise ValueError(f"invalid setting year_from: {zlib_year_from}")
    if zlib_year_to and zlib_year_to not in traits.custom["year_to"]:
        raise ValueError(f"invalid setting year_to: {zlib_year_to}")
 
 

◆ request()

Dict[str, Any] searx.engines.zlibrary.request	(	str	query,
		Dict[str, Any]	params )

Definition at line 94 of file zlibrary.py.

def request(query: str, params: Dict[str, Any]) -> Dict[str, Any]:
    lang: str = traits.get_language(params["language"], traits.all_locale)  # type: ignore
    search_url: str = (
        base_url
        + "/s/{search_query}/?page={pageno}"
        + "&yearFrom={zlib_year_from}"
        + "&yearTo={zlib_year_to}"
        + "&languages[]={lang}"
        + "&extensions[]={zlib_ext}"
    )
    params["url"] = search_url.format(
        search_query=quote(query),
        pageno=params["pageno"],
        lang=lang,
        zlib_year_from=zlib_year_from,
        zlib_year_to=zlib_year_to,
        zlib_ext=zlib_ext,
    )
    params["verify"] = False
    return params
 
 

◆ response()

List[Dict[str, Any]] searx.engines.zlibrary.response ( httpx.Response resp )

Definition at line 120 of file zlibrary.py.

def response(resp: httpx.Response) -> List[Dict[str, Any]]:
    results: List[Dict[str, Any]] = []
    dom = html.fromstring(resp.text)
 
    if domain_is_seized(dom):
        raise SearxException(f"zlibrary domain is seized: {base_url}")
 
    for item in dom.xpath('//div[@id="searchResultBox"]//div[contains(@class, "resItemBox")]'):
        results.append(_parse_result(item))
 
    return results
 
 

References searx.engines.zlibrary._parse_result(), and searx.engines.zlibrary.domain_is_seized().

Here is the call graph for this function:

Variable Documentation

◆ about

dict searx.engines.zlibrary.about

Initial value:

=  {
    "website": "https://zlibrary-global.se",
    "wikidata_id": "Q104863992",
    "official_api_documentation": None,
    "use_official_api": False,
    "require_api_key": False,
    "results": "HTML",
}

Definition at line 55 of file zlibrary.py.

◆ base_url

str searx.engines.zlibrary.base_url = "https://zlibrary-global.se"

Definition at line 66 of file zlibrary.py.

◆ categories

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

Definition at line 64 of file zlibrary.py.

◆ i18n_book_rating

searx.engines.zlibrary.i18n_book_rating = gettext("Book rating")

Definition at line 138 of file zlibrary.py.

◆ i18n_file_quality

searx.engines.zlibrary.i18n_file_quality = gettext("File quality")

Definition at line 139 of file zlibrary.py.

◆ i18n_language

searx.engines.zlibrary.i18n_language = gettext("Language")

Definition at line 137 of file zlibrary.py.

◆ logger

logging searx.engines.zlibrary.logger .Logger

Definition at line 52 of file zlibrary.py.

◆ paging

bool searx.engines.zlibrary.paging = True

Definition at line 65 of file zlibrary.py.

◆ zlib_ext

str searx.engines.zlibrary.zlib_ext = ""

Definition at line 76 of file zlibrary.py.

◆ zlib_year_from

str searx.engines.zlibrary.zlib_year_from = ""

Definition at line 68 of file zlibrary.py.

◆ zlib_year_to

str searx.engines.zlibrary.zlib_year_to = ""

Definition at line 72 of file zlibrary.py.

Functions

Variables

Detailed Description

Function Documentation

◆ _parse_result()

◆ _text()

◆ domain_is_seized()

◆ fetch_traits()

◆ init()

◆ request()

◆ response()

Variable Documentation

◆ about

◆ base_url

◆ categories

◆ i18n_book_rating

◆ i18n_file_quality

◆ i18n_language

◆ logger

◆ paging

◆ zlib_ext

◆ zlib_year_from

◆ zlib_year_to