Add parameter type hinting to API reference

[kevinsekuj]

• Added basic built-in type hints to client.py methods
• Modified docstrings of all methods with parameters from the form

            Parameters:
                - result - a previously returned paged result

to

:param result: a previously returned paged result

• Added sphinx-autodoc-typehints package to automatically build documentation based on type annotations in client.py

Example:

[stephanebruckert]

Indeed type hinting is something we will need at some point, however since spotipy 2.x still supports python 2.7, I wonder if type hinting isn't going to break on 2.7? If it is breaking it that's fine, we can still add type hinting in spotipy 3.x, see #652. In that case the PR must be raised against the v3 branch. However please be aware there is already #701 and #695

[kevinsekuj]

I see, thanks for the info. I was aiming more towards adding typing to the API reference documentation, using this package for sphinx, which auto generates the typing in the docs based on the source code.

So when adding type hints to function parameters and setting up the docstrings correctly, the docs build looks something like

I see that #701 uses more thorough types from the typing package, fortunately sphinx-autodoc-typehints should be compatible with those too.

Let me know your thoughts -- I can leave it up as well if it might be useful to someone later on since manually editing all the docstrings is time consuming