|
1 | 1 | # -*- coding: utf-8 -*-
|
2 |
| -# Autogenerated by Sphinx on Sun Oct 4 19:26:28 2020 |
| 2 | +# Autogenerated by Sphinx on Tue Nov 24 17:42:56 2020 |
3 | 3 | topics = {'assert': 'The "assert" statement\n'
|
4 | 4 | '**********************\n'
|
5 | 5 | '\n'
|
|
700 | 700 | 'syntax or\n'
|
701 | 701 | ' built-in functions. See Special method lookup.\n'
|
702 | 702 | '\n'
|
| 703 | + ' For certain sensitive attribute accesses, raises an ' |
| 704 | + 'auditing event\n' |
| 705 | + ' "object.__getattr__" with arguments "obj" and ' |
| 706 | + '"name".\n' |
| 707 | + '\n' |
703 | 708 | 'object.__setattr__(self, name, value)\n'
|
704 | 709 | '\n'
|
705 | 710 | ' Called when an attribute assignment is attempted. '
|
|
716 | 721 | 'for example,\n'
|
717 | 722 | ' "object.__setattr__(self, name, value)".\n'
|
718 | 723 | '\n'
|
| 724 | + ' For certain sensitive attribute assignments, raises ' |
| 725 | + 'an auditing\n' |
| 726 | + ' event "object.__setattr__" with arguments "obj", ' |
| 727 | + '"name", "value".\n' |
| 728 | + '\n' |
719 | 729 | 'object.__delattr__(self, name)\n'
|
720 | 730 | '\n'
|
721 | 731 | ' Like "__setattr__()" but for attribute deletion '
|
|
724 | 734 | 'obj.name" is\n'
|
725 | 735 | ' meaningful for the object.\n'
|
726 | 736 | '\n'
|
| 737 | + ' For certain sensitive attribute deletions, raises an ' |
| 738 | + 'auditing event\n' |
| 739 | + ' "object.__delattr__" with arguments "obj" and ' |
| 740 | + '"name".\n' |
| 741 | + '\n' |
727 | 742 | 'object.__dir__(self)\n'
|
728 | 743 | '\n'
|
729 | 744 | ' Called when "dir()" is called on the object. A '
|
|
1464 | 1479 | '\n'
|
1465 | 1480 | ' Called when the instance is “called” as a function; if '
|
1466 | 1481 | 'this method\n'
|
1467 |
| - ' is defined, "x(arg1, arg2, ...)" is a shorthand for\n' |
1468 |
| - ' "x.__call__(arg1, arg2, ...)".\n', |
| 1482 | + ' is defined, "x(arg1, arg2, ...)" roughly translates to\n' |
| 1483 | + ' "type(x).__call__(x, arg1, ...)".\n', |
1469 | 1484 | 'calls': 'Calls\n'
|
1470 | 1485 | '*****\n'
|
1471 | 1486 | '\n'
|
|
3461 | 3476 | ' on the value to determine if the result is true or '
|
3462 | 3477 | 'false.\n'
|
3463 | 3478 | '\n'
|
3464 |
| - ' By default, "__ne__()" delegates to "__eq__()" and ' |
3465 |
| - 'inverts the\n' |
3466 |
| - ' result unless it is "NotImplemented". There are no ' |
3467 |
| - 'other implied\n' |
3468 |
| - ' relationships among the comparison operators, for ' |
3469 |
| - 'example, the\n' |
3470 |
| - ' truth of "(x<y or x==y)" does not imply "x<=y". To ' |
3471 |
| - 'automatically\n' |
3472 |
| - ' generate ordering operations from a single root ' |
3473 |
| - 'operation, see\n' |
| 3479 | + ' By default, "object" implements "__eq__()" by using ' |
| 3480 | + '"is", returning\n' |
| 3481 | + ' "NotImplemented" in the case of a false comparison: ' |
| 3482 | + '"True if x is y\n' |
| 3483 | + ' else NotImplemented". For "__ne__()", by default it ' |
| 3484 | + 'delegates to\n' |
| 3485 | + ' "__eq__()" and inverts the result unless it is ' |
| 3486 | + '"NotImplemented".\n' |
| 3487 | + ' There are no other implied relationships among the ' |
| 3488 | + 'comparison\n' |
| 3489 | + ' operators or default implementations; for example, the ' |
| 3490 | + 'truth of\n' |
| 3491 | + ' "(x<y or x==y)" does not imply "x<=y". To automatically ' |
| 3492 | + 'generate\n' |
| 3493 | + ' ordering operations from a single root operation, see\n' |
3474 | 3494 | ' "functools.total_ordering()".\n'
|
3475 | 3495 | '\n'
|
3476 | 3496 | ' See the paragraph on "__hash__()" for some important '
|
|
6395 | 6415 | '\n'
|
6396 | 6416 | '* other future statements.\n'
|
6397 | 6417 | '\n'
|
6398 |
| - 'The only feature in Python 3.7 that requires using the future\n' |
6399 |
| - 'statement is "annotations".\n' |
| 6418 | + 'The only feature that requires using the future statement is\n' |
| 6419 | + '"annotations" (see **PEP 563**).\n' |
6400 | 6420 | '\n'
|
6401 | 6421 | 'All historical features enabled by the future statement are still\n'
|
6402 | 6422 | 'recognized by Python 3. The list includes "absolute_import",\n'
|
|
6928 | 6948 | '\n'
|
6929 | 6949 | ' If the right operand’s type is a subclass of the left '
|
6930 | 6950 | 'operand’s\n'
|
6931 |
| - ' type and that subclass provides the reflected method ' |
6932 |
| - 'for the\n' |
6933 |
| - ' operation, this method will be called before the left ' |
6934 |
| - 'operand’s\n' |
6935 |
| - ' non-reflected method. This behavior allows subclasses ' |
6936 |
| - 'to\n' |
6937 |
| - ' override their ancestors’ operations.\n' |
| 6951 | + ' type and that subclass provides a different ' |
| 6952 | + 'implementation of the\n' |
| 6953 | + ' reflected method for the operation, this method will ' |
| 6954 | + 'be called\n' |
| 6955 | + ' before the left operand’s non-reflected method. This ' |
| 6956 | + 'behavior\n' |
| 6957 | + ' allows subclasses to override their ancestors’ ' |
| 6958 | + 'operations.\n' |
6938 | 6959 | '\n'
|
6939 | 6960 | 'object.__iadd__(self, other)\n'
|
6940 | 6961 | 'object.__isub__(self, other)\n'
|
|
8251 | 8272 | ' on the value to determine if the result is true or '
|
8252 | 8273 | 'false.\n'
|
8253 | 8274 | '\n'
|
8254 |
| - ' By default, "__ne__()" delegates to "__eq__()" and ' |
8255 |
| - 'inverts the\n' |
8256 |
| - ' result unless it is "NotImplemented". There are no other ' |
8257 |
| - 'implied\n' |
8258 |
| - ' relationships among the comparison operators, for ' |
8259 |
| - 'example, the\n' |
8260 |
| - ' truth of "(x<y or x==y)" does not imply "x<=y". To ' |
8261 |
| - 'automatically\n' |
8262 |
| - ' generate ordering operations from a single root ' |
8263 |
| - 'operation, see\n' |
| 8275 | + ' By default, "object" implements "__eq__()" by using "is", ' |
| 8276 | + 'returning\n' |
| 8277 | + ' "NotImplemented" in the case of a false comparison: "True ' |
| 8278 | + 'if x is y\n' |
| 8279 | + ' else NotImplemented". For "__ne__()", by default it ' |
| 8280 | + 'delegates to\n' |
| 8281 | + ' "__eq__()" and inverts the result unless it is ' |
| 8282 | + '"NotImplemented".\n' |
| 8283 | + ' There are no other implied relationships among the ' |
| 8284 | + 'comparison\n' |
| 8285 | + ' operators or default implementations; for example, the ' |
| 8286 | + 'truth of\n' |
| 8287 | + ' "(x<y or x==y)" does not imply "x<=y". To automatically ' |
| 8288 | + 'generate\n' |
| 8289 | + ' ordering operations from a single root operation, see\n' |
8264 | 8290 | ' "functools.total_ordering()".\n'
|
8265 | 8291 | '\n'
|
8266 | 8292 | ' See the paragraph on "__hash__()" for some important '
|
|
8490 | 8516 | 'syntax or\n'
|
8491 | 8517 | ' built-in functions. See Special method lookup.\n'
|
8492 | 8518 | '\n'
|
| 8519 | + ' For certain sensitive attribute accesses, raises an ' |
| 8520 | + 'auditing event\n' |
| 8521 | + ' "object.__getattr__" with arguments "obj" and "name".\n' |
| 8522 | + '\n' |
8493 | 8523 | 'object.__setattr__(self, name, value)\n'
|
8494 | 8524 | '\n'
|
8495 | 8525 | ' Called when an attribute assignment is attempted. This '
|
|
8506 | 8536 | 'example,\n'
|
8507 | 8537 | ' "object.__setattr__(self, name, value)".\n'
|
8508 | 8538 | '\n'
|
| 8539 | + ' For certain sensitive attribute assignments, raises an ' |
| 8540 | + 'auditing\n' |
| 8541 | + ' event "object.__setattr__" with arguments "obj", "name", ' |
| 8542 | + '"value".\n' |
| 8543 | + '\n' |
8509 | 8544 | 'object.__delattr__(self, name)\n'
|
8510 | 8545 | '\n'
|
8511 | 8546 | ' Like "__setattr__()" but for attribute deletion instead '
|
|
8514 | 8549 | 'obj.name" is\n'
|
8515 | 8550 | ' meaningful for the object.\n'
|
8516 | 8551 | '\n'
|
| 8552 | + ' For certain sensitive attribute deletions, raises an ' |
| 8553 | + 'auditing event\n' |
| 8554 | + ' "object.__delattr__" with arguments "obj" and "name".\n' |
| 8555 | + '\n' |
8517 | 8556 | 'object.__dir__(self)\n'
|
8518 | 8557 | '\n'
|
8519 | 8558 | ' Called when "dir()" is called on the object. A sequence '
|
|
9307 | 9346 | '\n'
|
9308 | 9347 | ' Called when the instance is “called” as a function; if '
|
9309 | 9348 | 'this method\n'
|
9310 |
| - ' is defined, "x(arg1, arg2, ...)" is a shorthand for\n' |
9311 |
| - ' "x.__call__(arg1, arg2, ...)".\n' |
| 9349 | + ' is defined, "x(arg1, arg2, ...)" roughly translates to\n' |
| 9350 | + ' "type(x).__call__(x, arg1, ...)".\n' |
9312 | 9351 | '\n'
|
9313 | 9352 | '\n'
|
9314 | 9353 | 'Emulating container types\n'
|
|
9641 | 9680 | '\n'
|
9642 | 9681 | ' If the right operand’s type is a subclass of the left '
|
9643 | 9682 | 'operand’s\n'
|
9644 |
| - ' type and that subclass provides the reflected method ' |
9645 |
| - 'for the\n' |
9646 |
| - ' operation, this method will be called before the left ' |
9647 |
| - 'operand’s\n' |
9648 |
| - ' non-reflected method. This behavior allows subclasses ' |
9649 |
| - 'to\n' |
9650 |
| - ' override their ancestors’ operations.\n' |
| 9683 | + ' type and that subclass provides a different ' |
| 9684 | + 'implementation of the\n' |
| 9685 | + ' reflected method for the operation, this method will be ' |
| 9686 | + 'called\n' |
| 9687 | + ' before the left operand’s non-reflected method. This ' |
| 9688 | + 'behavior\n' |
| 9689 | + ' allows subclasses to override their ancestors’ ' |
| 9690 | + 'operations.\n' |
9651 | 9691 | '\n'
|
9652 | 9692 | 'object.__iadd__(self, other)\n'
|
9653 | 9693 | 'object.__isub__(self, other)\n'
|
|
11072 | 11112 | 'subscriptions': 'Subscriptions\n'
|
11073 | 11113 | '*************\n'
|
11074 | 11114 | '\n'
|
11075 |
| - 'A subscription selects an item of a sequence (string, tuple ' |
11076 |
| - 'or list)\n' |
11077 |
| - 'or mapping (dictionary) object:\n' |
| 11115 | + 'Subscription of a sequence (string, tuple or list) or ' |
| 11116 | + 'mapping\n' |
| 11117 | + '(dictionary) object usually selects an item from the ' |
| 11118 | + 'collection:\n' |
11078 | 11119 | '\n'
|
11079 | 11120 | ' subscription ::= primary "[" expression_list "]"\n'
|
11080 | 11121 | '\n'
|
|
11125 | 11166 | '\n'
|
11126 | 11167 | 'A string’s items are characters. A character is not a '
|
11127 | 11168 | 'separate data\n'
|
11128 |
| - 'type but a string of exactly one character.\n', |
| 11169 | + 'type but a string of exactly one character.\n' |
| 11170 | + '\n' |
| 11171 | + 'Subscription of certain *classes* or *types* creates a ' |
| 11172 | + 'generic alias.\n' |
| 11173 | + 'In this case, user-defined classes can support subscription ' |
| 11174 | + 'by\n' |
| 11175 | + 'providing a "__class_getitem__()" classmethod.\n', |
11129 | 11176 | 'truth': 'Truth Value Testing\n'
|
11130 | 11177 | '*******************\n'
|
11131 | 11178 | '\n'
|
|
11371 | 11418 | 'representation\n'
|
11372 | 11419 | ' in computers.\n'
|
11373 | 11420 | '\n'
|
| 11421 | + ' The string representations of the numeric classes, computed by\n' |
| 11422 | + ' "__repr__()" and "__str__()", have the following properties:\n' |
| 11423 | + '\n' |
| 11424 | + ' * They are valid numeric literals which, when passed to their ' |
| 11425 | + 'class\n' |
| 11426 | + ' constructor, produce an object having the value of the ' |
| 11427 | + 'original\n' |
| 11428 | + ' numeric.\n' |
| 11429 | + '\n' |
| 11430 | + ' * The representation is in base 10, when possible.\n' |
| 11431 | + '\n' |
| 11432 | + ' * Leading zeros, possibly excepting a single zero before a ' |
| 11433 | + 'decimal\n' |
| 11434 | + ' point, are not shown.\n' |
| 11435 | + '\n' |
| 11436 | + ' * Trailing zeros, possibly excepting a single zero after a ' |
| 11437 | + 'decimal\n' |
| 11438 | + ' point, are not shown.\n' |
| 11439 | + '\n' |
| 11440 | + ' * A sign is shown only when the number is negative.\n' |
| 11441 | + '\n' |
11374 | 11442 | ' Python distinguishes between integers, floating point numbers, '
|
11375 | 11443 | 'and\n'
|
11376 | 11444 | ' complex numbers:\n'
|
|
12422 | 12490 | 'positional\n'
|
12423 | 12491 | ' argument and a possibly empty set of keyword arguments.\n'
|
12424 | 12492 | '\n'
|
| 12493 | + ' Dictionaries can be created by several means:\n' |
| 12494 | + '\n' |
| 12495 | + ' * Use a comma-separated list of "key: value" pairs within ' |
| 12496 | + 'braces:\n' |
| 12497 | + ' "{\'jack\': 4098, \'sjoerd\': 4127}" or "{4098: ' |
| 12498 | + "'jack', 4127:\n" |
| 12499 | + ' \'sjoerd\'}"\n' |
| 12500 | + '\n' |
| 12501 | + ' * Use a dict comprehension: "{}", "{x: x ** 2 for x in ' |
| 12502 | + 'range(10)}"\n' |
| 12503 | + '\n' |
| 12504 | + ' * Use the type constructor: "dict()", "dict([(\'foo\', ' |
| 12505 | + "100), ('bar',\n" |
| 12506 | + ' 200)])", "dict(foo=100, bar=200)"\n' |
| 12507 | + '\n' |
12425 | 12508 | ' If no positional argument is given, an empty dictionary '
|
12426 | 12509 | 'is created.\n'
|
12427 | 12510 | ' If a positional argument is given and it is a mapping '
|
|
0 commit comments