Search⌘ K
AI Features

Final Remarks About Descriptors

Explore final recommendations on using descriptors in Python to write clean code. Understand why minimal method implementation is preferred, how object-oriented design principles apply, and when to use type annotations or docstrings to improve code clarity and reuse.

To wrap up our analysis on descriptors, we would like to share some thoughts in terms of clean code and good practices or recommendations from experience.

Descriptor interfaces

When we revisited the interface segregation principle, we said that it's good practice to keep the interfaces small, and for that reason, we might want to separate them into smaller ones.

This idea appears here once again, not in the sense of an interface as in an abstract base class, but as the interface that the descriptor itself will present.

As already mentioned, the descriptor protocol entails four methods, but partial implementation is allowed. That means we ...