Browse Source

add first blog entry on python3 support

Noémi Ványi 7 years ago
parent
commit
d96ebffcef

BIN
_images/searxpy3.png View File


+ 7
- 0
_sources/blog/blog.txt View File

1
+Blog
2
+====
3
+
4
+.. toctree::
5
+   :maxdepth: 1
6
+
7
+   python3

+ 54
- 0
_sources/blog/python3.txt View File

1
+Introducing Python3 support
2
+===========================
3
+
4
+As most operation systems are coming with Python3 installed by default. So it is time for searx to support Python3. But don't worry support of Python2.7 won't be dropped.
5
+
6
+.. image:: searxpy3.png
7
+    :scale: 50 %
8
+    :alt: hurray
9
+    :align: center
10
+
11
+
12
+How to run searx using Python3
13
+------------------------------
14
+
15
+Please make sure that you run at least Python3.5.
16
+
17
+To run searx, first a Python3 virtualenv should be created. After entering the virtualenv,
18
+dependencies must be installed. Then run searx with python3 instead of the usual python command.
19
+
20
+.. code:: sh
21
+
22
+    virtualenv -p python3 venv3
23
+    source venv3/bin/activate
24
+    pip3 install -r requirements.txt
25
+    python3 searx/webapp.py
26
+
27
+
28
+If you want to run searx using Python2.7, you don't have to do anything differently as before.
29
+
30
+Fun facts
31
+---------
32
+
33
+- 115 files were changed when implementing the support for both Python versions.
34
+
35
+- All of the dependencies was compatible except for the robotframework used for browser tests. Thus, these tests were migrated to splinter. So from now on both versions are being tested on Travis and can be tested locally.
36
+
37
+If you found bugs...
38
+--------------------
39
+
40
+...please open an issue on `GitHub`_. Make sure that you mention your Python version in your issue,
41
+so we can investigate it properly.
42
+
43
+.. _GitHub: https://github.com/asciimoo/searx/issues
44
+
45
+Acknowledgement
46
+---------------
47
+
48
+This development was sponsored by `NLnet Foundation`_.
49
+
50
+.. _NLnet Foundation: https://nlnet.nl/
51
+
52
+
53
+| Happy hacking.
54
+| kvch // 2017.05.13 22:57

+ 1
- 0
admin/api.html View File

141
 <ul>
141
 <ul>
142
     <li><a href="../index.html">Home</a></li>
142
     <li><a href="../index.html">Home</a></li>
143
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
143
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
144
+    <li><a href="../blog/blog.html">Blog</a></li>
144
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
145
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
145
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
146
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
146
 </ul>
147
 </ul>

+ 1
- 0
admin/filtron.html View File

153
 <ul>
153
 <ul>
154
     <li><a href="../index.html">Home</a></li>
154
     <li><a href="../index.html">Home</a></li>
155
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
155
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
156
+    <li><a href="../blog/blog.html">Blog</a></li>
156
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
157
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
157
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
158
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
158
 </ul>
159
 </ul>

+ 80
- 0
blog/blog.html View File

1
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+
4
+
5
+<html xmlns="http://www.w3.org/1999/xhtml">
6
+  <head>
7
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+    
9
+    <title>Blog &#8212; searx 0.11.0 documentation</title>
10
+    
11
+    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
12
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
13
+    
14
+    <script type="text/javascript">
15
+      var DOCUMENTATION_OPTIONS = {
16
+        URL_ROOT:    '../',
17
+        VERSION:     '0.11.0',
18
+        COLLAPSE_INDEX: false,
19
+        FILE_SUFFIX: '.html',
20
+        HAS_SOURCE:  true
21
+      };
22
+    </script>
23
+    <script type="text/javascript" src="../_static/jquery.js"></script>
24
+    <script type="text/javascript" src="../_static/underscore.js"></script>
25
+    <script type="text/javascript" src="../_static/doctools.js"></script>
26
+    <link rel="index" title="Index" href="../genindex.html" />
27
+    <link rel="search" title="Search" href="../search.html" />
28
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
29
+   
30
+  
31
+  <link media="only screen and (max-device-width: 480px)" href="../_static/small_flask.css" type= "text/css" rel="stylesheet" />
32
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9">
33
+
34
+  </head>
35
+  <body role="document">  
36
+
37
+    <div class="document">
38
+      <div class="documentwrapper">
39
+        <div class="bodywrapper">
40
+          <div class="body" role="main">
41
+            
42
+  <div class="section" id="blog">
43
+<h1>Blog<a class="headerlink" href="#blog" title="Permalink to this headline">¶</a></h1>
44
+<div class="toctree-wrapper compound">
45
+<ul>
46
+<li class="toctree-l1"><a class="reference internal" href="python3.html">Introducing Python3 support</a></li>
47
+</ul>
48
+</div>
49
+</div>
50
+
51
+
52
+          </div>
53
+        </div>
54
+      </div>
55
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
56
+        <div class="sphinxsidebarwrapper"><div class="sidebar_container body">
57
+<h1>Searx</h1>
58
+<ul>
59
+    <li><a href="../index.html">Home</a></li>
60
+    <li><a href="https://github.com/asciimoo/searx">Source</a></li>
61
+    <li><a href="#">Blog</a></li>
62
+    <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
63
+    <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
64
+</ul>
65
+<hr />
66
+<ul>
67
+    <li><a href="https://twitter.com/Searx_engine">Twitter</a></li>
68
+    <li><a href="https://flattr.com/submit/auto?user_id=asciimoo&url=https://github.com/asciimoo/searx&title=searx&language=&tags=github&category=software">Flattr</a></li>
69
+    <li><a href="https://gratipay.com/searx">Gratipay</a></li>
70
+</ul>
71
+</div>
72
+        </div>
73
+      </div>
74
+      <div class="clearer"></div>
75
+    </div>
76
+    <div class="footer">
77
+      &copy; Copyright 2015-2016, Adam Tauber.
78
+    </div>
79
+  </body>
80
+</html>

+ 110
- 0
blog/python3.html View File

1
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+
4
+
5
+<html xmlns="http://www.w3.org/1999/xhtml">
6
+  <head>
7
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+    
9
+    <title>Introducing Python3 support &#8212; searx 0.11.0 documentation</title>
10
+    
11
+    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
12
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
13
+    
14
+    <script type="text/javascript">
15
+      var DOCUMENTATION_OPTIONS = {
16
+        URL_ROOT:    '../',
17
+        VERSION:     '0.11.0',
18
+        COLLAPSE_INDEX: false,
19
+        FILE_SUFFIX: '.html',
20
+        HAS_SOURCE:  true
21
+      };
22
+    </script>
23
+    <script type="text/javascript" src="../_static/jquery.js"></script>
24
+    <script type="text/javascript" src="../_static/underscore.js"></script>
25
+    <script type="text/javascript" src="../_static/doctools.js"></script>
26
+    <link rel="index" title="Index" href="../genindex.html" />
27
+    <link rel="search" title="Search" href="../search.html" />
28
+    <link rel="top" title="searx 0.11.0 documentation" href="../index.html" />
29
+   
30
+  
31
+  <link media="only screen and (max-device-width: 480px)" href="../_static/small_flask.css" type= "text/css" rel="stylesheet" />
32
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9">
33
+
34
+  </head>
35
+  <body role="document">  
36
+
37
+    <div class="document">
38
+      <div class="documentwrapper">
39
+        <div class="bodywrapper">
40
+          <div class="body" role="main">
41
+            
42
+  <div class="section" id="introducing-python3-support">
43
+<h1>Introducing Python3 support<a class="headerlink" href="#introducing-python3-support" title="Permalink to this headline">¶</a></h1>
44
+<p>As most operation systems are coming with Python3 installed by default. So it is time for searx to support Python3. But don&#8217;t worry support of Python2.7 won&#8217;t be dropped.</p>
45
+<a class="reference internal image-reference" href="../_images/searxpy3.png"><img alt="hurray" class="align-center" src="../_images/searxpy3.png" style="width: 510.5px; height: 116.0px;" /></a>
46
+<div class="section" id="how-to-run-searx-using-python3">
47
+<h2>How to run searx using Python3<a class="headerlink" href="#how-to-run-searx-using-python3" title="Permalink to this headline">¶</a></h2>
48
+<p>Please make sure that you run at least Python3.5.</p>
49
+<p>To run searx, first a Python3 virtualenv should be created. After entering the virtualenv,
50
+dependencies must be installed. Then run searx with python3 instead of the usual python command.</p>
51
+<div class="code sh highlight-default"><div class="highlight"><pre><span></span><span class="n">virtualenv</span> <span class="o">-</span><span class="n">p</span> <span class="n">python3</span> <span class="n">venv3</span>
52
+<span class="n">source</span> <span class="n">venv3</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">activate</span>
53
+<span class="n">pip3</span> <span class="n">install</span> <span class="o">-</span><span class="n">r</span> <span class="n">requirements</span><span class="o">.</span><span class="n">txt</span>
54
+<span class="n">python3</span> <span class="n">searx</span><span class="o">/</span><span class="n">webapp</span><span class="o">.</span><span class="n">py</span>
55
+</pre></div>
56
+</div>
57
+<p>If you want to run searx using Python2.7, you don&#8217;t have to do anything differently as before.</p>
58
+</div>
59
+<div class="section" id="fun-facts">
60
+<h2>Fun facts<a class="headerlink" href="#fun-facts" title="Permalink to this headline">¶</a></h2>
61
+<ul class="simple">
62
+<li>115 files were changed when implementing the support for both Python versions.</li>
63
+<li>All of the dependencies was compatible except for the robotframework used for browser tests. Thus, these tests were migrated to splinter. So from now on both versions are being tested on Travis and can be tested locally.</li>
64
+</ul>
65
+</div>
66
+<div class="section" id="if-you-found-bugs">
67
+<h2>If you found bugs...<a class="headerlink" href="#if-you-found-bugs" title="Permalink to this headline">¶</a></h2>
68
+<p>...please open an issue on <a class="reference external" href="https://github.com/asciimoo/searx/issues">GitHub</a>. Make sure that you mention your Python version in your issue,
69
+so we can investigate it properly.</p>
70
+</div>
71
+<div class="section" id="acknowledgement">
72
+<h2>Acknowledgement<a class="headerlink" href="#acknowledgement" title="Permalink to this headline">¶</a></h2>
73
+<p>This development was sponsored by <a class="reference external" href="https://nlnet.nl/">NLnet Foundation</a>.</p>
74
+<div class="line-block">
75
+<div class="line">Happy hacking.</div>
76
+<div class="line">kvch // 2017.05.13 22:57</div>
77
+</div>
78
+</div>
79
+</div>
80
+
81
+
82
+          </div>
83
+        </div>
84
+      </div>
85
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
86
+        <div class="sphinxsidebarwrapper"><div class="sidebar_container body">
87
+<h1>Searx</h1>
88
+<ul>
89
+    <li><a href="../index.html">Home</a></li>
90
+    <li><a href="https://github.com/asciimoo/searx">Source</a></li>
91
+    <li><a href="blog.html">Blog</a></li>
92
+    <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
93
+    <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
94
+</ul>
95
+<hr />
96
+<ul>
97
+    <li><a href="https://twitter.com/Searx_engine">Twitter</a></li>
98
+    <li><a href="https://flattr.com/submit/auto?user_id=asciimoo&url=https://github.com/asciimoo/searx&title=searx&language=&tags=github&category=software">Flattr</a></li>
99
+    <li><a href="https://gratipay.com/searx">Gratipay</a></li>
100
+</ul>
101
+</div>
102
+        </div>
103
+      </div>
104
+      <div class="clearer"></div>
105
+    </div>
106
+    <div class="footer">
107
+      &copy; Copyright 2015-2016, Adam Tauber.
108
+    </div>
109
+  </body>
110
+</html>

+ 1
- 0
dev/contribution_guide.html View File

133
 <ul>
133
 <ul>
134
     <li><a href="../index.html">Home</a></li>
134
     <li><a href="../index.html">Home</a></li>
135
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
135
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
136
+    <li><a href="../blog/blog.html">Blog</a></li>
136
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
137
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
137
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
138
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
138
 </ul>
139
 </ul>

+ 1
- 0
dev/engine_overview.html View File

575
 <ul>
575
 <ul>
576
     <li><a href="../index.html">Home</a></li>
576
     <li><a href="../index.html">Home</a></li>
577
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
577
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
578
+    <li><a href="../blog/blog.html">Blog</a></li>
578
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
579
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
579
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
580
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
580
 </ul>
581
 </ul>

+ 1
- 0
dev/install/installation.html View File

325
 <ul>
325
 <ul>
326
     <li><a href="../../index.html">Home</a></li>
326
     <li><a href="../../index.html">Home</a></li>
327
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
327
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
328
+    <li><a href="../../blog/blog.html">Blog</a></li>
328
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
329
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
329
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
330
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
330
 </ul>
331
 </ul>

+ 1
- 0
dev/plugins.html View File

92
 <ul>
92
 <ul>
93
     <li><a href="../index.html">Home</a></li>
93
     <li><a href="../index.html">Home</a></li>
94
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
94
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
95
+    <li><a href="../blog/blog.html">Blog</a></li>
95
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
96
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
96
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
97
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
97
 </ul>
98
 </ul>

+ 8
- 5
dev/quickstart.html View File

109
 </div>
109
 </div>
110
 <div class="section" id="tips-for-debugging-development">
110
 <div class="section" id="tips-for-debugging-development">
111
 <h2>Tips for debugging/development<a class="headerlink" href="#tips-for-debugging-development" title="Permalink to this headline">¶</a></h2>
111
 <h2>Tips for debugging/development<a class="headerlink" href="#tips-for-debugging-development" title="Permalink to this headline">¶</a></h2>
112
-<ol class="arabic simple">
112
+<ol class="arabic">
113
 <li><dl class="first docutils">
113
 <li><dl class="first docutils">
114
 <dt>Turn on debug logging</dt>
114
 <dt>Turn on debug logging</dt>
115
-<dd>Whether you are working on a new engine or trying to eliminate a bug, it is always a good idea
115
+<dd><p class="first last">Whether you are working on a new engine or trying to eliminate a bug, it is always a good idea
116
 to turn on debug logging. When debug logging is enabled a stack trace appears,
116
 to turn on debug logging. When debug logging is enabled a stack trace appears,
117
 instead of the cryptic <code class="docutils literal"><span class="pre">Internal</span> <span class="pre">Server</span> <span class="pre">Error</span></code> message. It can be turned on by setting
117
 instead of the cryptic <code class="docutils literal"><span class="pre">Internal</span> <span class="pre">Server</span> <span class="pre">Error</span></code> message. It can be turned on by setting
118
-<code class="docutils literal"><span class="pre">debug:</span> <span class="pre">False</span></code> to <code class="docutils literal"><span class="pre">debug:</span> <span class="pre">True</span></code> in settings.yml.</dd>
118
+<code class="docutils literal"><span class="pre">debug:</span> <span class="pre">False</span></code> to <code class="docutils literal"><span class="pre">debug:</span> <span class="pre">True</span></code> in settings.yml.</p>
119
+</dd>
119
 </dl>
120
 </dl>
120
 </li>
121
 </li>
121
 <li><dl class="first docutils">
122
 <li><dl class="first docutils">
122
 <dt>Run <code class="docutils literal"><span class="pre">./manage.sh</span> <span class="pre">tests</span></code> before creating a PR.</dt>
123
 <dt>Run <code class="docutils literal"><span class="pre">./manage.sh</span> <span class="pre">tests</span></code> before creating a PR.</dt>
123
-<dd>Failing build on Travis is common because of PEP8 checks. So a new commit must be created
124
+<dd><p class="first last">Failing build on Travis is common because of PEP8 checks. So a new commit must be created
124
 containing these format fixes. This phase can be skipped if <code class="docutils literal"><span class="pre">./manage.sh</span> <span class="pre">tests</span></code> is run
125
 containing these format fixes. This phase can be skipped if <code class="docutils literal"><span class="pre">./manage.sh</span> <span class="pre">tests</span></code> is run
125
-locally before creating a PR.</dd>
126
+locally before creating a PR.</p>
127
+</dd>
126
 </dl>
128
 </dl>
127
 </li>
129
 </li>
128
 </ol>
130
 </ol>
139
 <ul>
141
 <ul>
140
     <li><a href="../index.html">Home</a></li>
142
     <li><a href="../index.html">Home</a></li>
141
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
143
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
144
+    <li><a href="../blog/blog.html">Blog</a></li>
142
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
145
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
143
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
146
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
144
 </ul>
147
 </ul>

+ 1
- 0
dev/search_api.html View File

105
 <ul>
105
 <ul>
106
     <li><a href="../index.html">Home</a></li>
106
     <li><a href="../index.html">Home</a></li>
107
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
107
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
108
+    <li><a href="../blog/blog.html">Blog</a></li>
108
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
109
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
109
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
110
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
110
 </ul>
111
 </ul>

+ 1
- 0
dev/translation.html View File

99
 <ul>
99
 <ul>
100
     <li><a href="../index.html">Home</a></li>
100
     <li><a href="../index.html">Home</a></li>
101
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
101
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
102
+    <li><a href="../blog/blog.html">Blog</a></li>
102
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
103
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
103
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
104
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
104
 </ul>
105
 </ul>

+ 1
- 0
docs/_themes/searx_theme/relations.html View File

3
 <ul>
3
 <ul>
4
     <li><a href="{{ pathto('index') }}">Home</a></li>
4
     <li><a href="{{ pathto('index') }}">Home</a></li>
5
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
5
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
6
+    <li><a href="{{ pathto('blog/blog') }}">Blog</a></li>
6
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
7
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
7
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
8
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
8
 </ul>
9
 </ul>

+ 7
- 0
docs/blog/blog.rst View File

1
+Blog
2
+====
3
+
4
+.. toctree::
5
+   :maxdepth: 1
6
+
7
+   python3

+ 54
- 0
docs/blog/python3.rst View File

1
+Introducing Python3 support
2
+===========================
3
+
4
+As most operation systems are coming with Python3 installed by default. So it is time for searx to support Python3. But don't worry support of Python2.7 won't be dropped.
5
+
6
+.. image:: hurray.png
7
+    :scale: 50 %
8
+    :alt: hurray
9
+    :align: center
10
+
11
+
12
+How to run searx using Python3
13
+------------------------------
14
+
15
+Please make sure that you run at least Python3.5.
16
+
17
+To run searx, first a Python3 virtualenv should be created. After entering the virtualenv,
18
+dependencies must be installed. Then run searx with python3 instead of the usual python command.
19
+
20
+.. code:: sh
21
+
22
+    virtualenv -p python3 venv3
23
+    source venv3/bin/activate
24
+    pip3 install -r requirements.txt
25
+    python3 searx/webapp.py
26
+
27
+
28
+If you want to run searx using Python2.7, you don't have to do anything differently as before.
29
+
30
+Fun facts
31
+---------
32
+
33
+- 115 files were changed when implementing the support for both Python versions.
34
+
35
+- All of the dependencies was compatible except for the robotframework used for browser tests. Thus, these tests were migrated to splinter. So from now on both versions are being tested on Travis and can be tested locally.
36
+
37
+If you found bugs...
38
+--------------------
39
+
40
+...please open an issue on `GitHub`_. Make sure that you mention your Python version in your issue,
41
+so we can investigate it properly.
42
+
43
+.. _GitHub: https://github.com/asciimoo/searx/issues
44
+
45
+Acknowledgement
46
+---------------
47
+
48
+This development was sponsored by `NLnet Foundation`_.
49
+
50
+.. _NLnet Foundation: https://nlnet.nl/
51
+
52
+
53
+| Happy hacking.
54
+| kvch // 2017.05.13 22:57

BIN
docs/blog/searxpy3.png View File


+ 1
- 0
genindex.html View File

59
 <ul>
59
 <ul>
60
     <li><a href="index.html">Home</a></li>
60
     <li><a href="index.html">Home</a></li>
61
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
61
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
62
+    <li><a href="blog/blog.html">Blog</a></li>
62
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
63
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
63
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
64
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
64
 </ul>
65
 </ul>

+ 1
- 0
index.html View File

106
 <ul>
106
 <ul>
107
     <li><a href="#">Home</a></li>
107
     <li><a href="#">Home</a></li>
108
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
108
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
109
+    <li><a href="blog/blog.html">Blog</a></li>
109
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
110
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
110
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
111
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
111
 </ul>
112
 </ul>

+ 1
- 0
search.html View File

80
 <ul>
80
 <ul>
81
     <li><a href="index.html">Home</a></li>
81
     <li><a href="index.html">Home</a></li>
82
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
82
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
83
+    <li><a href="blog/blog.html">Blog</a></li>
83
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
84
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
84
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
85
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
85
 </ul>
86
 </ul>

+ 1
- 0
user/own-instance.html View File

87
 <ul>
87
 <ul>
88
     <li><a href="../index.html">Home</a></li>
88
     <li><a href="../index.html">Home</a></li>
89
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
89
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
90
+    <li><a href="../blog/blog.html">Blog</a></li>
90
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
91
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
91
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
92
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
92
 </ul>
93
 </ul>

+ 1
- 0
user/search_syntax.html View File

77
 <ul>
77
 <ul>
78
     <li><a href="../index.html">Home</a></li>
78
     <li><a href="../index.html">Home</a></li>
79
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
79
     <li><a href="https://github.com/asciimoo/searx">Source</a></li>
80
+    <li><a href="../blog/blog.html">Blog</a></li>
80
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
81
     <li><a href="https://github.com/asciimoo/searx/wiki">Wiki</a></li>
81
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
82
     <li><a href="https://github.com/asciimoo/searx/wiki/Searx-instances">Public instances</a></li>
82
 </ul>
83
 </ul>