Unify datetime Imports (python-telegram-bot#4605)

Co-authored-by: Miguel Salomon <[email protected]>
Co-authored-by: Jeamhowards Montiel <[email protected]>
Co-authored-by: Snehashish Biswas <[email protected]>
Co-authored-by: Luis Pérez <[email protected]>
Co-authored-by: henryg311 <[email protected]>
Co-authored-by: AnyaMarcanito <[email protected]>
Co-authored-by: Jeam Montiel <[email protected]>

AUTHORS.rst

@@ -31,6 +31,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `Ambro17 <https://github.com/Ambro17>`_
 - `Andrej Zhilenkov <https://github.com/Andrej730>`_
 - `Anton Tagunov <https://github.com/anton-tagunov>`_
+- `Anya Marcano <https://github.com/AnyaMarcanito>`
 - `Avanatiker <https://github.com/Avanatiker>`_
 - `Balduro <https://github.com/Balduro>`_
 - `Bibo-Joshi <https://github.com/Bibo-Joshi>`_
@@ -58,12 +59,14 @@ The following wonderful people contributed directly or indirectly to this projec
 - `gamgi <https://github.com/gamgi>`_
 - `Gauthamram Ravichandran <https://github.com/GauthamramRavichandran>`_
 - `Harshil <https://github.com/harshil21>`_
+- `Henry Galue <https://github.com/henryg311>`
 - `Hugo Damer <https://github.com/HakimusGIT>`_
 - `ihoru <https://github.com/ihoru>`_
 - `Iulian Onofrei <https://github.com/revolter>`_
 - `Jainam Oswal <https://github.com/jainamoswal>`_
 - `Jasmin Bom <https://github.com/jsmnbom>`_
 - `JASON0916 <https://github.com/JASON0916>`_
+- `Jeamhowards Montiel <https://github.com/Jeam-zx>`
 - `jeffffc <https://github.com/jeffffc>`_
 - `Jelle Besseling <https://github.com/pingiun>`_
 - `jh0ker <https://github.com/jh0ker>`_
@@ -72,6 +75,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `Joscha Götzer <https://github.com/Rostgnom>`_
 - `jossalgon <https://github.com/jossalgon>`_
 - `JRoot3D <https://github.com/JRoot3D>`_
+- `Juan Cuevas <https://github.com/cuevasrja>`
 - `kenjitagawa <https://github.com/kenjitagawa>`_
 - `kennethcheo <https://github.com/kennethcheo>`_
 - `Kirill Vasin <https://github.com/vasinkd>`_
@@ -87,6 +91,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `Michael Dix <https://github.com/Eisberge>`_
 - `Michael Elovskikh <https://github.com/wronglink>`_
 - `Miguel C. R. <https://github.com/MiguelX413>`_
+- `Miguel Salomon <https://github.com/Migueldsc12>`
 - `miles <https://github.com/miles170>`_
 - `Mischa Krüger <https://github.com/Makman2>`_
 - `Mohd Yusuf <https://github.com/mohdyusuf2312>`_

docs/auxil/tg_const_role.py

@@ -15,7 +15,7 @@
 #
 #  You should have received a copy of the GNU Lesser Public License
 #  along with this program.  If not, see [http://www.gnu.org/licenses/].
-import datetime
+import datetime as dtm
 from enum import Enum
 
 from docutils.nodes import Element
@@ -75,7 +75,7 @@ def process_link(
             ):
                 return str(value), target
             if (
-                isinstance(value, datetime.datetime)
+                isinstance(value, dtm.datetime)
                 and value == telegram.constants.ZERO_DATE
                 and target in ("telegram.constants.ZERO_DATE",)
             ):

telegram/_birthdate.py

@@ -17,7 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram Birthday."""
-from datetime import date
+import datetime as dtm
 from typing import Optional
 
 from telegram._telegramobject import TelegramObject
@@ -70,7 +70,7 @@ def __init__(
 
         self._freeze()
 
-    def to_date(self, year: Optional[int] = None) -> date:
+    def to_date(self, year: Optional[int] = None) -> dtm.date:
         """Return the birthdate as a date object.
 
         .. versionchanged:: 21.2
@@ -89,4 +89,4 @@ def to_date(self, year: Optional[int] = None) -> date:
                 "The `year` argument is required if the `year` attribute was not present."
             )
 
-        return date(year or self.year, self.month, self.day)  # type: ignore[arg-type]
+        return dtm.date(year or self.year, self.month, self.day)  # type: ignore[arg-type]

telegram/_bot.py

@@ -22,9 +22,9 @@
 import asyncio
 import contextlib
 import copy
+import datetime as dtm
 import pickle
 from collections.abc import Sequence
-from datetime import datetime, timedelta
 from types import TracebackType
 from typing import (
     TYPE_CHECKING,
@@ -3815,7 +3815,7 @@ async def ban_chat_member(
         self,
         chat_id: Union[str, int],
         user_id: int,
-        until_date: Optional[Union[int, datetime]] = None,
+        until_date: Optional[Union[int, dtm.datetime]] = None,
         revoke_messages: Optional[bool] = None,
         *,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -5451,7 +5451,7 @@ async def restrict_chat_member(
         chat_id: Union[str, int],
         user_id: int,
         permissions: ChatPermissions,
-        until_date: Optional[Union[int, datetime]] = None,
+        until_date: Optional[Union[int, dtm.datetime]] = None,
         use_independent_chat_permissions: Optional[bool] = None,
         *,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -5788,7 +5788,7 @@ async def export_chat_invite_link(
     async def create_chat_invite_link(
         self,
         chat_id: Union[str, int],
-        expire_date: Optional[Union[int, datetime]] = None,
+        expire_date: Optional[Union[int, dtm.datetime]] = None,
         member_limit: Optional[int] = None,
         name: Optional[str] = None,
         creates_join_request: Optional[bool] = None,
@@ -5864,7 +5864,7 @@ async def edit_chat_invite_link(
         self,
         chat_id: Union[str, int],
         invite_link: Union[str, "ChatInviteLink"],
-        expire_date: Optional[Union[int, datetime]] = None,
+        expire_date: Optional[Union[int, dtm.datetime]] = None,
         member_limit: Optional[int] = None,
         name: Optional[str] = None,
         creates_join_request: Optional[bool] = None,
@@ -6233,7 +6233,7 @@ async def set_user_emoji_status(
         self,
         user_id: int,
         emoji_status_custom_emoji_id: Optional[str] = None,
-        emoji_status_expiration_date: Optional[Union[int, datetime]] = None,
+        emoji_status_expiration_date: Optional[Union[int, dtm.datetime]] = None,
         *,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
         write_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -7159,7 +7159,7 @@ async def send_poll(
         explanation: Optional[str] = None,
         explanation_parse_mode: ODVInput[str] = DEFAULT_NONE,
         open_period: Optional[int] = None,
-        close_date: Optional[Union[int, datetime]] = None,
+        close_date: Optional[Union[int, dtm.datetime]] = None,
         explanation_entities: Optional[Sequence["MessageEntity"]] = None,
         protect_content: ODVInput[bool] = DEFAULT_NONE,
         message_thread_id: Optional[int] = None,
@@ -8125,7 +8125,7 @@ async def create_invoice_link(
         send_phone_number_to_provider: Optional[bool] = None,
         send_email_to_provider: Optional[bool] = None,
         is_flexible: Optional[bool] = None,
-        subscription_period: Optional[Union[int, timedelta]] = None,
+        subscription_period: Optional[Union[int, dtm.timedelta]] = None,
         business_connection_id: Optional[str] = None,
         *,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -8248,7 +8248,7 @@ async def create_invoice_link(
             "send_email_to_provider": send_email_to_provider,
             "subscription_period": (
                 subscription_period.total_seconds()
-                if isinstance(subscription_period, timedelta)
+                if isinstance(subscription_period, dtm.timedelta)
                 else subscription_period
             ),
             "business_connection_id": business_connection_id,

telegram/_business.py

@@ -18,9 +18,8 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/]
 """This module contains the Telegram Business related classes."""
-
+import datetime as dtm
 from collections.abc import Sequence
-from datetime import datetime
 from typing import TYPE_CHECKING, Optional
 
 from telegram._chat import Chat
@@ -81,7 +80,7 @@ def __init__(
         id: str,
         user: "User",
         user_chat_id: int,
-        date: datetime,
+        date: dtm.datetime,
         can_reply: bool,
         is_enabled: bool,
         *,
@@ -91,7 +90,7 @@ def __init__(
         self.id: str = id
         self.user: User = user
         self.user_chat_id: int = user_chat_id
-        self.date: datetime = date
+        self.date: dtm.datetime = date
         self.can_reply: bool = can_reply
         self.is_enabled: bool = is_enabled
 

telegram/_chat.py

@@ -18,8 +18,8 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram Chat."""
+import datetime as dtm
 from collections.abc import Sequence
-from datetime import datetime
 from html import escape
 from typing import TYPE_CHECKING, Final, Optional, Union
 
@@ -384,7 +384,7 @@ async def ban_member(
         self,
         user_id: int,
         revoke_messages: Optional[bool] = None,
-        until_date: Optional[Union[int, datetime]] = None,
+        until_date: Optional[Union[int, dtm.datetime]] = None,
         *,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
         write_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -656,7 +656,7 @@ async def restrict_member(
         self,
         user_id: int,
         permissions: ChatPermissions,
-        until_date: Optional[Union[int, datetime]] = None,
+        until_date: Optional[Union[int, dtm.datetime]] = None,
         use_independent_chat_permissions: Optional[bool] = None,
         *,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -2116,7 +2116,7 @@ async def send_poll(
         explanation: Optional[str] = None,
         explanation_parse_mode: ODVInput[str] = DEFAULT_NONE,
         open_period: Optional[int] = None,
-        close_date: Optional[Union[int, datetime]] = None,
+        close_date: Optional[Union[int, dtm.datetime]] = None,
         explanation_entities: Optional[Sequence["MessageEntity"]] = None,
         protect_content: ODVInput[bool] = DEFAULT_NONE,
         message_thread_id: Optional[int] = None,
@@ -2588,7 +2588,7 @@ async def export_invite_link(
 
     async def create_invite_link(
         self,
-        expire_date: Optional[Union[int, datetime]] = None,
+        expire_date: Optional[Union[int, dtm.datetime]] = None,
         member_limit: Optional[int] = None,
         name: Optional[str] = None,
         creates_join_request: Optional[bool] = None,
@@ -2632,7 +2632,7 @@ async def create_invite_link(
     async def edit_invite_link(
         self,
         invite_link: Union[str, "ChatInviteLink"],
-        expire_date: Optional[Union[int, datetime]] = None,
+        expire_date: Optional[Union[int, dtm.datetime]] = None,
         member_limit: Optional[int] = None,
         name: Optional[str] = None,
         creates_join_request: Optional[bool] = None,

telegram/_chatboost.py

@@ -17,9 +17,8 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains the classes that represent Telegram ChatBoosts."""
-
+import datetime as dtm
 from collections.abc import Sequence
-from datetime import datetime
 from typing import TYPE_CHECKING, Final, Optional
 
 from telegram import constants
@@ -274,17 +273,17 @@ class ChatBoost(TelegramObject):
     def __init__(
         self,
         boost_id: str,
-        add_date: datetime,
-        expiration_date: datetime,
+        add_date: dtm.datetime,
+        expiration_date: dtm.datetime,
         source: ChatBoostSource,
         *,
         api_kwargs: Optional[JSONDict] = None,
     ):
         super().__init__(api_kwargs=api_kwargs)
 
         self.boost_id: str = boost_id
-        self.add_date: datetime = add_date
-        self.expiration_date: datetime = expiration_date
+        self.add_date: dtm.datetime = add_date
+        self.expiration_date: dtm.datetime = expiration_date
         self.source: ChatBoostSource = source
 
         self._id_attrs = (self.boost_id, self.add_date, self.expiration_date, self.source)
@@ -386,7 +385,7 @@ def __init__(
         self,
         chat: Chat,
         boost_id: str,
-        remove_date: datetime,
+        remove_date: dtm.datetime,
         source: ChatBoostSource,
         *,
         api_kwargs: Optional[JSONDict] = None,
@@ -395,7 +394,7 @@ def __init__(
 
         self.chat: Chat = chat
         self.boost_id: str = boost_id
-        self.remove_date: datetime = remove_date
+        self.remove_date: dtm.datetime = remove_date
         self.source: ChatBoostSource = source
 
         self._id_attrs = (self.chat, self.boost_id, self.remove_date, self.source)

telegram/_chatfullinfo.py

@@ -18,8 +18,8 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatFullInfo."""
+import datetime as dtm
 from collections.abc import Sequence
-from datetime import datetime
 from typing import TYPE_CHECKING, Optional
 
 from telegram._birthdate import Birthdate
@@ -422,7 +422,7 @@ def __init__(
         profile_accent_color_id: Optional[int] = None,
         profile_background_custom_emoji_id: Optional[str] = None,
         emoji_status_custom_emoji_id: Optional[str] = None,
-        emoji_status_expiration_date: Optional[datetime] = None,
+        emoji_status_expiration_date: Optional[dtm.datetime] = None,
         bio: Optional[str] = None,
         has_private_forwards: Optional[bool] = None,
         has_restricted_voice_and_video_messages: Optional[bool] = None,
@@ -486,7 +486,9 @@ def __init__(
             )
             self.active_usernames: tuple[str, ...] = parse_sequence_arg(active_usernames)
             self.emoji_status_custom_emoji_id: Optional[str] = emoji_status_custom_emoji_id
-            self.emoji_status_expiration_date: Optional[datetime] = emoji_status_expiration_date
+            self.emoji_status_expiration_date: Optional[dtm.datetime] = (
+                emoji_status_expiration_date
+            )
             self.has_aggressive_anti_spam_enabled: Optional[bool] = (
                 has_aggressive_anti_spam_enabled
             )

telegram/_chatinvitelink.py

@@ -17,7 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents an invite link for a chat."""
-import datetime
+import datetime as dtm
 from typing import TYPE_CHECKING, Optional
 
 from telegram._telegramobject import TelegramObject
@@ -139,7 +139,7 @@ def __init__(
         creates_join_request: bool,
         is_primary: bool,
         is_revoked: bool,
-        expire_date: Optional[datetime.datetime] = None,
+        expire_date: Optional[dtm.datetime] = None,
         member_limit: Optional[int] = None,
         name: Optional[str] = None,
         pending_join_request_count: Optional[int] = None,
@@ -157,7 +157,7 @@ def __init__(
         self.is_revoked: bool = is_revoked
 
         # Optionals
-        self.expire_date: Optional[datetime.datetime] = expire_date
+        self.expire_date: Optional[dtm.datetime] = expire_date
         self.member_limit: Optional[int] = member_limit
         self.name: Optional[str] = name
         self.pending_join_request_count: Optional[int] = (

telegram/_chatjoinrequest.py

@@ -17,7 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatJoinRequest."""
-import datetime
+import datetime as dtm
 from typing import TYPE_CHECKING, Optional
 
 from telegram._chat import Chat
@@ -106,7 +106,7 @@ def __init__(
         self,
         chat: Chat,
         from_user: User,
-        date: datetime.datetime,
+        date: dtm.datetime,
         user_chat_id: int,
         bio: Optional[str] = None,
         invite_link: Optional[ChatInviteLink] = None,
@@ -117,7 +117,7 @@ def __init__(
         # Required
         self.chat: Chat = chat
         self.from_user: User = from_user
-        self.date: datetime.datetime = date
+        self.date: dtm.datetime = date
         self.user_chat_id: int = user_chat_id
 
         # Optionals