Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
C
Cpython
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package registry
Model registry
Operate
Environments
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
GitLab community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
sip
Cpython
Commits
8b9173a8
Commit
8b9173a8
authored
Jun 13, 2016
by
Ned Deily
Browse files
Options
Downloads
Patches
Plain Diff
Update pydoc topics for 3.6.0a2
parent
647a6db3
Branches
Branches containing commit
Tags
Tags containing commit
No related merge requests found
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
Lib/pydoc_data/topics.py
+122
-80
122 additions, 80 deletions
Lib/pydoc_data/topics.py
with
122 additions
and
80 deletions
Lib/pydoc_data/topics.py
+
122
−
80
View file @
8b9173a8
# -*- coding: utf-8 -*-
# Autogenerated by Sphinx on Mon
May
1
6
1
3
:4
1:3
8 2016
# Autogenerated by Sphinx on Mon
Jun
1
3
1
6
:4
9:5
8 2016
topics = {'assert': '\n'
'The "assert" statement\n'
'**********************\n'
...
...
@@ -47,12 +47,12 @@
'to\n'
'modify attributes or items of mutable objects:\n'
'\n'
' assignment_stmt ::= (target_list "=")+ (expression
_list |
'
'yield_expression)\n'
' assignment_stmt ::= (target_list "=")+ (
starred_
expression '
'
|
yield_expression)\n'
' target_list ::= target ("," target)* [","]\n'
' target ::= identifier\n'
' | "(" target_list ")"\n'
' | "[" target_list "]"\n'
' | "("
[
target_list
]
")"\n'
' | "["
[
target_list
]
"]"\n'
' | attributeref\n'
' | subscription\n'
' | slicing\n'
...
...
@@ -89,35 +89,42 @@
'parentheses or square brackets, is recursively defined as '
'follows.\n'
'\n'
'* If the target list is
a single target: The object is
'
'
assigned to
\n'
'
that target
.\n'
'* If the target list is
empty: The object must also be an
'
'
empty
\n'
'
iterable
.\n'
'\n'
'* If the target list is a comma-separated list of targets: '
'The\n'
' object must be an iterable with the same number of items as '
'there\n'
' are targets in the target list, and the items are assigned, '
'from\n'
' left to right, to the corresponding targets.\n'
'* If the target list is a single target in parentheses: The '
'object\n'
' is assigned to that target.\n'
'\n'
' * If the target list contains one target prefixed with an\n'
' asterisk, called a "starred" target: The object must be a '
'sequence\n'
' with at least as many items as there are targets in the '
'* If the target list is a comma-separated list of targets, or '
'a\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, minus one. The first items of the sequence are '
'assigned,\n'
' from left to right, to the targets before the starred '
'target. The\n'
' final items of the sequence are assigned to the targets '
'after the\n'
' starred target. A list of the remaining items in the '
'sequence is\n'
' then assigned to the starred target (the list can be '
'empty).\n'
'\n'
' * Else: The object must be a sequence with the same number '
' list, and the items are assigned, from left to right, to '
'the\n'
' corresponding targets.\n'
'\n'
' * If the target list contains one target prefixed with an\n'
' asterisk, called a "starred" target: The object must be '
'an\n'
' iterable with at least as many items as there are targets '
'in the\n'
' target list, minus one. The first items of the iterable '
'are\n'
' assigned, from left to right, to the targets before the '
'starred\n'
' target. The final items of the iterable are assigned to '
'the\n'
' targets after the starred target. A list of the remaining '
'items\n'
' in the iterable is then assigned to the starred target '
'(the list\n'
' can be empty).\n'
'\n'
' * Else: The object must be an iterable with the same number '
'of\n'
' items as there are targets in the target list, and the '
'items are\n'
...
...
@@ -149,14 +156,6 @@
'destructor (if it\n'
' has one) to be called.\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 '
'expression in\n'
' the reference is evaluated. It should yield an object with\n'
...
...
@@ -1148,18 +1147,18 @@
' call ::= primary "(" [argument_list [","] | '
'comprehension] ")"\n'
' argument_list ::= positional_arguments ["," '
'
keyword_argument
s]\n'
' [","
"*" expression] [","
'
'
keyword_arguments]\n
'
'
["," "**" expression
]\n'
' | keyword_arguments
["," "*" expression]
\n'
'
["," keyword_arguments] [
"," "*
*
" '
'expression
]
\n'
'
|
"*" expression
[","
keyword_
arguments] [","
'
'"
*
*" expression
]\n
'
'
| "**" expression
\n'
'
positional
_arguments ::=
expression (",
" expression)
*
\n'
'
keyword_arguments ::= keyword_item ("," keyword_item
)*\n'
'
starred_and_keyword
s]\n'
' [","
keywords_arguments]\n
'
'
| starred_and_keywords [","
'
'
keywords_arguments
]\n'
' | keyword
s
_arguments\n'
'
positional_arguments ::= ["*"] expression (
","
[
"*"
]
'
'expression
)*
\n'
'
starred_and_keywords ::= (
"*" expression
|
keyword_
item)\n
'
'
(","
"*" expression
| ","
'
'
keyword_item)*
\n'
'
keywords
_arguments
::=
(keyword_item | "**
" expression)\n'
'
("," keyword_item | "**" expression
)*\n'
' keyword_item ::= identifier "=" expression\n'
'\n'
'An optional trailing comma may be present after the positional and\n'
...
...
@@ -1235,20 +1234,21 @@
'\n'
'If the syntax "*expression" appears in the function call, '
'"expression"\n'
'must evaluate to an iterable. Elements from th
is
iterable are
'
'treated
\n
'
'
as if they were additional positional arguments; if there are
\n'
'
positional arguments *
x1
*
,
..., *xN*, and "expression" evaluates to
'
'
a\n
'
'
sequence *y1*, ..., *yM*, this is equivalent to a call with M+N
\n'
'
positional arguments *x1*, ..., *xN
*, *y1*, ..., *yM*.\n'
'must evaluate to an
*
iterable
*
. Elements from th
ese
iterable
s
are
\n
'
'treated
as if they were additional positional arguments. For the
'
'
call
\n'
'
"f(
x1,
x2, *y, x3, x4)", if *y* evaluates to a sequence *y1*, ...,\n
'
'
*yM*, this is equivalent to a call with M+4 positional arguments
'
'
*x1*,
\n'
'
*x2
*, *y1*, ..., *yM*
, *x3*, *x4*
.\n'
'\n'
'A consequence of this is that although the "*expression" syntax '
'may\n'
'appear *after* some keyword arguments, it is processed *before* '
'the\n'
'keyword arguments (and the "**expression" argument, if any -- see\n'
'below). So:\n'
'appear *after* explicit keyword arguments, it is processed '
'*before*\n'
'the keyword arguments (and any "**expression" arguments -- see '
'below).\n'
'So:\n'
'\n'
' >>> def f(a, b):\n'
' ... print(a, b)\n'
...
...
@@ -1269,16 +1269,25 @@
'arise.\n'
'\n'
'If the syntax "**expression" appears in the function call,\n'
'"expression" must evaluate to a mapping, the contents of which are\n'
'treated as additional keyword arguments. In the case of a keyword\n'
'appearing in both "expression" and as an explicit keyword argument, '
'a\n'
'"TypeError" exception is raised.\n'
'"expression" must evaluate to a *mapping*, the contents of which '
'are\n'
'treated as additional keyword arguments. If a keyword is already\n'
'present (as an explicit keyword argument, or from another '
'unpacking),\n'
'a "TypeError" exception is raised.\n'
'\n'
'Formal parameters using the syntax "*identifier" or "**identifier"\n'
'cannot be used as positional argument slots or as keyword argument\n'
'names.\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 '
'an\n'
'exception. How this value is computed depends on the type of the\n'
...
...
@@ -1324,7 +1333,7 @@
'\n'
' classdef ::= [decorators] "class" classname [inheritance] ":" '
'suite\n'
' inheritance ::= "(" [
p
ar
ameter
_list] ")"\n'
' inheritance ::= "(" [ar
gument
_list] ")"\n'
' classname ::= identifier\n'
'\n'
'A class definition is an executable statement. The inheritance '
...
...
@@ -2261,7 +2270,7 @@
'[parameter_list] ")" ["->" expression] ":" suite\n'
' decorators ::= decorator+\n'
' decorator ::= "@" dotted_name ["(" '
'[
p
ar
ameter
_list [","]] ")"] NEWLINE\n'
'[ar
gument
_list [","]] ")"] NEWLINE\n'
' dotted_name ::= identifier ("." identifier)*\n'
' parameter_list ::= defparameter ("," defparameter)* '
'["," [parameter_list_starargs]]\n'
...
...
@@ -2426,7 +2435,7 @@
'\n'
' classdef ::= [decorators] "class" classname [inheritance] '
'":" suite\n'
' inheritance ::= "(" [
p
ar
ameter
_list] ")"\n'
' inheritance ::= "(" [ar
gument
_list] ")"\n'
' classname ::= identifier\n'
'\n'
'A class definition is an executable statement. The inheritance '
...
...
@@ -2563,7 +2572,7 @@
'Is semantically equivalent to:\n'
'\n'
' iter = (ITER)\n'
' iter =
await
type(iter).__aiter__(iter)\n'
' iter = type(iter).__aiter__(iter)\n'
' running = True\n'
' while running:\n'
' try:\n'
...
...
@@ -3889,7 +3898,7 @@
' dict_display ::= "{" [key_datum_list | dict_comprehension] '
'"}"\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'
'\n'
'A dictionary display yields a new dictionary object.\n'
...
...
@@ -3903,6 +3912,14 @@
'value\n'
'for that key will be the last one given.\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'
'needs two expressions separated with a colon followed by the usual\n'
'"for" and "if" clauses. When the comprehension is run, the '
...
...
@@ -4385,12 +4402,29 @@
'****************\n'
'\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'
'Except when part of a list or set display, an expression list\n'
'containing at least one comma yields a tuple. The length of '
'the tuple\n'
'is the number of expressions in the list. The expressions are\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'
'An expression list containing at least one comma yields a '
'tuple. The\n'
'length of the tuple is the number of expressions in the list. '
'The\n'
'expressions are evaluated from left to right.\n'
'New in version 3.5: Iterable unpacking in expression lists, '
'originally\n'
'proposed by **PEP 448**.\n'
'\n'
'The trailing comma is required only to create a single tuple '
'(a.k.a. a\n'
...
...
@@ -5220,7 +5254,7 @@
'[parameter_list] ")" ["->" expression] ":" suite\n'
' decorators ::= decorator+\n'
' decorator ::= "@" dotted_name ["(" '
'[
p
ar
ameter
_list [","]] ")"] NEWLINE\n'
'[ar
gument
_list [","]] ")"] NEWLINE\n'
' dotted_name ::= identifier ("." identifier)*\n'
' parameter_list ::= defparameter ("," defparameter)* '
'["," [parameter_list_starargs]]\n'
...
...
@@ -5682,7 +5716,7 @@
'the\n'
'two steps are carried out separately for each clause, just as '
'though\n'
'the clauses had been separated out into individ
i
ual import '
'the clauses had been separated out into individual import '
'statements.\n'
'\n'
'The details of the first step, finding and loading modules are\n'
...
...
@@ -6016,7 +6050,7 @@
'in\n'
'square brackets:\n'
'\n'
' list_display ::= "[" [
expression
_list | comprehension] "]"\n'
' list_display ::= "[" [
starred
_list | comprehension] "]"\n'
'\n'
'A list display yields a new list object, the contents being '
'specified\n'
...
...
@@ -8305,6 +8339,14 @@
'object is bound in the local namespace as the defined '
'class.\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'
'\n'
' **PEP 3135** - New super\n'
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment