Source code for pyrogram.methods.utilities.start
# Pyrogram - Telegram MTProto API Client Library for Python
# Copyright (C) 2017-present Dan <https://github.com/delivrance>
#
# This file is part of Pyrogram.
#
# 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 __future__ import annotations
import logging
import pyrogram
from pyrogram import raw
log = logging.getLogger(__name__)
class Start:
async def start(
self: pyrogram.Client,
*,
use_qr: bool = False,
except_ids: list[int] | None = None,
) -> pyrogram.Client:
"""Start the client.
.. include:: /_includes/usable-by/users-bots.rst
This method connects the client to Telegram and, in case of new sessions, automatically manages the
authorization process using an interactive prompt.
Parameters:
use_qr (``bool``, *optional*):
Use QR code authorization instead of the interactive prompt.
For new authorizations only.
Defaults to False.
except_ids (List of ``int``, *optional*):
List of already logged-in user IDs, to prevent logging in twice with the same user.
Returns:
:obj:`~pyrogram.Client`: The started client itself.
Raises:
ConnectionError: In case you try to start an already started client.
Example:
.. code-block:: python
from pyrogram import Client
app = Client("my_account")
async def main():
await app.start()
... # Invoke API methods
await app.stop()
app.run(main())
"""
is_authorized = await self.connect()
try:
if not is_authorized:
if use_qr:
await self.authorize_qr(except_ids=except_ids)
else:
await self.authorize()
if not await self.storage.is_bot() and self.takeout:
self.takeout_id = (await self.invoke(raw.functions.account.InitTakeoutSession())).id
log.info("Takeout session %s initiated", self.takeout_id)
await self.invoke(raw.functions.updates.GetState())
# inside the try: a failure in either used to leave a connected client
# the caller had no way to clean up
self.me = await self.get_me()
await self.initialize()
except (Exception, KeyboardInterrupt):
try:
await self.disconnect()
except Exception:
log.exception("Error disconnecting after a failed start")
raise
else:
return self