Helpers
Various helpers not related to the Telegram API itself
- class telethon.helpers.TotalList(*args, **kwargs)
Bases:
list
A list with an extra
total
property, which may not match itslen
since the total represents the total amount of items available somewhere else, not the items in this list.Examples:
# Telethon returns these lists in some cases (for example, # only when a chunk is returned, but the "total" count # is available). result = await client.get_messages(chat, limit=10) print(result.total) # large number print(len(result)) # 10 print(result[0]) # latest message for x in result: # show the 10 messages print(x.text)
- __repr__()
Return repr(self).
- __str__()
Return str(self).
- __weakref__
list of weak references to the object (if defined)
- telethon.helpers.add_surrogate(text)
- telethon.helpers.del_surrogate(text)
- telethon.helpers.ensure_parent_dir_exists(file_path)
Ensures that the parent directory exists
- telethon.helpers.generate_key_data_from_nonce(server_nonce, new_nonce)
Generates the key data corresponding to the given nonce
- telethon.helpers.generate_random_long(signed=True)
Generates a random long integer (8 bytes), which is optionally signed
- telethon.helpers.get_running_loop()
- telethon.helpers.retry_range(retries, force_retry=True)
Generates an integer sequence starting from 1. If
retries
is not a zero or a positive integer value, the sequence will be infinite, otherwise it will end atretries + 1
.
- telethon.helpers.strip_text(text, entities)
Strips whitespace from the given surrogated text modifying the provided entities, also removing any empty (0-length) entities.
This assumes that the length of entities is greater or equal to 0, and that no entity is out of bounds.