docs January 2020

docs@python.org

27 participants
392 discussions

[issue39158] ast.literal_eval() doesn't support empty sets

by Pablo Galindo Salgado

Pablo Galindo Salgado <pablogsal(a)gmail.com> added the comment: > And if add support of non-literals, where should we stop? Should we support also frozenset() and bytearray()? inf and nan? infj and nanj? complex()? Ellipsis? __debug__? Then the name of the function would be a bit misleading (for frozenset() and bytearray()), no? I think the set() change is somehow inconsistent already with the function name. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39158> _______________________________________

1 year, 1 month

[issue33095] Cross-reference isolated mode from relevant locations

by Nick Coghlan

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: In https://bugs.python.org/issue33053#msg313966, jwilk noted that it isn't obvious from https://docs.python.org/3/using/cmdline.html#cmdoption-m how to keep the current directory from being added to `sys.path` when using the -m switch. The answer is to pass the `-I` switch as well (to activate isolated mode), but there's no cross reference to help readers discover that fact. https://docs.python.org/3/using/cmdline.html#id2 is the main documentation for isolated mode, so the steps needed to close this issue are: 1. At least add a reference from the -m switch documentation to the -I switch documentation 2. Review the other parts of the `using` docs that describe how `sys.path` is initialised, and reference the -I switch documentation where relevant ---------- assignee: docs@python components: Documentation keywords: easy messages: 314022 nosy: docs@python, jwilk, ncoghlan priority: normal severity: normal stage: needs patch status: open title: Cross-reference isolated mode from relevant locations type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33095> _______________________________________

1 year, 1 month

[issue39158] ast.literal_eval() doesn't support empty sets

by Serhiy Storchaka

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: The documentation for ast.literal_eval(): Safely evaluate an expression node or a string containing a Python literal or container display. The string or node provided may only consist of the following Python literal structures: strings, bytes, numbers, tuples, lists, dicts, sets, booleans, and ``None``. https://docs.python.org/3/library/ast.html#ast.literal_eval If we are going to add support of a function call set(), we should change the documentation. And if add support of non-literals, where should we stop? Should we support also frozenset() and bytearray()? inf and nan? infj and nanj? complex()? Ellipsis? __debug__? ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python resolution: fixed -> stage: resolved -> needs patch status: closed -> open _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39158> _______________________________________

1 year, 1 month

[issue39183] Text divided in two strings due to wrong formatting

by Rafael Fontenelle

New submission from Rafael Fontenelle <rffontenelle(a)gmail.com>: When translating Python docs, the 'library/ensurepip' module [1] has an bullet list where one item's text is split in two due to a simple extra whitespace character. This causes two separated translations strings "``--default-pip``: if a \"default pip\" installation is requested, the" and "``pip`` script will be installed in addition to the two regular scripts." , which clearly should be a single one. Its effect can be seen also in the resulting documentation, where these strings are shown in different lines even when there are enough space in the browser window to should it all. Solution is to remove the extra space and formatting is good again. [1] https://docs.python.org/3/library/ensurepip.html ---------- assignee: docs@python components: Documentation messages: 359170 nosy: docs@python, rffontenelle priority: normal severity: normal status: open title: Text divided in two strings due to wrong formatting type: enhancement versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39183> _______________________________________

1 year, 2 months

Solicitud de Informacion

by Juan Castela

Estimados Sres : Me he propuesto aprender el lenguaje de programacion Python, he instalado en mi pc la ultima version del producto (3.8.1) de 32 bits, en mi portatil tengo Windows XP Profesional de 64 bits pero la version de Python de 64 bits no la encuentro en su pagina web, dentro de poco tiempo actualizare mi portatil a Windows 10. ¿ Existe una version de Python 3.8.1 de 64 bits ? y si es asi como puedo descargarla. Me gustaria disponer de todos los manuales que aparecen en su pagina web en la version en castellano pero al bajar los PDF en zip solo estan en ingles, podrian decirme como puedo conseguir bajar la version que deseo. Muchas gracias y aprovecho esta oportunidad para enviarles un cordial saludo. Juan Castela Hernandez

1 year, 2 months

Re: argparse: append action with default list adds to list instead of overriding (issue 16399)

by roy＠panix.com

This looks basically fine, but I'd leave off "This means that". http://bugs.python.org/review/16399/

1 year, 2 months

[issue39125] Type signature of @property not shown in help()

by Nguyễn Gia Phong

New submission from Nguyễn Gia Phong <vn.mcsinyx(a)gmail.com>: Dear Maintainer, I want to request a feature on the generative documentation of type-hinting. As of December 2019, I believe there is no support for generating such information in help(). For demonstration, I have this tiny piece of code class Foo: @property def bar(self) -> int: return 42 @bar.setter def bar(self, value: int) -> None: pass def baz(self, arg: float) -> str: pass whose documentation on CPython 3.7.5 (on Debian testing amd64 if that matters) is generated as class Foo(builtins.object) | Methods defined here: | | baz(self, arg: float) -> str | | ---------------------------------------------------------------------- | Data descriptors defined here: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ | list of weak references to the object (if defined) | | bar I expect the documentation for bar to be as informative as bar, i.e. something similar to ``bar: int''. As pointed out by ChrisWarrick on freenode#python, the annotations are already present, yet help() is not making use of them: >>> Foo.bar.fget.__annotations__ {'return': <class 'int'>} >>> Foo.bar.fset.__annotations__ {'value': <class 'int'>, 'return': None} Have a Merry Christmas or other holiday of your choice, Nguyễn Gia Phong ---------- assignee: docs@python components: Documentation messages: 358823 nosy: McSinyx, docs@python priority: normal severity: normal status: open title: Type signature of @property not shown in help() type: enhancement versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39125> _______________________________________

1 year, 2 months

[issue16399] argparse: append action with default list adds to list instead of overriding

by hai shi

hai shi <shihai1991(a)126.com> added the comment: I update the doc of argparse and think this bpo could be closed when PR merged. ---------- nosy: +rhettinger _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16399> _______________________________________

1 year, 2 months

[issue16399] argparse: append action with default list adds to list instead of overriding

by hai shi

Change by hai shi <shihai1991(a)126.com>: ---------- nosy: +shihai1991 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16399> _______________________________________

1 year, 2 months

[issue16399] argparse: append action with default list adds to list instead of overriding

by hai shi

Change by hai shi <shihai1991(a)126.com>: ---------- pull_requests: +17226 stage: -> patch review pull_request: https://github.com/python/cpython/pull/17793 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16399> _______________________________________

1 year, 2 months

Jump to page:

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

docs January 2020