What is the best way to organize a function call in python with type typing?

Question

Python

Hello, I am writing a wrapper over vk api for python. I want to make full type typing for all functions and objects of VK, as well as for VK api methods and their responses.
the question arose about the convenience of such a format. Data typing is certainly good, but it makes the code too cumbersome. For example, a function to call groups with the "filter" parameter will have to be done like this:

vk.groups.get(filter=GroupsFilter.ADMIN)
>>> {'response': {'count': 0, 'items': []}}

because there is a given type GroupsFilter, which has the following structure:

class GroupsFilter(Enum):
  ADMIN = 'admin'
  EDITOR = 'editor'
  MODER = 'moder'
  GROUPS = 'groups'
  PUBLICS = 'publics'
  EVENTS = 'events'
  HAS_ADDRESSES = 'has_addresses'

Although one could simply call:

vk.groups.get(filter='admin')
>>> {'response': {'count': 0, 'items': []}}

The advantage of the first option is that when programming in an IDE, for example in pycharm, prompts will appear as in the photo below, and it will immediately be clear what values ​​the parameter can take and not go into the documentation:
On the other hand, this makes the code cumbersome for When the prompt appears, you need to know that the "filter" parameter accepts the GroupsFilter type.

Do you have any advice on how best to do it?

ps All data types are taken from the official Json-Schema (Github)

Answer 1

You can also use typing.Literal, but you can't count on PyCharm support.