[PROPOSAL] Correct type hints or stub?

[skokado]

Hi, Thank you for this great project

What/Why

What are you proposing?

Add or improve type hints more and more in this library.

What problems are you trying to solve?

There is something I notice when using this library.

The type hint Any is used everywhere in this project.
For example, it is clear that the Document.search() method returns a Search instance.

opensearch-py/opensearchpy/helpers/document.py

Line 198 in 7336f51

def search(cls, using: Any = None, index: Any = None) -> Any:

What is the user experience going to be?

This makes the library interface clearer and contributes to improved usability.
In particular, it has benefit when using high-level APIs.

What will it take to execute?

All we have to do is write the correct type hints for every function and method.
It does not affect the behavior of this library.

Are you maintainers in favor of improving the type hints? Or do you prefer separate stubs? (Just like django-stubs)

[dblock]

Yes, please, definitely in favor! Much of this code is generated so that's where I'd make most changes.