Adding typings

[kornicameister]

Description

It would be quite useful for this library to support Python with type hints.
An obvious benefit is that users of the library, if using mypy or similar, are able to verify that they are using library in correct way, avoiding situations like:

• typos
• input data mismatch
• output data mismatch

There are 2 ways to do that:

• resolving Dropping support for old Pythons #207 first and baking annotations directly into codebase as a preferable method mentioned here
• getting an 👍 from this library maintainers and pushing stubs into python/typeshed library

Either works for me. I acknowledge that first option requires a lot of thinking and preparation whilst 2nd one is simply easier for auth0-python to keep compatibility with older Python versions for a little longer. I am willing to help with either #207 or this issue (either here or in typeshed)

Prerequisites

• I have checked the README documentation.
• I have checked the Auth0 Community for related posts.
• I have checked for related or duplicate Issues and PRs.
• I have read the Auth0 general contribution guidelines.
• I have read the Auth0 Code of Conduct.
• I am reporting this to the correct repository.

Environment

• auth0-python==3.9.1
• other factors does not seem to be relevant

Reproduction

I believe that an example like so is enough:

class TypingShowsAny:
   def __init__(domain: str, access_token: str) -> None:
      self._client = client = auth0.v3.management.Clients(domain, access_token)
      reveal_type(client) 

reveal_type reports Any whilst it should report auth0.v3.management.Clients

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. If you have not received a response for our team (apologies for the delay) and this is still a blocker, please reply with additional information or just a ping. Thank you for your contribution! 🙇‍♂️

[emosenkis]

Can this be reopened? Type hints would be very nice to have and it's increasingly unusual for an SDK not to either include them or have external stubs in typeshed.

[miketheman]

Echoing the sentiments - and tagging @emosenkis and @Widcket as a couple of folks who have recently merged PRs to this library.

[Widcket]

cc @adamjmcgrath

[adamjmcgrath]

Thanks for your suggestions @miketheman and @emosenkis

Currently we don't have plans to add Type hints, but we're constantly reviewing these decisions and we'll update this issue if anything changes.

[emosenkis]

@adamjmcgrath did you see @kornicameister's offer to add community-contributed type hints to typeshed? Would you be amenable to that?

[adamjmcgrath]

Thanks for raising that @emosenkis

And yep, thanks for your offer to add stubs to typeshed @kornicameister - happy to give it a 👍