CVS commit: pkgsrc/devel/py-ipython

["Adam Ciarcinski" <adam%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   adam
Date:           Mon Apr  3 17:33:39 UTC 2023

Modified Files:
        pkgsrc/devel/py-ipython: Makefile distinfo

Log Message:
py-ipython: updated to 8.12.0

IPython 8.12
------------

Hopefully slightly early release for IPython 8.12. Last Thursday of the month,
even if I guess it's likely already Friday somewhere in the pacific ocean.

A number of PRs and bug fixes this month with close to 20 PRs merged !

The IPython repo reached :ghpull:``14000`` !! Actually the PR that create those exact release
note is :ghpull:`14000`. Ok, more issues and PR is not always better, and I'd
love to have more time to close issues and Pull Requests.

Let's note that in less than 2 month JupyterCon is back, in Paris please visit
`jupytercon.com <https://jupytercon.com>`__, and looking forward to see you
there.

Packagers should take note that ``typing_extension`` is now a mandatory dependency
for Python versions ``<3.10``.

Let's note also that according to `NEP29
<https://numpy.org/neps/nep-0029-deprecation_policy.html>`__, It is soon time to
stop support for Python 3.8 that will be release more than 3 and 1/2 years ago::

    On Apr 14, 2023 drop support for Python 3.8 (initially released on Oct 14, 2019)

Thus I am likely to stop advertising support for Python 3.8 in the next
release at the end of April.

Here are some miscellaneous updates of interest:

 - :ghpull:`13957` brings updates to the Qt integration, particularly for Qt6.
 - :ghpull:`13960` fixes the %debug magic command to give access to the local
   scope.
 - :ghpull:`13964` fixes some crashes with the new fast traceback code. Note that
   there are still some issues with the fast traceback code, and I a, likely
   to fix and tweak behavior.
 - :ghpull:`13973` We are slowly migrating IPython internals to use proper type
   objects/dataclasses instead of dictionaries to allow static typing checks.
   These are technically public API and could lead to breakage, so please let us
   know if that's the case and I'll mitigate.
 - :ghpull:`13990`, :ghpull:`13991`, :ghpull:`13994` all improve keybinding and
   shortcut configurability.

As usual you can find the full list of PRs on GitHub under `the 8.12 milestone
<https://github.com/ipython/ipython/milestone/114?closed=1>`__.

We want to thank the D.E. Shaw group for requesting and sponsoring the work on
the following big feature. We had productive discussions on how to best expose
this feature

Dynamic documentation dispatch
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

We are experimenting with dynamic documentation dispatch for object attribute.
See :ghissue:`13860`. The goal is to allow object to define documentation for
their attributes, properties, even when those are dynamically defined with
`__getattr__`.

In particular when those objects are base types it can be useful to show the
documentation

.. code-block:: ipython

    In [1]: class User:
       ...:
       ...:     __custom_documentations__ = {
       ...:         "first": "The first name of the user.",
       ...:         "last": "The last name of the user.",
       ...:     }
       ...:
       ...:     first:str
       ...:     last:str
       ...:
       ...:     def __init__(self, first, last):
       ...:         self.first = first
       ...:         self.last = last
       ...:
       ...:     @property
       ...:     def full(self):
       ...:         """`self.first` and `self.last` joined by a space."""
       ...:         return self.first + " " + self.last
       ...:
       ...:
       ...: user = Person('Jane', 'Doe')

    In [2]: user.first?
    Type:            str
    String form:     Jane
    Length:          4
    Docstring:       the first name of a the person object, a str
    Class docstring:
    ....

    In [3]: user.last?
    Type:            str
    String form:     Doe
    Length:          3
    Docstring:       the last name, also a str
    ...

We can see here the symmetry with IPython looking for the docstring on the
properties:

.. code-block:: ipython

    In [4]: user.full?
    HERE
    Type:        property
    String form: <property object at 0x102bb15d0>
    Docstring:   first and last join by a space

Note that while in the above example we use a static dictionary, libraries may
decide to use a custom object that define ``__getitem__``, we caution against
using objects that would trigger computation to show documentation, but it is
sometime preferable for highly dynamic code that for example export ans API as
object.


To generate a diff of this commit:
cvs rdiff -u -r1.86 -r1.87 pkgsrc/devel/py-ipython/Makefile
cvs rdiff -u -r1.59 -r1.60 pkgsrc/devel/py-ipython/distinfo

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/devel/py-ipython/Makefile
diff -u pkgsrc/devel/py-ipython/Makefile:1.86 pkgsrc/devel/py-ipython/Makefile:1.87
--- pkgsrc/devel/py-ipython/Makefile:1.86       Thu Mar  2 12:47:08 2023
+++ pkgsrc/devel/py-ipython/Makefile    Mon Apr  3 17:33:39 2023
@@ -1,6 +1,6 @@
-# $NetBSD: Makefile,v 1.86 2023/03/02 12:47:08 adam Exp $
+# $NetBSD: Makefile,v 1.87 2023/04/03 17:33:39 adam Exp $
 
-DISTNAME=      ipython-8.11.0
+DISTNAME=      ipython-8.12.0
 PKGNAME=       ${PYPKGPREFIX}-${DISTNAME}
 CATEGORIES=    devel python
 MASTER_SITES=  ${MASTER_SITE_PYPI:=i/ipython/}

Index: pkgsrc/devel/py-ipython/distinfo
diff -u pkgsrc/devel/py-ipython/distinfo:1.59 pkgsrc/devel/py-ipython/distinfo:1.60
--- pkgsrc/devel/py-ipython/distinfo:1.59       Thu Mar  2 12:47:08 2023
+++ pkgsrc/devel/py-ipython/distinfo    Mon Apr  3 17:33:39 2023
@@ -1,6 +1,6 @@
-$NetBSD: distinfo,v 1.59 2023/03/02 12:47:08 adam Exp $
+$NetBSD: distinfo,v 1.60 2023/04/03 17:33:39 adam Exp $
 
-BLAKE2s (ipython-8.11.0.tar.gz) = 46e7a9053469e8e234a527312854c0c0d232c3e213e0bb0e0ab7a306639e148a
-SHA512 (ipython-8.11.0.tar.gz) = 9b07da3fed304f6739396883d0219386bb08d4860853b30f308c2e9b9017f48d1228dedb511c872b706881ee80dc7bf03f541720ffb816c35b66f6f53ac289a3
-Size (ipython-8.11.0.tar.gz) = 5462176 bytes
+BLAKE2s (ipython-8.12.0.tar.gz) = f0cc29718c4bfc65942cfd124e60cd1980bbecae8593fc6d997d378d933210de
+SHA512 (ipython-8.12.0.tar.gz) = 3e9a42a6fb34a46d32d1236eac99182a756db2ec7b57c77dbedff1e4b25bcf2ef37effe4e5575cda450a1cde77e3c0d24172dcf19d102110a1ac75b9cfe9272c
+Size (ipython-8.12.0.tar.gz) = 5465154 bytes
 SHA1 (patch-setupbase.py) = 241463d5368a4c80c8194244f5c3895196b44da5