tweepy-self 0.1.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

tweepy_self-1.0.0.dist-info/METADATA

@@ -0,0 +1,216 @@
+Metadata-Version: 2.1
+Name: tweepy-self
+Version: 1.0.0
+Summary: Twitter (selfbot) for Python!
+Author: Alen
+Author-email: alen.kimov@gmail.com
+Requires-Python: >=3.11,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: beautifulsoup4 (>=4,<5)
+Requires-Dist: better-proxy (==0.5.0)
+Requires-Dist: curl_cffi (==0.6.0b9)
+Requires-Dist: lxml (>=5,<6)
+Requires-Dist: pydantic (>=2,<3)
+Requires-Dist: pyotp (>=2,<3)
+Requires-Dist: python3-capsolver (>=0.9,<0.10)
+Requires-Dist: yarl (>=1,<2)
+Description-Content-Type: text/markdown
+
+# Tweepy-self
+[![Telegram channel](https://img.shields.io/endpoint?url=https://runkit.io/damiankrawczyk/telegram-badge/branches/master?url=https://t.me/cum_insider)](https://t.me/cum_insider)
+[![PyPI version info](https://img.shields.io/pypi/v/tweepy-self.svg)](https://pypi.python.org/pypi/tweepy-self)
+[![PyPI supported Python versions](https://img.shields.io/pypi/pyversions/tweepy-self.svg)](https://pypi.python.org/pypi/tweepy-self)
+
+A modern, easy to use, feature-rich, and async ready API wrapper for Twitter's user API written in Python.
+
+- Docs (soon)
+
+More libraries of the family:
+- [better-web3](https://github.com/alenkimov/better_web3)
+- [better-proxy](https://github.com/alenkimov/better_proxy)
+- [better-automation](https://github.com/alenkimov/better_automation)
+
+Отдельное спасибо [Кузнице Ботов](https://t.me/bots_forge) за код для авторизации и разморозки! Подписывайтесь на их Telegram :)
+
+## Key Features
+- Modern Pythonic API using async and await.
+- Prevents user account automation detection.
+
+## Installing
+```bash
+pip install tweepy-self
+```
+
+## Example
+```python
+import asyncio
+import twitter
+
+account = twitter.Account(auth_token="auth_token")
+
+async def main():
+    async with twitter.Client(account) as twitter_client:
+        await twitter_client.tweet("Hello, tweepy-self! <3")
+
+asyncio.run(main())
+```
+
+## More
+Automating user accounts is against the Twitter ToS. This library is a proof of concept and I cannot recommend using it. Do so at your own risk
+
+## Документация (устаревшая)
+`Код ушел немного дальше, чем эта документация.`
+
+Библиотека позволяет работать с неофициальным API Twitter, а именно:
+- Логин
+- Анлок
+- Привязывать сервисы (приложения).
+- Устанавливать статус аккаунта (бан, лок).
+- Загружать изображения на сервер и изменять баннер и аватарку.
+- Изменять данные о пользователе: имя, описание профиля и другое.
+- Изменять имя пользователя и пароль.
+- Запрашивать информацию о подписчиках.
+- Запрашивать некоторую информацию о пользователе (количество подписчиков и другое).
+- Голосовать.
+- Подписываться и отписываться.
+- Лайкать и дизлайкать.
+- Твиттить, ретвиттить с изображением и без.
+- Закреплять твиты.
+- Запрашивать твиты пользователей.
+- Удалять твиты.
+- И другое.
+
+#### Статус аккаунта
+После любого взаимодействия с Twitter устанавливается статус аккаунта:
+- `BAD_TOKEN` - Неверный токен.
+- `UNKNOWN` - Статус аккаунта не установлен.
+- `SUSPENDED` - Действие учетной записи приостановлено (бан).
+- `LOCKED` - Учетная запись заморожена (лок) (требуется прохождение капчи).
+- `GOOD` - Аккаунт в порядке.
+
+Не каждое взаимодействие с Twitter достоверно определяет статус аккаунта.
+Например, простой запрос данных об аккаунте честно вернет данные, даже если ваш аккаунт заморожен.
+
+Для достоверной установки статуса аккаунта используйте метод `establish_status()`
+
+### Примеры работы
+Запрос информации о пользователе:
+```python
+# Запрос информации о текущем пользователе:
+me = await twitter_client.request_user_data()
+print(f"[{account.short_auth_token}] {me}")
+print(f"Аккаунт создан: {me.created_at}")
+print(f"Following (подписан ты): {me.followings_count}")
+print(f"Followers (подписаны на тебя): {me.followers_count}")
+print(f"Прочая информация: {me.raw_data}")
+
+# Запрос информации об ином пользователе:
+elonmusk = await twitter.request_user_data("@elonmusk")
+print(elonmusk)
+```
+
+Смена имени пользователя и пароля:
+```python
+account = twitter.Account("auth_token", password="password")
+...
+await twitter_client.change_username("new_username")
+await twitter_client.request_user_data()
+print(f"New username: {account.data.username}")
+
+await twitter_client.change_password("new_password")
+print(f"New password: {account.password}")
+print(f"New auth_token: {account.auth_token}")
+```
+
+Смена данных профиля:
+```python
+await twitter_client.update_birthdate(day=1, month=12, year=2000)
+await twitter_client.update_profile(  # Locks account!
+    name="New Name",
+    description="New description",
+    location="New York",
+    website="https://github.com/alenkimov/better_automation",
+)
+```
+
+Загрузка изображений и смена аватара и баннера:
+```python
+image = open(f"image.png", "rb").read()
+media_id = await twitter_client.upload_image(image)
+avatar_image_url = await twitter_client.update_profile_avatar(media_id)
+banner_image_url = await twitter_client.update_profile_banner(media_id)
+```
+
+Привязка сервиса (приложения):
+
+```python
+# Изучите запросы сервиса и найдите подобные данные для авторизации (привязки):
+bind_data = {
+    'response_type': 'code',
+    'client_id': 'TjFVQm52ZDFGWEtNT0tKaktaSWU6MTpjaQ',
+    'redirect_uri': 'https://waitlist.lens.xyz/tw/',
+    'scope': 'users.read tweet.read offline.access',
+    'state': 'state',  # Может быть как статичным, так и динамическим.
+    'code_challenge': 'challenge',
+    'code_challenge_method': 'plain'
+}
+
+bind_code = await twitter_client.oauth_2(**bind_data)
+# Передайте код авторизации (привязки) сервису.
+# Сервис также может потребовать state, если он динамический.
+```
+
+Отправка сообщения:
+```python
+bro = await twitter_client.request_user_data("@username")
+await twitter_client.send_message(bro.id, "I love you!")
+```
+
+Запрос входящих сообщений:
+```python
+messages = await twitter_client.request_messages()
+for message in messages:
+    message_data = message["message_data"]
+    recipient_id = message_data["recipient_id"]
+    sender_id = message_data["sender_id"]
+    text = message_data["text"]
+    print(f"[id  {sender_id}] -> [id {recipient_id}]: {text}")
+```
+
+Другие методы:
+```python
+# Выражение любви через твит
+tweet_id = await twitter_client.tweet("I love YOU! !!!!1!1")
+print(f"Любовь выражена! Tweet id: {tweet_id}")
+
+print(f"Tweet is pined: {await twitter_client.pin_tweet(tweet_id)}")
+
+# Лайк
+print(f"Tweet {tweet_id} is liked: {await twitter_client.like(tweet_id)}")
+
+# Репост (ретвит)
+print(f"Tweet {tweet_id} is retweeted. Tweet id: {await twitter_client.repost(tweet_id)}")
+
+# Коммент (реплай)
+print(f"Tweet {tweet_id} is replied. Reply id: {await twitter_client.reply(tweet_id, 'tem razão')}")
+
+# Подписываемся на Илона Маска
+print(f"@{elonmusk.username} is followed: {await twitter_client.follow(elonmusk.id)}")
+
+# Отписываемся от Илона Маска
+print(f"@{elonmusk.username} is unfollowed: {await twitter_client.unfollow(elonmusk.id)}")
+
+tweet_url = 'https://twitter.com/CreamIce_Cone/status/1691735090529976489'
+# Цитата (Quote tweet)
+quote_tweet_id = await twitter_client.quote(tweet_url, 'oh....')
+print(f"Quoted! Tweet id: {quote_tweet_id}")
+
+# Запрашиваем первых трех подписчиков
+# (Параметр count по каким-то причинам работает некорректно)
+followers = await twitter_client.request_followers(count=20)
+print("Твои подписчики:")
+for follower in followers:
+    print(follower)
+```

tweepy_self-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+twitter/__init__.py,sha256=9KthivNBM-ooKWzAMCBOtC7HuwHLGyhrLeFvDf50vxg,581
+twitter/account.py,sha256=Vb9MCRxIQRODnefchXg3m0BGzQ1mEJnaL3xbv29zGTw,3294
+twitter/base/__init__.py,sha256=x0EHKv4q_FI6xEq2nL4V9s8P6VWr6IaHTqdH9sXB5d8,133
+twitter/base/client.py,sha256=7byb0Psai-dvg_ww6Y7uyE2hV1pfTU653hFgVdRiqXo,478
+twitter/base/session.py,sha256=6-gLhdSCaTCd_zv3YgUtVRGbfiAawXuDRBoo7s5bGSs,2234
+twitter/client.py,sha256=bIwoNFTcznAzth76Xcio8eXoe7seMQyEQpJ3fnMJqGs,53114
+twitter/errors.py,sha256=U6kGyNp_5tEq-RwxLjm61muJLEp5BYBq9vrPBkCxr_g,4088
+twitter/models.py,sha256=3-Lft160msCqOjRPubOmxMqWUkmjlTSzHSGsvZK91nU,1817
+twitter/utils/__init__.py,sha256=pyhQXwTdp0HFwV_UNF4dTyklLD9RtaefA16SrQXeNlg,589
+twitter/utils/file.py,sha256=-6n8I8KWDlntfciJJsfIeOi0gmqoHRIe1ldIx1ynGUE,1118
+twitter/utils/html.py,sha256=Cs55MxVyZLSKiCEj11ALUrnCW9ADZ4CEDCE0gKESzO0,1627
+twitter/utils/other.py,sha256=4NaGd2CIJVrDiW17shcrDlJRqFkQNbBSTiiH7kNWcww,559
+tweepy_self-1.0.0.dist-info/METADATA,sha256=RMRe1Jgbsd9csQGYeA1mhRd4d-qszaV7d46th6cw4UQ,9139
+tweepy_self-1.0.0.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+tweepy_self-1.0.0.dist-info/RECORD,,

twitter/__init__.py

@@ -0,0 +1,26 @@
+"""
+Twitter API Wrapper
+~~~~~~~~~~~~~~~~~~~
+
+A basic wrapper for the Twitter user API.
+"""
+
+from .client import Client
+from .account import Account, AccountStatus, load_accounts_from_file, extract_accounts_to_file
+from .models import Tweet, UserData
+from . import errors, utils
+
+__all__ = [
+    "Client",
+    "Account",
+    "AccountStatus",
+    "utils",
+    "errors",
+    "load_accounts_from_file",
+    "extract_accounts_to_file",
+]
+
+
+import warnings
+# HACK: Ignore event loop warnings from curl_cffi
+warnings.filterwarnings('ignore', module='curl_cffi')

twitter/account.py

@@ -0,0 +1,98 @@
+from pathlib import Path
+from typing import Sequence, Iterable
+import enum
+
+from pydantic import BaseModel, Field
+import pyotp
+
+from .utils import hidden_value, load_lines, write_lines
+
+
+class AccountStatus(enum.StrEnum):
+    BAD_TOKEN = "BAD_TOKEN"  # (401) 32
+    UNKNOWN   = "UNKNOWN"
+    SUSPENDED = "SUSPENDED"  # (403) 64, (200) 141
+    LOCKED    = "LOCKED"     # (403) 326
+    GOOD      = "GOOD"
+
+    def __str__(self):
+        return self.value
+
+
+class Account(BaseModel):
+    auth_token:  str | None = Field(default=None, pattern=r"^[a-f0-9]{40}$")
+    ct0:         str | None
+    id:          int | None
+    name:        str | None
+    username:    str | None
+    password:    str | None
+    email:       str | None
+    key2fa:      str | None = Field(default=None, pattern=r"^[a-f0-9]{12}$")
+    backup_code: str | None = Field(default=None, pattern=r"^[A-Z0-9]{16}$")
+    status: AccountStatus = AccountStatus.UNKNOWN
+
+    @property
+    def hidden_auth_token(self) -> str | None:
+        return hidden_value(self.auth_token) if self.auth_token else None
+
+    @property
+    def hidden_password(self) -> str | None:
+        return hidden_value(self.password) if self.password else None
+
+    @property
+    def hidden_key2fa(self) -> str | None:
+        return hidden_value(self.key2fa) if self.key2fa else None
+
+    @property
+    def hidden_backup_code(self) -> str | None:
+        return hidden_value(self.backup_code) if self.backup_code else None
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}(auth_token={self.hidden_auth_token}, username={self.username})"
+
+    def __str__(self):
+        return self.hidden_auth_token
+
+    def get_2fa_code(self) -> str | None:
+        if not self.key2fa:
+            raise ValueError("No key2fa")
+
+        return str(pyotp.TOTP(self.key2fa).now())
+
+
+def load_accounts_from_file(
+        filepath: Path | str,
+        *,
+        separator: str = ":",
+        fields: Sequence[str] = ("auth_token", "password", "email", "username"),
+) -> list[Account]:
+    """
+    :param filepath: Путь до файла с данными об аккаунтах.
+    :param separator: Разделитель между данными в строке.
+    :param fields: Кортеж, содержащий имена полей в порядке их появления в строке.
+    :return: Список Twitter аккаунтов.
+    """
+    accounts = []
+    for line in load_lines(filepath):
+        data = dict(zip(fields, line.split(separator)))
+        data.update({key: None for key in data if not data[key]})
+        accounts.append(Account(**data))
+    return accounts
+
+
+def extract_accounts_to_file(
+        filepath: Path | str,
+        accounts: Iterable[Account],
+        *,
+        separator: str = ":",
+        fields: Sequence[str] = ("auth_token", "password", "email", "username"),
+):
+    lines = []
+    for account in accounts:
+        account_data = []
+        for field_name in fields:
+            field = getattr(account, field_name)
+            field = field if field is not None else ""
+            account_data.append(field)
+        lines.append(separator.join(account_data))
+    write_lines(filepath, lines)

twitter/base/__init__.py

@@ -0,0 +1,7 @@
+from .client import BaseClient
+from .session import BaseAsyncSession
+
+__all__ = [
+    "BaseClient",
+    "BaseAsyncSession",
+]

twitter/base/client.py

@@ -0,0 +1,20 @@
+from .session import BaseAsyncSession
+
+
+class BaseClient:
+    _DEFAULT_HEADERS = None
+
+    def __init__(self, **session_kwargs):
+        self._session = BaseAsyncSession(
+            headers=session_kwargs.pop("headers", None) or self._DEFAULT_HEADERS,
+            **session_kwargs,
+        )
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *args):
+        self.close()
+
+    def close(self):
+        self._session.close()

twitter/base/session.py

@@ -0,0 +1,56 @@
+from curl_cffi import requests
+from better_proxy import Proxy
+
+
+class BaseAsyncSession(requests.AsyncSession):
+    """
+    Базовая асинхронная сессия:
+        - Принимает прокси в формате URL и better-proxy.
+        - Отключает верификацию SSL сертификатов по умолчанию.
+        - По умолчанию устанавливает версию браузера chrome120.
+        - По умолчанию устанавливает user-agent под версию браузера chrome120.
+    """
+    proxy: Proxy | None
+    DEFAULT_HEADERS = {
+        "accept": "*/*",
+        "accept-language": "en-US,en",
+        "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        "sec-ch-ua": '"Not_A Brand";v="8", "Chromium";v="120", "Google Chrome";v="120"',
+        "sec-ch-ua-platform": '"Windows"',
+        "sec-ch-ua-mobile": "?0",
+        "sec-fetch-dest": "empty",
+        "sec-fetch-mode": "cors",
+        "sec-fetch-site": "same-origin",
+        "connection": "keep-alive",
+    }
+    DEFAULT_IMPERSONATE = requests.BrowserType.chrome120
+
+    def __init__(
+            self,
+            proxy: str | Proxy = None,
+            **session_kwargs,
+    ):
+        self._proxy = None
+        headers = session_kwargs["headers"] = session_kwargs.get("headers") or {}
+        headers.update(self.DEFAULT_HEADERS)
+        session_kwargs["impersonate"] = session_kwargs.get("impersonate") or self.DEFAULT_IMPERSONATE
+        session_kwargs["verify"] = session_kwargs.get("verify", False)
+        super().__init__(**session_kwargs)
+        self.proxy = proxy
+
+    @property
+    def user_agent(self) -> str:
+        return self.headers["user-agent"]
+
+    @property
+    def proxy(self) -> Proxy | None:
+        return self._proxy
+
+    @proxy.setter
+    def proxy(self, proxy: str | Proxy | None):
+        if not proxy:
+            self.proxies = {}
+            return
+
+        self._proxy = Proxy.from_str(proxy) if proxy else None
+        self.proxies = {"http": self._proxy.as_url, "https": self._proxy.as_url}