upstream/ipython Commit - r10135:eee3d3bf

1

=====================

1

=====================

2

Development version

2

Development version

3

=====================

3

=====================

4

5

This document describes in-flight development work.

5

This document describes in-flight development work.

6

7

The CodeMirror js library has been updated fron 2.23 to 2.32

7

The CodeMirror js library has been updated fron 2.23 to 2.32

8

this might induce a few changes in behavior of keymaps in the notebook,

8

this might induce a few changes in behavior of keymaps in the notebook,

9

especially intenting/deindenting blocks that is now bound to Ctrl+] and ctr+[

9

especially intenting/deindenting blocks that is now bound to Ctrl+] and ctr+[

10

11

* Exception types can now be displayed with a custom traceback, by defining a

11

* Exception types can now be displayed with a custom traceback, by defining a

12

``_render_traceback_()`` method which returns a list of strings, each

12

``_render_traceback_()`` method which returns a list of strings, each

13

containing one line of the traceback.

13

containing one line of the traceback.

14

* A new command, ``ipython history trim`` can be used to delete everything but

14

* A new command, ``ipython history trim`` can be used to delete everything but

15

the last 1000 entries in the history database.

15

the last 1000 entries in the history database.

16

17

In-process kernels

17

In-process kernels

18

------------------

18

------------------

19

20

The Python-language frontends, particularly the Qt console, may now communicate

20

The Python-language frontends, particularly the Qt console, may now communicate

21

with in-process kernels, in addition to the traditional out-of-process

21

with in-process kernels, in addition to the traditional out-of-process

22

kernels. An in-process kernel permits direct access to the kernel namespace,

22

kernels. An in-process kernel permits direct access to the kernel namespace,

23

which is necessary in some applications. It should be understood, however, that

23

which is necessary in some applications. It should be understood, however, that

24

the in-process kernel is not robust to bad user input and will block the main

24

the in-process kernel is not robust to bad user input and will block the main

25

(GUI) thread while executing. Developers must decide on a case-by-case basis

25

(GUI) thread while executing. Developers must decide on a case-by-case basis

26

whether this tradeoff is appropriate for their application.

26

whether this tradeoff is appropriate for their application.

27

28

Backwards incompatible changes

28

Backwards incompatible changes

29

------------------------------

29

------------------------------

30

31

* Calling :meth:`InteractiveShell.prefilter` will no longer perform static

31

* Calling :meth:`InteractiveShell.prefilter` will no longer perform static

32

transformations - the processing of escaped commands such as ``%magic`` and

32

transformations - the processing of escaped commands such as ``%magic`` and

33

``!system``, and stripping input prompts from code blocks. This functionality

33

``!system``, and stripping input prompts from code blocks. This functionality

34

was duplicated in :mod:`IPython.core.inputsplitter`, and the latter version

34

was duplicated in :mod:`IPython.core.inputsplitter`, and the latter version

35

was already what IPython relied on. A new API to transform input will be ready

35

was already what IPython relied on. A new API to transform input will be ready

36

before release.

36

before release.

37

* Functions from :mod:`IPython.lib.inputhook` to control integration with GUI

37

* Functions from :mod:`IPython.lib.inputhook` to control integration with GUI

38

event loops are no longer exposed in the top level of :mod:`IPython.lib`.

38

event loops are no longer exposed in the top level of :mod:`IPython.lib`.

39

Code calling these should make sure to import them from

39

Code calling these should make sure to import them from

40

:mod:`IPython.lib.inputhook`.

40

:mod:`IPython.lib.inputhook`.

41

* For all kernel managers, the ``sub_channel`` attribute has been renamed to

41

* For all kernel managers, the ``sub_channel`` attribute has been renamed to

42

``iopub_channel``.

42

``iopub_channel``.

43

* Users on Python versions before 2.6.6, 2.7.1 or 3.2 will now need to call

44

:func:`IPython.utils.doctestreload.doctest_reload` to make doctests run

45

correctly inside IPython. Python releases since those versions are unaffected.

46

For details, see :ghpull:`3068` and `Python issue 8048 <http://bugs.python.org/issue8048>`_.

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             =====================
              Development version
             =====================
             This document describes in-flight development work.
             The CodeMirror js library has been updated fron 2.23 to 2.32
             this might induce a few changes in behavior of keymaps in the notebook,
             especially intenting/deindenting blocks that is now bound to Ctrl+] and ctr+[
             * Exception types can now be displayed with a custom traceback, by defining a
               ``_render_traceback_()`` method which returns a list of strings, each
               containing one line of the traceback.
             * A new command, ``ipython history trim`` can be used to delete everything but
               the last 1000 entries in the history database.
             In-process kernels
             ------------------
             The Python-language frontends, particularly the Qt console, may now communicate
             with in-process kernels, in addition to the traditional out-of-process
             kernels. An in-process kernel permits direct access to the kernel namespace,
             which is necessary in some applications. It should be understood, however, that
             the in-process kernel is not robust to bad user input and will block the main
             (GUI) thread while executing. Developers must decide on a case-by-case basis
             whether this tradeoff is appropriate for their application.
             Backwards incompatible changes
             ------------------------------
             * Calling :meth:`InteractiveShell.prefilter` will no longer perform static
               transformations - the processing of escaped commands such as ``%magic`` and
               ``!system``, and stripping input prompts from code blocks. This functionality
               was duplicated in :mod:`IPython.core.inputsplitter`, and the latter version
               was already what IPython relied on. A new API to transform input will be ready
               before release.
             * Functions from :mod:`IPython.lib.inputhook` to control integration with GUI
               event loops are no longer exposed in the top level of :mod:`IPython.lib`.
               Code calling these should make sure to import them from
               :mod:`IPython.lib.inputhook`.
             * For all kernel managers, the ``sub_channel`` attribute has been renamed to
               ``iopub_channel``.
+            * Users on Python versions before 2.6.6, 2.7.1 or 3.2 will now need to call
+              :func:`IPython.utils.doctestreload.doctest_reload` to make doctests run
+              correctly inside IPython. Python releases since those versions are unaffected.
+              For details, see :ghpull:`3068` and `Python issue 8048 <http://bugs.python.org/issue8048>`_.