-
-
Notifications
You must be signed in to change notification settings - Fork 17
/
Copy pathfaq.html
154 lines (132 loc) · 8.51 KB
/
faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
<!DOCTYPE html>
<html lang="en" data-content_root="./">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>FAQ — IPython</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=03e43079" />
<link rel="stylesheet" type="text/css" href="_static/agogo.css?v=9d7b1825" />
<link rel="stylesheet" href="_static/ipython.css" type="text/css" />
<script src="_static/documentation_options.js?v=5929fcd5"></script>
<script src="_static/doctools.js?v=9a2dae69"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Installing IPython" href="install.html" />
<link rel="prev" title="Support IPython Development" href="donate.html" />
</head><body>
<div class="header-wrapper">
<div class="header">
<div class="logo"><a href="index.html">
<img class="logo" src="_static/IPy_header.png" alt="Logo"/>
</a></div>
<div class="rel">
<a href="https://jupyter.readthedocs.io/en/latest/install.html" target="_blank">Install</a> ·
<a href="documentation.html">Documentation</a> ·
<a href="project.html">Project</a> ·
<a href="https://jupyter.org/" target="_blank">Jupyter</a> ·
<a href="news.html">News</a> ·
<a href="citing.html">Cite</a> ·
<a href="donate.html">Donate</a> ·
<a href="books.html">Books</a>
</div>
</div>
</div>
<div class="content-wrapper">
<div class="content">
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<div class="sidebarblock">
<h3>Notebook Viewer</h3>
Share your notebooks
<div class="nbviewer-thm-random">
<script src="_static/nbviewer_thm.js"></script>
<script type="text/javascript">
nbviewer_random_thumbnail();
</script>
</div>
</div>
<div class="sidebarblock">
<h3>Community</h3>
<ul class="simple">
<li><a class="reference external" href="http://stackoverflow.com/questions/tagged/ipython">
Stack Overflow</a></li>
<li><a class="reference external" href="https://github.com/ipython/ipython/issues">
File a bug</a></li>
<li><a class="reference external" href="http://www.reddit.com/r/IPython">
Reddit</a></li>
</ul>
</div>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="faq">
<h1>FAQ<a class="headerlink" href="#faq" title="Link to this heading">¶</a></h1>
<p>If your question isn’t answered below, check <a class="reference external" href="https://ipython.org/ipython-doc/">the docs</a>, then ask on the <a class="reference external" href="https://mail.python.org/mailman/listinfo/ipython-dev">mailing list</a>.</p>
<nav class="contents local" id="contents">
<ul class="simple">
<li><p><a class="reference internal" href="#can-ipython-run-under-ironpython-pypy-jython-other-python-interpreters" id="id1">Can IPython run under IronPython/PyPy/Jython/other Python interpreters?</a></p></li>
<li><p><a class="reference internal" href="#ipython-crashes-under-os-x-when-using-the-arrow-keys" id="id2">IPython crashes under OS X when using the arrow keys</a></p></li>
<li><p><a class="reference internal" href="#does-ipython-play-well-with-windows" id="id3">Does IPython play well with Windows?</a></p></li>
<li><p><a class="reference internal" href="#what-is-the-best-way-to-install-ipython" id="id4">What is the best way to install IPython?</a></p></li>
</ul>
</nav>
<section id="can-ipython-run-under-ironpython-pypy-jython-other-python-interpreters">
<h2>Can IPython run under IronPython/PyPy/Jython/other Python interpreters?<a class="headerlink" href="#can-ipython-run-under-ironpython-pypy-jython-other-python-interpreters" title="Link to this heading">¶</a></h2>
<p>The terminal-based shell should run on any interpreter which complies with
the necessary version of Python. IPython 0.11 requires Python 2.6
or above, and as of June 2011, IronPython and PyPy both support this.</p>
<p>The most likely problems would come from Readline and from using the undocumented
sys._getframe() function. On Windows we ship our own <a class="reference external" href="pyreadline.html">pyreadline</a>,
which might also work under IronPython. PyPy ships its own readline module,
which should now work.</p>
<p>If IPython does not work under a supported interpreter, please
<a class="reference external" href="https://github.com/ipython/ipython/issues">file a bug</a>.</p>
</section>
<section id="ipython-crashes-under-os-x-when-using-the-arrow-keys">
<h2>IPython crashes under OS X when using the arrow keys<a class="headerlink" href="#ipython-crashes-under-os-x-when-using-the-arrow-keys" title="Link to this heading">¶</a></h2>
<p>Under some circumstances, using the arrow keys to navigate your input history can cause a complete crash of the Python interpreter.</p>
<p><strong>Answer:</strong> This is due to a bug in the readline library from the official builds. There are a few solutions you can take:</p>
<blockquote>
<div><ol class="arabic">
<li><p>Use a different Python version from Apple’s default (MacPython or Fink have been reported to work)</p></li>
<li><p>You can disable in your ipythonrc file the following lines by commenting them out:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">readline_parse_and_bind</span> <span class="s2">"\e[A"</span><span class="p">:</span> <span class="n">history</span><span class="o">-</span><span class="n">search</span><span class="o">-</span><span class="n">backward</span>
<span class="n">readline_parse_and_bind</span> <span class="s2">"\e[B"</span><span class="p">:</span> <span class="n">history</span><span class="o">-</span><span class="n">search</span><span class="o">-</span><span class="n">forward</span>
</pre></div>
</div>
</li>
</ol>
</div></blockquote>
<p>You will lose searching in your history with the arrow keys, but at least Python won’t crash.</p>
</section>
<section id="does-ipython-play-well-with-windows">
<h2>Does IPython play well with Windows?<a class="headerlink" href="#does-ipython-play-well-with-windows" title="Link to this heading">¶</a></h2>
<p>Yes, it most definitely does! There are some things that should be noted: <a class="reference external" href="https://ipython.org/ipython-doc/stable/install/install.html#windows">see
the installation documentation</a>.</p>
</section>
<section id="what-is-the-best-way-to-install-ipython">
<h2>What is the best way to install IPython?<a class="headerlink" href="#what-is-the-best-way-to-install-ipython" title="Link to this heading">¶</a></h2>
<p>See <a class="reference external" href="https://ipython.org/ipython-doc/stable/install/install.html#installing-ipython-itself">the installation documentation</a> for full details.</p>
<p>The standard Python installation mechanisms (<code class="docutils literal notranslate"><span class="pre">setup.py</span></code>, <code class="docutils literal notranslate"><span class="pre">pip</span></code> or <code class="docutils literal notranslate"><span class="pre">easy_install</span></code>) all work for installing IPython to use in a terminal. Windows users are best off installing <a class="reference external" href="https://pypi.python.org/pypi/distribute">distribute</a>, then running the .exe installer, to create start menu shortcuts.</p>
<p>To use the notebook or the Qt console, it’s easiest to install through a package manager, or download a Python distribution such as <a class="reference external" href="https://store.continuum.io/cshop/anaconda">Anaconda</a> or <a class="reference external" href="https://www.enthought.com/downloads/">Enthought Canopy</a>. Otherwise, you will need to install pyzmq, along with tornado for the notebook, and PyQt4/PySide and pygments for the Qt console.</p>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
</div>
<div class="footer-wrapper">
<div class="footer" role="contentinfo">
© Copyright the IPython development team. Python is trademark of the Python Software Foundation.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
</div>
</div>
</body>
</html>