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.
...editor that will let them make changes and submit a merge request all from the comfort of their browser. Criticism X is not written in Python One feature that the current tooling (Mercurial, Rietveld) has is that the primary language for all of the pieces are written in Python. This PEP focuses more on the best tools for the job and not necessarily on the best tools that happen to be written in Python. Volunteer time is the most precious resource for any open source project and we can best...
...text on a diff up to and including the entire file. Finally they allow commenting inline and on the pull request as a whole and they present that in a nice unified way which will also hide comments which no longer apply. Github also provides a "rendered diff" view which enables easily viewing a diff of rendered markup (such as rst) instead of needing to review the diff of the raw markup. The Pull Request work flow also makes it trivial to enable the ability to pre-test a change before actually m...
...Text files to HTML webpages. We aim to specify a self-contained and maintainable solution for PEP readers, authors, and editors. Motivation As of November 2021, Python Enhancement Proposals (PEPs) are rendered in a multi-system, multi-stage process. A continuous integration (CI) task runs a docutils script to render all PEP files individually. The CI task then uploads a tar archive to a server, where it is retrieved and rendered into the python.org website periodically. This places a constrain...
...text or automate miscellaneous tasks. I went to PyCon 2004, and was shocked by the number of interesting projects that were developed and maintained by lone developers or very small teams. I was particularly impressed by the demos and presentations given by the Twisted team. We briefly considered using J2EE, but felt that rapid development of our initial prototypes would be much faster in Python and Twisted. In the end, we estimate that it would have taken us at least twice as long for a solutio...
...text, StructuredText Early on, variants of Setext (Structure Enhanced Text), including Zope Corp's StructuredText, were proposed for Python docstring formatting. Hereafter these variants will collectively be called "STexts". STexts have the advantage of being easy to read without special knowledge, and relatively easy to write. Although used by some (including in most existing Python auto-documentation tools), until now STexts have failed to become standard because: STexts have been incomplet...
...editor navigation can add whitespace to the end of a line, that invisible change will alter the semantics of the program. Fortunately, the typical result is only a syntax error, rather than a runtime bug: >>> assert val>4, \ "val is too small" SyntaxError: unexpected character after line continuation character This PEP proposes to eliminate this redundant and potentially confusing alternative. Terminal \ within a string A terminal \ within a single-quoted string, at the ...
...editor also warns about this use. Ruby allows return from inside ensure (Python's finally), but it should be an explicit return. It is discouraged and handled by linters [5], [6]. Like Ruby, JavaScript also allows use of return/break/continue within a finally but it is seen as unsafe and it is handled by eslint [7]. C# forbids the use of ending statements like return/goto/break within a finally [8], [9]. Rationale Since the behaviour of return/break/continue within a finally is unclear, the p...
...text editors can have trouble editing files containing binary data). The zipapp module provides functions to handle the shebang line, but does not include a command line interface to that functionality. This is because it is not clear how to provide one without the resulting interface being over-complex and potentially confusing. Changing the shebang line is expected to be an uncommon requirement. Reference Implementation A reference implementation is at http://bugs.python.org/issue23491. ...
...text of the proposal: At the request of some supporters of other languages, I've withdrawn a language comparison chart that contained highly personal and sometimes unfounded opinions of other languages. The table was being used out of context in a way that some found objectionable. (Not all of the table is disputed, but it seems wiser not to engage in direct language comparisons without a lot more documentation.) I've also removed some administrative details from the text and made so...
...editors and hosting providers, which want to be as flexible as possible when it comes to accepting a user's application code, but also have a limit as to how much development resources they can spend to add support for yet another lock file format. A standardized format would allow tools to focus their work on a single target, and make sure that workflow decisions made by developers outside of the lock file format are of no concern to e.g. hosting providers. Other programming language communitie...
...text - specifically, a thank-you letter from the chairman -- outside of that, we are indeed close." S. Holden: "I'll be happy to provide that. Is there any web work required? Can we get help? K. Kaiser: "No, no web work. There's a good possibility it will go on line this week. 5.3 Marketing Material M.A.Lemburg, Marketing Material Project Manager, reported on the progress of this project when he said: "We are making slow progress in getting success stories,...
...text encoding from the C locale system in that case, allowing text handling inconsistencies to arise between CPython and other locale-aware components running in the same process and in subprocesses. This approach aims to make CPython behave less like a locale-aware application, and more like locale-independent language runtimes like those for Go, Node.js (V8), and Rust this PEP proposes to override the legacy C locale with a more recently defined locale that uses UTF-8 as its default text encod...
...editor, fetchmailconf. The design objective of fetchmailconf was clear: to completely hide the control file syntax behind a fashionable, ergonomically correct GUI interface replete with selection buttons, slider bars and fill-out forms. The thought of implementing this in Perl did not thrill me. I had seen GUI code in Perl, and it was a spiky mixture of Perl and Tcl that looked even uglier than my own pure-Perl code. It was at this point I remembered the bit I had set more than six months earlie...
...editor), and the test package, as it only serves to test Python internally and is about as big as the rest of the standard library put together. The methods of omission of these modules differ. For example, Debian patches the file Lib/tkinter/__init__.py to envelop the line import _tkinter in a try-except block and upon encountering an ImportError it simply adds the following to the error message: please install the python3-tk package [1]. Fedora and other distributions simply don't include th...
...editors, packages can be "partial". This means modules not found in the stub package SHOULD be searched for in parts four and five of the module resolution order above, namely inline packages and typeshed. Type checkers should merge the stub package and runtime package or typeshed directories. This can be thought of as the functional equivalent of copying the stub package into the same directory as the corresponding runtime package or typeshed folder and type checking the combined directory stru...
...editor. Guidelines for the formation of the trio The success of this governance model relies on the members of the trio, and the ability of the trio members to collaborate and work well together. The three people need to have similar vision to Python, and each can have different skills that complement one another. With such a team, disagreements and conflict should be rare, but can still happen. We will need to trust the people we select that they are able to resolve this among themselves. Wh...
...text attribute to files using .gitattributes. For files that have to have specific line endings assign eol attribute. For binary files the attribute is, naturally, binary. For example: $ cat .gitattributes *.py text *.txt text *.png binary /readme.txt eol=CRLF To check what attributes git uses for files use git check-attr command. For example: $ git check-attr -a -- \*.py Useful assets GitAlias (repository) is a big collection of aliases. A careful selection of aliases for frequently used ...
...editors and other core developers to act as intermediaries to apply updates suggested by other users. The richer administrative functionality would also make it substantially easier to grant users access to particular repositories for collaboration purposes, without having to grant them general access to the entire installation. This helps lower barriers to entry, as trust can more readily be granted and earned incrementally, rather than being an all-or-nothing decision around granting core deve...
...editors such as PyCharm and Visual Studio already make use of this information. Third-party installers, such as those used by distributions, typically create identical keys for the same purpose. Most tools that use the registry to detect Python installations only inspect the keys used by the official installer. As a result, third-party installations that wish to be discoverable will overwrite these values, often causing users to "lose" their original Python installation. By describing a layout f...
...EDITOR environment variable is set up correctly, release.py will pop up editor windows with the files you need to edit. Review the blurb-generated Misc/NEWS file and edit as necessary. Make sure all changes have been committed. (release.py --bump doesn't check in its changes for you.) Check the years on the copyright notice. If the last release was some time last year, add the current year to the copyright notice in several places: README LICENSE (make sure to change on trunk and the branch...