From ac84e34d38651489961c96a66f65bfbe3d1bba6d Mon Sep 17 00:00:00 2001 From: Jordan Gillard Date: Tue, 5 Mar 2024 04:57:06 -0500 Subject: [PATCH] Extend --help text to include info for acquiring Telegram API ID/hash (#20) * Fix Poetry mismatch b/w pyproject.toml/poetry.lock * docs: poetry run command to use pyproject script * Update .gitignore * Add show_default kwarg to --output option * Add envvar kwarg to options and move load_dotenv() * Add info on creating/storing api credentials * Bump version --------- Co-authored-by: Galen Reich <54807169+GalenReich@users.noreply.github.com> --- .gitignore | 9 ++++- README.md | 7 ++-- poetry.lock | 6 ++-- pyproject.toml | 2 +- telegram_phone_number_checker/main.py | 50 ++++++++++++++++++++++----- 5 files changed, 58 insertions(+), 16 deletions(-) diff --git a/.gitignore b/.gitignore index 715a7b7..827fe5a 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,11 @@ .env *.session *.json -dist/ \ No newline at end of file +dist/ + +# JetBrains IDEs +.idea/ + +# Byte-compiled / optimized / DLL files +__pycache__/ +**/*.py[cod] diff --git a/README.md b/README.md index 32bbe54..0297b16 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ You can install this tool directly from the [official pypi release](https://pypi pip install telegram-phone-number-checker ``` -You can also install it and run it directly from github as a script. +You can also install it and run it directly from GitHub as a script. ```bash git clone https://github.com/bellingcat/telegram-phone-number-checker cd telegram-phone-number-checker @@ -77,6 +77,9 @@ cd telegram-phone-number-checker This project uses [poetry](https://python-poetry.org/) to manage dependencies. You can install dependencies via poetry, or use the up-to-date [requirements.txt](requirements.txt) file. ```bash +# install poetry if you haven't already +pip install poetry + # with poetry poetry install @@ -87,7 +90,7 @@ pip install -r requirements.txt You can then run it with any of these: ```bash # with poetry -poetry run python3 telegram_phone_number_checker/main.py +poetry run telegram-phone-number-checker # with pip installation python3 telegram_phone_number_checker/main.py diff --git a/poetry.lock b/poetry.lock index 2d3a71e..08fd10d 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 1.6.1 and should not be changed by hand. +# This file is automatically @generated by Poetry 1.8.2 and should not be changed by hand. [[package]] name = "anyio" @@ -162,5 +162,5 @@ files = [ [metadata] lock-version = "2.0" -python-versions = "^3.10" -content-hash = "1cf8b9ab78b1cf2860f38fc9e50e373b857e6d10ed6a397cb4f29cc556e14c95" +python-versions = "^3.9" +content-hash = "926cb8d034d6b5554d1a45ea61091fb4267210f203eefbf4da7604c3c19cbeb0" diff --git a/pyproject.toml b/pyproject.toml index 77a9dad..0bb0b11 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "telegram-phone-number-checker" -version = "1.0.7" +version = "1.0.8" description = "Check if phone numbers are connected to Telegram accounts." authors = ["Bellingcat"] license = "MIT" diff --git a/telegram_phone_number_checker/main.py b/telegram_phone_number_checker/main.py index bad0687..e355b30 100644 --- a/telegram_phone_number_checker/main.py +++ b/telegram_phone_number_checker/main.py @@ -5,6 +5,9 @@ from dotenv import load_dotenv from getpass import getpass import click + +load_dotenv() + def get_names(client: TelegramClient, phone_number: str) -> dict: """ Takes in a phone number and returns the associated user information if the user exists. It does so by first adding the user's phones to the contact list, retrieving the information, and then deleting the user from the contact list. @@ -64,7 +67,7 @@ def validate_users(client: TelegramClient, phone_numbers: str) -> dict: return result -def login(api_id: str, api_hash: str, phone_number: str) -> TelegramClient: +def login(api_id: str | None, api_hash: str | None, phone_number: str | None) -> TelegramClient: """Create a telethon session or reuse existing one""" print('Logging in...', end="", flush=True) API_ID = api_id or os.getenv('API_ID') or input('Enter your API ID: ') @@ -88,17 +91,46 @@ def show_results(output: str, res: dict) -> None: json.dump(res, f, indent=4) print(f"Results saved to {output}") -@click.command() + +@click.command(epilog='Check out the docs at github.com/bellingcat/telegram-phone-number-checker for more information.') @click.option('--phone-numbers', '-p', help='List of phone numbers to check, separated by commas', type=str) -@click.option('--api-id', help='Your API_ID', type=str) -@click.option('--api-hash', help='Your API_HASH', type=str) -@click.option('--api-phone-number', help='Your phone_number', type=str) -@click.option('--output', help='results filename, default to results.json', default="results.json", type=str) +@click.option('--api-id', help='Your Telegram app api_id', type=str, prompt="Enter your Telegram App app_id", envvar='API_ID', show_envvar=True) +@click.option('--api-hash', help='Your Telegram app api_hash', type=str, prompt="Enter your Telegram App api_hash", hide_input=True, envvar='API_HASH', show_envvar=True) +@click.option('--api-phone-number', help='Your phone number', type=str, prompt="Enter the number associated with your Telegram account", envvar='PHONE_NUMBER', show_envvar=True) +@click.option('--output', help='Filename to store results', default="results.json", show_default=True, type=str) def main_entrypoint(phone_numbers: str, api_id: str, api_hash: str, api_phone_number: str, output: str) -> None: - """Check to see if one or more phone numbers belong to a valid Telegram account""" - load_dotenv(".env") + """ + Check to see if one or more phone numbers belong to a valid Telegram account. + + \b + Prerequisites: + 1. A Telegram account with an active phone number + 2. A Telegram App api_id and App api_hash, which you can get by creating + a Telegram App @ https://my.telegram.org/apps + + \b + Note: + If you do not want to enter the API ID, API hash, or phone number associated with + your Telegram account on the command line, you can store these values in a `.env` + file located within the same directory you run this command from. + + \b + // .env file example: + API_ID=12345678 + API_HASH=1234abcd5678efgh1234abcd567 + PHONE_NUMBER=+15555555555 + + See the official Telegram docs at https://core.telegram.org/api/obtaining_api_id for more information on obtaining an API ID. + + \b + Recommendations: + Telegram recommends entering phone numbers in international format + +(country code)(city or carrier code)(your number) + i.e. +491234567891 + + """ client = login(api_id, api_hash, api_phone_number) - res = validate_users(client, phone_numbers) + res = validate_users(client, phone_numbers) show_results(output, res)