NTab仓库
fjmwkj
/
searxng
mirror of https://github.com/searxng/searxng
1
0
Fork 0
Files Issues 0 Wiki
Tree: e7569a92e4
Branches Tags
searxng
/
_modules
/
searx
/
weather.html

weather.html 90 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745 
  1. <!DOCTYPE html>
    2. 

  2. 

  3. <html lang="en" data-content_root="../../">
    4. 

  4.   <head>
    5. 

  5.     <meta charset="utf-8" />
    6. 

  6.     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    7. 

  7.   <meta name="viewport" content="width=device-width, initial-scale=1">
    8. 

  8.     <title>searx.weather &#8212; SearXNG Documentation (2025.6.1+d63bdcd77)</title>
    9. 

  9.     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=6625fa76" />
    10. 

  10.     <link rel="stylesheet" type="text/css" href="../../_static/searxng.css?v=52e4ff28" />
    11. 

  11.     <script src="../../_static/documentation_options.js?v=7f7d2b46"></script>
    12. 

  12.     <script src="../../_static/doctools.js?v=9a2dae69"></script>
    13. 

  13.     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
    14. 

  14.     <script data-project="searxng" data-version="2025.6.1+d63bdcd77" src="../../_static/describe_version.js?v=fa7f30d0"></script>
    15. 

  15.     <link rel="index" title="Index" href="../../genindex.html" />
    16. 

  16.     <link rel="search" title="Search" href="../../search.html" /> 
    17. 

  17.   </head><body>
    18. 

  18.     <div class="related" role="navigation" aria-label="Related">
    19. 

  19.       <h3>Navigation</h3>
    20. 

  20.       <ul>
    21. 

  21.         <li class="right" style="margin-right: 10px">
    22. 

  22.           <a href="../../genindex.html" title="General Index"
    23. 

  23.              accesskey="I">index</a></li>
    24. 

  24.         <li class="right" >
    25. 

  25.           <a href="../../py-modindex.html" title="Python Module Index"
    26. 

  26.              >modules</a> |</li>
    27. 

  27.         <li class="nav-item nav-item-0"><a href="../../index.html">SearXNG Documentation (2025.6.1+d63bdcd77)</a> &#187;</li>
    28. 

  28.           <li class="nav-item nav-item-1"><a href="../index.html" accesskey="U">Module code</a> &#187;</li>
    29. 

  29.         <li class="nav-item nav-item-this"><a href="">searx.weather</a></li> 
    30. 

  30.       </ul>
    31. 

  31.     </div>  
    32. 

  32. 

  33.     <div class="document">
    34. 

  34.       <div class="documentwrapper">
    35. 

  35.         <div class="bodywrapper">
    36. 

  36.           <div class="body" role="main">
    37. 

  37.             
    38. 

  38.   <h1>Source code for searx.weather</h1><div class="highlight"><pre>
    39. 

  39. <span></span><span class="c1"># SPDX-License-Identifier: AGPL-3.0-or-later</span>
    40. 

  40. <span class="sd">&quot;&quot;&quot;Implementations used for weather conditions and forecast.&quot;&quot;&quot;</span>
    41. 

  41. <span class="c1"># pylint: disable=too-few-public-methods</span>
    42. 

  42. <span class="kn">from</span><span class="w"> </span><span class="nn">__future__</span><span class="w"> </span><span class="kn">import</span> <span class="n">annotations</span>
    43. 

  43. 

  44. <span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
    45. 

  45.     <span class="s2">&quot;symbol_url&quot;</span><span class="p">,</span>
    46. 

  46.     <span class="s2">&quot;Temperature&quot;</span><span class="p">,</span>
    47. 

  47.     <span class="s2">&quot;Pressure&quot;</span><span class="p">,</span>
    48. 

  48.     <span class="s2">&quot;WindSpeed&quot;</span><span class="p">,</span>
    49. 

  49.     <span class="s2">&quot;RelativeHumidity&quot;</span><span class="p">,</span>
    50. 

  50.     <span class="s2">&quot;Compass&quot;</span><span class="p">,</span>
    51. 

  51.     <span class="s2">&quot;WeatherConditionType&quot;</span><span class="p">,</span>
    52. 

  52.     <span class="s2">&quot;DateTime&quot;</span><span class="p">,</span>
    53. 

  53.     <span class="s2">&quot;GeoLocation&quot;</span><span class="p">,</span>
    54. 

  54. <span class="p">]</span>
    55. 

  55. 

  56. <span class="kn">import</span><span class="w"> </span><span class="nn">typing</span>
    57. 

  57. 

  58. <span class="kn">import</span><span class="w"> </span><span class="nn">base64</span>
    59. 

  59. <span class="kn">import</span><span class="w"> </span><span class="nn">datetime</span>
    60. 

  60. <span class="kn">import</span><span class="w"> </span><span class="nn">dataclasses</span>
    61. 

  61. 

  62. <span class="kn">from</span><span class="w"> </span><span class="nn">urllib.parse</span><span class="w"> </span><span class="kn">import</span> <span class="n">quote_plus</span>
    63. 

  63. 

  64. <span class="kn">import</span><span class="w"> </span><span class="nn">babel</span>
    65. 

  65. <span class="kn">import</span><span class="w"> </span><span class="nn">babel.numbers</span>
    66. 

  66. <span class="kn">import</span><span class="w"> </span><span class="nn">babel.dates</span>
    67. 

  67. <span class="kn">import</span><span class="w"> </span><span class="nn">babel.languages</span>
    68. 

  68. 

  69. <span class="kn">from</span><span class="w"> </span><span class="nn">searx</span><span class="w"> </span><span class="kn">import</span> <span class="n">network</span>
    70. 

  70. <span class="kn">from</span><span class="w"> </span><span class="nn">searx.cache</span><span class="w"> </span><span class="kn">import</span> <span class="n">ExpireCache</span><span class="p">,</span> <span class="n">ExpireCacheCfg</span>
    71. 

  71. <span class="kn">from</span><span class="w"> </span><span class="nn">searx.extended_types</span><span class="w"> </span><span class="kn">import</span> <span class="n">sxng_request</span>
    72. 

  72. <span class="kn">from</span><span class="w"> </span><span class="nn">searx.wikidata_units</span><span class="w"> </span><span class="kn">import</span> <span class="n">convert_to_si</span><span class="p">,</span> <span class="n">convert_from_si</span>
    73. 

  73. 

  74. <span class="n">WEATHER_DATA_CACHE</span><span class="p">:</span> <span class="n">ExpireCache</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: ignore</span>
    75. 

  75. <span class="sd">&quot;&quot;&quot;A simple cache for weather data (geo-locations, icons, ..)&quot;&quot;&quot;</span>
    76. 

  76. 

  77. <span class="n">YR_WEATHER_SYMBOL_URL</span> <span class="o">=</span> <span class="s2">&quot;https://raw.githubusercontent.com/nrkno/yr-weather-symbols/refs/heads/master/symbols/outline&quot;</span>
    78. 

  78. 

  79. 

  80. <span class="k">def</span><span class="w"> </span><span class="nf">get_WEATHER_DATA_CACHE</span><span class="p">():</span>
    81. 

  81. 

  82.     <span class="k">global</span> <span class="n">WEATHER_DATA_CACHE</span>  <span class="c1"># pylint: disable=global-statement</span>
    83. 

  83. 

  84.     <span class="k">if</span> <span class="n">WEATHER_DATA_CACHE</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    85. 

  85.         <span class="n">WEATHER_DATA_CACHE</span> <span class="o">=</span> <span class="n">ExpireCache</span><span class="o">.</span><span class="n">build_cache</span><span class="p">(</span>
    86. 

  86.             <span class="n">ExpireCacheCfg</span><span class="p">(</span>
    87. 

  87.                 <span class="n">name</span><span class="o">=</span><span class="s2">&quot;WEATHER_DATA_CACHE&quot;</span><span class="p">,</span>
    88. 

  88.                 <span class="n">MAX_VALUE_LEN</span><span class="o">=</span><span class="mi">1024</span> <span class="o">*</span> <span class="mi">200</span><span class="p">,</span>  <span class="c1"># max. 200kB per icon (icons have most often 10-20kB)</span>
    89. 

  89.                 <span class="n">MAXHOLD_TIME</span><span class="o">=</span><span class="mi">60</span> <span class="o">*</span> <span class="mi">60</span> <span class="o">*</span> <span class="mi">24</span> <span class="o">*</span> <span class="mi">7</span> <span class="o">*</span> <span class="mi">4</span><span class="p">,</span>  <span class="c1"># 4 weeks</span>
    90. 

  90.             <span class="p">)</span>
    91. 

  91.         <span class="p">)</span>
    92. 

  92.     <span class="k">return</span> <span class="n">WEATHER_DATA_CACHE</span>
    93. 

  93. 

  94. 

  95. <span class="k">def</span><span class="w"> </span><span class="nf">_get_sxng_locale_tag</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    96. 

  96.     <span class="c1"># The function should return a locale (the sxng-tag: de-DE.en-US, ..) that</span>
    97. 

  97.     <span class="c1"># can later be used to format and convert measured values for the output of</span>
    98. 

  98.     <span class="c1"># weather data to the user.</span>
    99. 

  99.     <span class="c1">#</span>
    100. 

  100.     <span class="c1"># In principle, SearXNG only has two possible parameters for determining</span>
    101. 

  101.     <span class="c1"># the locale: the UI language or the search- language/region.  Since the</span>
    102. 

  102.     <span class="c1"># conversion of weather data and time information is usually</span>
    103. 

  103.     <span class="c1"># region-specific, the UI language is not suitable.</span>
    104. 

  104.     <span class="c1">#</span>
    105. 

  105.     <span class="c1"># It would probably be ideal to use the user&#39;s geolocation, but this will</span>
    106. 

  106.     <span class="c1"># probably never be available in SearXNG (privacy critical).</span>
    107. 

  107.     <span class="c1">#</span>
    108. 

  108.     <span class="c1"># Therefore, as long as no &quot;better&quot; parameters are available, this function</span>
    109. 

  109.     <span class="c1"># returns a locale based on the search region.</span>
    110. 

  110. 

  111.     <span class="c1"># pylint: disable=import-outside-toplevel,disable=cyclic-import</span>
    112. 

  112.     <span class="kn">from</span><span class="w"> </span><span class="nn">searx</span><span class="w"> </span><span class="kn">import</span> <span class="n">query</span>
    113. 

  113.     <span class="kn">from</span><span class="w"> </span><span class="nn">searx.preferences</span><span class="w"> </span><span class="kn">import</span> <span class="n">ClientPref</span>
    114. 

  114. 

  115.     <span class="n">query</span> <span class="o">=</span> <span class="n">query</span><span class="o">.</span><span class="n">RawTextQuery</span><span class="p">(</span><span class="n">sxng_request</span><span class="o">.</span><span class="n">form</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;q&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">),</span> <span class="p">[])</span>
    116. 

  116.     <span class="k">if</span> <span class="n">query</span><span class="o">.</span><span class="n">languages</span> <span class="ow">and</span> <span class="n">query</span><span class="o">.</span><span class="n">languages</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;all&quot;</span><span class="p">,</span> <span class="s2">&quot;auto&quot;</span><span class="p">]:</span>
    117. 

  117.         <span class="k">return</span> <span class="n">query</span><span class="o">.</span><span class="n">languages</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
    118. 

  118. 

  119.     <span class="n">search_lang</span> <span class="o">=</span> <span class="n">sxng_request</span><span class="o">.</span><span class="n">form</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;language&quot;</span><span class="p">)</span>
    120. 

  120.     <span class="k">if</span> <span class="n">search_lang</span> <span class="ow">and</span> <span class="n">search_lang</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;all&quot;</span><span class="p">,</span> <span class="s2">&quot;auto&quot;</span><span class="p">]:</span>
    121. 

  121.         <span class="k">return</span> <span class="n">search_lang</span>
    122. 

  122. 

  123.     <span class="n">client_pref</span> <span class="o">=</span> <span class="n">ClientPref</span><span class="o">.</span><span class="n">from_http_request</span><span class="p">(</span><span class="n">sxng_request</span><span class="p">)</span>
    124. 

  124.     <span class="n">search_lang</span> <span class="o">=</span> <span class="n">client_pref</span><span class="o">.</span><span class="n">locale_tag</span>
    125. 

  125.     <span class="k">if</span> <span class="n">search_lang</span> <span class="ow">and</span> <span class="n">search_lang</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;all&quot;</span><span class="p">,</span> <span class="s2">&quot;auto&quot;</span><span class="p">]:</span>
    126. 

  126.         <span class="k">return</span> <span class="n">search_lang</span>
    127. 

  127.     <span class="k">return</span> <span class="s2">&quot;en&quot;</span>
    128. 

  128. 

  129. 

  130. <div class="viewcode-block" id="symbol_url">
    131. 

  131. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.symbol_url">[docs]</a>
    132. 

  132. <span class="k">def</span><span class="w"> </span><span class="nf">symbol_url</span><span class="p">(</span><span class="n">condition</span><span class="p">:</span> <span class="n">WeatherConditionType</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
    133. 

  133. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Returns ``data:`` URL for the weather condition symbol or ``None`` if</span>
    134. 

  134. <span class="sd">    the condition is not of type :py:obj:`WeatherConditionType`.</span>
    135. 

  135. 

  136. <span class="sd">    If symbol (SVG) is not already in the :py:obj:`WEATHER_DATA_CACHE` its</span>
    137. 

  137. <span class="sd">    fetched from https://github.com/nrkno/yr-weather-symbols</span>
    138. 

  138. <span class="sd">    &quot;&quot;&quot;</span>
    139. 

  139.     <span class="c1"># Symbols for darkmode/lightmode? .. and day/night symbols? .. for the</span>
    140. 

  140.     <span class="c1"># latter we need a geopoint (critical in sense of privacy)</span>
    141. 

  141. 

  142.     <span class="n">fname</span> <span class="o">=</span> <span class="n">YR_WEATHER_SYMBOL_MAP</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">condition</span><span class="p">)</span>
    143. 

  143.     <span class="k">if</span> <span class="n">fname</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    144. 

  144.         <span class="k">return</span> <span class="kc">None</span>
    145. 

  145. 

  146.     <span class="n">ctx</span> <span class="o">=</span> <span class="s2">&quot;weather_symbol_url&quot;</span>
    147. 

  147.     <span class="n">cache</span> <span class="o">=</span> <span class="n">get_WEATHER_DATA_CACHE</span><span class="p">()</span>
    148. 

  148.     <span class="n">origin_url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">YR_WEATHER_SYMBOL_URL</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">fname</span><span class="si">}</span><span class="s2">.svg&quot;</span>
    149. 

  149. 

  150.     <span class="n">data_url</span> <span class="o">=</span> <span class="n">cache</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">origin_url</span><span class="p">,</span> <span class="n">ctx</span><span class="o">=</span><span class="n">ctx</span><span class="p">)</span>
    151. 

  151.     <span class="k">if</span> <span class="n">data_url</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
    152. 

  152.         <span class="k">return</span> <span class="n">data_url</span>
    153. 

  153. 

  154.     <span class="n">response</span> <span class="o">=</span> <span class="n">network</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">origin_url</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span>
    155. 

  155.     <span class="k">if</span> <span class="n">response</span><span class="o">.</span><span class="n">status_code</span> <span class="o">==</span> <span class="mi">200</span><span class="p">:</span>
    156. 

  156.         <span class="n">mimetype</span> <span class="o">=</span> <span class="n">response</span><span class="o">.</span><span class="n">headers</span><span class="p">[</span><span class="s1">&#39;Content-Type&#39;</span><span class="p">]</span>
    157. 

  157.         <span class="n">data_url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;data:</span><span class="si">{</span><span class="n">mimetype</span><span class="si">}</span><span class="s2">;base64,</span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">base64</span><span class="o">.</span><span class="n">b64encode</span><span class="p">(</span><span class="n">response</span><span class="o">.</span><span class="n">content</span><span class="p">),</span><span class="w"> </span><span class="s1">&#39;utf-8&#39;</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span>
    158. 

  158.         <span class="n">cache</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="n">origin_url</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="n">data_url</span><span class="p">,</span> <span class="n">expire</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">ctx</span><span class="o">=</span><span class="n">ctx</span><span class="p">)</span>
    159. 

  159.     <span class="k">return</span> <span class="n">data_url</span></div>
    160. 

  160. 

  161. 

  162. 

  163. <div class="viewcode-block" id="GeoLocation">
    164. 

  164. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.GeoLocation">[docs]</a>
    165. 

  165. <span class="nd">@dataclasses</span><span class="o">.</span><span class="n">dataclass</span>
    166. 

  166. <span class="k">class</span><span class="w"> </span><span class="nc">GeoLocation</span><span class="p">:</span>
    167. 

  167. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Minimal implementation of Geocoding.&quot;&quot;&quot;</span>
    168. 

  168. 

  169.     <span class="c1"># The type definition was based on the properties from the geocoding API of</span>
    170. 

  170.     <span class="c1"># open-meteo.</span>
    171. 

  171.     <span class="c1">#</span>
    172. 

  172.     <span class="c1"># - https://open-meteo.com/en/docs/geocoding-api</span>
    173. 

  173.     <span class="c1"># - https://en.wikipedia.org/wiki/List_of_tz_database_time_zones</span>
    174. 

  174.     <span class="c1"># - https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2</span>
    175. 

  175. 

  176.     <span class="n">name</span><span class="p">:</span> <span class="nb">str</span>
    177. 

  177.     <span class="n">latitude</span><span class="p">:</span> <span class="nb">float</span>  <span class="c1"># Geographical WGS84 coordinates of this location</span>
    178. 

  178.     <span class="n">longitude</span><span class="p">:</span> <span class="nb">float</span>
    179. 

  179.     <span class="n">elevation</span><span class="p">:</span> <span class="nb">float</span>  <span class="c1"># Elevation above mean sea level of this location</span>
    180. 

  180.     <span class="n">country_code</span><span class="p">:</span> <span class="nb">str</span>  <span class="c1"># 2-Character ISO-3166-1 alpha2 country code. E.g. DE for Germany</span>
    181. 

  181.     <span class="n">timezone</span><span class="p">:</span> <span class="nb">str</span>  <span class="c1"># Time zone using time zone database definitions</span>
    182. 

  182. 

  183.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    184. 

  184.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span>
    185. 

  185. 

  186.     <span class="k">def</span><span class="w"> </span><span class="nf">locale</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="p">:</span>
    187. 

  187. 

  188.         <span class="c1"># by region of the search language</span>
    189. 

  189.         <span class="n">sxng_tag</span> <span class="o">=</span> <span class="n">_get_sxng_locale_tag</span><span class="p">()</span>
    190. 

  190.         <span class="k">if</span> <span class="s2">&quot;-&quot;</span> <span class="ow">in</span> <span class="n">sxng_tag</span><span class="p">:</span>
    191. 

  191.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    192. 

  192.             <span class="k">return</span> <span class="n">locale</span>
    193. 

  193. 

  194.         <span class="c1"># by most popular language in the region (country code)</span>
    195. 

  195.         <span class="k">for</span> <span class="n">lang</span> <span class="ow">in</span> <span class="n">babel</span><span class="o">.</span><span class="n">languages</span><span class="o">.</span><span class="n">get_official_languages</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">country_code</span><span class="p">):</span>
    196. 

  196.             <span class="k">try</span><span class="p">:</span>
    197. 

  197.                 <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">lang</span><span class="si">}</span><span class="s2">_</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">country_code</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
    198. 

  198.                 <span class="k">return</span> <span class="n">locale</span>
    199. 

  199.             <span class="k">except</span> <span class="n">babel</span><span class="o">.</span><span class="n">UnknownLocaleError</span><span class="p">:</span>
    200. 

  200.                 <span class="k">continue</span>
    201. 

  201. 

  202.         <span class="c1"># No locale could be determined.  This does not actually occur, but if</span>
    203. 

  203.         <span class="c1"># it does, the English language is used by default.  But not region US.</span>
    204. 

  204.         <span class="c1"># US has some units that are only used in US but not in the rest of the</span>
    205. 

  205.         <span class="c1"># world (e.g. °F instead of °C)</span>
    206. 

  206.         <span class="k">return</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="p">(</span><span class="s2">&quot;en&quot;</span><span class="p">,</span> <span class="n">territory</span><span class="o">=</span><span class="s2">&quot;DE&quot;</span><span class="p">)</span>
    207. 

  207. 

  208. <div class="viewcode-block" id="GeoLocation.by_query">
    209. 

  209. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.GeoLocation.by_query">[docs]</a>
    210. 

  210.     <span class="nd">@classmethod</span>
    211. 

  211.     <span class="k">def</span><span class="w"> </span><span class="nf">by_query</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">GeoLocation</span><span class="p">:</span>
    212. 

  212. <span class="w">        </span><span class="sd">&quot;&quot;&quot;Factory method to get a GeoLocation object by a search term.  If no</span>
    213. 

  213. <span class="sd">        location can be determined for the search term, a :py:obj:`ValueError`</span>
    214. 

  214. <span class="sd">        is thrown.</span>
    215. 

  215. <span class="sd">        &quot;&quot;&quot;</span>
    216. 

  216. 

  217.         <span class="n">ctx</span> <span class="o">=</span> <span class="s2">&quot;weather_geolocation_by_query&quot;</span>
    218. 

  218.         <span class="n">cache</span> <span class="o">=</span> <span class="n">get_WEATHER_DATA_CACHE</span><span class="p">()</span>
    219. 

  219.         <span class="n">geo_props</span> <span class="o">=</span> <span class="n">cache</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">search_term</span><span class="p">,</span> <span class="n">ctx</span><span class="o">=</span><span class="n">ctx</span><span class="p">)</span>
    220. 

  220. 

  221.         <span class="k">if</span> <span class="ow">not</span> <span class="n">geo_props</span><span class="p">:</span>
    222. 

  222.             <span class="n">geo_props</span> <span class="o">=</span> <span class="bp">cls</span><span class="o">.</span><span class="n">_query_open_meteo</span><span class="p">(</span><span class="n">search_term</span><span class="o">=</span><span class="n">search_term</span><span class="p">)</span>
    223. 

  223.             <span class="n">cache</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="n">search_term</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="n">geo_props</span><span class="p">,</span> <span class="n">expire</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">ctx</span><span class="o">=</span><span class="n">ctx</span><span class="p">)</span>
    224. 

  224. 

  225.         <span class="k">return</span> <span class="bp">cls</span><span class="p">(</span><span class="o">**</span><span class="n">geo_props</span><span class="p">)</span></div>
    226. 

  226. 

  227. 

  228.     <span class="nd">@classmethod</span>
    229. 

  229.     <span class="k">def</span><span class="w"> </span><span class="nf">_query_open_meteo</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">search_term</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
    230. 

  230.         <span class="n">url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;https://geocoding-api.open-meteo.com/v1/search?name=</span><span class="si">{</span><span class="n">quote_plus</span><span class="p">(</span><span class="n">search_term</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span>
    231. 

  231.         <span class="n">resp</span> <span class="o">=</span> <span class="n">network</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">url</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span>
    232. 

  232.         <span class="k">if</span> <span class="n">resp</span><span class="o">.</span><span class="n">status_code</span> <span class="o">!=</span> <span class="mi">200</span><span class="p">:</span>
    233. 

  233.             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;unknown geo location: &#39;</span><span class="si">{</span><span class="n">search_term</span><span class="si">}</span><span class="s2">&#39;&quot;</span><span class="p">)</span>
    234. 

  234.         <span class="n">results</span> <span class="o">=</span> <span class="n">resp</span><span class="o">.</span><span class="n">json</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;results&quot;</span><span class="p">)</span>
    235. 

  235.         <span class="k">if</span> <span class="ow">not</span> <span class="n">results</span><span class="p">:</span>
    236. 

  236.             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;unknown geo location: &#39;</span><span class="si">{</span><span class="n">search_term</span><span class="si">}</span><span class="s2">&#39;&quot;</span><span class="p">)</span>
    237. 

  237.         <span class="n">location</span> <span class="o">=</span> <span class="n">results</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
    238. 

  238.         <span class="k">return</span> <span class="p">{</span><span class="n">field</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">location</span><span class="p">[</span><span class="n">field</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> <span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">dataclasses</span><span class="o">.</span><span class="n">fields</span><span class="p">(</span><span class="bp">cls</span><span class="p">)}</span></div>
    239. 

  239. 

  240. 

  241. 

  242. <span class="n">DateTimeFormats</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;full&quot;</span><span class="p">,</span> <span class="s2">&quot;long&quot;</span><span class="p">,</span> <span class="s2">&quot;medium&quot;</span><span class="p">,</span> <span class="s2">&quot;short&quot;</span><span class="p">]</span>
    243. 

  243. 

  244. 

  245. <div class="viewcode-block" id="DateTime">
    246. 

  246. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.DateTime">[docs]</a>
    247. 

  247. <span class="k">class</span><span class="w"> </span><span class="nc">DateTime</span><span class="p">:</span>
    248. 

  248. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Class to represent date &amp; time.  Essentially, it is a wrapper that</span>
    249. 

  249. <span class="sd">    conveniently combines :py:obj:`datetime.datetime` and</span>
    250. 

  250. <span class="sd">    :py:obj:`babel.dates.format_datetime`.  A conversion of time zones is not</span>
    251. 

  251. <span class="sd">    provided (in the current version).</span>
    252. 

  252. <span class="sd">    &quot;&quot;&quot;</span>
    253. 

  253. 

  254.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">time</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="p">):</span>
    255. 

  255.         <span class="bp">self</span><span class="o">.</span><span class="n">datetime</span> <span class="o">=</span> <span class="n">time</span>
    256. 

  256. 

  257.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    258. 

  258.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">l10n</span><span class="p">()</span>
    259. 

  259. 

  260. <div class="viewcode-block" id="DateTime.l10n">
    261. 

  261. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.DateTime.l10n">[docs]</a>
    262. 

  262.     <span class="k">def</span><span class="w"> </span><span class="nf">l10n</span><span class="p">(</span>
    263. 

  263.         <span class="bp">self</span><span class="p">,</span>
    264. 

  264.         <span class="n">fmt</span><span class="p">:</span> <span class="n">DateTimeFormats</span> <span class="o">|</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;medium&quot;</span><span class="p">,</span>
    265. 

  265.         <span class="n">locale</span><span class="p">:</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span> <span class="o">|</span> <span class="n">GeoLocation</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    266. 

  266.     <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    267. 

  267. <span class="w">        </span><span class="sd">&quot;&quot;&quot;Localized representation of date &amp; time.&quot;&quot;&quot;</span>
    268. 

  268.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">locale</span><span class="p">,</span> <span class="n">GeoLocation</span><span class="p">):</span>
    269. 

  269.             <span class="n">locale</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">locale</span><span class="p">()</span>
    270. 

  270.         <span class="k">elif</span> <span class="n">locale</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    271. 

  271.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    272. 

  272.         <span class="k">return</span> <span class="n">babel</span><span class="o">.</span><span class="n">dates</span><span class="o">.</span><span class="n">format_datetime</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">datetime</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">fmt</span><span class="p">,</span> <span class="n">locale</span><span class="o">=</span><span class="n">locale</span><span class="p">)</span></div>
    273. 

  273. </div>
    274. 

  274. 

  275. 

  276. 

  277. <div class="viewcode-block" id="Temperature">
    278. 

  278. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.Temperature">[docs]</a>
    279. 

  279. <span class="k">class</span><span class="w"> </span><span class="nc">Temperature</span><span class="p">:</span>
    280. 

  280. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Class for converting temperature units and for string representation of</span>
    281. 

  281. <span class="sd">    measured values.&quot;&quot;&quot;</span>
    282. 

  282. 

  283.     <span class="n">si_name</span> <span class="o">=</span> <span class="s2">&quot;Q11579&quot;</span>
    284. 

  284. 

  285.     <span class="n">Units</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;°C&quot;</span><span class="p">,</span> <span class="s2">&quot;°F&quot;</span><span class="p">,</span> <span class="s2">&quot;K&quot;</span><span class="p">]</span>
    286. 

  286. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Supported temperature units.&quot;&quot;&quot;</span>
    287. 

  287. 

  288.     <span class="n">units</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">typing</span><span class="o">.</span><span class="n">get_args</span><span class="p">(</span><span class="n">Units</span><span class="p">))</span>
    289. 

  289. 

  290.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">):</span>
    291. 

  291.         <span class="k">if</span> <span class="n">unit</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">:</span>
    292. 

  292.             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;invalid unit: </span><span class="si">{</span><span class="n">unit</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
    293. 

  293.         <span class="bp">self</span><span class="o">.</span><span class="n">si</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="n">convert_to_si</span><span class="p">(</span>  <span class="c1"># pylint: disable=invalid-name</span>
    294. 

  294.             <span class="n">si_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si_name</span><span class="p">,</span>
    295. 

  295.             <span class="n">symbol</span><span class="o">=</span><span class="n">unit</span><span class="p">,</span>
    296. 

  296.             <span class="n">value</span><span class="o">=</span><span class="n">value</span><span class="p">,</span>
    297. 

  297.         <span class="p">)</span>
    298. 

  298. 

  299.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    300. 

  300.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">l10n</span><span class="p">()</span>
    301. 

  301. 

  302.     <span class="k">def</span><span class="w"> </span><span class="nf">value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
    303. 

  303.         <span class="k">return</span> <span class="n">convert_from_si</span><span class="p">(</span><span class="n">si_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si_name</span><span class="p">,</span> <span class="n">symbol</span><span class="o">=</span><span class="n">unit</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si</span><span class="p">)</span>
    304. 

  304. 

  305. <div class="viewcode-block" id="Temperature.l10n">
    306. 

  306. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.Temperature.l10n">[docs]</a>
    307. 

  307.     <span class="k">def</span><span class="w"> </span><span class="nf">l10n</span><span class="p">(</span>
    308. 

  308.         <span class="bp">self</span><span class="p">,</span>
    309. 

  309.         <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    310. 

  310.         <span class="n">locale</span><span class="p">:</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span> <span class="o">|</span> <span class="n">GeoLocation</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    311. 

  311.         <span class="n">template</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{value}</span><span class="s2"> </span><span class="si">{unit}</span><span class="s2">&quot;</span><span class="p">,</span>
    312. 

  312.         <span class="n">num_pattern</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;#,##0&quot;</span><span class="p">,</span>
    313. 

  313.     <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    314. 

  314. <span class="w">        </span><span class="sd">&quot;&quot;&quot;Localized representation of a measured value.</span>
    315. 

  315. 

  316. <span class="sd">        If the ``unit`` is not set, an attempt is made to determine a ``unit``</span>
    317. 

  317. <span class="sd">        matching the territory of the ``locale``.  If the locale is not set, an</span>
    318. 

  318. <span class="sd">        attempt is made to determine it from the HTTP request.</span>
    319. 

  319. 

  320. <span class="sd">        The value is converted into the respective unit before formatting.</span>
    321. 

  321. 

  322. <span class="sd">        The argument ``num_pattern`` is used to determine the string formatting</span>
    323. 

  323. <span class="sd">        of the numerical value:</span>
    324. 

  324. 

  325. <span class="sd">        - https://babel.pocoo.org/en/latest/numbers.html#pattern-syntax</span>
    326. 

  326. <span class="sd">        - https://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns</span>
    327. 

  327. 

  328. <span class="sd">        The argument ``template`` specifies how the **string formatted** value</span>
    329. 

  329. <span class="sd">        and unit are to be arranged.</span>
    330. 

  330. 

  331. <span class="sd">        - `Format Specification Mini-Language</span>
    332. 

  332. <span class="sd">          &lt;https://docs.python.org/3/library/string.html#format-specification-mini-language&gt;`.</span>
    333. 

  333. <span class="sd">        &quot;&quot;&quot;</span>
    334. 

  334. 

  335.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">locale</span><span class="p">,</span> <span class="n">GeoLocation</span><span class="p">):</span>
    336. 

  336.             <span class="n">locale</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">locale</span><span class="p">()</span>
    337. 

  337.         <span class="k">elif</span> <span class="n">locale</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    338. 

  338.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    339. 

  339. 

  340.         <span class="k">if</span> <span class="n">unit</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>  <span class="c1"># unit by territory</span>
    341. 

  341.             <span class="n">unit</span> <span class="o">=</span> <span class="s2">&quot;°C&quot;</span>
    342. 

  342.             <span class="k">if</span> <span class="n">locale</span><span class="o">.</span><span class="n">territory</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;US&quot;</span><span class="p">]:</span>
    343. 

  343.                 <span class="n">unit</span> <span class="o">=</span> <span class="s2">&quot;°F&quot;</span>
    344. 

  344.         <span class="n">val_str</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">numbers</span><span class="o">.</span><span class="n">format_decimal</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">(</span><span class="n">unit</span><span class="p">),</span> <span class="n">locale</span><span class="o">=</span><span class="n">locale</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">num_pattern</span><span class="p">)</span>
    345. 

  345.         <span class="k">return</span> <span class="n">template</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="n">val_str</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="n">unit</span><span class="p">)</span></div>
    346. 

  346. </div>
    347. 

  347. 

  348. 

  349. 

  350. <div class="viewcode-block" id="Pressure">
    351. 

  351. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.Pressure">[docs]</a>
    352. 

  352. <span class="k">class</span><span class="w"> </span><span class="nc">Pressure</span><span class="p">:</span>
    353. 

  353. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Class for converting pressure units and for string representation of</span>
    354. 

  354. <span class="sd">    measured values.&quot;&quot;&quot;</span>
    355. 

  355. 

  356.     <span class="n">si_name</span> <span class="o">=</span> <span class="s2">&quot;Q44395&quot;</span>
    357. 

  357. 

  358.     <span class="n">Units</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;Pa&quot;</span><span class="p">,</span> <span class="s2">&quot;hPa&quot;</span><span class="p">,</span> <span class="s2">&quot;cm Hg&quot;</span><span class="p">,</span> <span class="s2">&quot;bar&quot;</span><span class="p">]</span>
    359. 

  359. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Supported units.&quot;&quot;&quot;</span>
    360. 

  360. 

  361.     <span class="n">units</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">typing</span><span class="o">.</span><span class="n">get_args</span><span class="p">(</span><span class="n">Units</span><span class="p">))</span>
    362. 

  362. 

  363.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">):</span>
    364. 

  364.         <span class="k">if</span> <span class="n">unit</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">:</span>
    365. 

  365.             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;invalid unit: </span><span class="si">{</span><span class="n">unit</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
    366. 

  366.         <span class="c1"># pylint: disable=invalid-name</span>
    367. 

  367.         <span class="bp">self</span><span class="o">.</span><span class="n">si</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="n">convert_to_si</span><span class="p">(</span><span class="n">si_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si_name</span><span class="p">,</span> <span class="n">symbol</span><span class="o">=</span><span class="n">unit</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="n">value</span><span class="p">)</span>
    368. 

  368. 

  369.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    370. 

  370.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">l10n</span><span class="p">()</span>
    371. 

  371. 

  372.     <span class="k">def</span><span class="w"> </span><span class="nf">value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
    373. 

  373.         <span class="k">return</span> <span class="n">convert_from_si</span><span class="p">(</span><span class="n">si_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si_name</span><span class="p">,</span> <span class="n">symbol</span><span class="o">=</span><span class="n">unit</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si</span><span class="p">)</span>
    374. 

  374. 

  375.     <span class="k">def</span><span class="w"> </span><span class="nf">l10n</span><span class="p">(</span>
    376. 

  376.         <span class="bp">self</span><span class="p">,</span>
    377. 

  377.         <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    378. 

  378.         <span class="n">locale</span><span class="p">:</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span> <span class="o">|</span> <span class="n">GeoLocation</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    379. 

  379.         <span class="n">template</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{value}</span><span class="s2"> </span><span class="si">{unit}</span><span class="s2">&quot;</span><span class="p">,</span>
    380. 

  380.         <span class="n">num_pattern</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;#,##0&quot;</span><span class="p">,</span>
    381. 

  381.     <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    382. 

  382.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">locale</span><span class="p">,</span> <span class="n">GeoLocation</span><span class="p">):</span>
    383. 

  383.             <span class="n">locale</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">locale</span><span class="p">()</span>
    384. 

  384.         <span class="k">elif</span> <span class="n">locale</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    385. 

  385.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    386. 

  386. 

  387.         <span class="k">if</span> <span class="n">unit</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>  <span class="c1"># unit by territory?</span>
    388. 

  388.             <span class="n">unit</span> <span class="o">=</span> <span class="s2">&quot;hPa&quot;</span>
    389. 

  389. 

  390.         <span class="n">val_str</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">numbers</span><span class="o">.</span><span class="n">format_decimal</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">(</span><span class="n">unit</span><span class="p">),</span> <span class="n">locale</span><span class="o">=</span><span class="n">locale</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">num_pattern</span><span class="p">)</span>
    391. 

  391.         <span class="k">return</span> <span class="n">template</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="n">val_str</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="n">unit</span><span class="p">)</span></div>
    392. 

  392. 

  393. 

  394. 

  395. <div class="viewcode-block" id="WindSpeed">
    396. 

  396. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.WindSpeed">[docs]</a>
    397. 

  397. <span class="k">class</span><span class="w"> </span><span class="nc">WindSpeed</span><span class="p">:</span>
    398. 

  398. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Class for converting speed or velocity units and for string</span>
    399. 

  399. <span class="sd">    representation of measured values.</span>
    400. 

  400. 

  401. <span class="sd">    .. hint::</span>
    402. 

  402. 

  403. <span class="sd">       Working with unit ``Bft`` (:py:obj:`searx.wikidata_units.Beaufort`) will</span>
    404. 

  404. <span class="sd">       throw a :py:obj:`ValueError` for egative values or values greater 16 Bft</span>
    405. 

  405. <span class="sd">       (55.6 m/s)</span>
    406. 

  406. <span class="sd">    &quot;&quot;&quot;</span>
    407. 

  407. 

  408.     <span class="n">si_name</span> <span class="o">=</span> <span class="s2">&quot;Q182429&quot;</span>
    409. 

  409. 

  410.     <span class="n">Units</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;m/s&quot;</span><span class="p">,</span> <span class="s2">&quot;km/h&quot;</span><span class="p">,</span> <span class="s2">&quot;kn&quot;</span><span class="p">,</span> <span class="s2">&quot;mph&quot;</span><span class="p">,</span> <span class="s2">&quot;mi/h&quot;</span><span class="p">,</span> <span class="s2">&quot;Bft&quot;</span><span class="p">]</span>
    411. 

  411. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Supported units.&quot;&quot;&quot;</span>
    412. 

  412. 

  413.     <span class="n">units</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">typing</span><span class="o">.</span><span class="n">get_args</span><span class="p">(</span><span class="n">Units</span><span class="p">))</span>
    414. 

  414. 

  415.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">):</span>
    416. 

  416.         <span class="k">if</span> <span class="n">unit</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">units</span><span class="p">:</span>
    417. 

  417.             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;invalid unit: </span><span class="si">{</span><span class="n">unit</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
    418. 

  418.         <span class="c1"># pylint: disable=invalid-name</span>
    419. 

  419.         <span class="bp">self</span><span class="o">.</span><span class="n">si</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="n">convert_to_si</span><span class="p">(</span><span class="n">si_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si_name</span><span class="p">,</span> <span class="n">symbol</span><span class="o">=</span><span class="n">unit</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="n">value</span><span class="p">)</span>
    420. 

  420. 

  421.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    422. 

  422.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">l10n</span><span class="p">()</span>
    423. 

  423. 

  424.     <span class="k">def</span><span class="w"> </span><span class="nf">value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
    425. 

  425.         <span class="k">return</span> <span class="n">convert_from_si</span><span class="p">(</span><span class="n">si_name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si_name</span><span class="p">,</span> <span class="n">symbol</span><span class="o">=</span><span class="n">unit</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">si</span><span class="p">)</span>
    426. 

  426. 

  427.     <span class="k">def</span><span class="w"> </span><span class="nf">l10n</span><span class="p">(</span>
    428. 

  428.         <span class="bp">self</span><span class="p">,</span>
    429. 

  429.         <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    430. 

  430.         <span class="n">locale</span><span class="p">:</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span> <span class="o">|</span> <span class="n">GeoLocation</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    431. 

  431.         <span class="n">template</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{value}</span><span class="s2"> </span><span class="si">{unit}</span><span class="s2">&quot;</span><span class="p">,</span>
    432. 

  432.         <span class="n">num_pattern</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;#,##0&quot;</span><span class="p">,</span>
    433. 

  433.     <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    434. 

  434.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">locale</span><span class="p">,</span> <span class="n">GeoLocation</span><span class="p">):</span>
    435. 

  435.             <span class="n">locale</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">locale</span><span class="p">()</span>
    436. 

  436.         <span class="k">elif</span> <span class="n">locale</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    437. 

  437.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    438. 

  438. 

  439.         <span class="k">if</span> <span class="n">unit</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>  <span class="c1"># unit by territory?</span>
    440. 

  440.             <span class="n">unit</span> <span class="o">=</span> <span class="s2">&quot;m/s&quot;</span>
    441. 

  441. 

  442.         <span class="n">val_str</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">numbers</span><span class="o">.</span><span class="n">format_decimal</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">(</span><span class="n">unit</span><span class="p">),</span> <span class="n">locale</span><span class="o">=</span><span class="n">locale</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">num_pattern</span><span class="p">)</span>
    443. 

  443.         <span class="k">return</span> <span class="n">template</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="n">val_str</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="n">unit</span><span class="p">)</span></div>
    444. 

  444. 

  445. 

  446. 

  447. <div class="viewcode-block" id="RelativeHumidity">
    448. 

  448. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.RelativeHumidity">[docs]</a>
    449. 

  449. <span class="k">class</span><span class="w"> </span><span class="nc">RelativeHumidity</span><span class="p">:</span>
    450. 

  450. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Amount of relative humidity in the air. The unit is ``%``&quot;&quot;&quot;</span>
    451. 

  451. 

  452.     <span class="n">Units</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;%&quot;</span><span class="p">]</span>
    453. 

  453. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Supported unit.&quot;&quot;&quot;</span>
    454. 

  454. 

  455.     <span class="n">units</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">typing</span><span class="o">.</span><span class="n">get_args</span><span class="p">(</span><span class="n">Units</span><span class="p">))</span>
    456. 

  456. 

  457.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">humidity</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
    458. 

  458.         <span class="bp">self</span><span class="o">.</span><span class="n">humidity</span> <span class="o">=</span> <span class="n">humidity</span>
    459. 

  459. 

  460.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    461. 

  461.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">l10n</span><span class="p">()</span>
    462. 

  462. 

  463.     <span class="k">def</span><span class="w"> </span><span class="nf">value</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
    464. 

  464.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">humidity</span>
    465. 

  465. 

  466.     <span class="k">def</span><span class="w"> </span><span class="nf">l10n</span><span class="p">(</span>
    467. 

  467.         <span class="bp">self</span><span class="p">,</span>
    468. 

  468.         <span class="n">locale</span><span class="p">:</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span> <span class="o">|</span> <span class="n">GeoLocation</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    469. 

  469.         <span class="n">template</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{value}{unit}</span><span class="s2">&quot;</span><span class="p">,</span>
    470. 

  470.         <span class="n">num_pattern</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;#,##0&quot;</span><span class="p">,</span>
    471. 

  471.     <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    472. 

  472.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">locale</span><span class="p">,</span> <span class="n">GeoLocation</span><span class="p">):</span>
    473. 

  473.             <span class="n">locale</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">locale</span><span class="p">()</span>
    474. 

  474.         <span class="k">elif</span> <span class="n">locale</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    475. 

  475.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    476. 

  476. 

  477.         <span class="n">unit</span> <span class="o">=</span> <span class="s2">&quot;%&quot;</span>
    478. 

  478.         <span class="n">val_str</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">numbers</span><span class="o">.</span><span class="n">format_decimal</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">(),</span> <span class="n">locale</span><span class="o">=</span><span class="n">locale</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">num_pattern</span><span class="p">)</span>
    479. 

  479.         <span class="k">return</span> <span class="n">template</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="n">val_str</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="n">unit</span><span class="p">)</span></div>
    480. 

  480. 

  481. 

  482. 

  483. <div class="viewcode-block" id="Compass">
    484. 

  484. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.Compass">[docs]</a>
    485. 

  485. <span class="k">class</span><span class="w"> </span><span class="nc">Compass</span><span class="p">:</span>
    486. 

  486. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Class for converting compass points and azimuth values (360°)&quot;&quot;&quot;</span>
    487. 

  487. 

  488.     <span class="n">Units</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;°&quot;</span><span class="p">,</span> <span class="s2">&quot;Point&quot;</span><span class="p">]</span>
    489. 

  489. 

  490.     <span class="n">Point</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span>
    491. 

  491.         <span class="s2">&quot;N&quot;</span><span class="p">,</span> <span class="s2">&quot;NNE&quot;</span><span class="p">,</span> <span class="s2">&quot;NE&quot;</span><span class="p">,</span> <span class="s2">&quot;ENE&quot;</span><span class="p">,</span> <span class="s2">&quot;E&quot;</span><span class="p">,</span> <span class="s2">&quot;ESE&quot;</span><span class="p">,</span> <span class="s2">&quot;SE&quot;</span><span class="p">,</span> <span class="s2">&quot;SSE&quot;</span><span class="p">,</span> <span class="s2">&quot;S&quot;</span><span class="p">,</span> <span class="s2">&quot;SSW&quot;</span><span class="p">,</span> <span class="s2">&quot;SW&quot;</span><span class="p">,</span> <span class="s2">&quot;WSW&quot;</span><span class="p">,</span> <span class="s2">&quot;W&quot;</span><span class="p">,</span> <span class="s2">&quot;WNW&quot;</span><span class="p">,</span> <span class="s2">&quot;NW&quot;</span><span class="p">,</span> <span class="s2">&quot;NNW&quot;</span>
    492. 

  492.     <span class="p">]</span>
    493. 

  493. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Compass point type definition&quot;&quot;&quot;</span>
    494. 

  494. 

  495.     <span class="n">TURN</span> <span class="o">=</span> <span class="mf">360.0</span>
    496. 

  496. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Full turn (360°)&quot;&quot;&quot;</span>
    497. 

  497. 

  498.     <span class="n">POINTS</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">typing</span><span class="o">.</span><span class="n">get_args</span><span class="p">(</span><span class="n">Point</span><span class="p">))</span>
    499. 

  499. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Compass points.&quot;&quot;&quot;</span>
    500. 

  500. 

  501.     <span class="n">RANGE</span> <span class="o">=</span> <span class="n">TURN</span> <span class="o">/</span> <span class="nb">len</span><span class="p">(</span><span class="n">POINTS</span><span class="p">)</span>
    502. 

  502. <span class="w">    </span><span class="sd">&quot;&quot;&quot;Angle sector of a compass point&quot;&quot;&quot;</span>
    503. 

  503. 

  504.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">azimuth</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="n">Point</span><span class="p">):</span>
    505. 

  505.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">azimuth</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
    506. 

  506.             <span class="k">if</span> <span class="n">azimuth</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">POINTS</span><span class="p">:</span>
    507. 

  507.                 <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid compass point: </span><span class="si">{</span><span class="n">azimuth</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
    508. 

  508.             <span class="n">azimuth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">POINTS</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">azimuth</span><span class="p">)</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">RANGE</span>
    509. 

  509.         <span class="bp">self</span><span class="o">.</span><span class="n">azimuth</span> <span class="o">=</span> <span class="n">azimuth</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">TURN</span>
    510. 

  510. 

  511.     <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
    512. 

  512.         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">l10n</span><span class="p">()</span>
    513. 

  513. 

  514.     <span class="k">def</span><span class="w"> </span><span class="nf">value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span><span class="p">):</span>
    515. 

  515.         <span class="k">if</span> <span class="n">unit</span> <span class="o">==</span> <span class="s2">&quot;Point&quot;</span><span class="p">:</span>
    516. 

  516.             <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">point</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">azimuth</span><span class="p">)</span>
    517. 

  517.         <span class="k">if</span> <span class="n">unit</span> <span class="o">==</span> <span class="s2">&quot;°&quot;</span><span class="p">:</span>
    518. 

  518.             <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">azimuth</span>
    519. 

  519.         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;unknown unit: </span><span class="si">{</span><span class="n">unit</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
    520. 

  520. 

  521. <div class="viewcode-block" id="Compass.point">
    522. 

  522. <a class="viewcode-back" href="../../src/searx.weather.html#searx.weather.Compass.point">[docs]</a>
    523. 

  523.     <span class="nd">@classmethod</span>
    524. 

  524.     <span class="k">def</span><span class="w"> </span><span class="nf">point</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">azimuth</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Point</span><span class="p">:</span>
    525. 

  525. <span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the compass point to an azimuth value.&quot;&quot;&quot;</span>
    526. 

  526.         <span class="n">azimuth</span> <span class="o">=</span> <span class="n">azimuth</span> <span class="o">%</span> <span class="bp">cls</span><span class="o">.</span><span class="n">TURN</span>
    527. 

  527.         <span class="c1"># The angle sector of a compass point starts 1/2 sector range before</span>
    528. 

  528.         <span class="c1"># and after compass point (example: &quot;N&quot; goes from -11.25° to +11.25°)</span>
    529. 

  529.         <span class="n">azimuth</span> <span class="o">=</span> <span class="n">azimuth</span> <span class="o">-</span> <span class="bp">cls</span><span class="o">.</span><span class="n">RANGE</span> <span class="o">/</span> <span class="mi">2</span>
    530. 

  530.         <span class="n">idx</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">azimuth</span> <span class="o">//</span> <span class="bp">cls</span><span class="o">.</span><span class="n">RANGE</span><span class="p">)</span>
    531. 

  531.         <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">POINTS</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span></div>
    532. 

  532. 

  533. 

  534.     <span class="k">def</span><span class="w"> </span><span class="nf">l10n</span><span class="p">(</span>
    535. 

  535.         <span class="bp">self</span><span class="p">,</span>
    536. 

  536.         <span class="n">unit</span><span class="p">:</span> <span class="n">Units</span> <span class="o">=</span> <span class="s2">&quot;Point&quot;</span><span class="p">,</span>
    537. 

  537.         <span class="n">locale</span><span class="p">:</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span> <span class="o">|</span> <span class="n">GeoLocation</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
    538. 

  538.         <span class="n">template</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{value}{unit}</span><span class="s2">&quot;</span><span class="p">,</span>
    539. 

  539.         <span class="n">num_pattern</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;#,##0&quot;</span><span class="p">,</span>
    540. 

  540.     <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
    541. 

  541.         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">locale</span><span class="p">,</span> <span class="n">GeoLocation</span><span class="p">):</span>
    542. 

  542.             <span class="n">locale</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">locale</span><span class="p">()</span>
    543. 

  543.         <span class="k">elif</span> <span class="n">locale</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
    544. 

  544.             <span class="n">locale</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">Locale</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">_get_sxng_locale_tag</span><span class="p">(),</span> <span class="n">sep</span><span class="o">=</span><span class="s1">&#39;-&#39;</span><span class="p">)</span>
    545. 

  545. 

  546.         <span class="k">if</span> <span class="n">unit</span> <span class="o">==</span> <span class="s2">&quot;Point&quot;</span><span class="p">:</span>
    547. 

  547.             <span class="n">val_str</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">(</span><span class="n">unit</span><span class="p">)</span>
    548. 

  548.             <span class="k">return</span> <span class="n">template</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="n">val_str</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">)</span>
    549. 

  549. 

  550.         <span class="n">val_str</span> <span class="o">=</span> <span class="n">babel</span><span class="o">.</span><span class="n">numbers</span><span class="o">.</span><span class="n">format_decimal</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">(</span><span class="n">unit</span><span class="p">),</span> <span class="n">locale</span><span class="o">=</span><span class="n">locale</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">num_pattern</span><span class="p">)</span>
    551. 

  551.         <span class="k">return</span> <span class="n">template</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="n">val_str</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="n">unit</span><span class="p">)</span></div>
    552. 

  552. 

  553. 

  554. 

  555. <span class="n">WeatherConditionType</span> <span class="o">=</span> <span class="n">typing</span><span class="o">.</span><span class="n">Literal</span><span class="p">[</span>
    556. 

  556.     <span class="c1"># The capitalized string goes into to i18n/l10n (en: &quot;Clear sky&quot; -&gt; de: &quot;wolkenloser Himmel&quot;)</span>
    557. 

  557.     <span class="s2">&quot;clear sky&quot;</span><span class="p">,</span>
    558. 

  558.     <span class="s2">&quot;cloudy&quot;</span><span class="p">,</span>
    559. 

  559.     <span class="s2">&quot;fair&quot;</span><span class="p">,</span>
    560. 

  560.     <span class="s2">&quot;fog&quot;</span><span class="p">,</span>
    561. 

  561.     <span class="s2">&quot;heavy rain and thunder&quot;</span><span class="p">,</span>
    562. 

  562.     <span class="s2">&quot;heavy rain showers and thunder&quot;</span><span class="p">,</span>
    563. 

  563.     <span class="s2">&quot;heavy rain showers&quot;</span><span class="p">,</span>
    564. 

  564.     <span class="s2">&quot;heavy rain&quot;</span><span class="p">,</span>
    565. 

  565.     <span class="s2">&quot;heavy sleet and thunder&quot;</span><span class="p">,</span>
    566. 

  566.     <span class="s2">&quot;heavy sleet showers and thunder&quot;</span><span class="p">,</span>
    567. 

  567.     <span class="s2">&quot;heavy sleet showers&quot;</span><span class="p">,</span>
    568. 

  568.     <span class="s2">&quot;heavy sleet&quot;</span><span class="p">,</span>
    569. 

  569.     <span class="s2">&quot;heavy snow and thunder&quot;</span><span class="p">,</span>
    570. 

  570.     <span class="s2">&quot;heavy snow showers and thunder&quot;</span><span class="p">,</span>
    571. 

  571.     <span class="s2">&quot;heavy snow showers&quot;</span><span class="p">,</span>
    572. 

  572.     <span class="s2">&quot;heavy snow&quot;</span><span class="p">,</span>
    573. 

  573.     <span class="s2">&quot;light rain and thunder&quot;</span><span class="p">,</span>
    574. 

  574.     <span class="s2">&quot;light rain showers and thunder&quot;</span><span class="p">,</span>
    575. 

  575.     <span class="s2">&quot;light rain showers&quot;</span><span class="p">,</span>
    576. 

  576.     <span class="s2">&quot;light rain&quot;</span><span class="p">,</span>
    577. 

  577.     <span class="s2">&quot;light sleet and thunder&quot;</span><span class="p">,</span>
    578. 

  578.     <span class="s2">&quot;light sleet showers and thunder&quot;</span><span class="p">,</span>
    579. 

  579.     <span class="s2">&quot;light sleet showers&quot;</span><span class="p">,</span>
    580. 

  580.     <span class="s2">&quot;light sleet&quot;</span><span class="p">,</span>
    581. 

  581.     <span class="s2">&quot;light snow and thunder&quot;</span><span class="p">,</span>
    582. 

  582.     <span class="s2">&quot;light snow showers and thunder&quot;</span><span class="p">,</span>
    583. 

  583.     <span class="s2">&quot;light snow showers&quot;</span><span class="p">,</span>
    584. 

  584.     <span class="s2">&quot;light snow&quot;</span><span class="p">,</span>
    585. 

  585.     <span class="s2">&quot;partly cloudy&quot;</span><span class="p">,</span>
    586. 

  586.     <span class="s2">&quot;rain and thunder&quot;</span><span class="p">,</span>
    587. 

  587.     <span class="s2">&quot;rain showers and thunder&quot;</span><span class="p">,</span>
    588. 

  588.     <span class="s2">&quot;rain showers&quot;</span><span class="p">,</span>
    589. 

  589.     <span class="s2">&quot;rain&quot;</span><span class="p">,</span>
    590. 

  590.     <span class="s2">&quot;sleet and thunder&quot;</span><span class="p">,</span>
    591. 

  591.     <span class="s2">&quot;sleet showers and thunder&quot;</span><span class="p">,</span>
    592. 

  592.     <span class="s2">&quot;sleet showers&quot;</span><span class="p">,</span>
    593. 

  593.     <span class="s2">&quot;sleet&quot;</span><span class="p">,</span>
    594. 

  594.     <span class="s2">&quot;snow and thunder&quot;</span><span class="p">,</span>
    595. 

  595.     <span class="s2">&quot;snow showers and thunder&quot;</span><span class="p">,</span>
    596. 

  596.     <span class="s2">&quot;snow showers&quot;</span><span class="p">,</span>
    597. 

  597.     <span class="s2">&quot;snow&quot;</span><span class="p">,</span>
    598. 

  598. <span class="p">]</span>
    599. 

  599. <span class="sd">&quot;&quot;&quot;Standardized designations for weather conditions.  The designators were</span>
    600. 

  600. <span class="sd">taken from a collaboration between NRK and Norwegian Meteorological Institute</span>
    601. 

  601. <span class="sd">(yr.no_).  `Weather symbols`_ can be assigned to the identifiers</span>
    602. 

  602. <span class="sd">(weathericons_) and they are included in the translation (i18n/l10n</span>
    603. 

  603. <span class="sd">:origin:`searx/searxng.msg`).</span>
    604. 

  604. 

  605. <span class="sd">.. _yr.no: https://www.yr.no/en</span>
    606. 

  606. <span class="sd">.. _Weather symbols: https://github.com/nrkno/yr-weather-symbols</span>
    607. 

  607. <span class="sd">.. _weathericons: https://github.com/metno/weathericons</span>
    608. 

  608. <span class="sd">&quot;&quot;&quot;</span>
    609. 

  609. 

  610. <span class="n">YR_WEATHER_SYMBOL_MAP</span> <span class="o">=</span> <span class="p">{</span>
    611. 

  611.     <span class="s2">&quot;clear sky&quot;</span><span class="p">:</span> <span class="s2">&quot;01d&quot;</span><span class="p">,</span>  <span class="c1"># 01d clearsky_day</span>
    612. 

  612.     <span class="s2">&quot;fair&quot;</span><span class="p">:</span> <span class="s2">&quot;02d&quot;</span><span class="p">,</span>  <span class="c1"># 02d fair_day</span>
    613. 

  613.     <span class="s2">&quot;partly cloudy&quot;</span><span class="p">:</span> <span class="s2">&quot;03d&quot;</span><span class="p">,</span>  <span class="c1"># 03d partlycloudy_day</span>
    614. 

  614.     <span class="s2">&quot;cloudy&quot;</span><span class="p">:</span> <span class="s2">&quot;04&quot;</span><span class="p">,</span>  <span class="c1"># 04 cloudy</span>
    615. 

  615.     <span class="s2">&quot;light rain showers&quot;</span><span class="p">:</span> <span class="s2">&quot;40d&quot;</span><span class="p">,</span>  <span class="c1"># 40d lightrainshowers_day</span>
    616. 

  616.     <span class="s2">&quot;rain showers&quot;</span><span class="p">:</span> <span class="s2">&quot;05d&quot;</span><span class="p">,</span>  <span class="c1"># 05d rainshowers_day</span>
    617. 

  617.     <span class="s2">&quot;heavy rain showers&quot;</span><span class="p">:</span> <span class="s2">&quot;41d&quot;</span><span class="p">,</span>  <span class="c1"># 41d heavyrainshowers_day</span>
    618. 

  618.     <span class="s2">&quot;light rain showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;24d&quot;</span><span class="p">,</span>  <span class="c1"># 24d lightrainshowersandthunder_day</span>
    619. 

  619.     <span class="s2">&quot;rain showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;06d&quot;</span><span class="p">,</span>  <span class="c1"># 06d rainshowersandthunder_day</span>
    620. 

  620.     <span class="s2">&quot;heavy rain showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;25d&quot;</span><span class="p">,</span>  <span class="c1"># 25d heavyrainshowersandthunder_day</span>
    621. 

  621.     <span class="s2">&quot;light sleet showers&quot;</span><span class="p">:</span> <span class="s2">&quot;42d&quot;</span><span class="p">,</span>  <span class="c1"># 42d lightsleetshowers_day</span>
    622. 

  622.     <span class="s2">&quot;sleet showers&quot;</span><span class="p">:</span> <span class="s2">&quot;07d&quot;</span><span class="p">,</span>  <span class="c1"># 07d sleetshowers_day</span>
    623. 

  623.     <span class="s2">&quot;heavy sleet showers&quot;</span><span class="p">:</span> <span class="s2">&quot;43d&quot;</span><span class="p">,</span>  <span class="c1"># 43d heavysleetshowers_day</span>
    624. 

  624.     <span class="s2">&quot;light sleet showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;26d&quot;</span><span class="p">,</span>  <span class="c1"># 26d lightssleetshowersandthunder_day</span>
    625. 

  625.     <span class="s2">&quot;sleet showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;20d&quot;</span><span class="p">,</span>  <span class="c1"># 20d sleetshowersandthunder_day</span>
    626. 

  626.     <span class="s2">&quot;heavy sleet showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;27d&quot;</span><span class="p">,</span>  <span class="c1"># 27d heavysleetshowersandthunder_day</span>
    627. 

  627.     <span class="s2">&quot;light snow showers&quot;</span><span class="p">:</span> <span class="s2">&quot;44d&quot;</span><span class="p">,</span>  <span class="c1"># 44d lightsnowshowers_day</span>
    628. 

  628.     <span class="s2">&quot;snow showers&quot;</span><span class="p">:</span> <span class="s2">&quot;08d&quot;</span><span class="p">,</span>  <span class="c1"># 08d snowshowers_day</span>
    629. 

  629.     <span class="s2">&quot;heavy snow showers&quot;</span><span class="p">:</span> <span class="s2">&quot;45d&quot;</span><span class="p">,</span>  <span class="c1"># 45d heavysnowshowers_day</span>
    630. 

  630.     <span class="s2">&quot;light snow showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;28d&quot;</span><span class="p">,</span>  <span class="c1"># 28d lightssnowshowersandthunder_day</span>
    631. 

  631.     <span class="s2">&quot;snow showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;21d&quot;</span><span class="p">,</span>  <span class="c1"># 21d snowshowersandthunder_day</span>
    632. 

  632.     <span class="s2">&quot;heavy snow showers and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;29d&quot;</span><span class="p">,</span>  <span class="c1"># 29d heavysnowshowersandthunder_day</span>
    633. 

  633.     <span class="s2">&quot;light rain&quot;</span><span class="p">:</span> <span class="s2">&quot;46&quot;</span><span class="p">,</span>  <span class="c1"># 46 lightrain</span>
    634. 

  634.     <span class="s2">&quot;rain&quot;</span><span class="p">:</span> <span class="s2">&quot;09&quot;</span><span class="p">,</span>  <span class="c1"># 09 rain</span>
    635. 

  635.     <span class="s2">&quot;heavy rain&quot;</span><span class="p">:</span> <span class="s2">&quot;10&quot;</span><span class="p">,</span>  <span class="c1"># 10 heavyrain</span>
    636. 

  636.     <span class="s2">&quot;light rain and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;30&quot;</span><span class="p">,</span>  <span class="c1"># 30 lightrainandthunder</span>
    637. 

  637.     <span class="s2">&quot;rain and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;22&quot;</span><span class="p">,</span>  <span class="c1"># 22 rainandthunder</span>
    638. 

  638.     <span class="s2">&quot;heavy rain and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;11&quot;</span><span class="p">,</span>  <span class="c1"># 11 heavyrainandthunder</span>
    639. 

  639.     <span class="s2">&quot;light sleet&quot;</span><span class="p">:</span> <span class="s2">&quot;47&quot;</span><span class="p">,</span>  <span class="c1"># 47 lightsleet</span>
    640. 

  640.     <span class="s2">&quot;sleet&quot;</span><span class="p">:</span> <span class="s2">&quot;12&quot;</span><span class="p">,</span>  <span class="c1"># 12 sleet</span>
    641. 

  641.     <span class="s2">&quot;heavy sleet&quot;</span><span class="p">:</span> <span class="s2">&quot;48&quot;</span><span class="p">,</span>  <span class="c1"># 48 heavysleet</span>
    642. 

  642.     <span class="s2">&quot;light sleet and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;31&quot;</span><span class="p">,</span>  <span class="c1"># 31 lightsleetandthunder</span>
    643. 

  643.     <span class="s2">&quot;sleet and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;23&quot;</span><span class="p">,</span>  <span class="c1"># 23 sleetandthunder</span>
    644. 

  644.     <span class="s2">&quot;heavy sleet and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;32&quot;</span><span class="p">,</span>  <span class="c1"># 32 heavysleetandthunder</span>
    645. 

  645.     <span class="s2">&quot;light snow&quot;</span><span class="p">:</span> <span class="s2">&quot;49&quot;</span><span class="p">,</span>  <span class="c1"># 49 lightsnow</span>
    646. 

  646.     <span class="s2">&quot;snow&quot;</span><span class="p">:</span> <span class="s2">&quot;13&quot;</span><span class="p">,</span>  <span class="c1"># 13 snow</span>
    647. 

  647.     <span class="s2">&quot;heavy snow&quot;</span><span class="p">:</span> <span class="s2">&quot;50&quot;</span><span class="p">,</span>  <span class="c1"># 50 heavysnow</span>
    648. 

  648.     <span class="s2">&quot;light snow and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;33&quot;</span><span class="p">,</span>  <span class="c1"># 33 lightsnowandthunder</span>
    649. 

  649.     <span class="s2">&quot;snow and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;14&quot;</span><span class="p">,</span>  <span class="c1"># 14 snowandthunder</span>
    650. 

  650.     <span class="s2">&quot;heavy snow and thunder&quot;</span><span class="p">:</span> <span class="s2">&quot;34&quot;</span><span class="p">,</span>  <span class="c1"># 34 heavysnowandthunder</span>
    651. 

  651.     <span class="s2">&quot;fog&quot;</span><span class="p">:</span> <span class="s2">&quot;15&quot;</span><span class="p">,</span>  <span class="c1"># 15 fog</span>
    652. 

  652. <span class="p">}</span>
    653. 

  653. <span class="sd">&quot;&quot;&quot;Map a :py:obj:`WeatherConditionType` to a `YR weather symbol`_</span>
    654. 

  654. 

  655. <span class="sd">.. code::</span>
    656. 

  656. 

  657. <span class="sd">   base_url = &quot;https://raw.githubusercontent.com/nrkno/yr-weather-symbols/refs/heads/master/symbols&quot;</span>
    658. 

  658. <span class="sd">   icon_url = f&quot;{base_url}/outline/{YR_WEATHER_SYMBOL_MAP[&#39;sleet showers&#39;]}.svg&quot;</span>
    659. 

  659. 

  660. <span class="sd">.. _YR weather symbol: https://github.com/nrkno/yr-weather-symbols/blob/master/locales/en.json</span>
    661. 

  661. 

  662. <span class="sd">&quot;&quot;&quot;</span>
    663. 

  663. 

  664. <span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">&quot;__main__&quot;</span><span class="p">:</span>
    665. 

  665. 

  666.     <span class="c1"># test: fetch all symbols of the type catalog ..</span>
    667. 

  667.     <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">typing</span><span class="o">.</span><span class="n">get_args</span><span class="p">(</span><span class="n">WeatherConditionType</span><span class="p">):</span>
    668. 

  668.         <span class="n">symbol_url</span><span class="p">(</span><span class="n">condition</span><span class="o">=</span><span class="n">c</span><span class="p">)</span>
    669. 

  669. 

  670.     <span class="n">_cache</span> <span class="o">=</span> <span class="n">get_WEATHER_DATA_CACHE</span><span class="p">()</span>
    671. 

  671.     <span class="n">title</span> <span class="o">=</span> <span class="s2">&quot;cached weather condition symbols&quot;</span>
    672. 

  672.     <span class="nb">print</span><span class="p">(</span><span class="n">title</span><span class="p">)</span>
    673. 

  673.     <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;=&quot;</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">title</span><span class="p">))</span>
    674. 

  674.     <span class="nb">print</span><span class="p">(</span><span class="n">_cache</span><span class="o">.</span><span class="n">state</span><span class="p">()</span><span class="o">.</span><span class="n">report</span><span class="p">())</span>
    675. 

  675.     <span class="nb">print</span><span class="p">()</span>
    676. 

  676.     <span class="n">title</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;properties of </span><span class="si">{</span><span class="n">_cache</span><span class="o">.</span><span class="n">cfg</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span>
    677. 

  677.     <span class="nb">print</span><span class="p">(</span><span class="n">title</span><span class="p">)</span>
    678. 

  678.     <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;=&quot;</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">title</span><span class="p">))</span>
    679. 

  679.     <span class="nb">print</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">_cache</span><span class="o">.</span><span class="n">properties</span><span class="p">))</span>  <span class="c1"># type: ignore</span>
    680. 

  680. </pre></div>
    681. 

  681. 

  682.             <div class="clearer"></div>
    683. 

  683.           </div>
    684. 

  684.         </div>
    685. 

  685.       </div>
    686. 

  686.   <span id="sidebar-top"></span>
    687. 

  687.       <div class="sphinxsidebar" role="navigation" aria-label="Main">
    688. 

  688.         <div class="sphinxsidebarwrapper">
    689. 

  689.   
    690. 

  690.     
    691. 

  691.             <p class="logo"><a href="../../index.html">
    692. 

  692.               <img class="logo" src="../../_static/searxng-wordmark.svg" alt="Logo of SearXNG"/>
    693. 

  693.             </a></p>
    694. 

  694.   
    695. 

  695. 

  696. <h3><a href="../../index.html">Table of Contents</a></h3>
    697. 

  697. <ul>
    698. 

  698. <li class="toctree-l1"><a class="reference internal" href="../../user/index.html">User information</a></li>
    699. 

  699. <li class="toctree-l1"><a class="reference internal" href="../../own-instance.html">Why use a private instance?</a></li>
    700. 

  700. <li class="toctree-l1"><a class="reference internal" href="../../admin/index.html">Administrator documentation</a></li>
    701. 

  701. <li class="toctree-l1"><a class="reference internal" href="../../dev/index.html">Developer documentation</a></li>
    702. 

  702. <li class="toctree-l1"><a class="reference internal" href="../../utils/index.html">DevOps tooling box</a></li>
    703. 

  703. <li class="toctree-l1"><a class="reference internal" href="../../src/index.html">Source-Code</a></li>
    704. 

  704. </ul>
    705. 

  705. 

  706.   <h3>Project Links</h3>
    707. 

  707.   <ul>
    708. 

  708.     <li><a href="https://github.com/searxng/searxng/tree/master">Source</a>
    709. 

  709.   
    710. 

  710.     <li><a href="https://github.com/searxng/searxng/wiki">Wiki</a>
    711. 

  711.   
    712. 

  712.     <li><a href="https://searx.space">Public instances</a>
    713. 

  713.   
    714. 

  714.     <li><a href="https://github.com/searxng/searxng/issues">Issue Tracker</a>
    715. 

  715.   </ul><h3>Navigation</h3>
    716. 

  716. <ul>
    717. 

  717.   <li><a href="../../index.html">Overview</a>
    718. 

  718.     <ul>
    719. 

  719.       <li><a href="../index.html">Module code</a>
    720. 

  720.         
    721. 

  721.           
    722. 

  722.           </ul>
    723. 

  723.       </li>
    724. 

  724.     </ul>
    725. 

  725.   </li>
    726. 

  726. </ul>
    727. 

  727. <search id="searchbox" style="display: none" role="search">
    728. 

  728.   <h3 id="searchlabel">Quick search</h3>
    729. 

  729.     <div class="searchformwrapper">
    730. 

  730.     <form class="search" action="../../search.html" method="get">
    731. 

  731.       <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
    732. 

  732.       <input type="submit" value="Go" />
    733. 

  733.     </form>
    734. 

  734.     </div>
    735. 

  735. </search>
    736. 

  736. <script>document.getElementById('searchbox').style.display = "block"</script>
    737. 

  737.         </div>
    738. 

  738.       </div>
    739. 

  739.       <div class="clearer"></div>
    740. 

  740.     </div>
    741. 

  741.     <div class="footer" role="contentinfo">
    742. 

  742.     &#169; Copyright SearXNG team.
    743. 

  743.     </div>
    744. 

  744.   </body>
    745. 

  745. </html>
    746.
© 2025 NTab仓库
Page: 60ms Template: 0ms 微信 微信二维码 哔哩哔哩 Sina Weibo Javascript Licenses Website