[clang] [libclang/python] Refactor enum usage (PR #95608)

[Vlad Serebrennikov via cfe-commits]

Endilll wrote:

The refactoring itself is worth mentioning in potentially breaking changes, because this covers a significant surface of our Python API.

https://github.com/llvm/llvm-project/pull/95608