You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
the helper methods from utils.helper that are actually there to be used by users and not exclusively by PTB itself (e.g. escape_markdown, mention_user_*) are not available
IMO we should try to make a clear policy for this. IMHO it should be clear that all API-classes are directly available through telgeram. All the things mentioned above are from … lets call them "auxiliary modules". For these I basically see two options:
Make all of that available directly through telegram
Make none of it available through telegram. In this case I'd vote to at least move the above mentioned helper methods directly to telegram.utils and spare the user the .helpers, especially as users are in general not to be concerned with the other contents of utils.
Case 2 would be breaking & in that case we should wait until v14.
In any case I would aim to document the import policy somewhere … probably just at the index of the docs.
I'm slightly in favor of 2. What do the other @python-telegram-bot/developers think?
We're currently not very consistent regarding what we make available directly via
telegram.__init__and what we don't. Some examples:telegram.erroronlyTelegramErroris available viatelegram.__init__, but no of the other classestelegram.constantsonly some few constants are available.TelegramDeprecationWarningis not available (see also Overhaul of warnings #2467)utils.helperthat are actually there to be used by users and not exclusively by PTB itself (e.g.escape_markdown,mention_user_*) are not availableIMO we should try to make a clear policy for this. IMHO it should be clear that all API-classes are directly available through
telgeram. All the things mentioned above are from … lets call them "auxiliary modules". For these I basically see two options:telegramtelegram. In this case I'd vote to at least move the above mentioned helper methods directly totelegram.utilsand spare the user the.helpers, especially as users are in general not to be concerned with the other contents ofutils.Case 2 would be breaking & in that case we should wait until v14.
In any case I would aim to document the import policy somewhere … probably just at the index of the docs.
I'm slightly in favor of 2. What do the other @python-telegram-bot/developers think?