back to dev

release 8.22.0

What's new 8.22 (#14351)

IPython/utils/path.py: Deprecate unused `target_outdated`, `target_update` (#14348) These functions are unused. I propose to deprecate them (`setupbase.py` brings its own copy of these functions.)

What's new 8.22

Emit deprecations warnings

Minor typing and updates post new inspector API (#14349) See #14342

Minor typing and updates post new inspector API See #14342

Improve typing and MIME hook API for inspector (#14342) Fixes https://github.com/ipython/ipython/issues/14339 ### Additions Adds `InfoDict` type to improve the typing of `info()` result. Adds missing `"subclasses"` to `info_fields` list (these were added to the field list in https://github.com/ipython/ipython/pull/11486 but we forgot to update `info_fields` variable at the time) - the newly added `InfoDict` type will ensure that this won't happen again. Adds `InspectorHookData` dataclass which is passed to the MIME hooks which now should expect a single argument. Having a single dataclass argument enables us to deprecate individual fields, or add new fields without breaking the existing hooks. The old hooks will still work (if any are out there since this mechanism got just added in the previous point version). ### Deletions A comment over `info_fields` gets deleted: - Contrarily to the comment (which is getting deleted in this PR), `info_fields` were not defining the order of display since at least 2015 (https://github.com/ipython/ipython/pull/7903 - I did not feel the need to go further in the history to find when exactly it happened). - Also contrarily to this comment, current Jupyter messaging spec does not define the contents of `info_fields` (I guess this was lost during IPython/Jupyter split), but the newly added `InfoDict` at least properly annotates their type (if you know where I can find the old IPython messaging spec with the descriptions I can add these as doc comments). Unused `cast_unicode` import gets deleted. If someone imported it from here... well they really should not have. ### Deprecations - mime hooks taking two arguments (`obj, info`)

Fix missing jQuery in documentation (#14346) It's been 8 years since I last updated my IPython fork... 😄  Fix #14213 by adding https://pypi.org/project/sphinxcontrib-jquery/ to the Sphinx extensions, see https://github.com/sphinx-doc/sphinx/issues/10070 and https://github.com/sphinx-doc/sphinx/issues/7405 for extra context. Also fix #14264.

Fix for dynamically evaluated source code traceback (#14345) And add test. This should close #14057

Do not deprecate `object_info` as this is used elsewhere We might decide to deprecate it separately in another PR

IPython/utils/path.py: Deprecate unused functions target_outdated, target_update

Style

Add sphinxcontrib-jquery to doc dependencies

Add `sphinxcontrib.jquery` to Sphinx extensions

Fix for dynamically evaluated source code traceback And add test. This should close #14057

Remove no longer needed mypy note, mention darker/black versions (#14343) Fixes https://github.com/ipython/ipython/issues/14338 Thanks @s-kai273 for pointing out missing version info.

pyproject.toml (project.entrypoints, project.scripts): Define here (#14340) ... instead of in setup.py, setupbase.py Another step toward removing setup.py, as requested by @Carreau in https://github.com/ipython/ipython/pull/14327#pullrequestreview-1884755776

Improve typing and MIME hook API for inspector