Bump to v1.25

README.rst

@@ -75,7 +75,7 @@ useful information.
 .. _asyncio: https://docs.python.org/3/library/asyncio.html
 .. _MTProto: https://core.telegram.org/mtproto
 .. _Telegram: https://telegram.org
-.. _Compatibility and Convenience: https://docs.telethon.dev/en/latest/misc/compatibility-and-convenience.html
+.. _Compatibility and Convenience: https://docs.telethon.dev/en/stable/misc/compatibility-and-convenience.html
 .. _Read The Docs: https://docs.telethon.dev
 
 .. |logo| image:: logo.svg

readthedocs/misc/changelog.rst

@@ -13,6 +13,40 @@ it can take advantage of new goodies!
 
 .. contents:: List of All Versions
 
+Update handling overhaul (v1.25)
+================================
+
++------------------------+
+| Scheme layer used: 144 |
++------------------------+
+
+I had plans to release v2 way earlier, but my motivation drained off, so that
+didn't happen. The reason for another v1 release is that there was a clear
+need to fix some things regarding update handling (which were present in v2).
+I did not want to make this release. But with the release date for v2 still
+being unclear, I find it necessary to release another v1 version. I apologize
+for the delay (I should've done this a lot sooner but didn't because in my
+head I would've pushed through and finished v2, but I underestimated how much
+work that was and I probably experienced burn-out).
+
+I still don't intend to make new additions to the v1 series (beyond updating
+the Telegram layer being used). I still have plans to finish v2 some day.
+But in the meantime, new features, such as reactions, will have to be used
+through raw API.
+
+This update also backports the update overhaul from v2. If you experience
+issues with updates, please report them on the GitHub page for the project.
+However, this new update handling should be more reliable, and ``catch_up``
+should actually work properly.
+
+Breaking Changes
+~~~~~~~~~~~~~~~~
+
+* In order for ``catch_up`` to work (new flag in the ``TelegramClient``
+  constructor), sessions need to impleemnt the new ``get_update_states``.
+  Third-party session storages won't have this implemented by the time
+  this version released, so ``catch_up`` may not work with those.
+
 Rushed release to fix login (v1.24)
 ===================================
 

telethon/client/users.py

@@ -465,7 +465,7 @@ class UserMethods:
 
         raise ValueError(
             'Could not find the input entity for {} ({}). Please read https://'
-            'docs.telethon.dev/en/latest/concepts/entities.html to'
+            'docs.telethon.dev/en/stable/concepts/entities.html to'
             ' find out more details.'
             .format(peer, type(peer).__name__)
         )

telethon/version.py

@@ -1,3 +1,3 @@
 # Versions should comply with PEP440.
 # This line is parsed in setup.py:
-__version__ = '1.24.0'
+__version__ = '1.25.0'

telethon_examples/README.md

@@ -164,4 +164,4 @@ It makes use of the ["raw API"](https://tl.telethon.dev) (that is, no friendly `
 [`asyncio`]: https://docs.python.org/3/library/asyncio.html
 [`tkinter`]: https://docs.python.org/3/library/tkinter.html
 [tkinter GUI]: https://raw.githubusercontent.com/LonamiWebs/Telethon/master/telethon_examples/screenshot-gui.jpg
-[`events.NewMessage`]: https://docs.telethon.dev/en/latest/modules/events.html#telethon.events.newmessage.NewMessage
+[`events.NewMessage`]: https://docs.telethon.dev/en/stable/modules/events.html#telethon.events.newmessage.NewMessage

telethon_generator/data/errors.csv

@@ -162,6 +162,7 @@ GROUPCALL_NOT_MODIFIED,400,
 GROUPED_MEDIA_INVALID,400,Invalid grouped media
 GROUP_CALL_INVALID,400,Group call invalid
 HASH_INVALID,400,The provided hash is invalid
+HIDE_REQUESTER_MISSING,400,
 HISTORY_GET_FAILED,500,Fetching of history failed
 IMAGE_PROCESS_FAILED,400,Failure while processing image
 IMPORT_FILE_INVALID,400,The file is too large to be imported
@@ -213,7 +214,7 @@ MESSAGE_IDS_EMPTY,400,No message ids were provided
 MESSAGE_ID_INVALID,400,"The specified message ID is invalid or you can't do that operation on such message"
 MESSAGE_NOT_MODIFIED,400,Content of the message was not modified
 MESSAGE_POLL_CLOSED,400,The poll was closed and can no longer be voted on
-MESSAGE_TOO_LONG,400,Message was too long. Current maximum length is 4096 UTF-8 characters
+MESSAGE_TOO_LONG,400,Message was too long
 METHOD_INVALID,400,The API method is invalid and cannot be used
 MSGID_DECREASE_RETRY,500,The request should be retried with a lower message ID
 MSG_ID_INVALID,400,The message ID used in the peer was invalid

telethon_generator/data/html/core.html

@@ -54,7 +54,7 @@ users.getUsers#0d91a548 id:Vector&lt;InputUser&gt; = Vector&lt;User&gt;</pre>
     <p>This is <b>not</b> Python code. It's the "TL definition". It's
     an easy-to-read line that gives a quick overview on the parameters
     and its result. You don't need to worry about this. See
-    <a href="https://docs.telethon.dev/en/latest/developing/understanding-the-type-language.html">Understanding
+    <a href="https://docs.telethon.dev/en/stable/developing/understanding-the-type-language.html">Understanding
     the Type Language</a> for more details on it.</p>
 
     <h3>Index</h3>
@@ -170,7 +170,7 @@ users.getUsers#0d91a548 id:Vector&lt;InputUser&gt; = Vector&lt;User&gt;</pre>
     not always run. They are just there to show the right syntax.</p>
 
     <p>You should check out
-    <a href="https://docs.telethon.dev/en/latest/concepts/full-api.html">how
+    <a href="https://docs.telethon.dev/en/stable/concepts/full-api.html">how
     to access the full API</a> in ReadTheDocs.
     </p>
 </div>

telethon_generator/data/methods.csv

@@ -249,6 +249,7 @@ messages.getSuggestedDialogFilters,user,
 messages.getUnreadMentions,user,PEER_ID_INVALID
 messages.getWebPage,user,WC_CONVERT_URL_INVALID
 messages.getWebPagePreview,user,ENTITY_BOUNDS_INVALID
+messages.hideAllChatJoinRequests,user,HIDE_REQUESTER_MISSING
 messages.hidePeerSettingsBar,user,
 messages.importChatInvite,user,CHANNELS_TOO_MUCH INVITE_HASH_EMPTY INVITE_HASH_EXPIRED INVITE_HASH_INVALID SESSION_PASSWORD_NEEDED USERS_TOO_MUCH USER_ALREADY_PARTICIPANT
 messages.initHistoryImport,user,IMPORT_FILE_INVALID IMPORT_FORMAT_UNRECOGNIZED PREVIOUS_CHAT_IMPORT_ACTIVE_WAIT_XMIN TIMEOUT

telethon_generator/generators/docs.py

@@ -381,7 +381,7 @@ def _write_html_pages(tlobjects, methods, layer, input_res):
                     ns, friendly = tlobject.friendly
                     docs.write_text(
                         'Please refer to the documentation of <a href="'
-                        'https://docs.telethon.dev/en/latest/modules/client.html'
+                        'https://docs.telethon.dev/en/stable/modules/client.html'
                         '#telethon.client.{0}.{1}"><code>client.{1}()</code></a> '
                         'to learn about the parameters and see several code '
                         'examples on how to use it.'