From: Andre Delfino <adelfino@gmail.com>
Date: Wed, 21 Oct 2020 05:25:05 +0000 (-0300)
Subject: Doc: Do not encourage using a base class name in a derived class (GH-22177)
X-Git-Tag: v3.10.0a2~125
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4642ccd1c3e460cb2746d3f2095f1c1d1bafa4fe;p=thirdparty%2FPython%2Fcpython.git

Doc: Do not encourage using a base class name in a derived class (GH-22177)
---

diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 2d542cfb1dbb..57ab3e265f79 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -1517,18 +1517,18 @@ order` (MRO) with ``type(self).__mro__``, and return the next in line after
 How can I organize my code to make it easier to change the base class?
 ----------------------------------------------------------------------
 
-You could define an alias for the base class, assign the real base class to it
-before your class definition, and use the alias throughout your class.  Then all
+You could assign the base class to an alias and derive from the alias.  Then all
 you have to change is the value assigned to the alias.  Incidentally, this trick
 is also handy if you want to decide dynamically (e.g. depending on availability
 of resources) which base class to use.  Example::
 
-   BaseAlias = <real base class>
+   class Base:
+       ...
+
+   BaseAlias = Base
 
    class Derived(BaseAlias):
-       def meth(self):
-           BaseAlias.meth(self)
-           ...
+       ...
 
 
 How do I create static class data and static class methods?