python-telegram-bot · Bibo-Joshi · May 11, 2024 · May 9, 2024 · May 9, 2024 · May 9, 2024
diff --git a/docs/source/telegram.at-tree.rst b/docs/source/telegram.at-tree.rst
@@ -28,6 +28,16 @@ Available Types
     telegram.callbackquery
     telegram.chat
     telegram.chatadministratorrights
+    telegram.chatbackground
+    telegram.backgroundtype
+    telegram.backgroundtypefill
+    telegram.backgroundtypewallpaper
+    telegram.backgroundtypepattern
+    telegram.backgroundtypechattheme
+    telegram.backgroundfill
+    telegram.backgroundfillsolid
+    telegram.backgroundfillgradient
+    telegram.backgroundfillfreeformgradient
     telegram.chatboost
     telegram.chatboostadded
     telegram.chatboostremoved

diff --git a/docs/source/telegram.backgroundfill.rst b/docs/source/telegram.backgroundfill.rst
@@ -0,0 +1,8 @@
+BackgroundFill
+==============
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundFill
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundfillfreeformgradient.rst b/docs/source/telegram.backgroundfillfreeformgradient.rst
@@ -0,0 +1,8 @@
+BackgroundFillFreeformGradient
+==============================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundFillFreeformGradient
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundfillgradient.rst b/docs/source/telegram.backgroundfillgradient.rst
@@ -0,0 +1,8 @@
+BackgroundFillGradient
+======================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundFillGradient
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundfillsolid.rst b/docs/source/telegram.backgroundfillsolid.rst
@@ -0,0 +1,8 @@
+BackgroundFillSolid
+===================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundFillSolid
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundtype.rst b/docs/source/telegram.backgroundtype.rst
@@ -0,0 +1,8 @@
+BackgroundType
+==============
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundType
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundtypechattheme.rst b/docs/source/telegram.backgroundtypechattheme.rst
@@ -0,0 +1,8 @@
+BackgroundTypeChatTheme
+=======================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundTypeChatTheme
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundtypefill.rst b/docs/source/telegram.backgroundtypefill.rst
@@ -0,0 +1,8 @@
+BackgroundTypeFill
+==================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundTypeFill
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundtypepattern.rst b/docs/source/telegram.backgroundtypepattern.rst
@@ -0,0 +1,8 @@
+BackgroundTypePattern
+=====================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundTypePattern
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.backgroundtypewallpaper.rst b/docs/source/telegram.backgroundtypewallpaper.rst
@@ -0,0 +1,8 @@
+BackgroundTypeWallpaper
+=======================
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.BackgroundTypeWallpaper
+    :members:
+    :show-inheritance:
diff --git a/docs/source/telegram.chatbackground.rst b/docs/source/telegram.chatbackground.rst
@@ -0,0 +1,8 @@
+ChatBackground
+==============
+
+.. versionadded:: NEXT.VERSION
+
+.. autoclass:: telegram.ChatBackground
+    :members:
+    :show-inheritance:
diff --git a/telegram/__init__.py b/telegram/__init__.py
@@ -22,6 +22,15 @@
 __all__ = (
     "Animation",
     "Audio",
+    "BackgroundFill",
+    "BackgroundFillFreeformGradient",
+    "BackgroundFillGradient",
+    "BackgroundFillSolid",
+    "BackgroundType",
+    "BackgroundTypeChatTheme",
+    "BackgroundTypeFill",
+    "BackgroundTypePattern",
+    "BackgroundTypeWallpaper",
     "Birthdate",
     "Bot",
     "BotCommand",
@@ -46,6 +55,7 @@
     "CallbackQuery",
     "Chat",
     "ChatAdministratorRights",
+    "ChatBackground",
     "ChatBoost",
     "ChatBoostAdded",
     "ChatBoostRemoved",
@@ -259,6 +269,18 @@
 from ._callbackquery import CallbackQuery
 from ._chat import Chat
 from ._chatadministratorrights import ChatAdministratorRights
+from ._chatbackground import (
+    BackgroundFill,
+    BackgroundFillFreeformGradient,
+    BackgroundFillGradient,
+    BackgroundFillSolid,
+    BackgroundType,
+    BackgroundTypeChatTheme,
+    BackgroundTypeFill,
+    BackgroundTypePattern,
+    BackgroundTypeWallpaper,
+    ChatBackground,
+)
 from ._chatboost import (
     ChatBoost,
     ChatBoostAdded,

diff --git a/telegram/_bot.py b/telegram/_bot.py
@@ -2720,6 +2720,7 @@ async def edit_message_live_location(
         horizontal_accuracy: Optional[float] = None,
         heading: Optional[int] = None,
         proximity_alert_radius: Optional[int] = None,
+        live_period: Optional[int] = None,
         *,
         location: Optional[Location] = None,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -2758,6 +2759,15 @@ async def edit_message_live_location(
                 if specified.
             reply_markup (:class:`telegram.InlineKeyboardMarkup`, optional): An object for a new
                 inline keyboard.
+            live_period (:obj:`int`, optional): New period in seconds during which the location
+                can be updated, starting from the message send date. If
+                :tg-const:`telegram.constants.LocationLimit.LIVE_PERIOD_FOREVER` is specified,
+                then the location can be updated forever. Otherwise, the new value must not exceed
+                the current live_period by more than a day, and the live location expiration date
+                must remain within the next 90 days. If not specified, then `live_period`
+                remains unchanged
+
+                .. versionadded:: NEXT.VERSION.
 
         Keyword Args:
             location (:class:`telegram.Location`, optional): The location to send.
@@ -2790,6 +2800,7 @@ async def edit_message_live_location(
             "horizontal_accuracy": horizontal_accuracy,
             "heading": heading,
             "proximity_alert_radius": proximity_alert_radius,
+            "live_period": live_period,
         }
 
         return await self._send_message(

diff --git a/telegram/_callbackquery.py b/telegram/_callbackquery.py
@@ -461,6 +461,7 @@ async def edit_message_live_location(
         horizontal_accuracy: Optional[float] = None,
         heading: Optional[int] = None,
         proximity_alert_radius: Optional[int] = None,
+        live_period: Optional[int] = None,
         *,
         location: Optional[Location] = None,
         read_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -509,6 +510,7 @@ async def edit_message_live_location(
                 horizontal_accuracy=horizontal_accuracy,
                 heading=heading,
                 proximity_alert_radius=proximity_alert_radius,
+                live_period=live_period,
                 chat_id=None,
                 message_id=None,
             )
@@ -525,6 +527,7 @@ async def edit_message_live_location(
             horizontal_accuracy=horizontal_accuracy,
             heading=heading,
             proximity_alert_radius=proximity_alert_radius,
+            live_period=live_period,
         )
 
     async def stop_message_live_location(