Skip to content

Updated the file tdjson_example.py #3316

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Updated the file tdjson_example.py #3316

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
113 changes: 52 additions & 61 deletions example/python/tdjson_example.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#!/usr/bin/env python3

# Copyright Aliaksei Levin ([email protected]), Arseny Smirnov ([email protected]),
# Pellegrino Prevete ([email protected]) 2014-2025
#
# Distributed under the Boost Software License, Version 1.0. (See accompanying
# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

Expand All @@ -17,7 +17,8 @@ class TdExample:
"""A Python client for the Telegram API using TDLib."""

def __init__(self, api_id: int = None, api_hash: str = None):
"""Initialize a Telegram client.
"""
Initialize a Telegram client.

Args:
api_id: Telegram API ID (get from https://my.telegram.org)
Expand All @@ -38,7 +39,7 @@ def _load_library(self) -> None:
tdjson_path = os.path.join(os.path.dirname(__file__), "tdjson.dll")
else:
sys.exit(
"Error: Can't find 'tdjson' library. Make sure it's installed correctly."
"Error: Can't find 'tdjson' library. Please ensure it's installed correctly."
)

try:
Expand All @@ -48,27 +49,22 @@ def _load_library(self) -> None:

def _setup_functions(self) -> None:
"""Set up function signatures for TDLib calls."""
# Create client ID
self._td_create_client_id = self.tdjson.td_create_client_id
self._td_create_client_id.restype = c_int
self._td_create_client_id.argtypes = []

# Receive updates
self._td_receive = self.tdjson.td_receive
self._td_receive.restype = c_char_p
self._td_receive.argtypes = [c_double]

# Send requests
self._td_send = self.tdjson.td_send
self._td_send.restype = None
self._td_send.argtypes = [c_int, c_char_p]

# Execute synchronous requests
self._td_execute = self.tdjson.td_execute
self._td_execute.restype = c_char_p
self._td_execute.argtypes = [c_char_p]

# Set log callback
self.log_message_callback_type = CFUNCTYPE(None, c_int, c_char_p)
self._td_set_log_message_callback = self.tdjson.td_set_log_message_callback
self._td_set_log_message_callback.restype = None
Expand All @@ -83,7 +79,6 @@ def _setup_logging(self, verbosity_level: int = 1) -> None:
Args:
verbosity_level: 0-fatal, 1-errors, 2-warnings, 3+-debug
"""

@self.log_message_callback_type
def on_log_message_callback(verbosity_level, message):
if verbosity_level == 0:
Expand Down Expand Up @@ -136,7 +131,7 @@ def login(self) -> None:
"""Start the authentication process."""
self.send({"@type": "getOption", "name": "version"})

print("Starting Telegram authentication flow...")
print("Starting the Telegram authentication process...")
print("Press Ctrl+C to cancel at any time.")

try:
Expand All @@ -152,12 +147,10 @@ def _handle_authentication(self) -> None:
if not event:
continue

# Print all updates for debugging
event_type = event["@type"]
if event_type != "updateAuthorizationState":
print(f"Receive: {json.dumps(event, indent=2)}")
print(f"Received update: {json.dumps(event, indent=2)}")

# Process authorization states
if event_type == "updateAuthorizationState":
auth_state = event["authorization_state"]
auth_type = auth_state["@type"]
Expand All @@ -169,10 +162,10 @@ def _handle_authentication(self) -> None:
elif auth_type == "authorizationStateWaitTdlibParameters":
if not self.api_id or not self.api_hash:
print(
"\nYou MUST obtain your own api_id and api_hash at https://my.telegram.org"
"\nYou must obtain your own API ID and API Hash at https://my.telegram.org"
)
self.api_id = int(input("Please enter your API ID: "))
self.api_hash = input("Please enter your API hash: ")
self.api_hash = input("Please enter your API Hash: ")

print("Setting TDLib parameters...")
self.send(
Expand Down Expand Up @@ -252,53 +245,51 @@ def _handle_authentication(self) -> None:
print("Authorization complete! You are now logged in.")
return

def main(self):
"""Main function to demonstrate client usage."""
# Example API credentials - DO NOT USE THESE
# Get your own from https://my.telegram.org
DEFAULT_API_ID = 94575
DEFAULT_API_HASH = "a3406de8d171bb422bb6ddf3bbd800e2"

print("TDLib Python Client")
print("===================")
print(
"IMPORTANT: You must obtain your own API ID and API Hash at https://my.telegram.org"
)
print("The default values are for demonstration only.\n")

def main():
"""Main function to demonstrate client usage."""
# Example API credentials - DO NOT USE THESE
# Get your own from https://my.telegram.org
DEFAULT_API_ID = 94575
DEFAULT_API_HASH = "a3406de8d171bb422bb6ddf3bbd800e2"

print("TDLib Python Client")
print("===================")
print(
"IMPORTANT: You should obtain your own api_id and api_hash at https://my.telegram.org"
)
print(" The default values are for demonstration only.\n")

use_default = (
input("Use default API credentials for testing? (y/n): ").lower() == "y"
)

if use_default:
client = TdExample(DEFAULT_API_ID, DEFAULT_API_HASH)
else:
client = TdExample()

# Test execute method
print("\nTesting TDLib execute method...")
result = client.execute(
{
"@type": "getTextEntities",
"text": "@telegram /test_command https://telegram.org telegram.me",
}
)
print(f"Text entities: {json.dumps(result, indent=2)}")

# Start login process
client.login()

# Main event loop
print("\nEntering main event loop. Press Ctrl+C to exit.")
try:
while True:
event = client.receive()
if event:
print(json.dumps(event, indent=2))
except KeyboardInterrupt:
print("\nExiting...")
use_default = (
input("Use default API credentials for testing? (y/n): ").lower() == "y"
)

if use_default:
client = TdExample(DEFAULT_API_ID, DEFAULT_API_HASH)
else:
client = TdExample()

# Test execute method
print("\nTesting TDLib execute method...")
result = client.execute(
{
"@type": "getTextEntities",
"text": "@telegram /test_command https://telegram.org telegram.me",
}
)
print(f"Text entities: {json.dumps(result, indent=2)}")

# Start login process
client.login()

# Main event loop
print("\nEntering main event loop. Press Ctrl+C to exit.")
try:
while True:
event = client.receive()
if event:
print(f"Received event: {json.dumps(event, indent=2)}")
except KeyboardInterrupt:
print("\nExiting. Goodbye.")

if __name__ == "__main__":
main()
TdExample().main()