|
1 | 1 | # -*- coding: utf-8 -*- |
2 | | -# Autogenerated by Sphinx on Mon Jan 8 21:23:03 2018 |
| 2 | +# Autogenerated by Sphinx on Tue Jan 30 18:36:07 2018 |
3 | 3 | topics = {'assert': 'The "assert" statement\n' |
4 | 4 | '**********************\n' |
5 | 5 | '\n' |
|
629 | 629 | 'dictionary) is\n' |
630 | 630 | ' unaffected.\n' |
631 | 631 | '\n' |
| 632 | + 'Changed in version 3.5: "__class__" module attribute is ' |
| 633 | + 'now writable.\n' |
| 634 | + '\n' |
| 635 | + 'New in version 3.7: "__getattr__" and "__dir__" module ' |
| 636 | + 'attributes.\n' |
| 637 | + '\n' |
| 638 | + 'See also:\n' |
| 639 | + '\n' |
| 640 | + ' **PEP 562** - Module __getattr__ and __dir__\n' |
| 641 | + ' Describes the "__getattr__" and "__dir__" functions ' |
| 642 | + 'on modules.\n' |
| 643 | + '\n' |
632 | 644 | '\n' |
633 | 645 | 'Implementing Descriptors\n' |
634 | 646 | '========================\n' |
|
2512 | 2524 | 'have\n' |
2513 | 2525 | '"return" annotation of the form ""-> expression"" after the ' |
2514 | 2526 | 'parameter\n' |
2515 | | - 'list. These annotations can be any valid Python expression and ' |
2516 | | - 'are\n' |
2517 | | - 'evaluated when the function definition is executed. Annotations ' |
2518 | | - 'may\n' |
2519 | | - 'be evaluated in a different order than they appear in the source ' |
2520 | | - 'code.\n' |
2521 | | - 'The presence of annotations does not change the semantics of a\n' |
2522 | | - 'function. The annotation values are available as values of a\n' |
2523 | | - "dictionary keyed by the parameters' names in the " |
2524 | | - '"__annotations__"\n' |
2525 | | - 'attribute of the function object.\n' |
| 2527 | + 'list. These annotations can be any valid Python expression. ' |
| 2528 | + 'The\n' |
| 2529 | + 'presence of annotations does not change the semantics of a ' |
| 2530 | + 'function.\n' |
| 2531 | + 'The annotation values are available as values of a dictionary ' |
| 2532 | + 'keyed by\n' |
| 2533 | + 'the parameters\' names in the "__annotations__" attribute of ' |
| 2534 | + 'the\n' |
| 2535 | + 'function object. If the "annotations" import from "__future__" ' |
| 2536 | + 'is\n' |
| 2537 | + 'used, annotations are preserved as strings at runtime which ' |
| 2538 | + 'enables\n' |
| 2539 | + 'postponed evaluation. Otherwise, they are evaluated when the ' |
| 2540 | + 'function\n' |
| 2541 | + 'definition is executed. In this case annotations may be ' |
| 2542 | + 'evaluated in\n' |
| 2543 | + 'a different order than they appear in the source code.\n' |
2526 | 2544 | '\n' |
2527 | 2545 | 'It is also possible to create anonymous functions (functions not ' |
2528 | 2546 | 'bound\n' |
|
2554 | 2572 | ' **PEP 3107** - Function Annotations\n' |
2555 | 2573 | ' The original specification for function annotations.\n' |
2556 | 2574 | '\n' |
| 2575 | + ' **PEP 484** - Type Hints\n' |
| 2576 | + ' Definition of a standard meaning for annotations: type ' |
| 2577 | + 'hints.\n' |
| 2578 | + '\n' |
| 2579 | + ' **PEP 526** - Syntax for Variable Annotations\n' |
| 2580 | + ' Ability to type hint variable declarations, including ' |
| 2581 | + 'class\n' |
| 2582 | + ' variables and instance variables\n' |
| 2583 | + '\n' |
| 2584 | + ' **PEP 563** - Postponed Evaluation of Annotations\n' |
| 2585 | + ' Support for forward references within annotations by ' |
| 2586 | + 'preserving\n' |
| 2587 | + ' annotations in a string form at runtime instead of eager\n' |
| 2588 | + ' evaluation.\n' |
| 2589 | + '\n' |
2557 | 2590 | '\n' |
2558 | 2591 | 'Class definitions\n' |
2559 | 2592 | '=================\n' |
|
3748 | 3781 | ' (com) end\n' |
3749 | 3782 | ' (Pdb)\n' |
3750 | 3783 | '\n' |
3751 | | - ' To remove all commands from a breakpoint, type commands and ' |
3752 | | - 'follow\n' |
3753 | | - ' it immediately with "end"; that is, give no commands.\n' |
| 3784 | + ' To remove all commands from a breakpoint, type "commands" ' |
| 3785 | + 'and\n' |
| 3786 | + ' follow it immediately with "end"; that is, give no commands.\n' |
3754 | 3787 | '\n' |
3755 | | - ' With no *bpnumber* argument, commands refers to the last ' |
3756 | | - 'breakpoint\n' |
3757 | | - ' set.\n' |
| 3788 | + ' With no *bpnumber* argument, "commands" refers to the last\n' |
| 3789 | + ' breakpoint set.\n' |
3758 | 3790 | '\n' |
3759 | 3791 | ' You can use breakpoint commands to start your program up ' |
3760 | 3792 | 'again.\n' |
3761 | | - ' Simply use the continue command, or step, or any other ' |
3762 | | - 'command that\n' |
3763 | | - ' resumes execution.\n' |
| 3793 | + ' Simply use the "continue" command, or "step", or any other ' |
| 3794 | + 'command\n' |
| 3795 | + ' that resumes execution.\n' |
3764 | 3796 | '\n' |
3765 | 3797 | ' Specifying any command resuming execution (currently ' |
3766 | | - 'continue,\n' |
3767 | | - ' step, next, return, jump, quit and their abbreviations) ' |
3768 | | - 'terminates\n' |
3769 | | - ' the command list (as if that command was immediately followed ' |
3770 | | - 'by\n' |
3771 | | - ' end). This is because any time you resume execution (even ' |
3772 | | - 'with a\n' |
3773 | | - ' simple next or step), you may encounter another ' |
3774 | | - 'breakpoint—which\n' |
3775 | | - ' could have its own command list, leading to ambiguities about ' |
3776 | | - 'which\n' |
3777 | | - ' list to execute.\n' |
| 3798 | + '"continue",\n' |
| 3799 | + ' "step", "next", "return", "jump", "quit" and their ' |
| 3800 | + 'abbreviations)\n' |
| 3801 | + ' terminates the command "list" (as if that command was ' |
| 3802 | + 'immediately\n' |
| 3803 | + ' followed by end). This is because any time you resume ' |
| 3804 | + 'execution\n' |
| 3805 | + ' (even with a simple next or step), you may encounter another\n' |
| 3806 | + ' breakpoint—which could have its own command list, leading to\n' |
| 3807 | + ' ambiguities about which list to execute.\n' |
3778 | 3808 | '\n' |
3779 | 3809 | " If you use the 'silent' command in the command list, the " |
3780 | 3810 | 'usual\n' |
|
5506 | 5536 | 'have\n' |
5507 | 5537 | '"return" annotation of the form ""-> expression"" after the ' |
5508 | 5538 | 'parameter\n' |
5509 | | - 'list. These annotations can be any valid Python expression and ' |
5510 | | - 'are\n' |
5511 | | - 'evaluated when the function definition is executed. Annotations ' |
5512 | | - 'may\n' |
5513 | | - 'be evaluated in a different order than they appear in the source ' |
5514 | | - 'code.\n' |
5515 | | - 'The presence of annotations does not change the semantics of a\n' |
5516 | | - 'function. The annotation values are available as values of a\n' |
5517 | | - "dictionary keyed by the parameters' names in the " |
5518 | | - '"__annotations__"\n' |
5519 | | - 'attribute of the function object.\n' |
| 5539 | + 'list. These annotations can be any valid Python expression. ' |
| 5540 | + 'The\n' |
| 5541 | + 'presence of annotations does not change the semantics of a ' |
| 5542 | + 'function.\n' |
| 5543 | + 'The annotation values are available as values of a dictionary ' |
| 5544 | + 'keyed by\n' |
| 5545 | + 'the parameters\' names in the "__annotations__" attribute of ' |
| 5546 | + 'the\n' |
| 5547 | + 'function object. If the "annotations" import from "__future__" ' |
| 5548 | + 'is\n' |
| 5549 | + 'used, annotations are preserved as strings at runtime which ' |
| 5550 | + 'enables\n' |
| 5551 | + 'postponed evaluation. Otherwise, they are evaluated when the ' |
| 5552 | + 'function\n' |
| 5553 | + 'definition is executed. In this case annotations may be ' |
| 5554 | + 'evaluated in\n' |
| 5555 | + 'a different order than they appear in the source code.\n' |
5520 | 5556 | '\n' |
5521 | 5557 | 'It is also possible to create anonymous functions (functions not ' |
5522 | 5558 | 'bound\n' |
|
5546 | 5582 | 'See also:\n' |
5547 | 5583 | '\n' |
5548 | 5584 | ' **PEP 3107** - Function Annotations\n' |
5549 | | - ' The original specification for function annotations.\n', |
| 5585 | + ' The original specification for function annotations.\n' |
| 5586 | + '\n' |
| 5587 | + ' **PEP 484** - Type Hints\n' |
| 5588 | + ' Definition of a standard meaning for annotations: type ' |
| 5589 | + 'hints.\n' |
| 5590 | + '\n' |
| 5591 | + ' **PEP 526** - Syntax for Variable Annotations\n' |
| 5592 | + ' Ability to type hint variable declarations, including ' |
| 5593 | + 'class\n' |
| 5594 | + ' variables and instance variables\n' |
| 5595 | + '\n' |
| 5596 | + ' **PEP 563** - Postponed Evaluation of Annotations\n' |
| 5597 | + ' Support for forward references within annotations by ' |
| 5598 | + 'preserving\n' |
| 5599 | + ' annotations in a string form at runtime instead of eager\n' |
| 5600 | + ' evaluation.\n', |
5550 | 5601 | 'global': 'The "global" statement\n' |
5551 | 5602 | '**********************\n' |
5552 | 5603 | '\n' |
|
6019 | 6070 | '\n' |
6020 | 6071 | '* other future statements.\n' |
6021 | 6072 | '\n' |
6022 | | - 'The features recognized by Python 3.0 are "absolute_import",\n' |
6023 | | - '"division", "generators", "unicode_literals", "print_function",\n' |
6024 | | - '"nested_scopes" and "with_statement". They are all redundant ' |
6025 | | - 'because\n' |
6026 | | - 'they are always enabled, and only kept for backwards ' |
| 6073 | + 'The only feature in Python 3.7 that requires using the future\n' |
| 6074 | + 'statement is "annotations".\n' |
| 6075 | + '\n' |
| 6076 | + 'All historical features enabled by the future statement are still\n' |
| 6077 | + 'recognized by Python 3. The list includes "absolute_import",\n' |
| 6078 | + '"division", "generators", "generator_stop", "unicode_literals",\n' |
| 6079 | + '"print_function", "nested_scopes" and "with_statement". They are ' |
| 6080 | + 'all\n' |
| 6081 | + 'redundant because they are always enabled, and only kept for ' |
| 6082 | + 'backwards\n' |
6027 | 6083 | 'compatibility.\n' |
6028 | 6084 | '\n' |
6029 | 6085 | 'A future statement is recognized and treated specially at compile\n' |
|
8146 | 8202 | 'dictionary) is\n' |
8147 | 8203 | ' unaffected.\n' |
8148 | 8204 | '\n' |
| 8205 | + 'Changed in version 3.5: "__class__" module attribute is now ' |
| 8206 | + 'writable.\n' |
| 8207 | + '\n' |
| 8208 | + 'New in version 3.7: "__getattr__" and "__dir__" module ' |
| 8209 | + 'attributes.\n' |
| 8210 | + '\n' |
| 8211 | + 'See also:\n' |
| 8212 | + '\n' |
| 8213 | + ' **PEP 562** - Module __getattr__ and __dir__\n' |
| 8214 | + ' Describes the "__getattr__" and "__dir__" functions on ' |
| 8215 | + 'modules.\n' |
| 8216 | + '\n' |
8149 | 8217 | '\n' |
8150 | 8218 | 'Implementing Descriptors\n' |
8151 | 8219 | '------------------------\n' |
|
9547 | 9615 | ' formatting options that can be specified in format ' |
9548 | 9616 | 'strings.\n' |
9549 | 9617 | '\n' |
| 9618 | + ' Note: When formatting a number ("int", "float", "float" ' |
| 9619 | + 'and\n' |
| 9620 | + ' subclasses) with the "n" type (ex: ' |
| 9621 | + '"\'{:n}\'.format(1234)"), the\n' |
| 9622 | + ' function sets temporarily the "LC_CTYPE" locale to ' |
| 9623 | + 'the\n' |
| 9624 | + ' "LC_NUMERIC" locale to decode "decimal_point" and ' |
| 9625 | + '"thousands_sep"\n' |
| 9626 | + ' fields of "localeconv()" if they are non-ASCII or ' |
| 9627 | + 'longer than 1\n' |
| 9628 | + ' byte, and the "LC_NUMERIC" locale is different than ' |
| 9629 | + 'the\n' |
| 9630 | + ' "LC_CTYPE" locale. This temporary change affects ' |
| 9631 | + 'other threads.\n' |
| 9632 | + '\n' |
| 9633 | + ' Changed in version 3.7: When formatting a number with ' |
| 9634 | + 'the "n" type,\n' |
| 9635 | + ' the function sets temporarily the "LC_CTYPE" locale to ' |
| 9636 | + 'the\n' |
| 9637 | + ' "LC_NUMERIC" locale in some cases.\n' |
| 9638 | + '\n' |
9550 | 9639 | 'str.format_map(mapping)\n' |
9551 | 9640 | '\n' |
9552 | 9641 | ' Similar to "str.format(**mapping)", except that ' |
|
9598 | 9687 | 'Unicode\n' |
9599 | 9688 | ' Standard.\n' |
9600 | 9689 | '\n' |
| 9690 | + 'str.isascii()\n' |
| 9691 | + '\n' |
| 9692 | + ' Return true if the string is empty or all characters in ' |
| 9693 | + 'the string\n' |
| 9694 | + ' are ASCII, false otherwise. ASCII characters have code ' |
| 9695 | + 'points in\n' |
| 9696 | + ' the range U+0000-U+007F.\n' |
| 9697 | + '\n' |
| 9698 | + ' New in version 3.7.\n' |
| 9699 | + '\n' |
9601 | 9700 | 'str.isdecimal()\n' |
9602 | 9701 | '\n' |
9603 | 9702 | ' Return true if all characters in the string are decimal ' |
|
0 commit comments