Doc: Do not encourage using a base class name in a derived class (GH-22177)
(cherry picked from commit 4642ccd1c3e460cb2746d3f2095f1c1d1bafa4fe)
Co-authored-by: Andre Delfino <adelfino@gmail.com>
diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 106450f..1d11559 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -1518,18 +1518,18 @@
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?