New exception class for multiple errors (#965)

telethon/errors/__init__.py

@@ -8,7 +8,7 @@ from threading import Thread
 
 from .common import (
     ReadCancelledError, TypeNotFoundError, InvalidChecksumError,
-    BrokenAuthKeyError, SecurityError, CdnFileTamperedError
+    BrokenAuthKeyError, SecurityError, CdnFileTamperedError, MultiError
 )
 
 # This imports the base errors too, as they're imported there

telethon/errors/common.py

@@ -1,4 +1,5 @@
 """Errors not related to the Telegram API itself"""
+from ..tl import TLRequest
 
 
 class ReadCancelledError(Exception):
@@ -67,3 +68,29 @@ class CdnFileTamperedError(SecurityError):
         super().__init__(
             'The CDN file has been altered and its download cancelled.'
         )
+
+
+class MultiError(Exception):
+    """Exception container for multiple `TLRequest`'s."""
+
+    def __new__(cls, exceptions, result, requests):
+        if len(result) != len(exceptions) != len(requests):
+            raise ValueError(
+                'Need result, exception and request for each error')
+        for e, req in zip(exceptions, requests):
+            if not isinstance(e, BaseException):
+                raise TypeError(
+                    'Expected and exception object, not %r' % e
+                )
+            if not isinstance(req, TLRequest):
+                raise TypeError(
+                    'Expected TLRequest object, not %r' % req
+                )
+
+        if len(exceptions) == 1:
+            return exceptions[0]
+        self = BaseException.__new__(cls)
+        self.exceptions = list(exceptions)
+        self.results = list(result)
+        self.requests = list(requests)
+        return self