bpo-36982: add new function: curses.has_extended_color_support()

to indicate whether extended colors are suported by the underlying ncurses library.
websurfer5 · May 21, 2019 · May 22, 2019 · May 23, 2019 · May 24, 2019 · May 24, 2019
commit 765d44d347a68172dc83e1e21b05e57cd276fdcd
diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst
@@ -242,6 +242,16 @@ The module :mod:`curses` defines the following functions:
 
    Return ``True`` if the terminal can display colors; otherwise, return ``False``.
 
+.. function:: has_extended_color_support()
+
+   Return ``True`` if the module supports extended colors; otherwise, return
+   ``False``. Extended color support allows more than 256 color-pairs for
+   terminals that support more than 16 colors (e.g. xterm-256color).
+
+   Extended color support requires ncurses version 6.1 or later.
+
+   .. versionadded:: 3.8
+
 
 .. function:: has_ic()
 

diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
@@ -375,6 +375,13 @@ Added a new variable holding structured version information for the
 underlying ncurses library: :data:`~curses.ncurses_version`.
 (Contributed by Serhiy Storchaka in :issue:`31680`.)
 
+The extended color functions added in ncurses 6.1 will be used transparently
+by :func:`curses.color_content`, :func:`curses.init_color`,
+:func:`curses.init_pair`, and :func:`curses.pair_content`. A new function,
+:func:`curses.has_extended_color_support`, indicates whether extended color
+support is provided by the underlying ncurses library.
+(Contributed by Jeffrey Kintscher in :issue:`36982`.)
+
 
 pathlib
 -------

diff --git a/Modules/_cursesmodule.c b/Modules/_cursesmodule.c
@@ -4403,6 +4403,7 @@ static PyMethodDef PyCurses_methods[] = {
     _CURSES_GETSYX_METHODDEF
     _CURSES_GETWIN_METHODDEF
     _CURSES_HAS_COLORS_METHODDEF
+    _CURSES_HAS_EXTENDED_COLOR_SUPPORT_METHODDEF
     _CURSES_HAS_IC_METHODDEF
     _CURSES_HAS_IL_METHODDEF
     _CURSES_HAS_KEY_METHODDEF

diff --git a/Modules/clinic/_cursesmodule.c.h b/Modules/clinic/_cursesmodule.c.h