The key issue is that it requires inheritance, but doesn't actually support subclassing very well.

Also it relies on python's type system, which is rather limited.

It's a very large module for what it does, and understanding all the details of how it works in practice is a big challenge.