Add type hints to management

[Viicos]

Fixes #470.

This is ready for review, but I might take a second look, probably forgot a few things.

[adamjmcgrath]

lgtm - thanks @Viicos

Just need to fix the build

[Viicos]

@adamjmcgrath done (apart from the failing docs, I don't really know how to fix this), sorry for the delay

[adamjmcgrath]

Thanks @Viicos - will take a look at the docs when I have a moment

[shchotse]

pls, pay attention, here is the wrong return type, the all_organization_members method can also return the dict object if include_totals equals True or Pagination is enabled

{
  "members": [{"user_id": "xxxx", ...}, ...],
  "start": 0,
  "limit": 50,
  "total": n
}

[adamjmcgrath]

@shchotse This PR is merged, would you mind creating a separate issue? Thanks

[Viicos]

@shchotse thanks. As I said:

This is ready for review, but I might take a second look, probably forgot a few things.

I've tried specifying the correct return type where possible, but otherwise made use of Any. The issue is no OpenAPI file is available, so it's hard to be accurate. By the way some people suggested to auto generate the sdk from an OpenAPI spec, but this usually requires some additional work and the OpenAPI needs to be complete

[lilidworkin]

I believe this is the wrong type? I think it should be Dict[str, Any]

[adamjmcgrath]

@lilidworkin This PR is merged, would you mind creating a separate issue? Thanks

[Viicos]

@lilidworkin thanks. See #497 (comment) for more details

[michaeloliverx]

Are there any plans to add some more concrete return types? E.g. using TypedDict

It would be a huge win for DX, currently I am maintaining local definitions and doing this:

from typing import NotRequired, TypedDict


class Role(TypedDict):
    id: str
    name: str
    description: str


class RolesResponse(TypedDict):
    """https://auth0.com/docs/api/management/v2/roles/get-roles"""
    start: int
    limit: int
    total: int
    roles: list[Role]

...

user_roles: RolesResponse = auth0_client.users.list_roles(user_id)