:tocdepth: 3

:py:mod:`gws.base.search.finder`
================================

.. py:module:: gws.base.search.finder


**Source code:** :source:`gws.base.search.finder<gws/base/search/finder.py>`



Module Contents
---------------



.. py:class:: Config(*args, **kwargs)


   Bases: :py:obj:`gws.ConfigWithAccess`

   Basic config with permissions.

   .. py:attribute:: models
      :type:  Optional[list[gws.ext.config.model]]

      data models for features

   .. py:attribute:: spatialContext
      :type:  Optional[SpatialContext]

      spatial context for keyword searches

   .. py:attribute:: templates
      :type:  Optional[list[gws.ext.config.template]]

      feature formatting templates

   .. py:attribute:: title
      :type:  Optional[str]

      provider title

   .. py:attribute:: withFilter
      :type:  bool
      :value: True


      enable filter search

   .. py:attribute:: withGeometry
      :type:  bool
      :value: True


      enable geometry search

   .. py:attribute:: withKeyword
      :type:  bool
      :value: True


      enable keyword search


.. py:class:: Object


   Bases: :py:obj:`gws.Finder`

   Finder object.

   .. py:attribute:: spatialContext
      :type:  SpatialContext

   .. py:method:: can_run(search, user)

   .. py:method:: configure()

      Configuration hook.


   .. py:method:: configure_models()

   .. py:method:: configure_templates()

   .. py:method:: context_shape(search: gws.SearchQuery) -> gws.Shape

   .. py:method:: run(search, user, layer=None)


.. py:class:: SpatialContext


   Bases: :py:obj:`gws.Enum`

   Enumeration type.

   Despite being declared as extending ``Enum`` (for IDE support), this class is actually just a simple object
   and intended to be used as a collection of attributes. It doesn't provide any ``Enum``-specific utilities.

   The rationale behind this is that we need ``Enum`` members (e.g. ``Color.RED``) to be scalars,
   and not complex objects as in the standard ``Enum``.

   .. py:attribute:: map
      :value: 'map'


      search in the map extent

   .. py:attribute:: view
      :value: 'view'


      search in the client view extent