Mailman 3 June 2021 - Docs-bugs

[issue44362] improve documentation of SSL deprecations
by Jack DeVries June 10, 2021

June 10, 2021

Jack DeVries <jdevries3133(a)gmail.com> added the comment: Would you like me to submit a PR for this simple patch? https://github.com/jdevries3133/cpython/commit/42d9bd7f97f03b49d4fc89780616… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44362> _______________________________________

1 0

[issue44347] Unclear documentation for shutil.copytree()
by Tilman Vogel June 10, 2021

June 10, 2021

New submission from Tilman Vogel <tilman.vogel(a)gmail.com>: I donot understand this sentence: "dirs_exist_ok dictates whether to raise an exception in case dst or any missing parent directory already exists." How can a "missing parent directory already exist"? My understanding would be that an existing `dst` would be OK (and copied into) but missing parent directories are just the ones above `dst` that also don't exist. Until 3.7, missing parent directories were documented to be auto-created (`mkdir -p`-style) according to the documentation ("The destination directory, named by dst, must not already exist; it will be created as well as missing parent directories."). Was this feature really removed? If not, then this part was accidentally (?) dropped from documentation? What am I missing? I think, the documentation should be amended to make that clear. ---------- assignee: docs@python components: Documentation messages: 395315 nosy: docs@python, tilman.vogel priority: normal severity: normal status: open title: Unclear documentation for shutil.copytree() type: enhancement versions: Python 3.10, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44347> _______________________________________

3 6

[issue44362] improve documentation of SSL deprecations
by Christian Heimes June 9, 2021

June 9, 2021

Christian Heimes <lists(a)cheimes.de> added the comment: You either use TLS_PROTOCOL_CLIENT for a client-side socket or TLS_PROTOCOL_SERVER for a server-side socket. TLS_PROTOCOL_CLIENT gives you a secure context for client connections with cert and hostname verification. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44362> _______________________________________

1 0

[issue44362] improve documentation of SSL deprecations
by Jack DeVries June 9, 2021

June 9, 2021

Jack DeVries <jdevries3133(a)gmail.com> added the comment: These changes are part of PEP 644; support for OpenSSL v1.1.1. The benefits are detailed in `the PEP <https://www.python.org/dev/peps/pep-0644/#benefits>`_. Later, the deprecation process began in `bpo-43880 <https://bugs.python.org/issue43880>`_. It seems like `PROTOCOL_TLS` is the only thing with a deprecation warning that does not have a suggested alternative. I'm confused as to how this can be deprecated; what will be the new mechanism for selecting a protocol? If someone can provide some brief clarification, I'd be more than happy to update the docs! ---------- nosy: +jack__d _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44362> _______________________________________

1 0

[issue21760] inspect documentation describes module type inaccurately
by Eric Snow June 9, 2021

June 9, 2021

Eric Snow <ericsnowcurrently(a)gmail.com> added the comment: I've merged the changes for __file__. Thanks, furkanonder! The fixes in the types module remain to be done, though now I see 4 of the relevant attributes instead of 2. (missing: __path__, __file__, __cached__) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue21760> _______________________________________

1 0

[issue21760] inspect documentation describes module type inaccurately
by miss-islington June 9, 2021

June 9, 2021

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 878d7e4ee464913438fd59582bbb795e7e0fa387 by Furkan Onder in branch 'main': bpo-21760: fix __file__ description (GH-19097) https://github.com/python/cpython/commit/878d7e4ee464913438fd59582bbb795e7e… ---------- nosy: +miss-islington _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue21760> _______________________________________

1 0

[issue44362] improve documentation of SSL deprecations
by Christian Heimes June 9, 2021

June 9, 2021

Change by Christian Heimes <lists(a)cheimes.de>: ---------- assignee: -> docs@python components: +Documentation, SSL nosy: +docs@python type: -> enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44362> _______________________________________

1 0

[issue14547] Python symlink to script behaves unexpectedly
by ِAbdulrahman ِShawa June 8, 2021

June 8, 2021

ِAbdulrahman ِShawa <free.abdo.sh(a)gmail.com> added the comment: hello guys I am facing problem with my sqlite3 database when i make changes it saves the changes for almost 13 hours and then retakes back all the changes that i made, i am using two threads in my code and i am not committing the data but i set the isolation mode to None, i was using the same queries with mysql database with setting autocommit to on and it was working fine what could be the problem in your opinion? we searched and ask a lot about this issue but nothing was helpful. ---------- nosy: +free.abdo.sh type: enhancement -> behavior versions: +Python 3.6, Python 3.7, Python 3.8 -Python 2.7, Python 3.4, Python 3.5 Added file: https://bugs.python.org/file50098/main.py _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue14547> _______________________________________

1 0

[issue31472] "Emulating callable objects" documentation misleading
by Andrei Kulakov June 7, 2021

June 7, 2021

Andrei Kulakov <andrei.avk(a)gmail.com> added the comment: I don't think the docs in current form imply keyword args are disallowed: "arguments" covers both positional and keyword args, and the call as given in example would work for both positional and keyword args (though not overriding the default value of an arg). It seems to me this can be closed. ---------- nosy: +andrei.avk _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31472> _______________________________________

1 0

[issue27901] DOC: inspect.ismethod returns different results on the same basic code between Python2.7 Python3.5
by Andrei Kulakov June 7, 2021

June 7, 2021

Andrei Kulakov <andrei.avk(a)gmail.com> added the comment: The data model docs still have 2 references to unbound methods: For callables, it may indicate that an instance of the given type (or a subclass) is expected or required as the first positional argument (for example, CPython sets this attribute for unbound methods that are implemented in C). ... Incorrectly attempting to invoke an unbound method of a class in this way is sometimes referred to as ‘metaclass confusion’, and is avoided by bypassing the instance when looking up special methods: So the concept of unbound methods is still valid, and in addition I would expect that majority of users think of a method defined in a class as a "method" rather than "function defined in class that will become a method" - perhaps because the former is much shorter ;-) Therefore inspect.ismethod() returning False can easily cause confusion. I think it might be worth adding this note to `ismethod` docs, something like: "While the term 'unbound method' is commonly used for functions defined on class objects, from the point of view of `inspect` it is not a method because the object itself is just a plain function." I can make a PR if this sounds reasonable? ---------- nosy: +andrei.avk _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue27901> _______________________________________

1 0