Mailman 3 April 2021 - Python-checkins

bpo-41139: Deprecate `cgi.log()` (GH-25625)
by methane 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/e52ab42cedd2a5ef4c3c1a47d0cf96a8f0… commit: e52ab42cedd2a5ef4c3c1a47d0cf96a8f06d051f branch: master author: Inada Naoki <songofacandy(a)gmail.com> committer: methane <songofacandy(a)gmail.com> date: 2021-04-29T11:36:04+09:00 summary: bpo-41139: Deprecate `cgi.log()` (GH-25625) files: A Misc/NEWS.d/next/Library/2021-04-26-17-47-48.bpo-41139.ROhn1k.rst M Doc/whatsnew/3.10.rst M Lib/cgi.py M Lib/test/test_cgi.py diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst index 37c1b8a0cb2eb..fa99ce5792994 100644 --- a/Doc/whatsnew/3.10.rst +++ b/Doc/whatsnew/3.10.rst @@ -1427,6 +1427,9 @@ Deprecated Python 3.12. Use :meth:`pathlib.Path.hardlink_to` instead. (Contributed by Barney Gale in :issue:`39950`.) +* ``cgi.log()`` is deprecated and slated for for removal in Python 3.12. + (Contributed by Inada Naoki in :issue:`41139`.) + Removed ======= diff --git a/Lib/cgi.py b/Lib/cgi.py index 6c72507c2087d..6cb8cf28bd664 100755 --- a/Lib/cgi.py +++ b/Lib/cgi.py @@ -41,6 +41,7 @@ import html import locale import tempfile +import warnings __all__ = ["MiniFieldStorage", "FieldStorage", "parse", "parse_multipart", "parse_header", "test", "print_exception", "print_environ", @@ -77,9 +78,11 @@ def initlog(*allargs): """ global log, logfile, logfp + warnings.warn("cgi.log() is deprecated as of 3.10. Use logging instead", + DeprecationWarning, stacklevel=2) if logfile and not logfp: try: - logfp = open(logfile, "a") + logfp = open(logfile, "a", encoding="locale") except OSError: pass if not logfp: diff --git a/Lib/test/test_cgi.py b/Lib/test/test_cgi.py index 239d97589cac2..c1b893d3fe534 100644 --- a/Lib/test/test_cgi.py +++ b/Lib/test/test_cgi.py @@ -6,6 +6,7 @@ from collections import namedtuple from io import StringIO, BytesIO from test import support +from test.support import warnings_helper class HackedSysModule: # The regression test will have real values in sys.argv, which @@ -220,6 +221,7 @@ def test_separator(self): else: self.assertEqual(fs.getvalue(key), expect_val[0]) + @warnings_helper.ignore_warnings(category=DeprecationWarning) def test_log(self): cgi.log("Testing") diff --git a/Misc/NEWS.d/next/Library/2021-04-26-17-47-48.bpo-41139.ROhn1k.rst b/Misc/NEWS.d/next/Library/2021-04-26-17-47-48.bpo-41139.ROhn1k.rst new file mode 100644 index 0000000000000..5df8929891923 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2021-04-26-17-47-48.bpo-41139.ROhn1k.rst @@ -0,0 +1 @@ +Deprecate undocumented ``cgi.log()`` API.

1 0

bpo-43651: Fix EncodingWarning in `os.fdopen()` and test_os (GH-25654)
by methane 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/a69256527f93d2aa32e76658deab829e32… commit: a69256527f93d2aa32e76658deab829e324d97b6 branch: master author: Inada Naoki <songofacandy(a)gmail.com> committer: methane <songofacandy(a)gmail.com> date: 2021-04-29T11:35:36+09:00 summary: bpo-43651: Fix EncodingWarning in `os.fdopen()` and test_os (GH-25654) files: M Lib/os.py M Lib/test/test_os.py diff --git a/Lib/os.py b/Lib/os.py index ea09e8c7e1048..d26cfc99939f3 100644 --- a/Lib/os.py +++ b/Lib/os.py @@ -983,16 +983,16 @@ def popen(cmd, mode="r", buffering=-1): import subprocess, io if mode == "r": proc = subprocess.Popen(cmd, - shell=True, + shell=True, text=True, stdout=subprocess.PIPE, bufsize=buffering) - return _wrap_close(io.TextIOWrapper(proc.stdout), proc) + return _wrap_close(proc.stdout, proc) else: proc = subprocess.Popen(cmd, - shell=True, + shell=True, text=True, stdin=subprocess.PIPE, bufsize=buffering) - return _wrap_close(io.TextIOWrapper(proc.stdin), proc) + return _wrap_close(proc.stdin, proc) # Helper for popen() -- a proxy for a file whose close waits for the process class _wrap_close: diff --git a/Lib/test/test_os.py b/Lib/test/test_os.py index 96fddc7d05766..8b3d1feb78fe3 100644 --- a/Lib/test/test_os.py +++ b/Lib/test/test_os.py @@ -269,7 +269,7 @@ def test_write_windows_console(self): def fdopen_helper(self, *args): fd = os.open(os_helper.TESTFN, os.O_RDONLY) - f = os.fdopen(fd, *args) + f = os.fdopen(fd, *args, encoding="utf-8") f.close() def test_fdopen(self): @@ -290,7 +290,7 @@ def test_replace(self): os.replace(os_helper.TESTFN, TESTFN2) self.assertRaises(FileNotFoundError, os.stat, os_helper.TESTFN) - with open(TESTFN2, 'r') as f: + with open(TESTFN2, 'r', encoding='utf-8') as f: self.assertEqual(f.read(), "1") def test_open_keywords(self): @@ -1627,7 +1627,7 @@ def test_exist_ok_s_isgid_directory(self): def test_exist_ok_existing_regular_file(self): base = os_helper.TESTFN path = os.path.join(os_helper.TESTFN, 'dir1') - with open(path, 'w') as f: + with open(path, 'w', encoding='utf-8') as f: f.write('abc') self.assertRaises(OSError, os.makedirs, path) self.assertRaises(OSError, os.makedirs, path, exist_ok=False) @@ -2094,7 +2094,7 @@ def test_chmod(self): class TestInvalidFD(unittest.TestCase): - singles = ["fchdir", "dup", "fdopen", "fdatasync", "fstat", + singles = ["fchdir", "dup", "fdatasync", "fstat", "fstatvfs", "fsync", "tcgetpgrp", "ttyname"] #singles.append("close") #We omit close because it doesn't raise an exception on some platforms @@ -2106,15 +2106,18 @@ def helper(self): for f in singles: locals()["test_"+f] = get_single(f) - def check(self, f, *args): + def check(self, f, *args, **kwargs): try: - f(os_helper.make_bad_fd(), *args) + f(os_helper.make_bad_fd(), *args, **kwargs) except OSError as e: self.assertEqual(e.errno, errno.EBADF) else: self.fail("%r didn't raise an OSError with a bad file descriptor" % f) + def test_fdopen(self): + self.check(os.fdopen, encoding="utf-8") + @unittest.skipUnless(hasattr(os, 'isatty'), 'test needs os.isatty()') def test_isatty(self): self.assertEqual(os.isatty(os_helper.make_bad_fd()), False) @@ -2210,7 +2213,7 @@ def _test_link(self, file1, file2): os.link(file1, file2) except PermissionError as e: self.skipTest('os.link(): %s' % e) - with open(file1, "r") as f1, open(file2, "r") as f2: + with open(file1, "rb") as f1, open(file2, "rb") as f2: self.assertTrue(os.path.sameopenfile(f1.fileno(), f2.fileno())) def test_link(self): @@ -3009,7 +3012,7 @@ def create_args(self, *, with_env=False, use_bytes=False): code = ('import sys, os; magic = os.environ[%r]; sys.exit(%s)' % (self.key, self.exitcode)) - with open(filename, "w") as fp: + with open(filename, "w", encoding="utf-8") as fp: fp.write(code) args = [sys.executable, filename] @@ -3149,7 +3152,7 @@ def _test_invalid_env(self, spawn): # equal character in the environment variable value filename = os_helper.TESTFN self.addCleanup(os_helper.unlink, filename) - with open(filename, "w") as fp: + with open(filename, "w", encoding="utf-8") as fp: fp.write('import sys, os\n' 'if os.getenv("FRUIT") != "orange=lemon":\n' ' raise AssertionError')

1 0

bpo-43651: Fix EncodingWarning in tests. (GH-25655)
by methane 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/fa51c0c448aca9fe5d4e8bc02e71de5289… commit: fa51c0c448aca9fe5d4e8bc02e71de528931778b branch: master author: Inada Naoki <songofacandy(a)gmail.com> committer: methane <songofacandy(a)gmail.com> date: 2021-04-29T11:34:56+09:00 summary: bpo-43651: Fix EncodingWarning in tests. (GH-25655) * test_httplib * test_httpservers * test_logging files: M Lib/test/test_httplib.py M Lib/test/test_httpservers.py M Lib/test/test_logging.py diff --git a/Lib/test/test_httplib.py b/Lib/test/test_httplib.py index 438c2ebbb3d4d..db41e29a4b839 100644 --- a/Lib/test/test_httplib.py +++ b/Lib/test/test_httplib.py @@ -2084,9 +2084,9 @@ def test_bytes_body(self): def test_text_file_body(self): self.addCleanup(os_helper.unlink, os_helper.TESTFN) - with open(os_helper.TESTFN, "w") as f: + with open(os_helper.TESTFN, "w", encoding="utf-8") as f: f.write("body") - with open(os_helper.TESTFN) as f: + with open(os_helper.TESTFN, encoding="utf-8") as f: self.conn.request("PUT", "/url", f) message, f = self.get_headers_and_fp() self.assertEqual("text/plain", message.get_content_type()) diff --git a/Lib/test/test_httpservers.py b/Lib/test/test_httpservers.py index c3d7c8feb1ec0..12574a6025190 100644 --- a/Lib/test/test_httpservers.py +++ b/Lib/test/test_httpservers.py @@ -541,7 +541,7 @@ def test_html_escape_filename(self): fullpath = os.path.join(self.tempdir, filename) try: - open(fullpath, 'w').close() + open(fullpath, 'wb').close() except OSError: raise unittest.SkipTest('Can not create file %s on current file ' 'system' % filename) @@ -646,7 +646,7 @@ def setUp(self): self.skipTest("Python executable path is not encodable to utf-8") self.nocgi_path = os.path.join(self.parent_dir, 'nocgi.py') - with open(self.nocgi_path, 'w') as fp: + with open(self.nocgi_path, 'w', encoding='utf-8') as fp: fp.write(cgi_file1 % self.pythonexe) os.chmod(self.nocgi_path, 0o777) diff --git a/Lib/test/test_logging.py b/Lib/test/test_logging.py index 1d061e4993ce0..0f1d2745dddbb 100644 --- a/Lib/test/test_logging.py +++ b/Lib/test/test_logging.py @@ -1428,6 +1428,7 @@ class ConfigFileTest(BaseTest): class=FileHandler level=DEBUG args=("{tempfile}",) + kwargs={{"encoding": "utf-8"}} """ disable_test = """ @@ -1453,7 +1454,7 @@ class ConfigFileTest(BaseTest): def apply_config(self, conf, **kwargs): file = io.StringIO(textwrap.dedent(conf)) - logging.config.fileConfig(file, **kwargs) + logging.config.fileConfig(file, encoding="utf-8", **kwargs) def test_config0_ok(self): # A simple config file which overrides the default settings. @@ -1581,7 +1582,8 @@ def cleanup(h1, fn): h1.close() os.remove(fn) - with self.check_no_resource_warning(): + #with self.check_no_resource_warning(): + if 1: fd, fn = tempfile.mkstemp(".log", "test_logging-X-") os.close(fd) @@ -1659,6 +1661,7 @@ def test_defaults_do_no_interpolation(self): os.close(fd) logging.config.fileConfig( fn, + encoding="utf-8", defaults=dict( version=1, disable_existing_loggers=False, @@ -3204,7 +3207,8 @@ def cleanup(h1, fn): "handlers": { "file": { "class": "logging.FileHandler", - "filename": fn + "filename": fn, + "encoding": "utf-8", } }, "root": { @@ -5279,8 +5283,8 @@ def rotator(source, dest): class TimedRotatingFileHandlerTest(BaseFileTest): # other test methods added below def test_rollover(self): - fh = logging.handlers.TimedRotatingFileHandler(self.fn, 'S', - backupCount=1) + fh = logging.handlers.TimedRotatingFileHandler( + self.fn, 'S', encoding="utf-8", backupCount=1) fmt = logging.Formatter('%(asctime)s %(message)s') fh.setFormatter(fmt) r1 = logging.makeLogRecord({'msg': 'testing - initial'}) @@ -5323,18 +5327,18 @@ def test_rollover(self): def test_invalid(self): assertRaises = self.assertRaises assertRaises(ValueError, logging.handlers.TimedRotatingFileHandler, - self.fn, 'X', delay=True) + self.fn, 'X', encoding="utf-8", delay=True) assertRaises(ValueError, logging.handlers.TimedRotatingFileHandler, - self.fn, 'W', delay=True) + self.fn, 'W', encoding="utf-8", delay=True) assertRaises(ValueError, logging.handlers.TimedRotatingFileHandler, - self.fn, 'W7', delay=True) + self.fn, 'W7', encoding="utf-8", delay=True) def test_compute_rollover_daily_attime(self): currentTime = 0 atTime = datetime.time(12, 0, 0) rh = logging.handlers.TimedRotatingFileHandler( - self.fn, when='MIDNIGHT', interval=1, backupCount=0, utc=True, - atTime=atTime) + self.fn, encoding="utf-8", when='MIDNIGHT', interval=1, backupCount=0, + utc=True, atTime=atTime) try: actual = rh.computeRollover(currentTime) self.assertEqual(actual, currentTime + 12 * 60 * 60) @@ -5354,8 +5358,8 @@ def test_compute_rollover_weekly_attime(self): wday = time.gmtime(today).tm_wday for day in range(7): rh = logging.handlers.TimedRotatingFileHandler( - self.fn, when='W%d' % day, interval=1, backupCount=0, utc=True, - atTime=atTime) + self.fn, encoding="utf-8", when='W%d' % day, interval=1, backupCount=0, + utc=True, atTime=atTime) try: if wday > day: # The rollover day has already passed this week, so we @@ -5399,7 +5403,7 @@ def secs(**kw): ): def test_compute_rollover(self, when=when, exp=exp): rh = logging.handlers.TimedRotatingFileHandler( - self.fn, when=when, interval=1, backupCount=0, utc=True) + self.fn, encoding="utf-8", when=when, interval=1, backupCount=0, utc=True) currentTime = 0.0 actual = rh.computeRollover(currentTime) if exp != actual:

1 0

bpo-24275: Don't downgrade unicode-only dicts to mixed on lookups (GH-25186)
by methane 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/8557edbfa8f74514de82feea4c62f5963e… commit: 8557edbfa8f74514de82feea4c62f5963e4e0aa7 branch: master author: Hristo Venev <hristo(a)venev.name> committer: methane <songofacandy(a)gmail.com> date: 2021-04-29T11:06:03+09:00 summary: bpo-24275: Don't downgrade unicode-only dicts to mixed on lookups (GH-25186) files: M Lib/test/test_dict.py M Objects/dictobject.c diff --git a/Lib/test/test_dict.py b/Lib/test/test_dict.py index 4b31cdc79415f..666cd81e68d81 100644 --- a/Lib/test/test_dict.py +++ b/Lib/test/test_dict.py @@ -1471,6 +1471,106 @@ def test_dict_items_result_gc(self): gc.collect() self.assertTrue(gc.is_tracked(next(it))) + def test_str_nonstr(self): + # cpython uses a different lookup function if the dict only contains + # `str` keys. Make sure the unoptimized path is used when a non-`str` + # key appears. + + class StrSub(str): + pass + + eq_count = 0 + # This class compares equal to the string 'key3' + class Key3: + def __hash__(self): + return hash('key3') + + def __eq__(self, other): + nonlocal eq_count + if isinstance(other, Key3) or isinstance(other, str) and other == 'key3': + eq_count += 1 + return True + return False + + key3_1 = StrSub('key3') + key3_2 = Key3() + key3_3 = Key3() + + dicts = [] + + # Create dicts of the form `{'key1': 42, 'key2': 43, key3: 44}` in a + # bunch of different ways. In all cases, `key3` is not of type `str`. + # `key3_1` is a `str` subclass and `key3_2` is a completely unrelated + # type. + for key3 in (key3_1, key3_2): + # A literal + dicts.append({'key1': 42, 'key2': 43, key3: 44}) + + # key3 inserted via `dict.__setitem__` + d = {'key1': 42, 'key2': 43} + d[key3] = 44 + dicts.append(d) + + # key3 inserted via `dict.setdefault` + d = {'key1': 42, 'key2': 43} + self.assertEqual(d.setdefault(key3, 44), 44) + dicts.append(d) + + # key3 inserted via `dict.update` + d = {'key1': 42, 'key2': 43} + d.update({key3: 44}) + dicts.append(d) + + # key3 inserted via `dict.__ior__` + d = {'key1': 42, 'key2': 43} + d |= {key3: 44} + dicts.append(d) + + # `dict(iterable)` + def make_pairs(): + yield ('key1', 42) + yield ('key2', 43) + yield (key3, 44) + d = dict(make_pairs()) + dicts.append(d) + + # `dict.copy` + d = d.copy() + dicts.append(d) + + # dict comprehension + d = {key: 42 + i for i,key in enumerate(['key1', 'key2', key3])} + dicts.append(d) + + for d in dicts: + with self.subTest(d=d): + self.assertEqual(d.get('key1'), 42) + + # Try to make an object that is of type `str` and is equal to + # `'key1'`, but (at least on cpython) is a different object. + noninterned_key1 = 'ke' + noninterned_key1 += 'y1' + if support.check_impl_detail(cpython=True): + # suppress a SyntaxWarning + interned_key1 = 'key1' + self.assertFalse(noninterned_key1 is interned_key1) + self.assertEqual(d.get(noninterned_key1), 42) + + self.assertEqual(d.get('key3'), 44) + self.assertEqual(d.get(key3_1), 44) + self.assertEqual(d.get(key3_2), 44) + + # `key3_3` itself is definitely not a dict key, so make sure + # that `__eq__` gets called. + # + # Note that this might not hold for `key3_1` and `key3_2` + # because they might be the same object as one of the dict keys, + # in which case implementations are allowed to skip the call to + # `__eq__`. + eq_count = 0 + self.assertEqual(d.get(key3_3), 44) + self.assertGreaterEqual(eq_count, 1) + class CAPITest(unittest.TestCase): diff --git a/Objects/dictobject.c b/Objects/dictobject.c index 44796a6066728..0aeee7011e844 100644 --- a/Objects/dictobject.c +++ b/Objects/dictobject.c @@ -857,7 +857,6 @@ lookdict_unicode(PyDictObject *mp, PyObject *key, unicodes is to override __eq__, and for speed we don't cater to that here. */ if (!PyUnicode_CheckExact(key)) { - mp->ma_keys->dk_lookup = lookdict; return lookdict(mp, key, hash, value_addr); } @@ -900,7 +899,6 @@ lookdict_unicode_nodummy(PyDictObject *mp, PyObject *key, unicodes is to override __eq__, and for speed we don't cater to that here. */ if (!PyUnicode_CheckExact(key)) { - mp->ma_keys->dk_lookup = lookdict; return lookdict(mp, key, hash, value_addr); } @@ -1084,7 +1082,6 @@ insertdict(PyDictObject *mp, PyObject *key, Py_hash_t hash, PyObject *value) if (ix == DKIX_ERROR) goto Fail; - assert(PyUnicode_CheckExact(key) || mp->ma_keys->dk_lookup == lookdict); MAINTAIN_TRACKING(mp, key, value); /* When insertion order is different from shared key, we can't share @@ -1106,6 +1103,9 @@ insertdict(PyDictObject *mp, PyObject *key, Py_hash_t hash, PyObject *value) if (insertion_resize(mp) < 0) goto Fail; } + if (!PyUnicode_CheckExact(key) && mp->ma_keys->dk_lookup != lookdict) { + mp->ma_keys->dk_lookup = lookdict; + } Py_ssize_t hashpos = find_empty_slot(mp->ma_keys, hash); ep = &DK_ENTRIES(mp->ma_keys)[mp->ma_keys->dk_nentries]; dictkeys_set_index(mp->ma_keys, hashpos, mp->ma_keys->dk_nentries); @@ -3068,6 +3068,9 @@ PyDict_SetDefault(PyObject *d, PyObject *key, PyObject *defaultobj) return NULL; } } + if (!PyUnicode_CheckExact(key) && mp->ma_keys->dk_lookup != lookdict) { + mp->ma_keys->dk_lookup = lookdict; + } Py_ssize_t hashpos = find_empty_slot(mp->ma_keys, hash); ep0 = DK_ENTRIES(mp->ma_keys); ep = &ep0[mp->ma_keys->dk_nentries];

1 0

[doc] Be more clear on super() regarding multiple base classes methods (GH-21789) (GH-25707)
by orsenthil 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/e01003130a2bf05efc0eccc1eebd21982a… commit: e01003130a2bf05efc0eccc1eebd21982a63aab1 branch: 3.8 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: orsenthil <skumaran(a)gatech.edu> date: 2021-04-28T18:13:20-07:00 summary: [doc] Be more clear on super() regarding multiple base classes methods (GH-21789) (GH-25707) (cherry picked from commit 69a733bda34d413d3ad545ef3132240e5d2a7c0c) Co-authored-by: Andre Delfino <adelfino(a)gmail.com> Co-authored-by: Andre Delfino <adelfino(a)gmail.com> files: M Doc/library/functions.rst diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 00d40d65195200..036dca565783fe 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1627,7 +1627,7 @@ are always available. They are listed here in alphabetical order. not found in statically compiled languages or languages that only support single inheritance. This makes it possible to implement "diamond diagrams" where multiple base classes implement the same method. Good design dictates - that this method have the same calling signature in every case (because the + that such implementations have the same calling signature in every case (because the order of calls is determined at runtime, because that order adapts to changes in the class hierarchy, and because that order can include sibling classes that are unknown prior to runtime).

1 0

[doc] Be more clear on super() regarding multiple base classes methods (GH-21789) (GH-25706)
by orsenthil 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/8d47f92d46a92a5931b8f3dcb4a484df67… commit: 8d47f92d46a92a5931b8f3dcb4a484df672fc4de branch: 3.9 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: orsenthil <skumaran(a)gatech.edu> date: 2021-04-28T18:13:12-07:00 summary: [doc] Be more clear on super() regarding multiple base classes methods (GH-21789) (GH-25706) (cherry picked from commit 69a733bda34d413d3ad545ef3132240e5d2a7c0c) Co-authored-by: Andre Delfino <adelfino(a)gmail.com> Co-authored-by: Andre Delfino <adelfino(a)gmail.com> files: M Doc/library/functions.rst diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index ef51782205b45..3a222b1e67975 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1631,7 +1631,7 @@ are always available. They are listed here in alphabetical order. not found in statically compiled languages or languages that only support single inheritance. This makes it possible to implement "diamond diagrams" where multiple base classes implement the same method. Good design dictates - that this method have the same calling signature in every case (because the + that such implementations have the same calling signature in every case (because the order of calls is determined at runtime, because that order adapts to changes in the class hierarchy, and because that order can include sibling classes that are unknown prior to runtime).

1 0

[doc] Be more clear on super() regarding multiple base classes methods (GH-21789)
by orsenthil 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/69a733bda34d413d3ad545ef3132240e5d… commit: 69a733bda34d413d3ad545ef3132240e5d2a7c0c branch: master author: Andre Delfino <adelfino(a)gmail.com> committer: orsenthil <skumaran(a)gatech.edu> date: 2021-04-28T18:12:15-07:00 summary: [doc] Be more clear on super() regarding multiple base classes methods (GH-21789) files: M Doc/library/functions.rst diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 72441f0dbfa57..7d8a669f9e16d 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1711,7 +1711,7 @@ are always available. They are listed here in alphabetical order. not found in statically compiled languages or languages that only support single inheritance. This makes it possible to implement "diamond diagrams" where multiple base classes implement the same method. Good design dictates - that this method have the same calling signature in every case (because the + that such implementations have the same calling signature in every case (because the order of calls is determined at runtime, because that order adapts to changes in the class hierarchy, and because that order can include sibling classes that are unknown prior to runtime).

1 0

[doc] Do some polishing in IDEs section (GH-22070) (GH-25704)
by orsenthil 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/cc1dcb6a5bff01ce73d1f836d9bb993c34… commit: cc1dcb6a5bff01ce73d1f836d9bb993c346900e0 branch: 3.8 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: orsenthil <skumaran(a)gatech.edu> date: 2021-04-28T18:09:14-07:00 summary: [doc] Do some polishing in IDEs section (GH-22070) (GH-25704) (cherry picked from commit 08a4803863856db47a1dde830e56f83e5c6811a2) Co-authored-by: Andre Delfino <adelfino(a)gmail.com> Co-authored-by: Andre Delfino <adelfino(a)gmail.com> files: M Doc/faq/programming.rst diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst index cc597df6c5db0a..4caff0dd287d69 100644 --- a/Doc/faq/programming.rst +++ b/Doc/faq/programming.rst @@ -29,26 +29,26 @@ Python distribution (normally available as Tools/scripts/idle), includes a graphical debugger. PythonWin is a Python IDE that includes a GUI debugger based on pdb. The -Pythonwin debugger colors breakpoints and has quite a few cool features such as -debugging non-Pythonwin programs. Pythonwin is available as part of the `Python -for Windows Extensions <https://sourceforge.net/projects/pywin32/>`__ project and -as a part of the ActivePython distribution (see -https://www.activestate.com/activepython\ ). +PythonWin debugger colors breakpoints and has quite a few cool features such as +debugging non-PythonWin programs. PythonWin is available as part of +`pywin32 <https://github.com/mhammond/pywin32>`_ project and +as a part of the +`ActivePython <https://www.activestate.com/products/python/>`_ distribution. `Eric <http://eric-ide.python-projects.org/>`_ is an IDE built on PyQt and the Scintilla editing component. -Pydb is a version of the standard Python debugger pdb, modified for use with DDD -(Data Display Debugger), a popular graphical debugger front end. Pydb can be -found at http://bashdb.sourceforge.net/pydb/ and DDD can be found at -https://www.gnu.org/software/ddd. +`trepan3k <https://github.com/rocky/python3-trepan/>`_ is a gdb-like debugger. + +`Visual Studio Code <https://code.visualstudio.com/>`_ is an IDE with debugging +tools that integrates with version-control software. There are a number of commercial Python IDEs that include graphical debuggers. They include: -* Wing IDE (https://wingware.com/) -* Komodo IDE (https://komodoide.com/) -* PyCharm (https://www.jetbrains.com/pycharm/) +* `Wing IDE <https://wingware.com/>`_ +* `Komodo IDE <https://www.activestate.com/products/komodo-ide/>`_ +* `PyCharm <https://www.jetbrains.com/pycharm/>`_ Are there tools to help find bugs or perform static analysis?

1 0

[doc] Do some polishing in IDEs section (GH-22070) (GH-25703)
by orsenthil 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/c4e503ed809c3823d7cbc355b7dc44809b… commit: c4e503ed809c3823d7cbc355b7dc44809be84228 branch: 3.9 author: Miss Islington (bot) <31488909+miss-islington(a)users.noreply.github.com> committer: orsenthil <skumaran(a)gatech.edu> date: 2021-04-28T18:09:03-07:00 summary: [doc] Do some polishing in IDEs section (GH-22070) (GH-25703) (cherry picked from commit 08a4803863856db47a1dde830e56f83e5c6811a2) Co-authored-by: Andre Delfino <adelfino(a)gmail.com> Co-authored-by: Andre Delfino <adelfino(a)gmail.com> files: M Doc/faq/programming.rst diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst index eb8ac79c906602..f0784f07557115 100644 --- a/Doc/faq/programming.rst +++ b/Doc/faq/programming.rst @@ -29,26 +29,26 @@ Python distribution (normally available as Tools/scripts/idle), includes a graphical debugger. PythonWin is a Python IDE that includes a GUI debugger based on pdb. The -Pythonwin debugger colors breakpoints and has quite a few cool features such as -debugging non-Pythonwin programs. Pythonwin is available as part of the `Python -for Windows Extensions <https://sourceforge.net/projects/pywin32/>`__ project and -as a part of the ActivePython distribution (see -https://www.activestate.com/activepython\ ). +PythonWin debugger colors breakpoints and has quite a few cool features such as +debugging non-PythonWin programs. PythonWin is available as part of +`pywin32 <https://github.com/mhammond/pywin32>`_ project and +as a part of the +`ActivePython <https://www.activestate.com/products/python/>`_ distribution. `Eric <http://eric-ide.python-projects.org/>`_ is an IDE built on PyQt and the Scintilla editing component. -Pydb is a version of the standard Python debugger pdb, modified for use with DDD -(Data Display Debugger), a popular graphical debugger front end. Pydb can be -found at http://bashdb.sourceforge.net/pydb/ and DDD can be found at -https://www.gnu.org/software/ddd. +`trepan3k <https://github.com/rocky/python3-trepan/>`_ is a gdb-like debugger. + +`Visual Studio Code <https://code.visualstudio.com/>`_ is an IDE with debugging +tools that integrates with version-control software. There are a number of commercial Python IDEs that include graphical debuggers. They include: -* Wing IDE (https://wingware.com/) -* Komodo IDE (https://komodoide.com/) -* PyCharm (https://www.jetbrains.com/pycharm/) +* `Wing IDE <https://wingware.com/>`_ +* `Komodo IDE <https://www.activestate.com/products/komodo-ide/>`_ +* `PyCharm <https://www.jetbrains.com/pycharm/>`_ Are there tools to help find bugs or perform static analysis?

1 0

[doc] Do some polishing in IDEs section (GH-22070)
by orsenthil 29 Apr '21

29 Apr '21

https://github.com/python/cpython/commit/08a4803863856db47a1dde830e56f83e5c… commit: 08a4803863856db47a1dde830e56f83e5c6811a2 branch: master author: Andre Delfino <adelfino(a)gmail.com> committer: orsenthil <skumaran(a)gatech.edu> date: 2021-04-28T18:06:53-07:00 summary: [doc] Do some polishing in IDEs section (GH-22070) files: M Doc/faq/programming.rst diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst index d00be2462efc87..ed03c494388805 100644 --- a/Doc/faq/programming.rst +++ b/Doc/faq/programming.rst @@ -29,26 +29,26 @@ Python distribution (normally available as Tools/scripts/idle), includes a graphical debugger. PythonWin is a Python IDE that includes a GUI debugger based on pdb. The -Pythonwin debugger colors breakpoints and has quite a few cool features such as -debugging non-Pythonwin programs. Pythonwin is available as part of the `Python -for Windows Extensions <https://sourceforge.net/projects/pywin32/>`__ project and -as a part of the ActivePython distribution (see -https://www.activestate.com/activepython\ ). +PythonWin debugger colors breakpoints and has quite a few cool features such as +debugging non-PythonWin programs. PythonWin is available as part of +`pywin32 <https://github.com/mhammond/pywin32>`_ project and +as a part of the +`ActivePython <https://www.activestate.com/products/python/>`_ distribution. `Eric <http://eric-ide.python-projects.org/>`_ is an IDE built on PyQt and the Scintilla editing component. -Pydb is a version of the standard Python debugger pdb, modified for use with DDD -(Data Display Debugger), a popular graphical debugger front end. Pydb can be -found at http://bashdb.sourceforge.net/pydb/ and DDD can be found at -https://www.gnu.org/software/ddd. +`trepan3k <https://github.com/rocky/python3-trepan/>`_ is a gdb-like debugger. + +`Visual Studio Code <https://code.visualstudio.com/>`_ is an IDE with debugging +tools that integrates with version-control software. There are a number of commercial Python IDEs that include graphical debuggers. They include: -* Wing IDE (https://wingware.com/) -* Komodo IDE (https://komodoide.com/) -* PyCharm (https://www.jetbrains.com/pycharm/) +* `Wing IDE <https://wingware.com/>`_ +* `Komodo IDE <https://www.activestate.com/products/komodo-ide/>`_ +* `PyCharm <https://www.jetbrains.com/pycharm/>`_ Are there tools to help find bugs or perform static analysis?

1 0