Which classes cannot be subclassed?

by

There seems to be two reasons for a class to be “final” in Python.

1. Violation of Class Invariant

Classes that follow Singleton pattern have an invariant that there’s a limited (pre-determined) number of instances. Any violation of this invariant in a subclass will be inconsistent with the class’ intent, and would not work correctly. Examples:

  • bool: True, False; see Guido’s comments
  • NoneType: None
  • NotImplementedType: NotImplemented
  • ellipsis: Ellipsis

There may be cases other than the Singleton pattern in this category but I’m not aware of any.

2. No Persuasive Use Case

A class implemented in C requires additional work to allow subclassing (at least in CPython). Doing such work without a convincing use case is not very attractive, so volunteers are less likely to come forward. Examples:

Note 1:

I originally thought there were valid use cases, but simply insufficient interest, in subclassing of function and operator.itemgetter. Thanks to @agf for pointing out that the use cases offered here and here are not convincing (see @agf comments to the question).

Note 2:

My concern is that another Python implementation might accidentally allow subclassing a class that’s final in CPython. This may result in non-portable code (a use case may be weak, but someone might still write code that subclasses function if their Python supports it). This can be resolved by marking in Python documentation all built-in and standard library classes that cannot be subclassed, and requiring that all implementations follow CPython behavior in that respect.

Note 3:

The message produced by CPython in all the above cases is:

TypeError: type 'bool' is not an acceptable base type

It is quite cryptic, as numerous questions on this subject show. I’ll submit a suggestion to add a paragraph to the documentation that explains final classes, and maybe even change the error message to:

TypeError: type 'bool' is final (non-extensible)

More Related Contents:

  1. Name class error
  2. Understanding Python super() with __init__() methods [duplicate]
  3. How do I call a parent class’s method from a child class in Python?
  4. How to invoke the super constructor in Python?
  5. Why is the id of a Python class not unique when called quickly?
  6. Saving and loading multiple objects in pickle file?
  7. Why does Python assignment not return a value?
  8. Is it possible to make abstract classes in Python?
  9. List attributes of an object [duplicate]
  10. How can I dynamically create derived classes from a base class
  11. What’s the difference between __builtin__ and __builtins__?
  12. Why do attribute references act like this with Python inheritance? [duplicate]
  13. TypeError: module.__init__() takes at most 2 arguments (3 given)
  14. List all base classes in a hierarchy of given class?
  15. Prevent creating new attributes outside __init__
  16. putting current class as return type annotation [duplicate]
  17. Why is a class __dict__ a mappingproxy?
  18. “__init__” vs “__call__” in python class
  19. Comparable classes in Python 3
  20. Class (Static) variables and methods in Python
  21. Is it possible to make abstract classes?
  22. Using Properties in Python classes cause “maximum recursion depth exceeded” [duplicate]
  23. How do you change the value of one attribute by changing the value of another? (dependent attributes)
  24. TypeError: attack() missing 1 required positional argument: ‘self’
  25. Python: deleting a class attribute in a subclass
  26. Is it possible to do partial inheritance with Python?
  27. Provide __classcell__ example for Python 3.6 metaclass
  28. Accessing attribute from parent class inside child class
  29. What is the difference between super() with arguments and without arguments?
  30. Get the object with the max attribute’s value in a list of objects

Leave a Comment