Update pydoc topics for 3.6.0a2
This commit is contained in:
Ned Deily
parent
647a6db30a
commit
8b9173a8de
|
|
@ -1,5 +1,5 @@
|
||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
# Autogenerated by Sphinx on Mon May 16 13:41:38 2016
|
# Autogenerated by Sphinx on Mon Jun 13 16:49:58 2016
|
||||||
topics = {'assert': '\n'
|
topics = {'assert': '\n'
|
||||||
'The "assert" statement\n'
|
'The "assert" statement\n'
|
||||||
'**********************\n'
|
'**********************\n'
|
||||||
|
|
@ -47,12 +47,12 @@ topics = {'assert': '\n'
|
||||||
'to\n'
|
'to\n'
|
||||||
'modify attributes or items of mutable objects:\n'
|
'modify attributes or items of mutable objects:\n'
|
||||||
'\n'
|
'\n'
|
||||||
' assignment_stmt ::= (target_list "=")+ (expression_list | '
|
' assignment_stmt ::= (target_list "=")+ (starred_expression '
|
||||||
'yield_expression)\n'
|
'| yield_expression)\n'
|
||||||
' target_list ::= target ("," target)* [","]\n'
|
' target_list ::= target ("," target)* [","]\n'
|
||||||
' target ::= identifier\n'
|
' target ::= identifier\n'
|
||||||
' | "(" target_list ")"\n'
|
' | "(" [target_list] ")"\n'
|
||||||
' | "[" target_list "]"\n'
|
' | "[" [target_list] "]"\n'
|
||||||
' | attributeref\n'
|
' | attributeref\n'
|
||||||
' | subscription\n'
|
' | subscription\n'
|
||||||
' | slicing\n'
|
' | slicing\n'
|
||||||
|
|
@ -89,35 +89,42 @@ topics = {'assert': '\n'
|
||||||
'parentheses or square brackets, is recursively defined as '
|
'parentheses or square brackets, is recursively defined as '
|
||||||
'follows.\n'
|
'follows.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'* If the target list is a single target: The object is '
|
'* If the target list is empty: The object must also be an '
|
||||||
'assigned to\n'
|
'empty\n'
|
||||||
' that target.\n'
|
' iterable.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'* If the target list is a comma-separated list of targets: '
|
'* If the target list is a single target in parentheses: The '
|
||||||
'The\n'
|
'object\n'
|
||||||
' object must be an iterable with the same number of items as '
|
' is assigned to that target.\n'
|
||||||
'there\n'
|
'\n'
|
||||||
' are targets in the target list, and the items are assigned, '
|
'* If the target list is a comma-separated list of targets, or '
|
||||||
'from\n'
|
'a\n'
|
||||||
' left to right, to the corresponding targets.\n'
|
' single target in square brackets: The object must be an '
|
||||||
|
'iterable\n'
|
||||||
|
' with the same number of items as there are targets in the '
|
||||||
|
'target\n'
|
||||||
|
' list, and the items are assigned, from left to right, to '
|
||||||
|
'the\n'
|
||||||
|
' corresponding targets.\n'
|
||||||
'\n'
|
'\n'
|
||||||
' * If the target list contains one target prefixed with an\n'
|
' * If the target list contains one target prefixed with an\n'
|
||||||
' asterisk, called a "starred" target: The object must be a '
|
' asterisk, called a "starred" target: The object must be '
|
||||||
'sequence\n'
|
'an\n'
|
||||||
' with at least as many items as there are targets in the '
|
' iterable with at least as many items as there are targets '
|
||||||
'target\n'
|
'in the\n'
|
||||||
' list, minus one. The first items of the sequence are '
|
' target list, minus one. The first items of the iterable '
|
||||||
'assigned,\n'
|
'are\n'
|
||||||
' from left to right, to the targets before the starred '
|
' assigned, from left to right, to the targets before the '
|
||||||
'target. The\n'
|
'starred\n'
|
||||||
' final items of the sequence are assigned to the targets '
|
' target. The final items of the iterable are assigned to '
|
||||||
'after the\n'
|
'the\n'
|
||||||
' starred target. A list of the remaining items in the '
|
' targets after the starred target. A list of the remaining '
|
||||||
'sequence is\n'
|
'items\n'
|
||||||
' then assigned to the starred target (the list can be '
|
' in the iterable is then assigned to the starred target '
|
||||||
'empty).\n'
|
'(the list\n'
|
||||||
|
' can be empty).\n'
|
||||||
'\n'
|
'\n'
|
||||||
' * Else: The object must be a sequence with the same number '
|
' * Else: The object must be an iterable with the same number '
|
||||||
'of\n'
|
'of\n'
|
||||||
' items as there are targets in the target list, and the '
|
' items as there are targets in the target list, and the '
|
||||||
'items are\n'
|
'items are\n'
|
||||||
|
|
@ -149,14 +156,6 @@ topics = {'assert': '\n'
|
||||||
'destructor (if it\n'
|
'destructor (if it\n'
|
||||||
' has one) to be called.\n'
|
' has one) to be called.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'* If the target is a target list enclosed in parentheses or '
|
|
||||||
'in\n'
|
|
||||||
' square brackets: The object must be an iterable with the '
|
|
||||||
'same number\n'
|
|
||||||
' of items as there are targets in the target list, and its '
|
|
||||||
'items are\n'
|
|
||||||
' assigned, from left to right, to the corresponding targets.\n'
|
|
||||||
'\n'
|
|
||||||
'* If the target is an attribute reference: The primary '
|
'* If the target is an attribute reference: The primary '
|
||||||
'expression in\n'
|
'expression in\n'
|
||||||
' the reference is evaluated. It should yield an object with\n'
|
' the reference is evaluated. It should yield an object with\n'
|
||||||
|
|
@ -1148,18 +1147,18 @@ topics = {'assert': '\n'
|
||||||
' call ::= primary "(" [argument_list [","] | '
|
' call ::= primary "(" [argument_list [","] | '
|
||||||
'comprehension] ")"\n'
|
'comprehension] ")"\n'
|
||||||
' argument_list ::= positional_arguments ["," '
|
' argument_list ::= positional_arguments ["," '
|
||||||
'keyword_arguments]\n'
|
'starred_and_keywords]\n'
|
||||||
' ["," "*" expression] ["," '
|
' ["," keywords_arguments]\n'
|
||||||
'keyword_arguments]\n'
|
' | starred_and_keywords ["," '
|
||||||
' ["," "**" expression]\n'
|
'keywords_arguments]\n'
|
||||||
' | keyword_arguments ["," "*" expression]\n'
|
' | keywords_arguments\n'
|
||||||
' ["," keyword_arguments] ["," "**" '
|
' positional_arguments ::= ["*"] expression ("," ["*"] '
|
||||||
'expression]\n'
|
'expression)*\n'
|
||||||
' | "*" expression ["," keyword_arguments] ["," '
|
' starred_and_keywords ::= ("*" expression | keyword_item)\n'
|
||||||
'"**" expression]\n'
|
' ("," "*" expression | "," '
|
||||||
' | "**" expression\n'
|
'keyword_item)*\n'
|
||||||
' positional_arguments ::= expression ("," expression)*\n'
|
' keywords_arguments ::= (keyword_item | "**" expression)\n'
|
||||||
' keyword_arguments ::= keyword_item ("," keyword_item)*\n'
|
' ("," keyword_item | "**" expression)*\n'
|
||||||
' keyword_item ::= identifier "=" expression\n'
|
' keyword_item ::= identifier "=" expression\n'
|
||||||
'\n'
|
'\n'
|
||||||
'An optional trailing comma may be present after the positional and\n'
|
'An optional trailing comma may be present after the positional and\n'
|
||||||
|
|
@ -1235,20 +1234,21 @@ topics = {'assert': '\n'
|
||||||
'\n'
|
'\n'
|
||||||
'If the syntax "*expression" appears in the function call, '
|
'If the syntax "*expression" appears in the function call, '
|
||||||
'"expression"\n'
|
'"expression"\n'
|
||||||
'must evaluate to an iterable. Elements from this iterable are '
|
'must evaluate to an *iterable*. Elements from these iterables are\n'
|
||||||
'treated\n'
|
'treated as if they were additional positional arguments. For the '
|
||||||
'as if they were additional positional arguments; if there are\n'
|
'call\n'
|
||||||
'positional arguments *x1*, ..., *xN*, and "expression" evaluates to '
|
'"f(x1, x2, *y, x3, x4)", if *y* evaluates to a sequence *y1*, ...,\n'
|
||||||
'a\n'
|
'*yM*, this is equivalent to a call with M+4 positional arguments '
|
||||||
'sequence *y1*, ..., *yM*, this is equivalent to a call with M+N\n'
|
'*x1*,\n'
|
||||||
'positional arguments *x1*, ..., *xN*, *y1*, ..., *yM*.\n'
|
'*x2*, *y1*, ..., *yM*, *x3*, *x4*.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'A consequence of this is that although the "*expression" syntax '
|
'A consequence of this is that although the "*expression" syntax '
|
||||||
'may\n'
|
'may\n'
|
||||||
'appear *after* some keyword arguments, it is processed *before* '
|
'appear *after* explicit keyword arguments, it is processed '
|
||||||
'the\n'
|
'*before*\n'
|
||||||
'keyword arguments (and the "**expression" argument, if any -- see\n'
|
'the keyword arguments (and any "**expression" arguments -- see '
|
||||||
'below). So:\n'
|
'below).\n'
|
||||||
|
'So:\n'
|
||||||
'\n'
|
'\n'
|
||||||
' >>> def f(a, b):\n'
|
' >>> def f(a, b):\n'
|
||||||
' ... print(a, b)\n'
|
' ... print(a, b)\n'
|
||||||
|
|
@ -1269,16 +1269,25 @@ topics = {'assert': '\n'
|
||||||
'arise.\n'
|
'arise.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'If the syntax "**expression" appears in the function call,\n'
|
'If the syntax "**expression" appears in the function call,\n'
|
||||||
'"expression" must evaluate to a mapping, the contents of which are\n'
|
'"expression" must evaluate to a *mapping*, the contents of which '
|
||||||
'treated as additional keyword arguments. In the case of a keyword\n'
|
'are\n'
|
||||||
'appearing in both "expression" and as an explicit keyword argument, '
|
'treated as additional keyword arguments. If a keyword is already\n'
|
||||||
'a\n'
|
'present (as an explicit keyword argument, or from another '
|
||||||
'"TypeError" exception is raised.\n'
|
'unpacking),\n'
|
||||||
|
'a "TypeError" exception is raised.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'Formal parameters using the syntax "*identifier" or "**identifier"\n'
|
'Formal parameters using the syntax "*identifier" or "**identifier"\n'
|
||||||
'cannot be used as positional argument slots or as keyword argument\n'
|
'cannot be used as positional argument slots or as keyword argument\n'
|
||||||
'names.\n'
|
'names.\n'
|
||||||
'\n'
|
'\n'
|
||||||
|
'Changed in version 3.5: Function calls accept any number of "*" '
|
||||||
|
'and\n'
|
||||||
|
'"**" unpackings, positional arguments may follow iterable '
|
||||||
|
'unpackings\n'
|
||||||
|
'("*"), and keyword arguments may follow dictionary unpackings '
|
||||||
|
'("**").\n'
|
||||||
|
'Originally proposed by **PEP 448**.\n'
|
||||||
|
'\n'
|
||||||
'A call always returns some value, possibly "None", unless it raises '
|
'A call always returns some value, possibly "None", unless it raises '
|
||||||
'an\n'
|
'an\n'
|
||||||
'exception. How this value is computed depends on the type of the\n'
|
'exception. How this value is computed depends on the type of the\n'
|
||||||
|
|
@ -1324,7 +1333,7 @@ topics = {'assert': '\n'
|
||||||
'\n'
|
'\n'
|
||||||
' classdef ::= [decorators] "class" classname [inheritance] ":" '
|
' classdef ::= [decorators] "class" classname [inheritance] ":" '
|
||||||
'suite\n'
|
'suite\n'
|
||||||
' inheritance ::= "(" [parameter_list] ")"\n'
|
' inheritance ::= "(" [argument_list] ")"\n'
|
||||||
' classname ::= identifier\n'
|
' classname ::= identifier\n'
|
||||||
'\n'
|
'\n'
|
||||||
'A class definition is an executable statement. The inheritance '
|
'A class definition is an executable statement. The inheritance '
|
||||||
|
|
@ -2261,7 +2270,7 @@ topics = {'assert': '\n'
|
||||||
'[parameter_list] ")" ["->" expression] ":" suite\n'
|
'[parameter_list] ")" ["->" expression] ":" suite\n'
|
||||||
' decorators ::= decorator+\n'
|
' decorators ::= decorator+\n'
|
||||||
' decorator ::= "@" dotted_name ["(" '
|
' decorator ::= "@" dotted_name ["(" '
|
||||||
'[parameter_list [","]] ")"] NEWLINE\n'
|
'[argument_list [","]] ")"] NEWLINE\n'
|
||||||
' dotted_name ::= identifier ("." identifier)*\n'
|
' dotted_name ::= identifier ("." identifier)*\n'
|
||||||
' parameter_list ::= defparameter ("," defparameter)* '
|
' parameter_list ::= defparameter ("," defparameter)* '
|
||||||
'["," [parameter_list_starargs]]\n'
|
'["," [parameter_list_starargs]]\n'
|
||||||
|
|
@ -2426,7 +2435,7 @@ topics = {'assert': '\n'
|
||||||
'\n'
|
'\n'
|
||||||
' classdef ::= [decorators] "class" classname [inheritance] '
|
' classdef ::= [decorators] "class" classname [inheritance] '
|
||||||
'":" suite\n'
|
'":" suite\n'
|
||||||
' inheritance ::= "(" [parameter_list] ")"\n'
|
' inheritance ::= "(" [argument_list] ")"\n'
|
||||||
' classname ::= identifier\n'
|
' classname ::= identifier\n'
|
||||||
'\n'
|
'\n'
|
||||||
'A class definition is an executable statement. The inheritance '
|
'A class definition is an executable statement. The inheritance '
|
||||||
|
|
@ -2563,7 +2572,7 @@ topics = {'assert': '\n'
|
||||||
'Is semantically equivalent to:\n'
|
'Is semantically equivalent to:\n'
|
||||||
'\n'
|
'\n'
|
||||||
' iter = (ITER)\n'
|
' iter = (ITER)\n'
|
||||||
' iter = await type(iter).__aiter__(iter)\n'
|
' iter = type(iter).__aiter__(iter)\n'
|
||||||
' running = True\n'
|
' running = True\n'
|
||||||
' while running:\n'
|
' while running:\n'
|
||||||
' try:\n'
|
' try:\n'
|
||||||
|
|
@ -3889,7 +3898,7 @@ topics = {'assert': '\n'
|
||||||
' dict_display ::= "{" [key_datum_list | dict_comprehension] '
|
' dict_display ::= "{" [key_datum_list | dict_comprehension] '
|
||||||
'"}"\n'
|
'"}"\n'
|
||||||
' key_datum_list ::= key_datum ("," key_datum)* [","]\n'
|
' key_datum_list ::= key_datum ("," key_datum)* [","]\n'
|
||||||
' key_datum ::= expression ":" expression\n'
|
' key_datum ::= expression ":" expression | "**" or_expr\n'
|
||||||
' dict_comprehension ::= expression ":" expression comp_for\n'
|
' dict_comprehension ::= expression ":" expression comp_for\n'
|
||||||
'\n'
|
'\n'
|
||||||
'A dictionary display yields a new dictionary object.\n'
|
'A dictionary display yields a new dictionary object.\n'
|
||||||
|
|
@ -3903,6 +3912,14 @@ topics = {'assert': '\n'
|
||||||
'value\n'
|
'value\n'
|
||||||
'for that key will be the last one given.\n'
|
'for that key will be the last one given.\n'
|
||||||
'\n'
|
'\n'
|
||||||
|
'A double asterisk "**" denotes *dictionary unpacking*. Its operand\n'
|
||||||
|
'must be a *mapping*. Each mapping item is added to the new\n'
|
||||||
|
'dictionary. Later values replace values already set by earlier\n'
|
||||||
|
'key/datum pairs and earlier dictionary unpackings.\n'
|
||||||
|
'\n'
|
||||||
|
'New in version 3.5: Unpacking into dictionary displays, originally\n'
|
||||||
|
'proposed by **PEP 448**.\n'
|
||||||
|
'\n'
|
||||||
'A dict comprehension, in contrast to list and set comprehensions,\n'
|
'A dict comprehension, in contrast to list and set comprehensions,\n'
|
||||||
'needs two expressions separated with a colon followed by the usual\n'
|
'needs two expressions separated with a colon followed by the usual\n'
|
||||||
'"for" and "if" clauses. When the comprehension is run, the '
|
'"for" and "if" clauses. When the comprehension is run, the '
|
||||||
|
|
@ -4385,12 +4402,29 @@ topics = {'assert': '\n'
|
||||||
'****************\n'
|
'****************\n'
|
||||||
'\n'
|
'\n'
|
||||||
' expression_list ::= expression ( "," expression )* [","]\n'
|
' expression_list ::= expression ( "," expression )* [","]\n'
|
||||||
|
' starred_list ::= starred_item ( "," starred_item )* '
|
||||||
|
'[","]\n'
|
||||||
|
' starred_expression ::= expression | ( starred_item "," )* '
|
||||||
|
'[starred_item]\n'
|
||||||
|
' starred_item ::= expression | "*" or_expr\n'
|
||||||
'\n'
|
'\n'
|
||||||
'An expression list containing at least one comma yields a '
|
'Except when part of a list or set display, an expression list\n'
|
||||||
'tuple. The\n'
|
'containing at least one comma yields a tuple. The length of '
|
||||||
'length of the tuple is the number of expressions in the list. '
|
'the tuple\n'
|
||||||
'The\n'
|
'is the number of expressions in the list. The expressions are\n'
|
||||||
'expressions are evaluated from left to right.\n'
|
'evaluated from left to right.\n'
|
||||||
|
'\n'
|
||||||
|
'An asterisk "*" denotes *iterable unpacking*. Its operand must '
|
||||||
|
'be an\n'
|
||||||
|
'*iterable*. The iterable is expanded into a sequence of items, '
|
||||||
|
'which\n'
|
||||||
|
'are included in the new tuple, list, or set, at the site of '
|
||||||
|
'the\n'
|
||||||
|
'unpacking.\n'
|
||||||
|
'\n'
|
||||||
|
'New in version 3.5: Iterable unpacking in expression lists, '
|
||||||
|
'originally\n'
|
||||||
|
'proposed by **PEP 448**.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'The trailing comma is required only to create a single tuple '
|
'The trailing comma is required only to create a single tuple '
|
||||||
'(a.k.a. a\n'
|
'(a.k.a. a\n'
|
||||||
|
|
@ -5220,7 +5254,7 @@ topics = {'assert': '\n'
|
||||||
'[parameter_list] ")" ["->" expression] ":" suite\n'
|
'[parameter_list] ")" ["->" expression] ":" suite\n'
|
||||||
' decorators ::= decorator+\n'
|
' decorators ::= decorator+\n'
|
||||||
' decorator ::= "@" dotted_name ["(" '
|
' decorator ::= "@" dotted_name ["(" '
|
||||||
'[parameter_list [","]] ")"] NEWLINE\n'
|
'[argument_list [","]] ")"] NEWLINE\n'
|
||||||
' dotted_name ::= identifier ("." identifier)*\n'
|
' dotted_name ::= identifier ("." identifier)*\n'
|
||||||
' parameter_list ::= defparameter ("," defparameter)* '
|
' parameter_list ::= defparameter ("," defparameter)* '
|
||||||
'["," [parameter_list_starargs]]\n'
|
'["," [parameter_list_starargs]]\n'
|
||||||
|
|
@ -5682,7 +5716,7 @@ topics = {'assert': '\n'
|
||||||
'the\n'
|
'the\n'
|
||||||
'two steps are carried out separately for each clause, just as '
|
'two steps are carried out separately for each clause, just as '
|
||||||
'though\n'
|
'though\n'
|
||||||
'the clauses had been separated out into individiual import '
|
'the clauses had been separated out into individual import '
|
||||||
'statements.\n'
|
'statements.\n'
|
||||||
'\n'
|
'\n'
|
||||||
'The details of the first step, finding and loading modules are\n'
|
'The details of the first step, finding and loading modules are\n'
|
||||||
|
|
@ -6016,7 +6050,7 @@ topics = {'assert': '\n'
|
||||||
'in\n'
|
'in\n'
|
||||||
'square brackets:\n'
|
'square brackets:\n'
|
||||||
'\n'
|
'\n'
|
||||||
' list_display ::= "[" [expression_list | comprehension] "]"\n'
|
' list_display ::= "[" [starred_list | comprehension] "]"\n'
|
||||||
'\n'
|
'\n'
|
||||||
'A list display yields a new list object, the contents being '
|
'A list display yields a new list object, the contents being '
|
||||||
'specified\n'
|
'specified\n'
|
||||||
|
|
@ -8305,6 +8339,14 @@ topics = {'assert': '\n'
|
||||||
'object is bound in the local namespace as the defined '
|
'object is bound in the local namespace as the defined '
|
||||||
'class.\n'
|
'class.\n'
|
||||||
'\n'
|
'\n'
|
||||||
|
'When a new class is created by "type.__new__", the object '
|
||||||
|
'provided as\n'
|
||||||
|
'the namespace parameter is copied to a standard Python '
|
||||||
|
'dictionary and\n'
|
||||||
|
'the original object is discarded. The new copy becomes the '
|
||||||
|
'"__dict__"\n'
|
||||||
|
'attribute of the class object.\n'
|
||||||
|
'\n'
|
||||||
'See also:\n'
|
'See also:\n'
|
||||||
'\n'
|
'\n'
|
||||||
' **PEP 3135** - New super\n'
|
' **PEP 3135** - New super\n'
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue