Inheritance diagram for searx.enginelib.traits.EngineTraits:

Public Member Functions
	get_language (self, str searxng_locale, t.Any default=None)
t.Any	get_region (self, str searxng_locale, t.Any default=None)
bool	is_locale_supported (self, str searxng_locale)
	copy (self)
"EngineTraits \| None"	fetch_traits (cls, "Engine \| types.ModuleType" engine)
	set_traits (self, "Engine \| types.ModuleType" engine)

Static Public Attributes
dict	regions = dataclasses.field(default_factory=dict)
dict	languages = dataclasses.field(default_factory=dict)
str	all_locale = None
t	data_type = 'traits_v1'
dict	custom = dataclasses.field(default_factory=dict)

Protected Member Functions
	_set_traits_v1 (self, "Engine \| types.ModuleType" engine)

Detailed Description

The class is intended to be instantiated for each engine.

Definition at line 38 of file traits.py.

Member Function Documentation

◆ _set_traits_v1()

searx.enginelib.traits.EngineTraits._set_traits_v1	(		self,
		"Engine \| types.ModuleType"	engine )

protected

Definition at line 163 of file traits.py.

    def _set_traits_v1(self, engine: "Engine | types.ModuleType"):
        # For an engine, when there is `language: ...` in the YAML settings the engine
        # does support only this one language (region)::
        #
        #   - name: google italian
        #     engine: google
        #     language: it
        #     region: it-IT
 
        traits = self.copy()
 
        _msg = "settings.yml - engine: '%s' / %s: '%s' not supported"
 
        languages = traits.languages
        if hasattr(engine, 'language'):
            if engine.language not in languages:
                raise ValueError(_msg % (engine.name, 'language', engine.language))
            traits.languages = {engine.language: languages[engine.language]}
 
        regions = traits.regions
        if hasattr(engine, 'region'):
            if engine.region not in regions:
                raise ValueError(_msg % (engine.name, 'region', engine.region))
            traits.regions = {engine.region: regions[engine.region]}
 
        engine.language_support = bool(traits.languages or traits.regions)  # type: ignore
 
        # set the copied & modified traits in engine's namespace
        engine.traits = traits  # pyright: ignore[reportAttributeAccessIssue]
 
 

References copy().

Referenced by set_traits().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copy()

searx.enginelib.traits.EngineTraits.copy ( self )

Create a copy of the dataclass object.

Definition at line 133 of file traits.py.

    def copy(self):
        """Create a copy of the dataclass object."""
        return EngineTraits(**dataclasses.asdict(self))  # type: ignore
 

Referenced by _set_traits_v1().

Here is the caller graph for this function:

◆ fetch_traits()

"EngineTraits \| None" searx.enginelib.traits.EngineTraits.fetch_traits	(		cls,
		"Engine \| types.ModuleType"	engine )

Call a function ``fetch_traits(engine_traits)`` from engines namespace to fetch
and set properties from the origin engine in the object ``engine_traits``.  If
function does not exists, ``None`` is returned.

Reimplemented in searx.enginelib.traits.EngineTraitsMap.

Definition at line 138 of file traits.py.

    def fetch_traits(cls, engine: "Engine | types.ModuleType") -> "EngineTraits | None":
        """Call a function ``fetch_traits(engine_traits)`` from engines namespace to fetch
        and set properties from the origin engine in the object ``engine_traits``.  If
        function does not exists, ``None`` is returned.
        """
 
        fetch_traits = getattr(engine, 'fetch_traits', None)
        engine_traits = None
 
        if fetch_traits:
            engine_traits = cls()
            fetch_traits(engine_traits)
        return engine_traits
 

References fetch_traits().

Referenced by fetch_traits().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_language()

searx.enginelib.traits.EngineTraits.get_language	(		self,
		str	searxng_locale,
		t.Any	default = None )

Return engine's language string that *best fits* to SearXNG's locale.

:param searxng_locale: SearXNG's internal representation of locale
  selected by the user.

:param default: engine's default language

The *best fits* rules are implemented in
:py:obj:`searx.locales.get_engine_locale`.  Except for the special value ``all``
which is determined from :py:obj:`EngineTraits.all_locale`.

Definition at line 88 of file traits.py.

    def get_language(self, searxng_locale: str, default: t.Any = None):
        """Return engine's language string that *best fits* to SearXNG's locale.
 
        :param searxng_locale: SearXNG's internal representation of locale
          selected by the user.
 
        :param default: engine's default language
 
        The *best fits* rules are implemented in
        :py:obj:`searx.locales.get_engine_locale`.  Except for the special value ``all``
        which is determined from :py:obj:`EngineTraits.all_locale`.
        """
        if searxng_locale == 'all' and self.all_locale is not None:
            return self.all_locale
        return locales.get_engine_locale(searxng_locale, self.languages, default=default)
 

References all_locale, and languages.

Referenced by is_locale_supported().

Here is the caller graph for this function:

◆ get_region()

t.Any searx.enginelib.traits.EngineTraits.get_region	(		self,
		str	searxng_locale,
		t.Any	default = None )

Return engine's region string that best fits to SearXNG's locale.

:param searxng_locale: SearXNG's internal representation of locale
  selected by the user.

:param default: engine's default region

The *best fits* rules are implemented in
:py:obj:`searx.locales.get_engine_locale`.  Except for the special value ``all``
which is determined from :py:obj:`EngineTraits.all_locale`.

Definition at line 104 of file traits.py.

    def get_region(self, searxng_locale: str, default: t.Any = None) -> t.Any:
        """Return engine's region string that best fits to SearXNG's locale.
 
        :param searxng_locale: SearXNG's internal representation of locale
          selected by the user.
 
        :param default: engine's default region
 
        The *best fits* rules are implemented in
        :py:obj:`searx.locales.get_engine_locale`.  Except for the special value ``all``
        which is determined from :py:obj:`EngineTraits.all_locale`.
        """
        if searxng_locale == 'all' and self.all_locale is not None:
            return self.all_locale
        return locales.get_engine_locale(searxng_locale, self.regions, default=default)
 

References all_locale, and regions.

Referenced by is_locale_supported().

Here is the caller graph for this function:

◆ is_locale_supported()

bool searx.enginelib.traits.EngineTraits.is_locale_supported	(		self,
		str	searxng_locale )

A *locale* (SearXNG's internal representation) is considered to be
supported by the engine if the *region* or the *language* is supported
by the engine.

For verification the functions :py:func:`EngineTraits.get_region` and
:py:func:`EngineTraits.get_language` are used.

Definition at line 120 of file traits.py.

    def is_locale_supported(self, searxng_locale: str) -> bool:
        """A *locale* (SearXNG's internal representation) is considered to be
        supported by the engine if the *region* or the *language* is supported
        by the engine.
 
        For verification the functions :py:func:`EngineTraits.get_region` and
        :py:func:`EngineTraits.get_language` are used.
        """
        if self.data_type == 'traits_v1':
            return bool(self.get_region(searxng_locale) or self.get_language(searxng_locale))
 
        raise TypeError('engine traits of type %s is unknown' % self.data_type)
 

References data_type, get_language(), and get_region().

Here is the call graph for this function:

◆ set_traits()

searx.enginelib.traits.EngineTraits.set_traits	(		self,
		"Engine \| types.ModuleType"	engine )

Set traits from self object in a :py:obj:`.Engine` namespace.

:param engine: engine instance build by :py:func:`searx.engines.load_engine`

Reimplemented in searx.enginelib.traits.EngineTraitsMap.

Definition at line 152 of file traits.py.

    def set_traits(self, engine: "Engine | types.ModuleType"):
        """Set traits from self object in a :py:obj:`.Engine` namespace.
 
        :param engine: engine instance build by :py:func:`searx.engines.load_engine`
        """
 
        if self.data_type == 'traits_v1':
            self._set_traits_v1(engine)
        else:
            raise TypeError('engine traits of type %s is unknown' % self.data_type)
 

References _set_traits_v1(), and data_type.

Here is the call graph for this function:

Member Data Documentation

◆ all_locale

str searx.enginelib.traits.EngineTraits.all_locale = None

static

Definition at line 75 of file traits.py.

Referenced by get_language(), and get_region().

◆ custom

dict searx.enginelib.traits.EngineTraits.custom = dataclasses.field(default_factory=dict)

static

Definition at line 84 of file traits.py.

◆ data_type

searx.enginelib.traits.EngineTraits.data_type = 'traits_v1'

static

Definition at line 80 of file traits.py.

Referenced by is_locale_supported(), and set_traits().

◆ languages

searx.enginelib.traits.EngineTraits.languages = dataclasses.field(default_factory=dict)

static

Definition at line 58 of file traits.py.

Referenced by searx.search.checker.impl.ResultContainerTests._add_language(), searx.search.checker.impl.TestResults.add_language(), and get_language().

◆ regions

searx.enginelib.traits.EngineTraits.regions = dataclasses.field(default_factory=dict)

static

Definition at line 41 of file traits.py.

Referenced by get_region().

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

/home/andrew/Documents/code/public/searxng/searx/enginelib/traits.py

Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

Member Function Documentation

◆ _set_traits_v1()

◆ copy()

◆ fetch_traits()

◆ get_language()

◆ get_region()

◆ is_locale_supported()

◆ set_traits()

Member Data Documentation

◆ all_locale

◆ custom

◆ data_type

◆ languages

◆ regions