searx.favicons.resolvers Namespace Reference

Functions
	_req_args (**kwargs)
tuple[None|bytes, None|str]	allesedv (str domain, int timeout)
tuple[None|bytes, None|str]	duckduckgo (str domain, int timeout)
tuple[None|bytes, None|str]	google (str domain, int timeout)
tuple[None|bytes, None|str]	yandex (str domain, int timeout)

Variables
list	__all__ = ["DEFAULT_RESOLVER_MAP", "allesedv", "duckduckgo", "google", "yandex"]
dict	DEFAULT_RESOLVER_MAP [str, Callable]
	logger = logger.getChild('favicons.resolvers')

Detailed Description

Implementations of the favicon *resolvers* that are available in the favicon
proxy by default.  A *resolver* is a function that obtains the favicon from an
external source.  The *resolver* function receives two arguments (``domain,
timeout``) and returns a tuple ``(data, mime)``.

Function Documentation

_req_args()

searx.favicons.resolvers._req_args ( ** kwargs )

protected

Definition at line 20 of file resolvers.py.

def _req_args(**kwargs):
    # add the request arguments from the searx.network
    d = {"raise_for_httperror": False}
    d.update(kwargs)
    return d
 
 

Referenced by allesedv(), duckduckgo(), google(), and yandex().

Here is the caller graph for this function:

allesedv()

tuple[None | bytes, None | str] searx.favicons.resolvers.allesedv	(	str	domain,
		int	timeout )

Favicon Resolver from allesedv.com / https://favicon.allesedv.com/

Definition at line 27 of file resolvers.py.

def allesedv(domain: str, timeout: int) -> tuple[None | bytes, None | str]:
    """Favicon Resolver from allesedv.com / https://favicon.allesedv.com/"""
    data, mime = (None, None)
    url = f"https://f1.allesedv.com/32/{domain}"
    logger.debug("fetch favicon from: %s", url)
 
    # will just return a 200 regardless of the favicon existing or not
    # sometimes will be correct size, sometimes not
    response = network.get(url, **_req_args(timeout=timeout))
    if response and response.status_code == 200:
        mime = response.headers['Content-Type']
        if mime != 'image/gif':
            data = response.content
    return data, mime
 
 

References _req_args().

Here is the call graph for this function:

duckduckgo()

tuple[None | bytes, None | str] searx.favicons.resolvers.duckduckgo	(	str	domain,
		int	timeout )

Favicon Resolver from duckduckgo.com / https://blog.jim-nielsen.com/2021/displaying-favicons-for-any-domain/

Definition at line 43 of file resolvers.py.

def duckduckgo(domain: str, timeout: int) -> tuple[None | bytes, None | str]:
    """Favicon Resolver from duckduckgo.com / https://blog.jim-nielsen.com/2021/displaying-favicons-for-any-domain/"""
    data, mime = (None, None)
    url = f"https://icons.duckduckgo.com/ip2/{domain}.ico"
    logger.debug("fetch favicon from: %s", url)
 
    # will return a 404 if the favicon does not exist and a 200 if it does,
    response = network.get(url, **_req_args(timeout=timeout))
    if response and response.status_code == 200:
        # api will respond with a 32x32 png image
        mime = response.headers['Content-Type']
        data = response.content
    return data, mime
 
 

References _req_args().

Here is the call graph for this function:

google()

tuple[None | bytes, None | str] searx.favicons.resolvers.google	(	str	domain,
		int	timeout )

Favicon Resolver from google.com

Definition at line 58 of file resolvers.py.

def google(domain: str, timeout: int) -> tuple[None | bytes, None | str]:
    """Favicon Resolver from google.com"""
    data, mime = (None, None)
 
    # URL https://www.google.com/s2/favicons?sz=32&domain={domain}" will be
    # redirected (HTTP 301 Moved Permanently) to t1.gstatic.com/faviconV2:
    url = (
        f"https://t1.gstatic.com/faviconV2?client=SOCIAL&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
        f"&url=https://{domain}&size=32"
    )
    logger.debug("fetch favicon from: %s", url)
 
    # will return a 404 if the favicon does not exist and a 200 if it does,
    response = network.get(url, **_req_args(timeout=timeout))
    if response and response.status_code == 200:
        # api will respond with a 32x32 png image
        mime = response.headers['Content-Type']
        data = response.content
    return data, mime
 
 

References _req_args().

Here is the call graph for this function:

yandex()

tuple[None | bytes, None | str] searx.favicons.resolvers.yandex	(	str	domain,
		int	timeout )

Favicon Resolver from yandex.com

Definition at line 79 of file resolvers.py.

def yandex(domain: str, timeout: int) -> tuple[None | bytes, None | str]:
    """Favicon Resolver from yandex.com"""
    data, mime = (None, None)
    url = f"https://favicon.yandex.net/favicon/{domain}"
    logger.debug("fetch favicon from: %s", url)
 
    # api will respond with a 16x16 png image, if it doesn't exist, it will be a
    # 1x1 png image (70 bytes)
    response = network.get(url, **_req_args(timeout=timeout))
    if response and response.status_code == 200 and len(response.content) > 70:
        mime = response.headers['Content-Type']
        data = response.content
    return data, mime
 
 

References _req_args().

Here is the call graph for this function:

Variable Documentation

__all__

list searx.favicons.resolvers.__all__ = ["DEFAULT_RESOLVER_MAP", "allesedv", "duckduckgo", "google", "yandex"]

private

Definition at line 10 of file resolvers.py.

DEFAULT_RESOLVER_MAP

dict searx.favicons.resolvers.DEFAULT_RESOLVER_MAP [str, Callable]

Definition at line 16 of file resolvers.py.

logger

searx.favicons.resolvers.logger = logger.getChild('favicons.resolvers')

Definition at line 17 of file resolvers.py.