Skip to content

Commit 6903425

Browse files
warsawvstinner
andauthored
Add a this module doc, with an In Memoriam links (#161925)
Add a `this` module doc, with an In Memoriam link for Tim Peters (RIP). Co-authored-by: Victor Stinner <vstinner@python.org>
1 parent 910a92b commit 6903425

1 file changed

Lines changed: 42 additions & 0 deletions

File tree

‎Doc/library/this.rst‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
:orphan:
2+
3+
:mod:`!this` --- The Zen of Python
4+
==================================
5+
6+
.. module:: this
7+
:synopsis: The Zen of Python
8+
9+
..
10+
This easter egg module is deliberately missing from the table of contents.
11+
12+
:pep:`20` -- The Zen of Python, by Tim Peters (RIP).
13+
14+
| Beautiful is better than ugly.
15+
| Explicit is better than implicit.
16+
| Simple is better than complex.
17+
| Complex is better than complicated.
18+
| Flat is better than nested.
19+
| Sparse is better than dense.
20+
| Readability counts.
21+
| Special cases aren't special enough to break the rules.
22+
| Although practicality beats purity.
23+
| Errors should never pass silently.
24+
| Unless explicitly silenced.
25+
| In the face of ambiguity, refuse the temptation to guess.
26+
| There should be one-\- and preferably only one -\-obvious way to do it.
27+
| Although that way may not be obvious at first unless you're Dutch.
28+
| Now is better than never.
29+
| Although never is often better than *right* now.
30+
| If the implementation is hard to explain, it's a bad idea.
31+
| If the implementation is easy to explain, it may be a good idea.
32+
| Namespaces are one honking great idea -\- let's do more of those!
33+
34+
`In Memoriam: Tim Peters 1952-2026 <https://discuss.python.org/t/in-memoriam-tim-peters-1952-2026/110028>`__.
35+
36+
37+
Usage
38+
-----
39+
40+
.. code-block:: shell-session
41+
42+
$ python3 -m this

0 commit comments

Comments
 (0)