##// END OF EJS Templates
Update docs/source/whatsnew/version8.rst
M Bussonnier -
Show More
@@ -1,2360 +1,2360
1 1 ============
2 2 8.x Series
3 3 ============
4 4 .. _version 8.27:
5 5
6 6 IPython 8.27
7 7 ============
8 8
9 9 New release of IPython after a month off (not enough changes). We can see a few
10 10 important changes for this release.
11 11
12 12 - autocall was beeing call getitem, :ghpull:`14486`
13 13 - Only copy files in startup dir if we just created it. :ghpull:`14497`
14 14 - Fix some tests on Python 3.13 RC1 :ghpull:`14504`; this one I guess make this
15 15 the first IPython release officially compatible with Python 3.13; you will
16 16 need the most recent ``executing`` and ``stack_data``, we won't pin to avoid
17 17 forcing user of older Python version to upgrade.
18 18
19 19
20 20 As usual you can find the full list of PRs on GitHub under `the 8.27
21 21 <https://github.com/ipython/ipython/milestone/134?closed=1>`__ milestone.
22 22
23 23 Thanks
24 24 ------
25 25
26 26 Many thanks to `@Kleirre <https://github.com/Kleirre>`__ our June intern for
27 27 doing her first contribution to open source, doing the releases notes and
28 28 release. I guess you didn't even notice it was not me who released :-). I wish
29 29 her all the best in her future endeavor and look forward for her work in
30 30 astrophysics.
31 31
32 32 Thanks as well to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
33 33 work on IPython and related libraries.
34 34
35 35 .. _version 8.26:
36 36
37 37 IPython 8.26
38 38 ============
39 39
40 40 Hey, the release of IPython for this month is here! (I know you were waiting for it)
41 41
42 42 - :ghpull:`14453` bugfix for call to structured_traceback
43 43
44 44 - :ghpull:`14466` fixed honoring custom repr for NamedTuple if assigned by partialmethod
45 45
46 46 - :ghpull:`14451` Convert matplotlib gui name in enable_gui
47 47
48 48 As usual you can find the full list of PRs on GitHub under `the 8.26
49 49 <https://github.com/ipython/ipython/milestone/133?closed=1>`__ milestone.
50 50
51 51 Thanks
52 52 ------
53 53
54 54 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
55 55 work on IPython and related libraries.
56 56
57 57
58 58 .. _version 8.25:
59 59
60 60 IPython 8.25
61 61 ============
62 62
63 63 Mostly internal changes for this end of may release of IPython.
64 64
65 65 We'll count about a dozen PRs for this moth, with small bugfixes related to
66 66 matplotlib fixes.
67 67
68 68 Of notable interest,
69 69
70 70 - :ghpull:`14426` replaces the unicode micro symbol with greek letter mu,
71 71 visually identical but should fix nfkc normalisations issues.
72 72
73 73 - :ghpull:`14444` introduces ``intersphinx_registry`` as a new dependency
74 74 which is recommended only to build documentation.
75 75
76 76 As usual you can find the full list of PRs on GitHub under `the 8.25
77 77 <https://github.com/ipython/ipython/milestone/132?closed=1>`__ milestone.
78 78
79 79 Thanks
80 80 ------
81 81
82 82 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
83 83 work on IPython and related libraries.
84 84
85 85
86 86 .. _version 8.24:
87 87
88 88 IPython 8.24
89 89 ============
90 90
91 91 Back on regular release schedule, as usual month releases are relatively tiny.
92 92
93 93 The biggest change is the move of the matplotlib backend handling from IPython
94 94 to matplotlib. :ghpull:`14371` :ghpull:`14403`.
95 95
96 96 We will note:
97 97
98 98 - pytest 8 compatibility :ghpull:`14413`
99 99 - ``typing-extension`` now needs 4.6 or newer. It was already the case, but not
100 100 explicated. :ghpull:`14380`
101 101 - Attempt to speed running code under debugger in some cases. :ghpull:`14386`
102 102 :ghpull:`14418`.
103 103 - Multiple fixes to documentation for ipyparallel, simple_prompt and emacs
104 104 :ghpull:`14384` :ghpull:`14404` :ghpull:`14407`
105 105 - Maintenance and cleanup of debugger :ghpull:`14387` :ghpull:`14393`
106 106
107 107 As usual you can find the full list of PRs on GitHub under `the 8.24
108 108 <https://github.com/ipython/ipython/milestone/131?closed=1>`__ milestone.
109 109
110 110 Thanks
111 111 ------
112 112
113 113 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
114 114 work on IPython and related libraries.
115 115
116 116
117 117 .. _version 8.23:
118 118
119 119 IPython 8.23
120 120 ============
121 121
122 122 Super tiny release of IPython on Sunday – a bit later than usual, which is also
123 123 `πŸ³οΈβ€βš§οΈ International Transgender Day of VisibilityπŸ³οΈβ€βš§οΈ
124 124 <https://en.wikipedia.org/wiki/International_Transgender_Day_of_Visibility>`_ –
125 125 so a though for you on this day, you matter and you are valid [1]_.
126 126
127 127 This is a minuscule release with only 5 Pull requests.
128 128
129 129 Main change is :ghpull:`14357` which improve inference from return type
130 130 annotations in completer and the introduction of the optional target
131 131 ``ipython[matplotlib]`` to explicitly request the matplotlib optional
132 132 dependencies.
133 133
134 134 As usual you can find the full list of PRs on GitHub under `the 8.23
135 135 <https://github.com/ipython/ipython/milestone/130?closed=1>`__ milestone.
136 136
137 137 Thanks
138 138 ------
139 139
140 140 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
141 141 work on IPython and related libraries.
142 142
143 143
144 144 .. _version 8.22:
145 145
146 146 IPython 8.22, 8.22.1 and 8.22.2
147 147 ===============================
148 148
149 149 Quick release of IPython for this short month of February, with quite a bit of
150 150 activity with more than 15 PRs.
151 151
152 152 I am not going to details all the changes, but among other we have :
153 153
154 154 - More compatibility with emscripten :ghpull:`14316`, :ghpull:`14318`,
155 155 - Test more downstream project to avoid breakage :ghpull:`14317`
156 156 - Fix recently introduced bug with the ``store`` magic.
157 157 - Fix issues with multiple call to ``matplotlib.pyplot.switch_backend``
158 158 - Fix crashing IPython when some tracebacks encounter dynamically evaluated
159 159 code.
160 160
161 161 IPython 8.22.1 increase the minimal traitlets version, and 8.22.2 fix a critical
162 162 bug on emscripten preventing to use some magics like ``%matplotlib`` on
163 163 jupyter-light.
164 164
165 165 API changes
166 166 -----------
167 167
168 168 One of the largest change is the update the mimehooks and inspector API, see
169 169 :ghpull:`14342`. It should be backward compatible, but many hooks now receive a
170 170 single object with many fields allowing us flexibility to update the API later.
171 171
172 172
173 173 Packaging changes
174 174 -----------------
175 175
176 176 Thanks to `@mkoppe <https://github.com/mkoeppe>`__, we are slowly getting rid of
177 177 setup.py finally migrating to ``pyproject.toml``. There is still quite a bit of
178 178 work, and please open an issue if you encounter any problem.
179 179
180 180
181 181 Deprecation
182 182 -----------
183 183
184 184 A number of unused functions have been marked deprecated or pending deprecation.
185 185 Please let us know if you encounter any of those deprecation messages for us to
186 186 adjust the removal timeline.
187 187
188 188
189 189 Thanks
190 190 ------
191 191
192 192 Many thanks to `@mkoppe <https://github.com/mkoeppe>`__ and `@krassowski
193 193 <https://github.com/krassowski>`__ for their multiple contributions and codebase
194 194 cleanup.
195 195
196 196 As usual you can find the full list of PRs on GitHub under `the 8.22
197 197 <https://github.com/ipython/ipython/milestone/129?closed=1>`__ milestone.
198 198
199 199 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
200 200 work on IPython and related libraries.
201 201
202 202
203 203 .. _version 8.21:
204 204
205 205 IPython 8.21
206 206 ------------
207 207
208 208 More substantial release of IPython slightly out of schedule as it was not
209 209 possible for me to make a release last Friday.
210 210
211 211 Few new features are present, but the codebase has been cleaned, and a couple
212 212 of API are _considered_ for deprecation. They are not deprecated yet, but as
213 213 they do not seem to be quite used, they may emit a warning, in which case please
214 214 comment on the relevant issue to inform me of _which_ project use those feature
215 215 and how you use them. Depending on the feedback I might change the timeline for
216 216 deprecation.
217 217
218 218 This release saw 14 PRs, with more outside contribution than usual,
219 219 I'll note in particular PRs related to making IPython work on emscripten.
220 220
221 221 I also want to point that we are _trying_ to keep compatibility with Python 3.13,
222 222 but it's a cat and mouse game. Plus I am low on time, so I would appreciate any
223 223 help with that.
224 224
225 225 Deprecations
226 226 ~~~~~~~~~~~~
227 227
228 228 - :ghpull:`14307` Pending Deprecation of
229 229 ``ColorSchemeTable.set_active_scheme(...)``'s ``case_sensitive`` Parameter.
230 230 - :ghpull:`14305` Pending Deprecation of constructing ``ColorScheme`` via
231 231 ``kwargs``, in favor passing a single dict.
232 232
233 233
234 234 Fixes
235 235 ~~~~~
236 236
237 237 - :ghpull:`14284` TerminalIPythonApp's would warn that ``auto_create`` option is not
238 238 recognized.
239 239 - :ghpull:`14286` Fix a crash with ``NotOneValueFound`` when rendering complex
240 240 tracebacks.
241 241
242 242 - :ghpull:`14287` Partial Python 3.13 compatibility
243 243 - :ghpull:`14290` Docs/Typos.
244 244
245 245 Changes
246 246 ~~~~~~~
247 247
248 248 - :ghpull:`14289` ``ipdb.set_trace()`` now accepts ``header=`` for better
249 249 compatibility with ``pdb.set_trace()``
250 250
251 251 - :ghpull:`14300` and :ghpull:`14301` Add hooking ability to produce
252 252 mimebundle.
253 253
254 254 We'll outline :ghpull:`14300`, it is now possible to extend the ``?/??``
255 255 operator to return more mimetypes to render richer help in frontends that
256 256 support it. In particular you could send a json representation of the help that
257 257 could be displayed in a customizable way.
258 258
259 259 Miscellaneous
260 260 ~~~~~~~~~~~~~
261 261
262 262 - :ghpull:`14291` Misc Refactor of Color handling
263 263 - :ghpull:`14295` Misc test skip on problematic Pypy versions.
264 264
265 265
266 266 Thanks
267 267 ~~~~~~
268 268
269 269 Special thanks to all our contributors, and to the Pypy team that was extremely
270 270 reactive in helping to investigate a fixing a rare unicode+windows bug.
271 271
272 272 As usual you can find the full list of PRs on GitHub under `the 8.21
273 273 <https://github.com/ipython/ipython/milestone/128?closed=1>`__ milestone.
274 274
275 275 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
276 276 work on IPython and related libraries.
277 277
278 278
279 279 .. _version 8.20:
280 280
281 281 IPython 8.20
282 282 ------------
283 283
284 284 Quick IPython release in this beginning of 2024, barely 2 weeks after the previous
285 285 release.
286 286
287 287 This is mostly to fix a backward compatibility issue, I would have done a patch
288 288 release earlier if I could. As a few other cleanup are also part of this
289 289 release, this will get a minor version bump.
290 290
291 291
292 292 The crux of this release is :ghpull:`14274` (Inspect continuation prompt
293 293 signature and pass only viable arguments), the rest of the changes are mostly
294 294 type annotation, and a few compatibility issues with Python 3.13 that are
295 295 getting addressed.
296 296
297 297 Python 3.13 compatibility is still not complete (help welcomed).
298 298
299 299 As usual you can find the full list of PRs on GitHub under `the 8.20
300 300 <https://github.com/ipython/ipython/milestone/127?closed=1>`__ milestone.
301 301
302 302 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
303 303 work on IPython and related libraries.
304 304
305 305
306 306 .. _version 8.19:
307 307
308 308 IPython 8.19
309 309 ------------
310 310
311 311 New release of IPython a bit before the end of the month, and end of the year.
312 312
313 313 Mostly cleanup and deprecation, due to upstream deprecation and removal.
314 314
315 315 Remove of Python 3.9 support
316 316 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
317 317
318 318 A bit later than originally plan, IPython 8.19 does not support Python 3.9
319 319 anymore, as well as the few conditional code that were executing only on Python
320 320 3.9. :ghpull:`14254`
321 321
322 322 We used the opportunity to deprecate ``IPython.utils.tz`` :ghpull:`14256`, due
323 323 to upstream deprecation of some timezone utilities. It will be removed at a later
324 324 date.
325 325
326 326 We now also run CI on Python 3.12 (what I likely should have done before), but
327 327 running on too many Python version uses a lot of CI time.
328 328
329 329 Absolute and relative Line Numbers in Prompts
330 330 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
331 331
332 332 Thanks to the contribution of ``cohml``, IPython CLI now support absolute and
333 333 relative line numbers in both vi and emacs prompt, use for example
334 334 ``c.TerminalInteractiveShell.prompt_line_number_format='{line: 4d}/{rel_line:+03d} | '``
335 335 configuration option to display both in a custom format.
336 336
337 337 Miscellaneous
338 338 ~~~~~~~~~~~~~
339 339
340 340 In addition to various bugfixes, I unpinned pytest, let me know if there are any
341 341 issues and we'll re-pin.
342 342
343 343 See you in 2024
344 344 ~~~~~~~~~~~~~~~
345 345
346 346 As usual you can find the full list of PRs on GitHub under `the 8.19
347 347 <https://github.com/ipython/ipython/milestone/126?closed=1>`__ milestone.
348 348
349 349 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
350 350 work on IPython and related libraries.
351 351
352 352 .. _version 8.18:
353 353
354 354 IPython 8.18 and 8.18.1
355 355 -----------------------
356 356
357 357 8.18.1 is identical to 8.18 but pin ``prompt_toolkit`` to greater than ``3.0.41``
358 358
359 359 Small release of IPython that fixes a small number of inconveniences.
360 360
361 361 - :ghpull:`14251` Fix a memory leak in qt event loop integration by setting
362 362 the Loop parent to None.
363 363 - :ghpull:`14252` Pickleshare was made an optional dependency in 8.17, this
364 364 leads to warnings in some installations when using modules completions. The
365 365 warning has been silenced.
366 366 - :ghpull:`14241` Update event loop code for compatibility with more recent
367 367 ``prompt_toolkit`` due to deprecations in Python 3.12.
368 368 - :ghpull:`14245` Fix doc example on Pygments styles
369 369 - :ghpull:`14238` Remove dependency on app_nope, this is actually only a
370 370 dependency of IPykernel.
371 371
372 372 As usual you can find the full list of PRs on GitHub under `the 8.18
373 373 <https://github.com/ipython/ipython/milestone/125?closed=1>`__ milestone.
374 374
375 375 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
376 376 work on IPython and related libraries.
377 377
378 378 .. _version 8.17.1:
379 379 .. _version 8.17:
380 380
381 381 IPython 8.17, 8.17.1
382 382 --------------------
383 383
384 384 Medium-sized release of IPython that includes some cleanup (backcall, python2 leftovers)
385 385 and some refactoring improvements (typing, pathlib) and a fix on completion.
386 386
387 387 - :ghpull:`14216` remove backcall dependency
388 388 - :ghpull:`14217` make pickleshare dependency optional
389 389 - :ghpull:`14185` support completion based on type annotations of calls
390 390
391 391 Reverted in 8.17.1:
392 392
393 393 - :ghpull:`14190` remove support for python 2 in lexers (reverted in 8.17.1 as it is imported by qtconsole/spyder)
394 394
395 395
396 396 Mamba and Micromamba magic commands
397 397 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
398 398
399 399 In addition to the ``%conda`` magic command for calling ``conda`` in IPython,
400 400 the ``%mamba`` and ``%micromamba`` magic commands now
401 401 call ``mamba`` and ``micromamba`` if they are on ``sys.path``.
402 402
403 .. code:: python
403 .. code::
404 404
405 405 %mamba install pkgname
406 406 %micromamba install pkgname
407 407 %conda install pkgname
408 408 %pip install pkgname
409 409
410 410 %mamba --help
411 411 %micromamba --help
412 412 %conda --help
413 413 %pip --help # works w/ JupyterLite
414 414 !pip --help
415 415
416 416
417 417 :ghpull:`14191`
418 418
419 419 ----
420 420
421 421 As usual you can find the full list of PRs on GitHub under `the 8.17
422 422 <https://github.com/ipython/ipython/milestone/123?closed=1>`__ milestone.
423 423
424 424 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
425 425 work on IPython and related libraries.
426 426
427 427 .. _version 8.16:
428 428 .. _version 8.16.1:
429 429
430 430 IPython 8.16, 8.16.1
431 431 --------------------
432 432
433 433 Small double release of IPython (with the 8.12.3 release notes just below).
434 434 Mostly bug fixes and cleanups, and type annotations. Of interest for users:
435 435
436 436 - :ghpull:`14153` Fix a bug of the new iPdb chained traceback where some
437 437 Exception would not have any traceback. (see upstream fix in CPython for more
438 438 details).
439 439 - :ghpull:`14168` Fix case with spurious message about event loops when using
440 440 matplotlib.
441 441
442 442 This PR is in 8.16.0 but reverted in 8.16.1, we'll rework the fix for 8.17
443 443
444 444 - :ghpull:`14163` Fix an error where semicolon would not suppress output.
445 445
446 446 As usual you can find the full list of PRs on GitHub under `the 8.16
447 447 <https://github.com/ipython/ipython/milestone/121?closed=1>`__ and `8.16.1 milestone
448 448 <https://github.com/ipython/ipython/milestone/124?closed=1>`__.
449 449
450 450 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
451 451 work on IPython and related libraries.
452 452
453 453 .. _version 8.12.3:
454 454
455 455 IPython 8.12.3
456 456 --------------
457 457
458 458 Tiny release of 8.12.3 that backport a small number of fixes for users still
459 459 using Python 3.8.
460 460
461 461 - :ghpull:`14080` add passthrough filter shortcuts
462 462 - :ghpull:`14169` Fix `InteractiveShellEmbed`
463 463
464 464 .. _version 8.15:
465 465
466 466 IPython 8.15
467 467 ------------
468 468
469 469 Medium release of IPython after a couple of month hiatus, and a bit
470 470 off-schedule.
471 471
472 472 Among other, IPython 8.15:
473 473
474 474 - Improve compatibility with future version of Python 3.12/3.13
475 475 :ghpull:`14107`, :ghpull:`14139`,
476 476 - Improve support for ``ExceptionGroups``, :ghpull:`14108`
477 477 - Fix hangs in ``%gui osx``, :ghpull:`14125`
478 478 - Fix memory lead with ``%reset``, :ghpull:`14133`
479 479 - Unstable config option to modify traceback highlighting that is sometime hard
480 480 to read :ghpull:`14138`
481 481 - Support ``.`` in ``ipdb`` as an argument to the ``list`` command
482 482 :ghpull:`14121`
483 483 - Workroud ``parso`` showing warning message when the default logger level is
484 484 changed :ghpull:`14119`
485 485 - Fix multiple issues with matplotlib interactive mode, qt5/qt6 :ghpull:`14128`
486 486
487 487 Support for PEP-678 Exception Notes
488 488 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
489 489
490 490 Ultratb now shows :pep:`678` notes, improving your debugging experience on
491 491 Python 3.11+ or with libraries such as Pytest and Hypothesis.
492 492
493 493 Native fallback for displaying ExceptionGroup
494 494 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
495 495 ExceptionGroups are now displayed with ``traceback.print_exc``, as a temporary fix until UltraTB properly supports displaying child exceptions.
496 496
497 497
498 498 We have two larger features:
499 499
500 500 AST-based macros
501 501 ~~~~~~~~~~~~~~~~
502 502
503 503 :ghpull:`14100` introduce a new and efficient way to modify each execution block
504 504 (cell) using an template-ast-based transform. Unlike IPython pre and post code
505 505 execution hooks, this actually transform the code that is execute with as
506 506 minimal as possible overhead. While it was already technically possible to
507 507 register ast transformers for IPython this was far from evident.
508 508
509 509 This should make it trivial to hook into IPython to implement custom hooks, that
510 510 for example time or profile your code, catch exceptions to provide error
511 511 messages for students or do any other kind of transformations.
512 512
513 513 In addition to programmatic API there is also a magic to quickly register
514 514 hooks::
515 515
516 516 In [1]: %%code_wrap before_after
517 517 ...: print('before')
518 518 ...: __code__
519 519 ...: print('after')
520 520 ...: __ret__
521 521
522 522 This mean that for any subsequent execution code will be executed.
523 523 You can modify the above to print the date, compute the execution time,
524 524 retry the code in a for loop....
525 525
526 526
527 527 Allow IPdb/Pdb to move between chained exceptions
528 528 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
529 529
530 530 The main change is the addition of the ability to move between chained
531 531 exceptions when using IPdb, this feature was also contributed to upstream Pdb
532 532 and is thus native to CPython in Python 3.13+ Though ipdb should support this
533 533 feature in older version of Python. I invite you to look at the `CPython changes
534 534 and docs <https://github.com/python/cpython/pull/106676>`__ for more details.
535 535
536 536 In short, once in post-mortem debugger (``%debug``), you can use the ipdb
537 537 ``exceptions`` command to switch exceptions, for example:
538 538
539 539 .. code-block:: ipython
540 540
541 541 In [1]: def foo(x):
542 542 ...: try:
543 543 ...: bar(x)
544 544 ...: except Exception as e:
545 545 ...: raise ValueError("foo (): bar failed") from e
546 546 ...:
547 547 ...: def bar(x):
548 548 ...: 1 / X
549 549 ...:
550 550
551 551 In [2]: foo(0)
552 552 ---------------------------------------------------------------------------
553 553 NameError Traceback (most recent call last)
554 554 Cell In[1], line 3, in foo(x)
555 555 2 try:
556 556 ----> 3 bar(x)
557 557 4 except Exception as e:
558 558
559 559 Cell In[1], line 9, in bar(x)
560 560 8 def bar(x):
561 561 ----> 9 1 / X
562 562
563 563 NameError: name 'X' is not defined
564 564
565 565 The above exception was the direct cause of the following exception:
566 566
567 567 ValueError Traceback (most recent call last)
568 568 Cell In[2], line 1
569 569 ----> 1 foo(0)
570 570
571 571 Cell In[1], line 5, in foo(x)
572 572 3 bar(x)
573 573 4 except Exception as e:
574 574 ----> 5 raise ValueError("foo (): bar failed") from e
575 575
576 576 ValueError: foo (): bar failed
577 577
578 578 In [3]: %debug
579 579 > <ipython-input-1-b0bbdc271ffb>(5)foo()
580 580 3 bar(x)
581 581 4 except Exception as e:
582 582 ----> 5 raise ValueError("foo (): bar failed") from e
583 583
584 584 In previous ipdb you could not go into the bar error, now from within pdb you
585 585 can use ``exceptions``:
586 586
587 587 .. code-block:: ipython
588 588
589 589 ipdb> exceptions
590 590 0 NameError("name 'X' is not defined")
591 591 > 1 ValueError('foo (): bar failed')
592 592
593 593 ipdb> exceptions 0
594 594 > <ipython-input-1-b0bbdc271ffb>(9)bar()
595 595 6
596 596 7
597 597 8 def bar(x):
598 598 ----> 9 1 / X
599 599 10
600 600
601 601 ipdb>
602 602
603 603 In particular I want to thank the `D.E. Shaw group <https://www.deshaw.com/>`__
604 604 for suggesting and funding the two largest feature as well as many bug fixes of
605 605 this release.
606 606
607 607 As usual you can find the full list of PRs on GitHub under `the 8.15 milestone
608 608 <https://github.com/ipython/ipython/milestone/120?closed=1>`__.
609 609
610 610
611 611
612 612 .. _version 8.14:
613 613
614 614 IPython 8.14
615 615 ------------
616 616
617 617 Small release of IPython.
618 618
619 619 - :ghpull:`14080` fixes some shortcuts issues.
620 620 - :ghpull:`14056` Add option to ``%autoreload`` to hide errors when reloading code. This will be the default for spyder
621 621 user is my understanding.
622 622 - :ghpull:`14039` (and :ghpull:`14040`) to show exception notes in tracebacks.
623 623
624 624 - :ghpull:`14076` Add option to EventManager to prevent printing
625 625
626 626
627 627 SPEC 0 and SPEC 4
628 628 ~~~~~~~~~~~~~~~~~
629 629
630 630 You've heard about the NEPs, (NumPy enhancement Proposal), having a NEP for something non-numpy specific was sometime confusing.
631 631 Long live the `SPECs <https://scientific-python.org/specs/>`_.
632 632
633 633 We are now trying to follow SPEC 0 (aka old NEP 29) for support of upstream libraries.
634 634
635 635 We also now try to follow SPEC 4 (test and publish nightly on a centralized nightly repository).
636 636 We encourage you to do so as well in order to report breakage, and contribute to the SPEC process !
637 637
638 638
639 639 Python 3.12 compatibility ?
640 640 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
641 641
642 642 Python 3.12 changed its tokenizer to have better support for f-strings and allow arbitrary expression.
643 643 This is a great new feature and performance improvement in Python 3.12.
644 644
645 645 Unfortunately this means the new tokenizer does not support incomplete or invalid Python which will
646 646 break many features of IPython. Thus compatibility of IPython with Python 3.12 is not guarantied.
647 647 It is unclear to which extent IPython is affected, and whether we can/should try to still support magics, shell
648 648 escape (``! ....``), ..., as well as how to do it if we can.
649 649
650 650 In addition even if we there is technical feasibility to do so, it is no clear we have the resources to do it.
651 651 We are thus looking for your help if you can _test_ on Python 3.12 to see to which extent this affects users and which
652 652 features are critical.
653 653
654 654 We are not going to pin IPython to Python ``<3.12`` as otherwise on install pip would downgrade/resolve to IPython 8.13,
655 655 so if you plan to update to Python 3.12 after its release, we encourage for extra care.
656 656
657 657
658 658 .. _version 8.13.1:
659 659 .. _version 8.13.2:
660 660 .. _version 8.12.2:
661 661
662 662 IPython 8.13.1, 8.13.2 and 8.12.2
663 663 ---------------------------------
664 664
665 665 3 quick in succession patch release of IPython in addition to IPython 8.13.0
666 666 having been yanked.
667 667
668 668 IPython 8.13.0 was improperly tagged as still compatible with Python 3.8, and
669 669 still had some mention of compatibility with 3.8. IPython 8.13.1 is identical to
670 670 8.13 but with the exception of being correctly tagged. This release and yank was
671 671 mostly done to fix CI.
672 672
673 673 IPython 8.12.2 and 8.13.2 contain UI fixes, with respect to right arrow not
674 674 working in some case in the terminal, and 8.12.2 contain also a requested
675 675 backport of :ghpull:`14029` (Allow safe access to the ``__getattribute__``
676 676 method of modules) for tab completion.
677 677
678 678 .. _version 8.13:
679 679
680 680 IPython 8.13
681 681 ------------
682 682
683 683 As usual for the end of the month, minor release of IPython. This release is
684 684 significant in that it not only has a number of bugfixes, but also drop support
685 685 for Python 3.8 as per NEP 29 (:ghpull:`14023`).
686 686
687 687 All the critical bugfixes have been backported onto the 8.12.1 release (see
688 688 below). In addition to that went into 8.12.1 you'll find:
689 689
690 690 - Pretty representation for ``Counter`` has been fixed to match the Python one
691 691 and be in decreasing order. :ghpull:`14032`
692 692 - Module completion is better when jedi is disabled :ghpull:`14029`.
693 693 - Improvement of ``%%bash`` magic that would get stuck :ghpull:`14019`
694 694
695 695
696 696 We hope you enjoy this release an will maybe see you at JupyterCon in less than
697 697 two weeks.
698 698
699 699 As usual you can find the full list of PRs on GitHub under `the 8.13 milestone
700 700 <https://github.com/ipython/ipython/milestone/115?closed=1>`__.
701 701
702 702 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
703 703 work on IPython and related libraries.
704 704
705 705
706 706 .. _version 8.12.1:
707 707
708 708 IPython 8.12.1
709 709 --------------
710 710
711 711 This is the twin release of IPython 8.13 that contain only critical UI and bug
712 712 fixes. The next minor version of IPython has dropped support for Python 3.8 – as
713 713 per Nep 29 and this IPython 8.12.x will now only receive bugfixes.
714 714
715 715
716 716 - :ghpull:`14004` Fix a bug introduced in IPython 8.12 that crash when
717 717 inspecting some docstrings.
718 718 - :ghpull:`14010` Fix fast traceback code that was not working in some case.
719 719 - :ghpull:`14014` Fix ``%page`` magic broken in some case.
720 720 - :ghpull:`14026`, :ghpull:`14027` Tweak default shortcut with respect to
721 721 autosuggestions.
722 722 - :ghpull:`14033` add back the ability to use ``.get()`` on OInfo object for
723 723 backward compatibility with h5py (this will be re-deprecated later, and h5py
724 724 will also get a fix).
725 725
726 726 As usual you can find the full list of PRs on GitHub under `the 8.12.1 milestone
727 727 <https://github.com/ipython/ipython/milestone/116?closed=1>`__.
728 728
729 729 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
730 730 work on IPython and related libraries.
731 731
732 732 .. _version 8.12.0:
733 733
734 734 IPython 8.12
735 735 ------------
736 736
737 737 Hopefully slightly early release for IPython 8.12. Last Thursday of the month,
738 738 even if I guess it's likely already Friday somewhere in the pacific ocean.
739 739
740 740 A number of PRs and bug fixes this month with close to 20 PRs merged !
741 741
742 742
743 743 The IPython repo reached :ghpull:`14000` !! Actually the PR that create those exact release
744 744 note is :ghpull:`14000`. Ok, more issues and PR is not always better, and I'd
745 745 love to have more time to close issues and Pull Requests.
746 746
747 747 Let's note that in less than 2 month JupyterCon is back, in Paris please visit
748 748 `jupytercon.com <https://jupytercon.com>`__, and looking forward to see you
749 749 there.
750 750
751 751 Packagers should take note that ``typing_extension`` is now a mandatory dependency
752 752 for Python versions ``<3.10``.
753 753
754 754
755 755
756 756 Let's note also that according to `NEP29
757 757 <https://numpy.org/neps/nep-0029-deprecation_policy.html>`__, It is soon time to
758 758 stop support for Python 3.8 that will be release more than 3 and 1/2 years ago::
759 759
760 760 On Apr 14, 2023 drop support for Python 3.8 (initially released on Oct 14, 2019)
761 761
762 762 Thus I am likely to stop advertising support for Python 3.8 in the next
763 763 release at the end of April.
764 764
765 765
766 766 Here are some miscellaneous updates of interest:
767 767
768 768 - :ghpull:`13957` brings updates to the Qt integration, particularly for Qt6.
769 769 - :ghpull:`13960` fixes the %debug magic command to give access to the local
770 770 scope.
771 771 - :ghpull:`13964` fixes some crashes with the new fast traceback code. Note that
772 772 there are still some issues with the fast traceback code, and I a, likely
773 773 to fix and tweak behavior.
774 774 - :ghpull:`13973` We are slowly migrating IPython internals to use proper type
775 775 objects/dataclasses instead of dictionaries to allow static typing checks.
776 776 These are technically public API and could lead to breakage, so please let us
777 777 know if that's the case and I'll mitigate.
778 778 - :ghpull:`13990`, :ghpull:`13991`, :ghpull:`13994` all improve keybinding and
779 779 shortcut configurability.
780 780
781 781 As usual you can find the full list of PRs on GitHub under `the 8.12 milestone
782 782 <https://github.com/ipython/ipython/milestone/114?closed=1>`__.
783 783
784 784 We want to thank the D.E. Shaw group for requesting and sponsoring the work on
785 785 the following big feature. We had productive discussions on how to best expose
786 786 this feature
787 787
788 788 Dynamic documentation dispatch
789 789 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
790 790
791 791 We are experimenting with dynamic documentation dispatch for object attribute.
792 792 See :ghissue:`13860`. The goal is to allow object to define documentation for
793 793 their attributes, properties, even when those are dynamically defined with
794 794 `__getattr__`.
795 795
796 796 In particular when those objects are base types it can be useful to show the
797 797 documentation
798 798
799 799
800 800 .. code-block:: ipython
801 801
802 802
803 803 In [1]: class User:
804 804 ...:
805 805 ...: __custom_documentations__ = {
806 806 ...: "first": "The first name of the user.",
807 807 ...: "last": "The last name of the user.",
808 808 ...: }
809 809 ...:
810 810 ...: first:str
811 811 ...: last:str
812 812 ...:
813 813 ...: def __init__(self, first, last):
814 814 ...: self.first = first
815 815 ...: self.last = last
816 816 ...:
817 817 ...: @property
818 818 ...: def full(self):
819 819 ...: """`self.first` and `self.last` joined by a space."""
820 820 ...: return self.first + " " + self.last
821 821 ...:
822 822 ...:
823 823 ...: user = Person('Jane', 'Doe')
824 824
825 825 In [2]: user.first?
826 826 Type: str
827 827 String form: Jane
828 828 Length: 4
829 829 Docstring: the first name of a the person object, a str
830 830 Class docstring:
831 831 ....
832 832
833 833 In [3]: user.last?
834 834 Type: str
835 835 String form: Doe
836 836 Length: 3
837 837 Docstring: the last name, also a str
838 838 ...
839 839
840 840
841 841 We can see here the symmetry with IPython looking for the docstring on the
842 842 properties:
843 843
844 844 .. code-block:: ipython
845 845
846 846
847 847 In [4]: user.full?
848 848 HERE
849 849 Type: property
850 850 String form: <property object at 0x102bb15d0>
851 851 Docstring: first and last join by a space
852 852
853 853
854 854 Note that while in the above example we use a static dictionary, libraries may
855 855 decide to use a custom object that define ``__getitem__``, we caution against
856 856 using objects that would trigger computation to show documentation, but it is
857 857 sometime preferable for highly dynamic code that for example export ans API as
858 858 object.
859 859
860 860
861 861
862 862 .. _version 8.11.0:
863 863
864 864 IPython 8.11
865 865 ------------
866 866
867 867 Back on almost regular monthly schedule for IPython with end-of-month
868 868 really-late-Friday release to make sure some bugs are properly fixed.
869 869 Small addition of with a few new features, bugfix and UX improvements.
870 870
871 871 This is a non-exhaustive list, but among other you will find:
872 872
873 873 Faster Traceback Highlighting
874 874 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
875 875
876 876 Resurrection of pre-IPython-8 traceback highlighting code.
877 877
878 878 Really long and complicated files were slow to highlight in traceback with
879 879 IPython 8 despite upstream improvement that make many case better. Therefore
880 880 starting with IPython 8.11 when one of the highlighted file is more than 10 000
881 881 line long by default, we'll fallback to a faster path that does not have all the
882 882 features of highlighting failing AST nodes.
883 883
884 884 This can be configures by setting the value of
885 885 ``IPython.code.ultratb.FAST_THRESHOLD`` to an arbitrary low or large value.
886 886
887 887
888 888 Autoreload verbosity
889 889 ~~~~~~~~~~~~~~~~~~~~
890 890
891 891 We introduce more descriptive names for the ``%autoreload`` parameter:
892 892
893 893 - ``%autoreload now`` (also ``%autoreload``) - perform autoreload immediately.
894 894 - ``%autoreload off`` (also ``%autoreload 0``) - turn off autoreload.
895 895 - ``%autoreload explicit`` (also ``%autoreload 1``) - turn on autoreload only for modules
896 896 whitelisted by ``%aimport`` statements.
897 897 - ``%autoreload all`` (also ``%autoreload 2``) - turn on autoreload for all modules except those
898 898 blacklisted by ``%aimport`` statements.
899 899 - ``%autoreload complete`` (also ``%autoreload 3``) - all the fatures of ``all`` but also adding new
900 900 objects from the imported modules (see
901 901 IPython/extensions/tests/test_autoreload.py::test_autoload_newly_added_objects).
902 902
903 903 The original designations (e.g. "2") still work, and these new ones are case-insensitive.
904 904
905 905 Additionally, the option ``--print`` or ``-p`` can be added to the line to print the names of
906 906 modules being reloaded. Similarly, ``--log`` or ``-l`` will output the names to the logger at INFO
907 907 level. Both can be used simultaneously.
908 908
909 909 The parsing logic for ``%aimport`` is now improved such that modules can be whitelisted and
910 910 blacklisted in the same line, e.g. it's now possible to call ``%aimport os, -math`` to include
911 911 ``os`` for ``%autoreload explicit`` and exclude ``math`` for modes ``all`` and ``complete``.
912 912
913 913 Terminal shortcuts customization
914 914 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
915 915
916 916 Previously modifying shortcuts was only possible by hooking into startup files
917 917 and practically limited to adding new shortcuts or removing all shortcuts bound
918 918 to a specific key. This release enables users to override existing terminal
919 919 shortcuts, disable them or add new keybindings.
920 920
921 921 For example, to set the :kbd:`right` to accept a single character of auto-suggestion
922 922 you could use::
923 923
924 924 my_shortcuts = [
925 925 {
926 926 "command": "IPython:auto_suggest.accept_character",
927 927 "new_keys": ["right"]
928 928 }
929 929 ]
930 930 %config TerminalInteractiveShell.shortcuts = my_shortcuts
931 931
932 932 You can learn more in :std:configtrait:`TerminalInteractiveShell.shortcuts`
933 933 configuration reference.
934 934
935 935 Miscellaneous
936 936 ~~~~~~~~~~~~~
937 937
938 938 - ``%gui`` should now support PySide6. :ghpull:`13864`
939 939 - Cli shortcuts can now be configured :ghpull:`13928`, see above.
940 940 (note that there might be an issue with prompt_toolkit 3.0.37 and shortcut configuration).
941 941
942 942 - Capture output should now respect ``;`` semicolon to suppress output.
943 943 :ghpull:`13940`
944 944 - Base64 encoded images (in jupyter frontend), will not have trailing newlines.
945 945 :ghpull:`13941`
946 946
947 947 As usual you can find the full list of PRs on GitHub under `the 8.11 milestone
948 948 <https://github.com/ipython/ipython/milestone/113?closed=1>`__.
949 949
950 950 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
951 951 work on IPython and related libraries.
952 952
953 953 .. _version 8.10.0:
954 954
955 955 IPython 8.10
956 956 ------------
957 957
958 958 Out of schedule release of IPython with minor fixes to patch a potential CVE-2023-24816.
959 959 This is a really low severity CVE that you most likely are not affected by unless:
960 960
961 961 - You are on windows.
962 962 - You have a custom build of Python without ``_ctypes``
963 963 - You cd or start IPython or Jupyter in untrusted directory which names may be
964 964 valid shell commands.
965 965
966 966 You can read more on `the advisory
967 967 <https://github.com/ipython/ipython/security/advisories/GHSA-29gw-9793-fvw7>`__.
968 968
969 969 In addition to fixing this CVE we also fix a couple of outstanding bugs and issues.
970 970
971 971 As usual you can find the full list of PRs on GitHub under `the 8.10 milestone
972 972 <https://github.com/ipython/ipython/milestone/112?closed=1>`__.
973 973
974 974 In Particular:
975 975
976 976 - bump minimum numpy to `>=1.21` version following NEP29. :ghpull:`13930`
977 977 - fix for compatibility with MyPy 1.0. :ghpull:`13933`
978 978 - fix nbgrader stalling when IPython's ``showtraceback`` function is
979 979 monkeypatched. :ghpull:`13934`
980 980
981 981
982 982
983 983 As this release also contains those minimal changes in addition to fixing the
984 984 CVE I decided to bump the minor version anyway.
985 985
986 986 This will not affect the normal release schedule, so IPython 8.11 is due in
987 987 about 2 weeks.
988 988
989 989 .. _version 8.9.0:
990 990
991 991 IPython 8.9.0
992 992 -------------
993 993
994 994 Second release of IPython in 2023, last Friday of the month, we are back on
995 995 track. This is a small release with a few bug-fixes, and improvements, mostly
996 996 with respect to terminal shortcuts.
997 997
998 998
999 999 The biggest improvement for 8.9 is a drastic amelioration of the
1000 1000 auto-suggestions sponsored by D.E. Shaw and implemented by the more and more
1001 1001 active contributor `@krassowski <https://github.com/krassowski>`.
1002 1002
1003 1003 - ``right`` accepts a single character from suggestion
1004 1004 - ``ctrl+right`` accepts a semantic token (macos default shortcuts take
1005 1005 precedence and need to be disabled to make this work)
1006 1006 - ``backspace`` deletes a character and resumes hinting autosuggestions
1007 1007 - ``ctrl-left`` accepts suggestion and moves cursor left one character.
1008 1008 - ``backspace`` deletes a character and resumes hinting autosuggestions
1009 1009 - ``down`` moves to suggestion to later in history when no lines are present below the cursors.
1010 1010 - ``up`` moves to suggestion from earlier in history when no lines are present above the cursor.
1011 1011
1012 1012 This is best described by the Gif posted by `@krassowski
1013 1013 <https://github.com/krassowski>`, and in the PR itself :ghpull:`13888`.
1014 1014
1015 1015 .. image:: ../_images/autosuggest.gif
1016 1016
1017 1017 Please report any feedback in order for us to improve the user experience.
1018 1018 In particular we are also working on making the shortcuts configurable.
1019 1019
1020 1020 If you are interested in better terminal shortcuts, I also invite you to
1021 1021 participate in issue `13879
1022 1022 <https://github.com/ipython/ipython/issues/13879>`__.
1023 1023
1024 1024
1025 1025 As we follow `NEP29
1026 1026 <https://numpy.org/neps/nep-0029-deprecation_policy.html>`__, next version of
1027 1027 IPython will officially stop supporting numpy 1.20, and will stop supporting
1028 1028 Python 3.8 after April release.
1029 1029
1030 1030 As usual you can find the full list of PRs on GitHub under `the 8.9 milestone
1031 1031 <https://github.com/ipython/ipython/milestone/111?closed=1>`__.
1032 1032
1033 1033
1034 1034 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1035 1035 work on IPython and related libraries.
1036 1036
1037 1037 .. _version 8.8.0:
1038 1038
1039 1039 IPython 8.8.0
1040 1040 -------------
1041 1041
1042 1042 First release of IPython in 2023 as there was no release at the end of
1043 1043 December.
1044 1044
1045 1045 This is an unusually big release (relatively speaking) with more than 15 Pull
1046 1046 Requests merged.
1047 1047
1048 1048 Of particular interest are:
1049 1049
1050 1050 - :ghpull:`13852` that replaces the greedy completer and improves
1051 1051 completion, in particular for dictionary keys.
1052 1052 - :ghpull:`13858` that adds ``py.typed`` to ``setup.cfg`` to make sure it is
1053 1053 bundled in wheels.
1054 1054 - :ghpull:`13869` that implements tab completions for IPython options in the
1055 1055 shell when using `argcomplete <https://github.com/kislyuk/argcomplete>`. I
1056 1056 believe this also needs a recent version of Traitlets.
1057 1057 - :ghpull:`13865` makes the ``inspector`` class of `InteractiveShell`
1058 1058 configurable.
1059 1059 - :ghpull:`13880` that removes minor-version entrypoints as the minor version
1060 1060 entry points that would be included in the wheel would be the one of the
1061 1061 Python version that was used to build the ``whl`` file.
1062 1062
1063 1063 In no particular order, the rest of the changes update the test suite to be
1064 1064 compatible with Pygments 2.14, various docfixes, testing on more recent python
1065 1065 versions and various updates.
1066 1066
1067 1067 As usual you can find the full list of PRs on GitHub under `the 8.8 milestone
1068 1068 <https://github.com/ipython/ipython/milestone/110>`__.
1069 1069
1070 1070 Many thanks to @krassowski for the many PRs and @jasongrout for reviewing and
1071 1071 merging contributions.
1072 1072
1073 1073 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1074 1074 work on IPython and related libraries.
1075 1075
1076 1076 .. _version 8.7.0:
1077 1077
1078 1078 IPython 8.7.0
1079 1079 -------------
1080 1080
1081 1081
1082 1082 Small release of IPython with a couple of bug fixes and new features for this
1083 1083 month. Next month is the end of year, it is unclear if there will be a release
1084 1084 close to the new year's eve, or if the next release will be at the end of January.
1085 1085
1086 1086 Here are a few of the relevant fixes,
1087 1087 as usual you can find the full list of PRs on GitHub under `the 8.7 milestone
1088 1088 <https://github.com/ipython/ipython/pulls?q=milestone%3A8.7>`__.
1089 1089
1090 1090
1091 1091 - :ghpull:`13834` bump the minimum prompt toolkit to 3.0.11.
1092 1092 - IPython shipped with the ``py.typed`` marker now, and we are progressively
1093 1093 adding more types. :ghpull:`13831`
1094 1094 - :ghpull:`13817` add configuration of code blacks formatting.
1095 1095
1096 1096
1097 1097 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1098 1098 work on IPython and related libraries.
1099 1099
1100 1100
1101 1101 .. _version 8.6.0:
1102 1102
1103 1103 IPython 8.6.0
1104 1104 -------------
1105 1105
1106 1106 Back to a more regular release schedule (at least I try), as Friday is
1107 1107 already over by more than 24h hours. This is a slightly bigger release with a
1108 1108 few new features that contain no less than 25 PRs.
1109 1109
1110 1110 We'll notably found a couple of non negligible changes:
1111 1111
1112 1112 The ``install_ext`` and related functions have been removed after being
1113 1113 deprecated for years. You can use pip to install extensions. ``pip`` did not
1114 1114 exist when ``install_ext`` was introduced. You can still load local extensions
1115 1115 without installing them. Just set your ``sys.path`` for example. :ghpull:`13744`
1116 1116
1117 1117 IPython now has extra entry points that use the major *and minor* version of
1118 1118 python. For some of you this means that you can do a quick ``ipython3.10`` to
1119 1119 launch IPython from the Python 3.10 interpreter, while still using Python 3.11
1120 1120 as your main Python. :ghpull:`13743`
1121 1121
1122 1122 The completer matcher API has been improved. See :ghpull:`13745`. This should
1123 1123 improve the type inference and improve dict keys completions in many use case.
1124 1124 Thanks ``@krassowski`` for all the work, and the D.E. Shaw group for sponsoring
1125 1125 it.
1126 1126
1127 1127 The color of error nodes in tracebacks can now be customized. See
1128 1128 :ghpull:`13756`. This is a private attribute until someone finds the time to
1129 1129 properly add a configuration option. Note that with Python 3.11 that also shows
1130 1130 the relevant nodes in traceback, it would be good to leverage this information
1131 1131 (plus the "did you mean" info added on attribute errors). But that's likely work
1132 1132 I won't have time to do before long, so contributions welcome.
1133 1133
1134 1134 As we follow NEP 29, we removed support for numpy 1.19 :ghpull:`13760`.
1135 1135
1136 1136
1137 1137 The ``open()`` function present in the user namespace by default will now refuse
1138 1138 to open the file descriptors 0,1,2 (stdin, out, err), to avoid crashing IPython.
1139 1139 This mostly occurs in teaching context when incorrect values get passed around.
1140 1140
1141 1141
1142 1142 The ``?``, ``??``, and corresponding ``pinfo``, ``pinfo2`` magics can now find
1143 1143 objects inside arrays. That is to say, the following now works::
1144 1144
1145 1145
1146 1146 >>> def my_func(*arg, **kwargs):pass
1147 1147 >>> container = [my_func]
1148 1148 >>> container[0]?
1149 1149
1150 1150
1151 1151 If ``container`` define a custom ``getitem``, this __will__ trigger the custom
1152 1152 method. So don't put side effects in your ``getitems``. Thanks to the D.E. Shaw
1153 1153 group for the request and sponsoring the work.
1154 1154
1155 1155
1156 1156 As usual you can find the full list of PRs on GitHub under `the 8.6 milestone
1157 1157 <https://github.com/ipython/ipython/pulls?q=milestone%3A8.6>`__.
1158 1158
1159 1159 Thanks to all hacktoberfest contributors, please contribute to
1160 1160 `closember.org <https://closember.org/>`__.
1161 1161
1162 1162 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1163 1163 work on IPython and related libraries.
1164 1164
1165 1165 .. _version 8.5.0:
1166 1166
1167 1167 IPython 8.5.0
1168 1168 -------------
1169 1169
1170 1170 First release since a couple of month due to various reasons and timing preventing
1171 1171 me for sticking to the usual monthly release the last Friday of each month. This
1172 1172 is of non negligible size as it has more than two dozen PRs with various fixes
1173 1173 an bug fixes.
1174 1174
1175 1175 Many thanks to everybody who contributed PRs for your patience in review and
1176 1176 merges.
1177 1177
1178 1178 Here is a non-exhaustive list of changes that have been implemented for IPython
1179 1179 8.5.0. As usual you can find the full list of issues and PRs tagged with `the
1180 1180 8.5 milestone
1181 1181 <https://github.com/ipython/ipython/pulls?q=is%3Aclosed+milestone%3A8.5+>`__.
1182 1182
1183 1183 - Added a shortcut for accepting auto suggestion. The End key shortcut for
1184 1184 accepting auto-suggestion This binding works in Vi mode too, provided
1185 1185 ``TerminalInteractiveShell.emacs_bindings_in_vi_insert_mode`` is set to be
1186 1186 ``True`` :ghpull:`13566`.
1187 1187
1188 1188 - No popup in window for latex generation when generating latex (e.g. via
1189 1189 `_latex_repr_`) no popup window is shows under Windows. :ghpull:`13679`
1190 1190
1191 1191 - Fixed error raised when attempting to tab-complete an input string with
1192 1192 consecutive periods or forward slashes (such as "file:///var/log/...").
1193 1193 :ghpull:`13675`
1194 1194
1195 1195 - Relative filenames in Latex rendering :
1196 1196 The `latex_to_png_dvipng` command internally generates input and output file
1197 1197 arguments to `latex` and `dvipis`. These arguments are now generated as
1198 1198 relative files to the current working directory instead of absolute file
1199 1199 paths. This solves a problem where the current working directory contains
1200 1200 characters that are not handled properly by `latex` and `dvips`. There are
1201 1201 no changes to the user API. :ghpull:`13680`
1202 1202
1203 1203 - Stripping decorators bug: Fixed bug which meant that ipython code blocks in
1204 1204 restructured text documents executed with the ipython-sphinx extension
1205 1205 skipped any lines of code containing python decorators. :ghpull:`13612`
1206 1206
1207 1207 - Allow some modules with frozen dataclasses to be reloaded. :ghpull:`13732`
1208 1208 - Fix paste magic on wayland. :ghpull:`13671`
1209 1209 - show maxlen in deque's repr. :ghpull:`13648`
1210 1210
1211 1211 Restore line numbers for Input
1212 1212 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1213 1213
1214 1214 Line number information in tracebacks from input are restored.
1215 1215 Line numbers from input were removed during the transition to v8 enhanced traceback reporting.
1216 1216
1217 1217 So, instead of::
1218 1218
1219 1219 ---------------------------------------------------------------------------
1220 1220 ZeroDivisionError Traceback (most recent call last)
1221 1221 Input In [3], in <cell line: 1>()
1222 1222 ----> 1 myfunc(2)
1223 1223
1224 1224 Input In [2], in myfunc(z)
1225 1225 1 def myfunc(z):
1226 1226 ----> 2 foo.boo(z-1)
1227 1227
1228 1228 File ~/code/python/ipython/foo.py:3, in boo(x)
1229 1229 2 def boo(x):
1230 1230 ----> 3 return 1/(1-x)
1231 1231
1232 1232 ZeroDivisionError: division by zero
1233 1233
1234 1234 The error traceback now looks like::
1235 1235
1236 1236 ---------------------------------------------------------------------------
1237 1237 ZeroDivisionError Traceback (most recent call last)
1238 1238 Cell In [3], line 1
1239 1239 ----> 1 myfunc(2)
1240 1240
1241 1241 Cell In [2], line 2, in myfunc(z)
1242 1242 1 def myfunc(z):
1243 1243 ----> 2 foo.boo(z-1)
1244 1244
1245 1245 File ~/code/python/ipython/foo.py:3, in boo(x)
1246 1246 2 def boo(x):
1247 1247 ----> 3 return 1/(1-x)
1248 1248
1249 1249 ZeroDivisionError: division by zero
1250 1250
1251 1251 or, with xmode=Plain::
1252 1252
1253 1253 Traceback (most recent call last):
1254 1254 Cell In [12], line 1
1255 1255 myfunc(2)
1256 1256 Cell In [6], line 2 in myfunc
1257 1257 foo.boo(z-1)
1258 1258 File ~/code/python/ipython/foo.py:3 in boo
1259 1259 return 1/(1-x)
1260 1260 ZeroDivisionError: division by zero
1261 1261
1262 1262 :ghpull:`13560`
1263 1263
1264 1264 New setting to silence warning if working inside a virtual environment
1265 1265 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1266 1266
1267 1267 Previously, when starting IPython in a virtual environment without IPython installed (so IPython from the global environment is used), the following warning was printed:
1268 1268
1269 1269 Attempting to work in a virtualenv. If you encounter problems, please install IPython inside the virtualenv.
1270 1270
1271 1271 This warning can be permanently silenced by setting ``c.InteractiveShell.warn_venv`` to ``False`` (the default is ``True``).
1272 1272
1273 1273 :ghpull:`13706`
1274 1274
1275 1275 -------
1276 1276
1277 1277 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1278 1278 work on IPython and related libraries.
1279 1279
1280 1280
1281 1281 .. _version 8.4.0:
1282 1282
1283 1283 IPython 8.4.0
1284 1284 -------------
1285 1285
1286 1286 As for 7.34, this version contains a single fix: fix uncaught BdbQuit exceptions on ipdb
1287 1287 exit :ghpull:`13668`, and a single typo fix in documentation: :ghpull:`13682`
1288 1288
1289 1289 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1290 1290 work on IPython and related libraries.
1291 1291
1292 1292
1293 1293 .. _version 8.3.0:
1294 1294
1295 1295 IPython 8.3.0
1296 1296 -------------
1297 1297
1298 1298 - :ghpull:`13625`, using ``?``, ``??``, ``*?`` will not call
1299 1299 ``set_next_input`` as most frontend allow proper multiline editing and it was
1300 1300 causing issues for many users of multi-cell frontends. This has been backported to 7.33
1301 1301
1302 1302
1303 1303 - :ghpull:`13600`, ``pre_run_*``-hooks will now have a ``cell_id`` attribute on
1304 1304 the info object when frontend provides it. This has been backported to 7.33
1305 1305
1306 1306 - :ghpull:`13624`, fixed :kbd:`End` key being broken after accepting an
1307 1307 auto-suggestion.
1308 1308
1309 1309 - :ghpull:`13657` fixed an issue where history from different sessions would be mixed.
1310 1310
1311 1311 .. _version 8.2.0:
1312 1312
1313 1313 IPython 8.2.0
1314 1314 -------------
1315 1315
1316 1316 IPython 8.2 mostly bring bugfixes to IPython.
1317 1317
1318 1318 - Auto-suggestion can now be elected with the ``end`` key. :ghpull:`13566`
1319 1319 - Some traceback issues with ``assert etb is not None`` have been fixed. :ghpull:`13588`
1320 1320 - History is now pulled from the sqitel database and not from in-memory.
1321 1321 In particular when using the ``%paste`` magic, the content of the pasted text will
1322 1322 be part of the history and not the verbatim text ``%paste`` anymore. :ghpull:`13592`
1323 1323 - Fix ``Ctrl-\\`` exit cleanup :ghpull:`13603`
1324 1324 - Fixes to ``ultratb`` ipdb support when used outside of IPython. :ghpull:`13498`
1325 1325
1326 1326
1327 1327 I am still trying to fix and investigate :ghissue:`13598`, which seems to be
1328 1328 random, and would appreciate help if you find a reproducible minimal case. I've
1329 1329 tried to make various changes to the codebase to mitigate it, but a proper fix
1330 1330 will be difficult without understanding the cause.
1331 1331
1332 1332
1333 1333 All the issues on pull-requests for this release can be found in the `8.2
1334 1334 milestone. <https://github.com/ipython/ipython/milestone/100>`__ . And some
1335 1335 documentation only PR can be found as part of the `7.33 milestone
1336 1336 <https://github.com/ipython/ipython/milestone/101>`__ (currently not released).
1337 1337
1338 1338 Thanks to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1339 1339 work on IPython and related libraries.
1340 1340
1341 1341 .. _version 8.1.1:
1342 1342
1343 1343 IPython 8.1.1
1344 1344 -------------
1345 1345
1346 1346 Fix an issue with virtualenv and Python 3.8 introduced in 8.1
1347 1347
1348 1348 Revert :ghpull:`13537` (fix an issue with symlinks in virtualenv) that raises an
1349 1349 error in Python 3.8, and fixed in a different way in :ghpull:`13559`.
1350 1350
1351 1351 .. _version 8.1:
1352 1352
1353 1353 IPython 8.1.0
1354 1354 -------------
1355 1355
1356 1356 IPython 8.1 is the first minor release after 8.0 and fixes a number of bugs and
1357 1357 updates a few behaviors that were problematic with the 8.0 as with many new major
1358 1358 release.
1359 1359
1360 1360 Note that beyond the changes listed here, IPython 8.1.0 also contains all the
1361 1361 features listed in :ref:`version 7.32`.
1362 1362
1363 1363 - Misc and multiple fixes around quotation auto-closing. It is now disabled by
1364 1364 default. Run with ``TerminalInteractiveShell.auto_match=True`` to re-enabled
1365 1365 - Require pygments>=2.4.0 :ghpull:`13459`, this was implicit in the code, but
1366 1366 is now explicit in ``setup.cfg``/``setup.py``
1367 1367 - Docs improvement of ``core.magic_arguments`` examples. :ghpull:`13433`
1368 1368 - Multi-line edit executes too early with await. :ghpull:`13424`
1369 1369
1370 1370 - ``black`` is back as an optional dependency, and autoformatting disabled by
1371 1371 default until some fixes are implemented (black improperly reformat magics).
1372 1372 :ghpull:`13471` Additionally the ability to use ``yapf`` as a code
1373 1373 reformatter has been added :ghpull:`13528` . You can use
1374 1374 ``TerminalInteractiveShell.autoformatter="black"``,
1375 1375 ``TerminalInteractiveShell.autoformatter="yapf"`` to re-enable auto formatting
1376 1376 with black, or switch to yapf.
1377 1377
1378 1378 - Fix and issue where ``display`` was not defined.
1379 1379
1380 1380 - Auto suggestions are now configurable. Currently only
1381 1381 ``AutoSuggestFromHistory`` (default) and ``None``. new provider contribution
1382 1382 welcomed. :ghpull:`13475`
1383 1383
1384 1384 - multiple packaging/testing improvement to simplify downstream packaging
1385 1385 (xfail with reasons, try to not access network...).
1386 1386
1387 1387 - Update deprecation. ``InteractiveShell.magic`` internal method has been
1388 1388 deprecated for many years but did not emit a warning until now.
1389 1389
1390 1390 - internal ``appended_to_syspath`` context manager has been deprecated.
1391 1391
1392 1392 - fix an issue with symlinks in virtualenv :ghpull:`13537` (Reverted in 8.1.1)
1393 1393
1394 1394 - Fix an issue with vim mode, where cursor would not be reset on exit :ghpull:`13472`
1395 1395
1396 1396 - ipython directive now remove only known pseudo-decorators :ghpull:`13532`
1397 1397
1398 1398 - ``IPython/lib/security`` which used to be used for jupyter notebook has been
1399 1399 removed.
1400 1400
1401 1401 - Fix an issue where ``async with`` would execute on new lines. :ghpull:`13436`
1402 1402
1403 1403
1404 1404 We want to remind users that IPython is part of the Jupyter organisations, and
1405 1405 thus governed by a Code of Conduct. Some of the behavior we have seen on GitHub is not acceptable.
1406 1406 Abuse and non-respectful comments on discussion will not be tolerated.
1407 1407
1408 1408 Many thanks to all the contributors to this release, many of the above fixed issues and
1409 1409 new features were done by first time contributors, showing there is still
1410 1410 plenty of easy contribution possible in IPython
1411 1411 . You can find all individual contributions
1412 1412 to this milestone `on github <https://github.com/ipython/ipython/milestone/91>`__.
1413 1413
1414 1414 Thanks as well to the `D. E. Shaw group <https://deshaw.com/>`__ for sponsoring
1415 1415 work on IPython and related libraries. In particular the Lazy autoloading of
1416 1416 magics that you will find described in the 7.32 release notes.
1417 1417
1418 1418
1419 1419 .. _version 8.0.1:
1420 1420
1421 1421 IPython 8.0.1 (CVE-2022-21699)
1422 1422 ------------------------------
1423 1423
1424 1424 IPython 8.0.1, 7.31.1 and 5.11 are security releases that change some default
1425 1425 values in order to prevent potential Execution with Unnecessary Privileges.
1426 1426
1427 1427 Almost all version of IPython looks for configuration and profiles in current
1428 1428 working directory. Since IPython was developed before pip and environments
1429 1429 existed it was used a convenient way to load code/packages in a project
1430 1430 dependant way.
1431 1431
1432 1432 In 2022, it is not necessary anymore, and can lead to confusing behavior where
1433 1433 for example cloning a repository and starting IPython or loading a notebook from
1434 1434 any Jupyter-Compatible interface that has ipython set as a kernel can lead to
1435 1435 code execution.
1436 1436
1437 1437
1438 1438 I did not find any standard way for packaged to advertise CVEs they fix, I'm
1439 1439 thus trying to add a ``__patched_cves__`` attribute to the IPython module that
1440 1440 list the CVEs that should have been fixed. This attribute is informational only
1441 1441 as if a executable has a flaw, this value can always be changed by an attacker.
1442 1442
1443 1443 .. code::
1444 1444
1445 1445 In [1]: import IPython
1446 1446
1447 1447 In [2]: IPython.__patched_cves__
1448 1448 Out[2]: {'CVE-2022-21699'}
1449 1449
1450 1450 In [3]: 'CVE-2022-21699' in IPython.__patched_cves__
1451 1451 Out[3]: True
1452 1452
1453 1453 Thus starting with this version:
1454 1454
1455 1455 - The current working directory is not searched anymore for profiles or
1456 1456 configurations files.
1457 1457 - Added a ``__patched_cves__`` attribute (set of strings) to IPython module that contain
1458 1458 the list of fixed CVE. This is informational only.
1459 1459
1460 1460 Further details can be read on the `GitHub Advisory <https://github.com/ipython/ipython/security/advisories/GHSA-pq7m-3gw7-gq5x>`__
1461 1461
1462 1462
1463 1463 .. _version 8.0:
1464 1464
1465 1465 IPython 8.0
1466 1466 -----------
1467 1467
1468 1468 IPython 8.0 is bringing a large number of new features and improvements to both the
1469 1469 user of the terminal and of the kernel via Jupyter. The removal of compatibility
1470 1470 with an older version of Python is also the opportunity to do a couple of
1471 1471 performance improvements in particular with respect to startup time.
1472 1472 The 8.x branch started diverging from its predecessor around IPython 7.12
1473 1473 (January 2020).
1474 1474
1475 1475 This release contains 250+ pull requests, in addition to many of the features
1476 1476 and backports that have made it to the 7.x branch. Please see the
1477 1477 `8.0 milestone <https://github.com/ipython/ipython/milestone/73?closed=1>`__ for the full list of pull requests.
1478 1478
1479 1479 Please feel free to send pull requests to update those notes after release,
1480 1480 I have likely forgotten a few things reviewing 250+ PRs.
1481 1481
1482 1482 Dependencies changes/downstream packaging
1483 1483 -----------------------------------------
1484 1484
1485 1485 Most of our building steps have been changed to be (mostly) declarative
1486 1486 and follow PEP 517. We are trying to completely remove ``setup.py`` (:ghpull:`13238`) and are
1487 1487 looking for help to do so.
1488 1488
1489 1489 - minimum supported ``traitlets`` version is now 5+
1490 1490 - we now require ``stack_data``
1491 1491 - minimal Python is now 3.8
1492 1492 - ``nose`` is not a testing requirement anymore
1493 1493 - ``pytest`` replaces nose.
1494 1494 - ``iptest``/``iptest3`` cli entrypoints do not exist anymore.
1495 1495 - the minimum officially ​supported ``numpy`` version has been bumped, but this should
1496 1496 not have much effect on packaging.
1497 1497
1498 1498
1499 1499 Deprecation and removal
1500 1500 -----------------------
1501 1501
1502 1502 We removed almost all features, arguments, functions, and modules that were
1503 1503 marked as deprecated between IPython 1.0 and 5.0. As a reminder, 5.0 was released
1504 1504 in 2016, and 1.0 in 2013. Last release of the 5 branch was 5.10.0, in May 2020.
1505 1505 The few remaining deprecated features we left have better deprecation warnings
1506 1506 or have been turned into explicit errors for better error messages.
1507 1507
1508 1508 I will use this occasion to add the following requests to anyone emitting a
1509 1509 deprecation warning:
1510 1510
1511 1511 - Please add at least ``stacklevel=2`` so that the warning is emitted into the
1512 1512 caller context, and not the callee one.
1513 1513 - Please add **since which version** something is deprecated.
1514 1514
1515 1515 As a side note, it is much easier to conditionally compare version
1516 1516 numbers rather than using ``try/except`` when functionality changes with a version.
1517 1517
1518 1518 I won't list all the removed features here, but modules like ``IPython.kernel``,
1519 1519 which was just a shim module around ``ipykernel`` for the past 8 years, have been
1520 1520 removed, and so many other similar things that pre-date the name **Jupyter**
1521 1521 itself.
1522 1522
1523 1523 We no longer need to add ``IPython.extensions`` to the PYTHONPATH because that is being
1524 1524 handled by ``load_extension``.
1525 1525
1526 1526 We are also removing ``Cythonmagic``, ``sympyprinting`` and ``rmagic`` as they are now in
1527 1527 other packages and no longer need to be inside IPython.
1528 1528
1529 1529
1530 1530 Documentation
1531 1531 -------------
1532 1532
1533 1533 The majority of our docstrings have now been reformatted and automatically fixed by
1534 1534 the experimental `VΓ©lin <https://pypi.org/project/velin/>`_ project to conform
1535 1535 to numpydoc.
1536 1536
1537 1537 Type annotations
1538 1538 ----------------
1539 1539
1540 1540 While IPython itself is highly dynamic and can't be completely typed, many of
1541 1541 the functions now have type annotations, and part of the codebase is now checked
1542 1542 by mypy.
1543 1543
1544 1544
1545 1545 Featured changes
1546 1546 ----------------
1547 1547
1548 1548 Here is a features list of changes in IPython 8.0. This is of course non-exhaustive.
1549 1549 Please note as well that many features have been added in the 7.x branch as well
1550 1550 (and hence why you want to read the 7.x what's new notes), in particular
1551 1551 features contributed by QuantStack (with respect to debugger protocol and Xeus
1552 1552 Python), as well as many debugger features that I was pleased to implement as
1553 1553 part of my work at QuanSight and sponsored by DE Shaw.
1554 1554
1555 1555 Traceback improvements
1556 1556 ~~~~~~~~~~~~~~~~~~~~~~
1557 1557
1558 1558 Previously, error tracebacks for errors happening in code cells were showing a
1559 1559 hash, the one used for compiling the Python AST::
1560 1560
1561 1561 In [1]: def foo():
1562 1562 ...: return 3 / 0
1563 1563 ...:
1564 1564
1565 1565 In [2]: foo()
1566 1566 ---------------------------------------------------------------------------
1567 1567 ZeroDivisionError Traceback (most recent call last)
1568 1568 <ipython-input-2-c19b6d9633cf> in <module>
1569 1569 ----> 1 foo()
1570 1570
1571 1571 <ipython-input-1-1595a74c32d5> in foo()
1572 1572 1 def foo():
1573 1573 ----> 2 return 3 / 0
1574 1574 3
1575 1575
1576 1576 ZeroDivisionError: division by zero
1577 1577
1578 1578 The error traceback is now correctly formatted, showing the cell number in which the error happened::
1579 1579
1580 1580 In [1]: def foo():
1581 1581 ...: return 3 / 0
1582 1582 ...:
1583 1583
1584 1584 Input In [2]: foo()
1585 1585 ---------------------------------------------------------------------------
1586 1586 ZeroDivisionError Traceback (most recent call last)
1587 1587 input In [2], in <module>
1588 1588 ----> 1 foo()
1589 1589
1590 1590 Input In [1], in foo()
1591 1591 1 def foo():
1592 1592 ----> 2 return 3 / 0
1593 1593
1594 1594 ZeroDivisionError: division by zero
1595 1595
1596 1596 The ``stack_data`` package has been integrated, which provides smarter information in the traceback;
1597 1597 in particular it will highlight the AST node where an error occurs which can help to quickly narrow down errors.
1598 1598
1599 1599 For example in the following snippet::
1600 1600
1601 1601 def foo(i):
1602 1602 x = [[[0]]]
1603 1603 return x[0][i][0]
1604 1604
1605 1605
1606 1606 def bar():
1607 1607 return foo(0) + foo(
1608 1608 1
1609 1609 ) + foo(2)
1610 1610
1611 1611
1612 1612 calling ``bar()`` would raise an ``IndexError`` on the return line of ``foo``,
1613 1613 and IPython 8.0 is capable of telling you where the index error occurs::
1614 1614
1615 1615
1616 1616 IndexError
1617 1617 Input In [2], in <module>
1618 1618 ----> 1 bar()
1619 1619 ^^^^^
1620 1620
1621 1621 Input In [1], in bar()
1622 1622 6 def bar():
1623 1623 ----> 7 return foo(0) + foo(
1624 1624 ^^^^
1625 1625 8 1
1626 1626 ^^^^^^^^
1627 1627 9 ) + foo(2)
1628 1628 ^^^^
1629 1629
1630 1630 Input In [1], in foo(i)
1631 1631 1 def foo(i):
1632 1632 2 x = [[[0]]]
1633 1633 ----> 3 return x[0][i][0]
1634 1634 ^^^^^^^
1635 1635
1636 1636 The corresponding locations marked here with ``^`` will show up highlighted in
1637 1637 the terminal and notebooks.
1638 1638
1639 1639 Finally, a colon ``::`` and line number is appended after a filename in
1640 1640 traceback::
1641 1641
1642 1642
1643 1643 ZeroDivisionError Traceback (most recent call last)
1644 1644 File ~/error.py:4, in <module>
1645 1645 1 def f():
1646 1646 2 1/0
1647 1647 ----> 4 f()
1648 1648
1649 1649 File ~/error.py:2, in f()
1650 1650 1 def f():
1651 1651 ----> 2 1/0
1652 1652
1653 1653 Many terminals and editors have integrations enabling you to directly jump to the
1654 1654 relevant file/line when this syntax is used, so this small addition may have a high
1655 1655 impact on productivity.
1656 1656
1657 1657
1658 1658 Autosuggestions
1659 1659 ~~~~~~~~~~~~~~~
1660 1660
1661 1661 Autosuggestion is a very useful feature available in `fish <https://fishshell.com/>`__, `zsh <https://en.wikipedia.org/wiki/Z_shell>`__, and `prompt-toolkit <https://python-prompt-toolkit.readthedocs.io/en/master/pages/asking_for_input.html#auto-suggestion>`__.
1662 1662
1663 1663 `Ptpython <https://github.com/prompt-toolkit/ptpython#ptpython>`__ allows users to enable this feature in
1664 1664 `ptpython/config.py <https://github.com/prompt-toolkit/ptpython/blob/master/examples/ptpython_config/config.py#L90>`__.
1665 1665
1666 1666 This feature allows users to accept autosuggestions with ctrl e, ctrl f,
1667 1667 or right arrow as described below.
1668 1668
1669 1669 1. Start ipython
1670 1670
1671 1671 .. image:: ../_images/8.0/auto_suggest_1_prompt_no_text.png
1672 1672
1673 1673 2. Run ``print("hello")``
1674 1674
1675 1675 .. image:: ../_images/8.0/auto_suggest_2_print_hello_suggest.png
1676 1676
1677 1677 3. start typing ``print`` again to see the autosuggestion
1678 1678
1679 1679 .. image:: ../_images/8.0/auto_suggest_3_print_hello_suggest.png
1680 1680
1681 1681 4. Press ``ctrl-f``, or ``ctrl-e``, or ``right-arrow`` to accept the suggestion
1682 1682
1683 1683 .. image:: ../_images/8.0/auto_suggest_4_print_hello.png
1684 1684
1685 1685 You can also complete word by word:
1686 1686
1687 1687 1. Run ``def say_hello(): print("hello")``
1688 1688
1689 1689 .. image:: ../_images/8.0/auto_suggest_second_prompt.png
1690 1690
1691 1691 2. Start typing the first letter if ``def`` to see the autosuggestion
1692 1692
1693 1693 .. image:: ../_images/8.0/auto_suggest_d_phantom.png
1694 1694
1695 1695 3. Press ``alt-f`` (or ``escape`` followed by ``f``), to accept the first word of the suggestion
1696 1696
1697 1697 .. image:: ../_images/8.0/auto_suggest_def_phantom.png
1698 1698
1699 1699 Importantly, this feature does not interfere with tab completion:
1700 1700
1701 1701 1. After running ``def say_hello(): print("hello")``, press d
1702 1702
1703 1703 .. image:: ../_images/8.0/auto_suggest_d_phantom.png
1704 1704
1705 1705 2. Press Tab to start tab completion
1706 1706
1707 1707 .. image:: ../_images/8.0/auto_suggest_d_completions.png
1708 1708
1709 1709 3A. Press Tab again to select the first option
1710 1710
1711 1711 .. image:: ../_images/8.0/auto_suggest_def_completions.png
1712 1712
1713 1713 3B. Press ``alt f`` (``escape``, ``f``) to accept to accept the first word of the suggestion
1714 1714
1715 1715 .. image:: ../_images/8.0/auto_suggest_def_phantom.png
1716 1716
1717 1717 3C. Press ``ctrl-f`` or ``ctrl-e`` to accept the entire suggestion
1718 1718
1719 1719 .. image:: ../_images/8.0/auto_suggest_match_parens.png
1720 1720
1721 1721
1722 1722 Currently, autosuggestions are only shown in the emacs or vi insert editing modes:
1723 1723
1724 1724 - The ctrl e, ctrl f, and alt f shortcuts work by default in emacs mode.
1725 1725 - To use these shortcuts in vi insert mode, you will have to create `custom keybindings in your config.py <https://github.com/mskar/setup/commit/2892fcee46f9f80ef7788f0749edc99daccc52f4/>`__.
1726 1726
1727 1727
1728 1728 Show pinfo information in ipdb using "?" and "??"
1729 1729 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1730 1730
1731 1731 In IPDB, it is now possible to show the information about an object using "?"
1732 1732 and "??", in much the same way that it can be done when using the IPython prompt::
1733 1733
1734 1734 ipdb> partial?
1735 1735 Init signature: partial(self, /, *args, **kwargs)
1736 1736 Docstring:
1737 1737 partial(func, *args, **keywords) - new function with partial application
1738 1738 of the given arguments and keywords.
1739 1739 File: ~/.pyenv/versions/3.8.6/lib/python3.8/functools.py
1740 1740 Type: type
1741 1741 Subclasses:
1742 1742
1743 1743 Previously, ``pinfo`` or ``pinfo2`` command had to be used for this purpose.
1744 1744
1745 1745
1746 1746 Autoreload 3 feature
1747 1747 ~~~~~~~~~~~~~~~~~~~~
1748 1748
1749 1749 Example: When an IPython session is run with the 'autoreload' extension loaded,
1750 1750 you will now have the option '3' to select, which means the following:
1751 1751
1752 1752 1. replicate all functionality from option 2
1753 1753 2. autoload all new funcs/classes/enums/globals from the module when they are added
1754 1754 3. autoload all newly imported funcs/classes/enums/globals from external modules
1755 1755
1756 1756 Try ``%autoreload 3`` in an IPython session after running ``%load_ext autoreload``.
1757 1757
1758 1758 For more information please see the following unit test : ``extensions/tests/test_autoreload.py:test_autoload_newly_added_objects``
1759 1759
1760 1760 Auto formatting with black in the CLI
1761 1761 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1762 1762
1763 1763 This feature was present in 7.x, but disabled by default.
1764 1764
1765 1765 In 8.0, input was automatically reformatted with Black when black was installed.
1766 1766 This feature has been reverted for the time being.
1767 1767 You can re-enable it by setting ``TerminalInteractiveShell.autoformatter`` to ``"black"``
1768 1768
1769 1769 History Range Glob feature
1770 1770 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1771 1771
1772 1772 Previously, when using ``%history``, users could specify either
1773 1773 a range of sessions and lines, for example:
1774 1774
1775 1775 .. code-block:: python
1776 1776
1777 1777 ~8/1-~6/5 # see history from the first line of 8 sessions ago,
1778 1778 # to the fifth line of 6 sessions ago.``
1779 1779
1780 1780 Or users could specify a glob pattern:
1781 1781
1782 1782 .. code-block:: python
1783 1783
1784 1784 -g <pattern> # glob ALL history for the specified pattern.
1785 1785
1786 1786 However users could *not* specify both.
1787 1787
1788 1788 If a user *did* specify both a range and a glob pattern,
1789 1789 then the glob pattern would be used (globbing *all* history) *and the range would be ignored*.
1790 1790
1791 1791 With this enhancement, if a user specifies both a range and a glob pattern, then the glob pattern will be applied to the specified range of history.
1792 1792
1793 1793 Don't start a multi-line cell with sunken parenthesis
1794 1794 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1795 1795
1796 1796 From now on, IPython will not ask for the next line of input when given a single
1797 1797 line with more closing than opening brackets. For example, this means that if
1798 1798 you (mis)type ``]]`` instead of ``[]``, a ``SyntaxError`` will show up, instead of
1799 1799 the ``...:`` prompt continuation.
1800 1800
1801 1801 IPython shell for ipdb interact
1802 1802 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1803 1803
1804 1804 The ipdb ``interact`` starts an IPython shell instead of Python's built-in ``code.interact()``.
1805 1805
1806 1806 Automatic Vi prompt stripping
1807 1807 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1808 1808
1809 1809 When pasting code into IPython, it will strip the leading prompt characters if
1810 1810 there are any. For example, you can paste the following code into the console -
1811 1811 it will still work, even though each line is prefixed with prompts (``In``,
1812 1812 ``Out``)::
1813 1813
1814 1814 In [1]: 2 * 2 == 4
1815 1815 Out[1]: True
1816 1816
1817 1817 In [2]: print("This still works as pasted")
1818 1818
1819 1819
1820 1820 Previously, this was not the case for the Vi-mode prompts::
1821 1821
1822 1822 In [1]: [ins] In [13]: 2 * 2 == 4
1823 1823 ...: Out[13]: True
1824 1824 ...:
1825 1825 File "<ipython-input-1-727bb88eaf33>", line 1
1826 1826 [ins] In [13]: 2 * 2 == 4
1827 1827 ^
1828 1828 SyntaxError: invalid syntax
1829 1829
1830 1830 This is now fixed, and Vi prompt prefixes - ``[ins]`` and ``[nav]`` - are
1831 1831 skipped just as the normal ``In`` would be.
1832 1832
1833 1833 IPython shell can be started in the Vi mode using ``ipython --TerminalInteractiveShell.editing_mode=vi``,
1834 1834 You should be able to change mode dynamically with ``%config TerminalInteractiveShell.editing_mode='vi'``
1835 1835
1836 1836 Empty History Ranges
1837 1837 ~~~~~~~~~~~~~~~~~~~~
1838 1838
1839 1839 A number of magics that take history ranges can now be used with an empty
1840 1840 range. These magics are:
1841 1841
1842 1842 * ``%save``
1843 1843 * ``%load``
1844 1844 * ``%pastebin``
1845 1845 * ``%pycat``
1846 1846
1847 1847 Using them this way will make them take the history of the current session up
1848 1848 to the point of the magic call (such that the magic itself will not be
1849 1849 included).
1850 1850
1851 1851 Therefore it is now possible to save the whole history to a file using
1852 1852 ``%save <filename>``, load and edit it using ``%load`` (makes for a nice usage
1853 1853 when followed with :kbd:`F2`), send it to `dpaste.org <http://dpast.org>`_ using
1854 1854 ``%pastebin``, or view the whole thing syntax-highlighted with a single
1855 1855 ``%pycat``.
1856 1856
1857 1857
1858 1858 Windows timing implementation: Switch to process_time
1859 1859 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1860 1860 Timing on Windows, for example with ``%%time``, was changed from being based on ``time.perf_counter``
1861 1861 (which counted time even when the process was sleeping) to being based on ``time.process_time`` instead
1862 1862 (which only counts CPU time). This brings it closer to the behavior on Linux. See :ghpull:`12984`.
1863 1863
1864 1864 Miscellaneous
1865 1865 ~~~~~~~~~~~~~
1866 1866 - Non-text formatters are not disabled in the terminal, which should simplify
1867 1867 writing extensions displaying images or other mimetypes in supporting terminals.
1868 1868 :ghpull:`12315`
1869 1869 - It is now possible to automatically insert matching brackets in Terminal IPython using the
1870 1870 ``TerminalInteractiveShell.auto_match=True`` option. :ghpull:`12586`
1871 1871 - We are thinking of deprecating the current ``%%javascript`` magic in favor of a better replacement. See :ghpull:`13376`.
1872 1872 - ``~`` is now expanded when part of a path in most magics :ghpull:`13385`
1873 1873 - ``%/%%timeit`` magic now adds a comma every thousands to make reading a long number easier :ghpull:`13379`
1874 1874 - ``"info"`` messages can now be customised to hide some fields :ghpull:`13343`
1875 1875 - ``collections.UserList`` now pretty-prints :ghpull:`13320`
1876 1876 - The debugger now has a persistent history, which should make it less
1877 1877 annoying to retype commands :ghpull:`13246`
1878 1878 - ``!pip`` ``!conda`` ``!cd`` or ``!ls`` are likely doing the wrong thing. We
1879 1879 now warn users if they use one of those commands. :ghpull:`12954`
1880 1880 - Make ``%precision`` work for ``numpy.float64`` type :ghpull:`12902`
1881 1881
1882 1882 Re-added support for XDG config directories
1883 1883 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1884 1884
1885 1885 XDG support through the years comes and goes. There is a tension between having
1886 1886 an identical location for configuration in all platforms versus having simple instructions.
1887 1887 After initial failures a couple of years ago, IPython was modified to automatically migrate XDG
1888 1888 config files back into ``~/.ipython``. That migration code has now been removed.
1889 1889 IPython now checks the XDG locations, so if you _manually_ move your config
1890 1890 files to your preferred location, IPython will not move them back.
1891 1891
1892 1892
1893 1893 Preparing for Python 3.10
1894 1894 -------------------------
1895 1895
1896 1896 To prepare for Python 3.10, we have started working on removing reliance and
1897 1897 any dependency that is not compatible with Python 3.10. This includes migrating our
1898 1898 test suite to pytest and starting to remove nose. This also means that the
1899 1899 ``iptest`` command is now gone and all testing is via pytest.
1900 1900
1901 1901 This was in large part thanks to the NumFOCUS Small Developer grant, which enabled us to
1902 1902 allocate \$4000 to hire `Nikita Kniazev (@Kojoley) <https://github.com/Kojoley>`_,
1903 1903 who did a fantastic job at updating our code base, migrating to pytest, pushing
1904 1904 our coverage, and fixing a large number of bugs. I highly recommend contacting
1905 1905 them if you need help with C++ and Python projects.
1906 1906
1907 1907 You can find all relevant issues and PRs with `the SDG 2021 tag <https://github.com/ipython/ipython/issues?q=label%3A%22Numfocus+SDG+2021%22+>`__
1908 1908
1909 1909 Removing support for older Python versions
1910 1910 ------------------------------------------
1911 1911
1912 1912
1913 1913 We are removing support for Python up through 3.7, allowing internal code to use the more
1914 1914 efficient ``pathlib`` and to make better use of type annotations.
1915 1915
1916 1916 .. image:: ../_images/8.0/pathlib_pathlib_everywhere.jpg
1917 1917 :alt: "Meme image of Toy Story with Woody and Buzz, with the text 'pathlib, pathlib everywhere'"
1918 1918
1919 1919
1920 1920 We had about 34 PRs only to update some logic to update some functions from managing strings to
1921 1921 using Pathlib.
1922 1922
1923 1923 The completer has also seen significant updates and now makes use of newer Jedi APIs,
1924 1924 offering faster and more reliable tab completion.
1925 1925
1926 1926 Misc Statistics
1927 1927 ---------------
1928 1928
1929 1929 Here are some numbers::
1930 1930
1931 1931 7.x: 296 files, 12561 blank lines, 20282 comments, 35142 line of code.
1932 1932 8.0: 252 files, 12053 blank lines, 19232 comments, 34505 line of code.
1933 1933
1934 1934 $ git diff --stat 7.x...master | tail -1
1935 1935 340 files changed, 13399 insertions(+), 12421 deletions(-)
1936 1936
1937 1937 We have commits from 162 authors, who contributed 1916 commits in 23 month, excluding merges (to not bias toward
1938 1938 maintainers pushing buttons).::
1939 1939
1940 1940 $ git shortlog -s --no-merges 7.x...master | sort -nr
1941 1941 535 Matthias Bussonnier
1942 1942 86 Nikita Kniazev
1943 1943 69 Blazej Michalik
1944 1944 49 Samuel Gaist
1945 1945 27 Itamar Turner-Trauring
1946 1946 18 Spas Kalaydzhisyki
1947 1947 17 Thomas Kluyver
1948 1948 17 Quentin Peter
1949 1949 17 James Morris
1950 1950 17 Artur Svistunov
1951 1951 15 Bart Skowron
1952 1952 14 Alex Hall
1953 1953 13 rushabh-v
1954 1954 13 Terry Davis
1955 1955 13 Benjamin Ragan-Kelley
1956 1956 8 martinRenou
1957 1957 8 farisachugthai
1958 1958 7 dswij
1959 1959 7 Gal B
1960 1960 7 Corentin Cadiou
1961 1961 6 yuji96
1962 1962 6 Martin Skarzynski
1963 1963 6 Justin Palmer
1964 1964 6 Daniel Goldfarb
1965 1965 6 Ben Greiner
1966 1966 5 Sammy Al Hashemi
1967 1967 5 Paul Ivanov
1968 1968 5 Inception95
1969 1969 5 Eyenpi
1970 1970 5 Douglas Blank
1971 1971 5 Coco Mishra
1972 1972 5 Bibo Hao
1973 1973 5 AndrΓ© A. Gomes
1974 1974 5 Ahmed Fasih
1975 1975 4 takuya fujiwara
1976 1976 4 palewire
1977 1977 4 Thomas A Caswell
1978 1978 4 Talley Lambert
1979 1979 4 Scott Sanderson
1980 1980 4 Ram Rachum
1981 1981 4 Nick Muoh
1982 1982 4 Nathan Goldbaum
1983 1983 4 Mithil Poojary
1984 1984 4 Michael T
1985 1985 4 Jakub Klus
1986 1986 4 Ian Castleden
1987 1987 4 Eli Rykoff
1988 1988 4 Ashwin Vishnu
1989 1989 3 谭九鼎
1990 1990 3 sleeping
1991 1991 3 Sylvain Corlay
1992 1992 3 Peter Corke
1993 1993 3 Paul Bissex
1994 1994 3 Matthew Feickert
1995 1995 3 Fernando Perez
1996 1996 3 Eric Wieser
1997 1997 3 Daniel Mietchen
1998 1998 3 Aditya Sathe
1999 1999 3 007vedant
2000 2000 2 rchiodo
2001 2001 2 nicolaslazo
2002 2002 2 luttik
2003 2003 2 gorogoroumaru
2004 2004 2 foobarbyte
2005 2005 2 bar-hen
2006 2006 2 Theo Ouzhinski
2007 2007 2 Strawkage
2008 2008 2 Samreen Zarroug
2009 2009 2 Pete Blois
2010 2010 2 Meysam Azad
2011 2011 2 Matthieu Ancellin
2012 2012 2 Mark Schmitz
2013 2013 2 Maor Kleinberger
2014 2014 2 MRCWirtz
2015 2015 2 Lumir Balhar
2016 2016 2 Julien Rabinow
2017 2017 2 Juan Luis Cano RodrΓ­guez
2018 2018 2 Joyce Er
2019 2019 2 Jakub
2020 2020 2 Faris A Chugthai
2021 2021 2 Ethan Madden
2022 2022 2 Dimitri Papadopoulos
2023 2023 2 Diego Fernandez
2024 2024 2 Daniel Shimon
2025 2025 2 Coco Bennett
2026 2026 2 Carlos Cordoba
2027 2027 2 Boyuan Liu
2028 2028 2 BaoGiang HoangVu
2029 2029 2 Augusto
2030 2030 2 Arthur Svistunov
2031 2031 2 Arthur Moreira
2032 2032 2 Ali Nabipour
2033 2033 2 Adam Hackbarth
2034 2034 1 richard
2035 2035 1 linar-jether
2036 2036 1 lbennett
2037 2037 1 juacrumar
2038 2038 1 gpotter2
2039 2039 1 digitalvirtuoso
2040 2040 1 dalthviz
2041 2041 1 Yonatan Goldschmidt
2042 2042 1 Tomasz KΕ‚oczko
2043 2043 1 Tobias Bengfort
2044 2044 1 Timur Kushukov
2045 2045 1 Thomas
2046 2046 1 Snir Broshi
2047 2047 1 Shao Yang Hong
2048 2048 1 Sanjana-03
2049 2049 1 Romulo Filho
2050 2050 1 Rodolfo Carvalho
2051 2051 1 Richard Shadrach
2052 2052 1 Reilly Tucker Siemens
2053 2053 1 Rakessh Roshan
2054 2054 1 Piers Titus van der Torren
2055 2055 1 PhanatosZou
2056 2056 1 Pavel Safronov
2057 2057 1 Paulo S. Costa
2058 2058 1 Paul McCarthy
2059 2059 1 NotWearingPants
2060 2060 1 Naelson Douglas
2061 2061 1 Michael Tiemann
2062 2062 1 Matt Wozniski
2063 2063 1 Markus Wageringel
2064 2064 1 Marcus Wirtz
2065 2065 1 Marcio Mazza
2066 2066 1 LumΓ­r 'Frenzy' Balhar
2067 2067 1 Lightyagami1
2068 2068 1 Leon Anavi
2069 2069 1 LeafyLi
2070 2070 1 L0uisJ0shua
2071 2071 1 Kyle Cutler
2072 2072 1 Krzysztof Cybulski
2073 2073 1 Kevin Kirsche
2074 2074 1 KIU Shueng Chuan
2075 2075 1 Jonathan Slenders
2076 2076 1 Jay Qi
2077 2077 1 Jake VanderPlas
2078 2078 1 Iwan Briquemont
2079 2079 1 Hussaina Begum Nandyala
2080 2080 1 Gordon Ball
2081 2081 1 Gabriel Simonetto
2082 2082 1 Frank Tobia
2083 2083 1 Erik
2084 2084 1 Elliott Sales de Andrade
2085 2085 1 Daniel Hahler
2086 2086 1 Dan Green-Leipciger
2087 2087 1 Dan Green
2088 2088 1 Damian Yurzola
2089 2089 1 Coon, Ethan T
2090 2090 1 Carol Willing
2091 2091 1 Brian Lee
2092 2092 1 Brendan Gerrity
2093 2093 1 Blake Griffin
2094 2094 1 Bastian Ebeling
2095 2095 1 Bartosz Telenczuk
2096 2096 1 Ankitsingh6299
2097 2097 1 Andrew Port
2098 2098 1 Andrew J. Hesford
2099 2099 1 Albert Zhang
2100 2100 1 Adam Johnson
2101 2101
2102 2102 This does not, of course, represent non-code contributions, for which we are also grateful.
2103 2103
2104 2104
2105 2105 API Changes using Frappuccino
2106 2106 -----------------------------
2107 2107
2108 2108 This is an experimental exhaustive API difference using `Frappuccino <https://pypi.org/project/frappuccino/>`_
2109 2109
2110 2110
2111 2111 The following items are new in IPython 8.0 ::
2112 2112
2113 2113 + IPython.core.async_helpers.get_asyncio_loop()
2114 2114 + IPython.core.completer.Dict
2115 2115 + IPython.core.completer.Pattern
2116 2116 + IPython.core.completer.Sequence
2117 2117 + IPython.core.completer.__skip_doctest__
2118 2118 + IPython.core.debugger.Pdb.precmd(self, line)
2119 2119 + IPython.core.debugger.__skip_doctest__
2120 2120 + IPython.core.display.__getattr__(name)
2121 2121 + IPython.core.display.warn
2122 2122 + IPython.core.display_functions
2123 2123 + IPython.core.display_functions.DisplayHandle
2124 2124 + IPython.core.display_functions.DisplayHandle.display(self, obj, **kwargs)
2125 2125 + IPython.core.display_functions.DisplayHandle.update(self, obj, **kwargs)
2126 2126 + IPython.core.display_functions.__all__
2127 2127 + IPython.core.display_functions.__builtins__
2128 2128 + IPython.core.display_functions.__cached__
2129 2129 + IPython.core.display_functions.__doc__
2130 2130 + IPython.core.display_functions.__file__
2131 2131 + IPython.core.display_functions.__loader__
2132 2132 + IPython.core.display_functions.__name__
2133 2133 + IPython.core.display_functions.__package__
2134 2134 + IPython.core.display_functions.__spec__
2135 2135 + IPython.core.display_functions.b2a_hex
2136 2136 + IPython.core.display_functions.clear_output(wait=False)
2137 2137 + IPython.core.display_functions.display(*objs, include='None', exclude='None', metadata='None', transient='None', display_id='None', raw=False, clear=False, **kwargs)
2138 2138 + IPython.core.display_functions.publish_display_data(data, metadata='None', source='<deprecated>', *, transient='None', **kwargs)
2139 2139 + IPython.core.display_functions.update_display(obj, *, display_id, **kwargs)
2140 2140 + IPython.core.extensions.BUILTINS_EXTS
2141 2141 + IPython.core.inputtransformer2.has_sunken_brackets(tokens)
2142 2142 + IPython.core.interactiveshell.Callable
2143 2143 + IPython.core.interactiveshell.__annotations__
2144 2144 + IPython.core.ultratb.List
2145 2145 + IPython.core.ultratb.Tuple
2146 2146 + IPython.lib.pretty.CallExpression
2147 2147 + IPython.lib.pretty.CallExpression.factory(name)
2148 2148 + IPython.lib.pretty.RawStringLiteral
2149 2149 + IPython.lib.pretty.RawText
2150 2150 + IPython.terminal.debugger.TerminalPdb.do_interact(self, arg)
2151 2151 + IPython.terminal.embed.Set
2152 2152
2153 2153 The following items have been removed (or moved to superclass)::
2154 2154
2155 2155 - IPython.core.application.BaseIPythonApplication.initialize_subcommand
2156 2156 - IPython.core.completer.Sentinel
2157 2157 - IPython.core.completer.skip_doctest
2158 2158 - IPython.core.debugger.Tracer
2159 2159 - IPython.core.display.DisplayHandle
2160 2160 - IPython.core.display.DisplayHandle.display
2161 2161 - IPython.core.display.DisplayHandle.update
2162 2162 - IPython.core.display.b2a_hex
2163 2163 - IPython.core.display.clear_output
2164 2164 - IPython.core.display.display
2165 2165 - IPython.core.display.publish_display_data
2166 2166 - IPython.core.display.update_display
2167 2167 - IPython.core.excolors.Deprec
2168 2168 - IPython.core.excolors.ExceptionColors
2169 2169 - IPython.core.history.warn
2170 2170 - IPython.core.hooks.late_startup_hook
2171 2171 - IPython.core.hooks.pre_run_code_hook
2172 2172 - IPython.core.hooks.shutdown_hook
2173 2173 - IPython.core.interactiveshell.InteractiveShell.init_deprecation_warnings
2174 2174 - IPython.core.interactiveshell.InteractiveShell.init_readline
2175 2175 - IPython.core.interactiveshell.InteractiveShell.write
2176 2176 - IPython.core.interactiveshell.InteractiveShell.write_err
2177 2177 - IPython.core.interactiveshell.get_default_colors
2178 2178 - IPython.core.interactiveshell.removed_co_newlocals
2179 2179 - IPython.core.magics.execution.ExecutionMagics.profile_missing_notice
2180 2180 - IPython.core.magics.script.PIPE
2181 2181 - IPython.core.prefilter.PrefilterManager.init_transformers
2182 2182 - IPython.core.release.classifiers
2183 2183 - IPython.core.release.description
2184 2184 - IPython.core.release.keywords
2185 2185 - IPython.core.release.long_description
2186 2186 - IPython.core.release.name
2187 2187 - IPython.core.release.platforms
2188 2188 - IPython.core.release.url
2189 2189 - IPython.core.ultratb.VerboseTB.format_records
2190 2190 - IPython.core.ultratb.find_recursion
2191 2191 - IPython.core.ultratb.findsource
2192 2192 - IPython.core.ultratb.fix_frame_records_filenames
2193 2193 - IPython.core.ultratb.inspect_error
2194 2194 - IPython.core.ultratb.is_recursion_error
2195 2195 - IPython.core.ultratb.with_patch_inspect
2196 2196 - IPython.external.__all__
2197 2197 - IPython.external.__builtins__
2198 2198 - IPython.external.__cached__
2199 2199 - IPython.external.__doc__
2200 2200 - IPython.external.__file__
2201 2201 - IPython.external.__loader__
2202 2202 - IPython.external.__name__
2203 2203 - IPython.external.__package__
2204 2204 - IPython.external.__path__
2205 2205 - IPython.external.__spec__
2206 2206 - IPython.kernel.KernelConnectionInfo
2207 2207 - IPython.kernel.__builtins__
2208 2208 - IPython.kernel.__cached__
2209 2209 - IPython.kernel.__warningregistry__
2210 2210 - IPython.kernel.pkg
2211 2211 - IPython.kernel.protocol_version
2212 2212 - IPython.kernel.protocol_version_info
2213 2213 - IPython.kernel.src
2214 2214 - IPython.kernel.version_info
2215 2215 - IPython.kernel.warn
2216 2216 - IPython.lib.backgroundjobs
2217 2217 - IPython.lib.backgroundjobs.BackgroundJobBase
2218 2218 - IPython.lib.backgroundjobs.BackgroundJobBase.run
2219 2219 - IPython.lib.backgroundjobs.BackgroundJobBase.traceback
2220 2220 - IPython.lib.backgroundjobs.BackgroundJobExpr
2221 2221 - IPython.lib.backgroundjobs.BackgroundJobExpr.call
2222 2222 - IPython.lib.backgroundjobs.BackgroundJobFunc
2223 2223 - IPython.lib.backgroundjobs.BackgroundJobFunc.call
2224 2224 - IPython.lib.backgroundjobs.BackgroundJobManager
2225 2225 - IPython.lib.backgroundjobs.BackgroundJobManager.flush
2226 2226 - IPython.lib.backgroundjobs.BackgroundJobManager.new
2227 2227 - IPython.lib.backgroundjobs.BackgroundJobManager.remove
2228 2228 - IPython.lib.backgroundjobs.BackgroundJobManager.result
2229 2229 - IPython.lib.backgroundjobs.BackgroundJobManager.status
2230 2230 - IPython.lib.backgroundjobs.BackgroundJobManager.traceback
2231 2231 - IPython.lib.backgroundjobs.__builtins__
2232 2232 - IPython.lib.backgroundjobs.__cached__
2233 2233 - IPython.lib.backgroundjobs.__doc__
2234 2234 - IPython.lib.backgroundjobs.__file__
2235 2235 - IPython.lib.backgroundjobs.__loader__
2236 2236 - IPython.lib.backgroundjobs.__name__
2237 2237 - IPython.lib.backgroundjobs.__package__
2238 2238 - IPython.lib.backgroundjobs.__spec__
2239 2239 - IPython.lib.kernel.__builtins__
2240 2240 - IPython.lib.kernel.__cached__
2241 2241 - IPython.lib.kernel.__doc__
2242 2242 - IPython.lib.kernel.__file__
2243 2243 - IPython.lib.kernel.__loader__
2244 2244 - IPython.lib.kernel.__name__
2245 2245 - IPython.lib.kernel.__package__
2246 2246 - IPython.lib.kernel.__spec__
2247 2247 - IPython.lib.kernel.__warningregistry__
2248 2248 - IPython.paths.fs_encoding
2249 2249 - IPython.terminal.debugger.DEFAULT_BUFFER
2250 2250 - IPython.terminal.debugger.cursor_in_leading_ws
2251 2251 - IPython.terminal.debugger.emacs_insert_mode
2252 2252 - IPython.terminal.debugger.has_selection
2253 2253 - IPython.terminal.debugger.vi_insert_mode
2254 2254 - IPython.terminal.interactiveshell.DISPLAY_BANNER_DEPRECATED
2255 2255 - IPython.terminal.ipapp.TerminalIPythonApp.parse_command_line
2256 2256 - IPython.testing.test
2257 2257 - IPython.utils.contexts.NoOpContext
2258 2258 - IPython.utils.io.IOStream
2259 2259 - IPython.utils.io.IOStream.close
2260 2260 - IPython.utils.io.IOStream.write
2261 2261 - IPython.utils.io.IOStream.writelines
2262 2262 - IPython.utils.io.__warningregistry__
2263 2263 - IPython.utils.io.atomic_writing
2264 2264 - IPython.utils.io.stderr
2265 2265 - IPython.utils.io.stdin
2266 2266 - IPython.utils.io.stdout
2267 2267 - IPython.utils.io.unicode_std_stream
2268 2268 - IPython.utils.path.get_ipython_cache_dir
2269 2269 - IPython.utils.path.get_ipython_dir
2270 2270 - IPython.utils.path.get_ipython_module_path
2271 2271 - IPython.utils.path.get_ipython_package_dir
2272 2272 - IPython.utils.path.locate_profile
2273 2273 - IPython.utils.path.unquote_filename
2274 2274 - IPython.utils.py3compat.PY2
2275 2275 - IPython.utils.py3compat.PY3
2276 2276 - IPython.utils.py3compat.buffer_to_bytes
2277 2277 - IPython.utils.py3compat.builtin_mod_name
2278 2278 - IPython.utils.py3compat.cast_bytes
2279 2279 - IPython.utils.py3compat.getcwd
2280 2280 - IPython.utils.py3compat.isidentifier
2281 2281 - IPython.utils.py3compat.u_format
2282 2282
2283 2283 The following signatures differ between 7.x and 8.0::
2284 2284
2285 2285 - IPython.core.completer.IPCompleter.unicode_name_matches(self, text)
2286 2286 + IPython.core.completer.IPCompleter.unicode_name_matches(text)
2287 2287
2288 2288 - IPython.core.completer.match_dict_keys(keys, prefix, delims)
2289 2289 + IPython.core.completer.match_dict_keys(keys, prefix, delims, extra_prefix='None')
2290 2290
2291 2291 - IPython.core.interactiveshell.InteractiveShell.object_inspect_mime(self, oname, detail_level=0)
2292 2292 + IPython.core.interactiveshell.InteractiveShell.object_inspect_mime(self, oname, detail_level=0, omit_sections='()')
2293 2293
2294 2294 - IPython.core.interactiveshell.InteractiveShell.set_hook(self, name, hook, priority=50, str_key='None', re_key='None', _warn_deprecated=True)
2295 2295 + IPython.core.interactiveshell.InteractiveShell.set_hook(self, name, hook, priority=50, str_key='None', re_key='None')
2296 2296
2297 2297 - IPython.core.oinspect.Inspector.info(self, obj, oname='', formatter='None', info='None', detail_level=0)
2298 2298 + IPython.core.oinspect.Inspector.info(self, obj, oname='', info='None', detail_level=0)
2299 2299
2300 2300 - IPython.core.oinspect.Inspector.pinfo(self, obj, oname='', formatter='None', info='None', detail_level=0, enable_html_pager=True)
2301 2301 + IPython.core.oinspect.Inspector.pinfo(self, obj, oname='', formatter='None', info='None', detail_level=0, enable_html_pager=True, omit_sections='()')
2302 2302
2303 2303 - IPython.core.profiledir.ProfileDir.copy_config_file(self, config_file, path='None', overwrite=False)
2304 2304 + IPython.core.profiledir.ProfileDir.copy_config_file(self, config_file, path, overwrite=False)
2305 2305
2306 2306 - IPython.core.ultratb.VerboseTB.format_record(self, frame, file, lnum, func, lines, index)
2307 2307 + IPython.core.ultratb.VerboseTB.format_record(self, frame_info)
2308 2308
2309 2309 - IPython.terminal.embed.InteractiveShellEmbed.mainloop(self, local_ns='None', module='None', stack_depth=0, display_banner='None', global_ns='None', compile_flags='None')
2310 2310 + IPython.terminal.embed.InteractiveShellEmbed.mainloop(self, local_ns='None', module='None', stack_depth=0, compile_flags='None')
2311 2311
2312 2312 - IPython.terminal.embed.embed(**kwargs)
2313 2313 + IPython.terminal.embed.embed(*, header='', compile_flags='None', **kwargs)
2314 2314
2315 2315 - IPython.terminal.interactiveshell.TerminalInteractiveShell.interact(self, display_banner='<object object at 0xffffff>')
2316 2316 + IPython.terminal.interactiveshell.TerminalInteractiveShell.interact(self)
2317 2317
2318 2318 - IPython.terminal.interactiveshell.TerminalInteractiveShell.mainloop(self, display_banner='<object object at 0xffffff>')
2319 2319 + IPython.terminal.interactiveshell.TerminalInteractiveShell.mainloop(self)
2320 2320
2321 2321 - IPython.utils.path.get_py_filename(name, force_win32='None')
2322 2322 + IPython.utils.path.get_py_filename(name)
2323 2323
2324 2324 The following are new attributes (that might be inherited)::
2325 2325
2326 2326 + IPython.core.completer.IPCompleter.unicode_names
2327 2327 + IPython.core.debugger.InterruptiblePdb.precmd
2328 2328 + IPython.core.debugger.Pdb.precmd
2329 2329 + IPython.core.ultratb.AutoFormattedTB.has_colors
2330 2330 + IPython.core.ultratb.ColorTB.has_colors
2331 2331 + IPython.core.ultratb.FormattedTB.has_colors
2332 2332 + IPython.core.ultratb.ListTB.has_colors
2333 2333 + IPython.core.ultratb.SyntaxTB.has_colors
2334 2334 + IPython.core.ultratb.TBTools.has_colors
2335 2335 + IPython.core.ultratb.VerboseTB.has_colors
2336 2336 + IPython.terminal.debugger.TerminalPdb.do_interact
2337 2337 + IPython.terminal.debugger.TerminalPdb.precmd
2338 2338
2339 2339 The following attribute/methods have been removed::
2340 2340
2341 2341 - IPython.core.application.BaseIPythonApplication.deprecated_subcommands
2342 2342 - IPython.core.ultratb.AutoFormattedTB.format_records
2343 2343 - IPython.core.ultratb.ColorTB.format_records
2344 2344 - IPython.core.ultratb.FormattedTB.format_records
2345 2345 - IPython.terminal.embed.InteractiveShellEmbed.init_deprecation_warnings
2346 2346 - IPython.terminal.embed.InteractiveShellEmbed.init_readline
2347 2347 - IPython.terminal.embed.InteractiveShellEmbed.write
2348 2348 - IPython.terminal.embed.InteractiveShellEmbed.write_err
2349 2349 - IPython.terminal.interactiveshell.TerminalInteractiveShell.init_deprecation_warnings
2350 2350 - IPython.terminal.interactiveshell.TerminalInteractiveShell.init_readline
2351 2351 - IPython.terminal.interactiveshell.TerminalInteractiveShell.write
2352 2352 - IPython.terminal.interactiveshell.TerminalInteractiveShell.write_err
2353 2353 - IPython.terminal.ipapp.LocateIPythonApp.deprecated_subcommands
2354 2354 - IPython.terminal.ipapp.LocateIPythonApp.initialize_subcommand
2355 2355 - IPython.terminal.ipapp.TerminalIPythonApp.deprecated_subcommands
2356 2356 - IPython.terminal.ipapp.TerminalIPythonApp.initialize_subcommand
2357 2357
2358 2358 ------
2359 2359
2360 2360 .. [1] If this make you incomfortable feel free to not use IPython 8.23.
General Comments 0
You need to be logged in to leave comments. Login now