diff --git a/Doc/library/this.rst b/Doc/library/this.rst new file mode 100644 index 000000000000000..2893d5584addc4b --- /dev/null +++ b/Doc/library/this.rst @@ -0,0 +1,42 @@ +:orphan: + +:mod:`!this` --- The Zen of Python +================================== + +.. module:: this + :synopsis: The Zen of Python + +.. + This easter egg module is deliberately missing from the table of contents. + +:pep:`20` -- The Zen of Python, by Tim Peters (RIP). + + | Beautiful is better than ugly. + | Explicit is better than implicit. + | Simple is better than complex. + | Complex is better than complicated. + | Flat is better than nested. + | Sparse is better than dense. + | Readability counts. + | Special cases aren't special enough to break the rules. + | Although practicality beats purity. + | Errors should never pass silently. + | Unless explicitly silenced. + | In the face of ambiguity, refuse the temptation to guess. + | There should be one-\- and preferably only one -\-obvious way to do it. + | Although that way may not be obvious at first unless you're Dutch. + | Now is better than never. + | Although never is often better than *right* now. + | If the implementation is hard to explain, it's a bad idea. + | If the implementation is easy to explain, it may be a good idea. + | Namespaces are one honking great idea -\- let's do more of those! + +`In Memoriam: Tim Peters 1952-2026 `__. + + +Usage +----- + +.. code-block:: shell-session + + $ python3 -m this