|
@@
-1,33
+1,92
b''
|
|
1
|
=====================
|
|
1
|
=====================
|
|
2
|
Development version
|
|
2
|
Development version
|
|
3
|
=====================
|
|
3
|
=====================
|
|
4
|
|
|
4
|
|
|
5
|
This document describes in-flight development work.
|
|
5
|
This document describes in-flight development work.
|
|
6
|
|
|
6
|
|
|
7
|
.. warning::
|
|
7
|
.. warning::
|
|
8
|
|
|
8
|
|
|
9
|
Please do not edit this file by hand (doing so will likely cause merge
|
|
9
|
Please do not edit this file by hand (doing so will likely cause merge
|
|
10
|
conflicts for other Pull Requests). Instead, create a new file in the
|
|
10
|
conflicts for other Pull Requests). Instead, create a new file in the
|
|
11
|
`docs/source/whatsnew/pr` folder
|
|
11
|
`docs/source/whatsnew/pr` folder
|
|
12
|
|
|
12
|
|
|
13
|
|
|
13
|
|
|
14
|
Released .... ...., 2017
|
|
14
|
Released .... ...., 2017
|
|
15
|
|
|
15
|
|
|
16
|
|
|
16
|
|
|
17
|
Need to be updated:
|
|
17
|
Need to be updated:
|
|
18
|
|
|
18
|
|
|
19
|
.. toctree::
|
|
19
|
.. toctree::
|
|
20
|
:maxdepth: 2
|
|
20
|
:maxdepth: 2
|
|
21
|
:glob:
|
|
21
|
:glob:
|
|
22
|
|
|
22
|
|
|
23
|
pr/*
|
|
23
|
pr/*
|
|
24
|
|
|
24
|
|
|
25
|
|
|
25
|
|
|
26
|
|
|
26
|
|
|
|
|
|
27
|
Prompt Rendering Performance improvements
|
|
|
|
|
28
|
=========================================
|
|
|
|
|
29
|
|
|
|
|
|
30
|
Pull Request :ghpull:`11933` introduced an optimisation in the prompt rendering
|
|
|
|
|
31
|
logic that should decrease the resource usage of IPython when using the
|
|
|
|
|
32
|
_default_ configuration but could potentially introduce a regression of
|
|
|
|
|
33
|
functionalities if you are using a custom prompt.
|
|
|
|
|
34
|
|
|
|
|
|
35
|
We know assume if you haven't changed the default keybindings that the prompt
|
|
|
|
|
36
|
**will not change** during the duration of your input – which is for example
|
|
|
|
|
37
|
not true when using vi insert mode that switches between `[ins]` and `[nor]`
|
|
|
|
|
38
|
for the current mode.
|
|
|
|
|
39
|
|
|
|
|
|
40
|
If you are experiencing any issue let us know.
|
|
|
|
|
41
|
|
|
|
|
|
42
|
Code autoformatting
|
|
|
|
|
43
|
===================
|
|
|
|
|
44
|
|
|
|
|
|
45
|
The IPython terminal can now auto format your code just before entering a new
|
|
|
|
|
46
|
line or executing a command. To do so use the
|
|
|
|
|
47
|
``--TerminalInteractiveShell.autoformatter`` option and set it to ``'black'``;
|
|
|
|
|
48
|
if black is installed IPython will use black to format your code when possible.
|
|
|
|
|
49
|
|
|
|
|
|
50
|
IPython cannot always properly format your code; in particular it will
|
|
|
|
|
51
|
auto formatting with *black* will only work if:
|
|
|
|
|
52
|
|
|
|
|
|
53
|
- Your code does not contains magics or special python syntax.
|
|
|
|
|
54
|
|
|
|
|
|
55
|
- There is no code after your cursor.
|
|
|
|
|
56
|
|
|
|
|
|
57
|
The Black API is also still in motion; so this may not work with all versions of
|
|
|
|
|
58
|
black.
|
|
|
|
|
59
|
|
|
|
|
|
60
|
It should be possible to register custom reformatter, though the API is till in
|
|
|
|
|
61
|
flux.
|
|
|
|
|
62
|
|
|
|
|
|
63
|
Arbitrary Mimetypes Handing in Terminal
|
|
|
|
|
64
|
=======================================
|
|
|
|
|
65
|
|
|
|
|
|
66
|
When using IPython terminal it is now possible to register function to handle
|
|
|
|
|
67
|
arbitrary mimetypes. While rendering non-text based representation was possible in
|
|
|
|
|
68
|
many jupyter frontend; it was not possible in terminal IPython, as usually
|
|
|
|
|
69
|
terminal are limited to displaying text. As many terminal these days provide
|
|
|
|
|
70
|
escape sequences to display non-text; bringing this loved feature to IPython CLI
|
|
|
|
|
71
|
made a lot of sens. This functionality will not only allow inline images; but
|
|
|
|
|
72
|
allow opening of external program; for example ``mplayer`` to "display" sound
|
|
|
|
|
73
|
files.
|
|
|
|
|
74
|
|
|
|
|
|
75
|
So far only the hooks necessary for this are in place, but no default mime
|
|
|
|
|
76
|
renderers added; so inline images will only be available via extensions. We will
|
|
|
|
|
77
|
progressively enable these features by default in the next few releases, and
|
|
|
|
|
78
|
contribution is welcomed.
|
|
|
|
|
79
|
|
|
|
|
|
80
|
We welcome any feedback on the API. See :ref:`shell_mimerenderer` for more
|
|
|
|
|
81
|
informations.
|
|
|
|
|
82
|
|
|
|
|
|
83
|
This is originally based on work form in :ghpull:`10610` from stephanh42
|
|
|
|
|
84
|
started over two years ago, and still a lot need to be done.
|
|
|
|
|
85
|
|
|
27
|
.. DO NOT EDIT THIS LINE BEFORE RELEASE. FEATURE INSERTION POINT.
|
|
86
|
.. DO NOT EDIT THIS LINE BEFORE RELEASE. FEATURE INSERTION POINT.
|
|
28
|
|
|
87
|
|
|
29
|
|
|
88
|
|
|
30
|
Backwards incompatible changes
|
|
89
|
Backwards incompatible changes
|
|
31
|
------------------------------
|
|
90
|
------------------------------
|
|
32
|
|
|
91
|
|
|
33
|
.. DO NOT EDIT THIS LINE BEFORE RELEASE. INCOMPAT INSERTION POINT.
|
|
92
|
.. DO NOT EDIT THIS LINE BEFORE RELEASE. INCOMPAT INSERTION POINT.
No newline at end of file
|