Add Python 3.14 support

Co-authored-by: KurimuzonAkuma <[email protected]>

Author: SpEcHiDe

.github/workflows/python.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-22.04, macos-14]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v4

compiler/api/template/type.txt

@@ -2,10 +2,26 @@
 
 {warning}
 
-from typing import Union
+from typing import TYPE_CHECKING, Union
 from pyrogram import raw
+from pyrogram.raw.core import BaseTypeMeta
 
-{name} = Union[{types}]
-{name}.__doc__ = """
-    {docstring}
-"""
+
+if TYPE_CHECKING:
+    {name} = Union[{types}]
+else:
+    # noinspection PyRedeclaration
+    class {name}(metaclass=BaseTypeMeta):  # type: ignore
+        """{docstring}
+        """
+
+        QUALNAME = "pyrogram.raw.base.{qualname}"
+        __union_types__ = Union[{types}]
+
+        def __init__(self):
+            raise TypeError(
+                "Base types can only be used for type checking purposes: "
+                "you tried to use a base type instance as argument, "
+                "but you need to instantiate one of its constructors instead. "
+                "More info: https://telegramplayground.github.io/pyrogram/telegram/base/{doc_name}"
+            )

pyproject.toml

@@ -20,6 +20,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",

pyrogram/raw/core/__init__.py

@@ -28,4 +28,5 @@
 from .primitives.int import Int, Long, Int128, Int256
 from .primitives.string import String
 from .primitives.vector import Vector
+from .base_type_meta import BaseTypeMeta
 from .tl_object import TLObject

pyrogram/raw/core/base_type_meta.py

@@ -0,0 +1,26 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present <https://github.com/KurimuzonAkuma>
+#
+#  This file is part of Kurigram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import get_args
+
+class BaseTypeMeta(type):
+    def __instancecheck__(cls, instance):
+        return isinstance(instance, get_args(cls.__union_types__))
+
+    def __subclasscheck__(cls, subclass):
+        return issubclass(subclass, get_args(cls.__union_types__))