Notice: While JavaScript is not essential for this website, your interaction with the content will be limited. Please turn JavaScript on for the full experience.
...editors (like IDLE and Emacs) support the declarations of PEP 263, many editors still do not (and never will); users have to explicitly adjust the encoding which the editor assumes on a file-by-file basis. When the default encoding is changed to UTF-8, adding non-ASCII text to Python files becomes easier and more portable: On some systems, editors will automatically choose UTF-8 when saving text (e.g. on Unix systems where the locale uses UTF-8). On other systems, editors will guess the encoding...
...Editors The PEP editors are individuals responsible for managing the administrative and editorial aspects of the PEP workflow (e.g. assigning PEP numbers and changing their status). See PEP Editor Responsibilities & Workflow for details. PEP editorship is by invitation of the current editors, and they can be contacted by mentioning @python/pep-editors on GitHub. All of the PEP workflow can be conducted via the GitHub PEP repository issues and pull requests. Start with an idea for Python ...
...editor such as the Online ReSt editor for checking your formatting. Postings failing to format correctly will get rejected. Please watch out for common formatting mistakes: Requirements: * first item * second item should be written as (note the added blank line): Requirements: * first item * second item Bullets and paragraphs should always start in the first column: * correct * not correct Correct start of text... Incorrect start of text... Use '*' as bullet character, no center dots ...
...text editor integration. (actual video/screencast) A Demonstration of ReStructuredText A quick look at a style of marking up plaintext called "reStructuredText" with hotkeys from the Emacs text editor to view the result as HTML, PDF and slides. (actual video/screencast) Python and the Image Manipulation Library A slideshow look at the features of the widely used 2-d image manipulation package for Python named 'PIL', providing for the viewing, copying, printing, filtering and tran...
...text. Humans tend to ignore details in longer identifiers: the variable name accessibi1ity_options can still look indistinguishable from accessibility_options, while they are distinct for the compiler. The same can be said for plain typos: most humans will not notice the typo in responsbility_chain_delegate. Control Characters Python generally considers all CR (\r), LF (\n), and CR-LF pairs (\r\n) as an end of line characters. Most code editors do as well, but there are editors that display “n...
...text PEP Template PEP:9 Title:Sample Plaintext PEP Template Author:Barry Warsaw <barry at python.org> Status:Withdrawn Type:Process Created:14-Aug-2001 Post-History: Resolution:https://mail.python.org/mailman/private/peps/2016-January/001165.html Update As of 05-Jan-2016, this PEP is officially deprecated and replaced by PEP 12. All PEPs should now use the reStructuredText format described by PEP 12, and plaintext PEPs will no longer be accepted. Abstra...
...text files would break. Examples of such programs would be editors which warn you when you open a file with a different newline convention. If universal newlines was made the default such an editor would silently convert your line endings to the local convention on save. Programs which open binary files as text files on Unix would also break (but it could be argued they deserve it :-). Interface clarity. Universal newlines are only supported for input files, not for input/output files, as the s...
...editor is as valued as being approved by the peer review process. Presumably the PSA's stamp and publication in the PSA archives would be considered equivalent to publishing in a peer reviewed journal. Both editors/reviewers and authors would be interested in contributing if the PSA became a vehicle for peer recognition. in the free-ware world: They'll do what they want anyway, but in general the goal of writing free-ware is for personal satisfaction, ...
...texts present in the tool are reused to produce the reference section in the written documentation. The object model of the configuration tool is visible to the user, displayed in a "Pilot-Window". The Pilot lets the user manipulate object data, and links between objects, by clicking on the respective item (see Figure A). This click opens an object editor for modification of attributes. The object editor is parameterized with the type of object in the model. The code for drawing th...
...text: # This Python file uses the following encoding: utf-8 import os, sys ... Text editors might have different ways of defining the file's encoding, e.g.: #!/usr/local/bin/python # coding: latin-1 import os, sys ... Without encoding comment, Python's parser will assume ASCII text: #!/usr/local/bin/python import os, sys ... Encoding comments which don't work: Missing "coding:" prefix: #!/usr/local/bin/python # latin-1 import os, sys ... Encoding comment not on line 1 or 2: #!/usr/...
...editors for details. Copyright This document has been placed in the public domain. Source: https://github.com/python/peps/blob/master/pep-0801.rst
...text editors are tailored to make Python editing easy, browse the list of introductory books, or look at code samples that you might find helpful. There is a list of tutorials suitable for experienced programmers on the BeginnersGuide/Tutorials page. There is also a list of resources in other languages which might be useful if English is not your first language. The online documentation is your first port of call for definitive information. There is a fairly brief tutorial that gives you basic i...
...Text messaging seemed to be the right way to go, because messages are easily received by any mobile phone. Most wireless providers maintain email to SMS gateways, and many off-the-shelf devices can generate email messages. I was only limited by the necessity of dial-up connectivity -- many locations containing monitored equipment proved impervious to wireless signals. After coming up with the basic idea to use text messages and selecting the components, I had to figure out how to make the indivi...
...text menus (Issue 1207589, opened in 2005 [1]; pydev thread [2]). The features were available as keyboard shortcuts but not on the context menu. It is standard, at least on Windows, that they should be when applicable (a read-only window would only have Copy), so users do not have to shift to the keyboard after selecting text for cutting or copying or a slice point for pasting. The context menu was not documented until 10 days before the new options were added (Issue 10405 [5]). Normally, beh...
...TextNG (http://www.zope.org/Members/jim/StructuredTextWiki/StructuredTextNG) Since StructuredText is not yet strong enough to handle (a) and (b) above, we will need to extend it. I suggest using [<optional description>:python identifier]. E.g.: [class:POP3], [:POP3.list], etc. If the description is missing, a guess will be made from the text. Unresolved Issues Is there a way to escape characters in ST? If so, how? (example: * at the beginning of a line without being bullet symbol) Is my ...
...text (with non-invasive markup) is the best format for writing anything. All other formats are to be generated from the plain text. Codetag design was influenced by the following goals: Comments should be short whenever possible. Codetag fields should be optional and of minimal length. Default values and custom fields can be set by individual code shops. Codetags should be minimalistic. The quicker it is to jot something down, the more likely it is to get jotted. The most common use of code...
...editors, folding editors, and the like; and confused users. There are no situations currently in Python where a line ending in a colon is followed by an unindented line. Alternative 3 This is the same as alternative 2 but leaves out the colon after the switch: switch EXPR case EXPR: SUITE case EXPR: SUITE .... else: SUITE The hope of this alternative is that it will not upset the auto-indent logic of the average Python-aware text editor less. But it looks strange to me. Alter...
...editor might delete it as a matter of routine. Function definition style: function name in column 1, outermost curly braces in column 1, blank line after local variable declarations. static int extra_ivars(PyTypeObject *type, PyTypeObject *base) { int t_size = PyType_BASICSIZE(type); int b_size = PyType_BASICSIZE(base); assert(t_size >= b_size); /* type smaller than base! */ ... return 1; } Code structure: one space between keywords like if, for and the following left...
...text" \ "x's docstring" The trailing slash would cause the Python compiler to concatenate the attribute value and the docstring. A modern syntax highlighting editor would easily make this accident visible, though, and by simply inserting empty lines between the attribute definition and the docstring you can avoid the possible concatenation completely, so the problem is negligible. Another possible problem is that of using triple quoted strings as a way to uncomment parts of your code. I...
...text with fewer structural restrictions (docstrings or comments), the line length should be limited to 72 characters. Limiting the required editor window width makes it possible to have several files open side by side, and works well when using code review tools that present the two versions in adjacent columns. The default wrapping in most tools disrupts the visual structure of the code, making it more difficult to understand. The limits are chosen to avoid wrapping in editors with the window w...