tweepy-self 1.0.0b1__py3-none-any.whl → 1.0.0b2__py3-none-any.whl

tweepy_self-1.0.0b2.dist-info/METADATA

@@ -0,0 +1,218 @@
+Metadata-Version: 2.1
+Name: tweepy-self
+Version: 1.0.0b2
+Summary: Twitter (selfbot) for Python!
+Author: Alen
+Author-email: alen.kimov@gmail.com
+Requires-Python: >=3.9,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+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")
+
+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.0b2.dist-info/RECORD

@@ -0,0 +1,16 @@
+twitter/__init__.py,sha256=ydA6wuWhW7-0sYmaJyl5_7wIaekKdaBaN7aO6elywLk,465
+twitter/account.py,sha256=vXPd3ag3lmYbSblAnHJLm6t42SyFNbULpjWkRPiDhT0,1787
+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=v2ebGB3NxmEmStePAddNR5XX7oqBCn0Fm86wf0l7MVI,53004
+twitter/errors.py,sha256=U6kGyNp_5tEq-RwxLjm61muJLEp5BYBq9vrPBkCxr_g,4088
+twitter/models.py,sha256=3-Lft160msCqOjRPubOmxMqWUkmjlTSzHSGsvZK91nU,1817
+twitter/utils/__init__.py,sha256=2sjQEu5jJgUEpGYT_arwNVhaboywCbYLB00eiD0mZCk,743
+twitter/utils/accounts.py,sha256=lp7c4GyScAsY65V52V5Buquj8OZgWFyi-54YloRpOfE,1556
+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.0b2.dist-info/METADATA,sha256=0rOKLx8U1hRVeRKk9T6qnRHu_RAP3sqbOFV5qSajmKA,9230
+tweepy_self-1.0.0b2.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+tweepy_self-1.0.0b2.dist-info/RECORD,,

twitter/__init__.py

@@ -5,9 +5,9 @@ Twitter API Wrapper
 A basic wrapper for the Twitter user API.
 """
 
-from ._twitter_client import Client
-from ._account import Account, AccountStatus
-from ._models import Tweet, UserData
+from .client import Client
+from .account import Account, AccountStatus
+from .models import Tweet, UserData
 from . import errors, utils
 
 __all__ = [

twitter/{_account.py → account.py}

@@ -1,14 +1,10 @@
 import enum
 
+from pydantic import BaseModel, Field
 import pyotp
 
 from .utils import hidden_value
 
-# TODO Валидация
-# AUTH_TOKEN_PATTERN = r"^[a-f0-9]{40}$"
-# BACKUP_CODE_PATTERN = r"^[a-z0-9]{12}$"
-# KEY_2FA_PATTERN = r"^[A-Z0-9]{16}$"
-
 
 class AccountStatus(enum.StrEnum):
     BAD_TOKEN = "BAD_TOKEN"  # (401) 32
@@ -21,38 +17,17 @@ class AccountStatus(enum.StrEnum):
         return self.value
 
 
-class Account:
-    auth_token:  str | None
+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
-    backup_code: str | None
-    status: AccountStatus
-
-    def __init__(
-            self,
-            auth_token:  str = None,
-            *,
-            username:    str = None,
-            password:    str = None,
-            email:       str = None,
-            key2fa:      str = None,
-            backup_code: str = None,
-    ):
-        self.auth_token  = auth_token
-        self.ct0         = None
-        self.id          = None
-        self.name        = None
-        self.username    = username
-        self.password    = password
-        self.email       = email
-        self.key2fa      = key2fa
-        self.backup_code = backup_code
-        self.status      = AccountStatus.UNKNOWN
+    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:

twitter/base/__init__.py

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

twitter/{_client.py → base/client.py}

@@ -1,4 +1,4 @@
-from ._session import BaseAsyncSession
+from .session import BaseAsyncSession
 
 
 class BaseClient:

twitter/{_twitter_client.py → client.py}

@@ -23,10 +23,10 @@ from .errors import (
     Locked,
     Suspended,
 )
-from ._file_utils import to_json
-from ._client import BaseClient
-from ._account import Account, AccountStatus
-from ._models import UserData, Tweet
+from .utils import to_json
+from .base import BaseClient
+from .account import Account, AccountStatus
+from .models import UserData, Tweet
 from .utils import remove_at_sign, parse_oauth_html, parse_unlock_html
 
 

twitter/errors.py

@@ -1,6 +1,6 @@
 from curl_cffi import requests
 
-from ._account import Account
+from .account import Account
 
 __all__ = [
     "TwitterException",

twitter/utils/__init__.py

@@ -0,0 +1,42 @@
+from .file import (
+    copy_file,
+    load_lines,
+    load_json,
+    load_toml,
+    write_lines,
+    write_json,
+    to_json,
+)
+from .accounts import (
+    load_accounts_from_file,
+    extract_accounts_to_file,
+)
+from .html import (
+    parse_unlock_html,
+    parse_oauth_html,
+)
+from .other import (
+    remove_at_sign,
+    tweet_url,
+    to_datetime,
+    hidden_value,
+)
+
+
+__all__ = [
+    "copy_file",
+    "load_lines",
+    "load_json",
+    "load_toml",
+    "write_lines",
+    "write_json",
+    "to_json",
+    "load_accounts_from_file",
+    "extract_accounts_to_file",
+    "parse_unlock_html",
+    "parse_oauth_html",
+    "remove_at_sign",
+    "tweet_url",
+    "to_datetime",
+    "hidden_value",
+]

twitter/utils/accounts.py

@@ -0,0 +1,43 @@
+from pathlib import Path
+from typing import Sequence, Iterable
+
+from .file import load_lines, write_lines
+from ..account import Account
+
+
+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/utils/file.py

@@ -0,0 +1,41 @@
+import json
+import shutil
+import tomllib
+from pathlib import Path
+from typing import Iterable
+
+
+def copy_file(source_path: Path | str, destination_path: Path | str):
+    destination_path = Path(destination_path)
+    if destination_path.exists():
+        return
+    shutil.copy2(str(source_path), str(destination_path))
+
+
+def load_toml(filepath: Path | str) -> dict:
+    with open(filepath, "rb") as file:
+        return tomllib.load(file)
+
+
+def load_lines(filepath: Path | str) -> list[str]:
+    with open(filepath, "r") as file:
+        return [line.strip() for line in file.readlines() if line != "\n"]
+
+
+def write_lines(filepath: Path | str, lines: Iterable[str]):
+    with open(filepath, "w") as file:
+        file.write("\n".join(lines))
+
+
+def load_json(filepath: Path | str) -> dict:
+    with open(filepath, "r") as file:
+        return json.load(file)
+
+
+def write_json(filepath: Path | str, data):
+    with open(filepath, "w") as file:
+        json.dump(data, file, indent=4)
+
+
+def to_json(obj) -> str:
+    return json.dumps(obj, separators=(',', ':'), ensure_ascii=True)

twitter/{utils.py → utils/html.py}

@@ -1,5 +1,3 @@
-from datetime import datetime
-
 from bs4 import BeautifulSoup
 
 
@@ -29,26 +27,3 @@ def parse_unlock_html(html: str) -> tuple[str | None, str | None, bool]:
     verification_string = soup.find('input', id='verification_string')
     needs_unlock = bool(verification_string)
     return authenticity_token, assignment_token, needs_unlock
-
-
-def remove_at_sign(username: str) -> str:
-    if username.startswith("@"):
-        return username[1:]
-    return username
-
-
-def tweet_url(username: str, tweet_id: int) -> str:
-    """
-    :return: Tweet URL
-    """
-    return f"https://x.com/{username}/status/{tweet_id}"
-
-
-def to_datetime(twitter_datetime: str):
-    return datetime.strptime(twitter_datetime, '%a %b %d %H:%M:%S +0000 %Y')
-
-
-def hidden_value(value: str) -> str:
-    start = value[:3]
-    end = value[-3:]
-    return f"{start}**{end}"

twitter/utils/other.py

@@ -0,0 +1,24 @@
+from datetime import datetime
+
+
+def remove_at_sign(username: str) -> str:
+    if username.startswith("@"):
+        return username[1:]
+    return username
+
+
+def tweet_url(username: str, tweet_id: int) -> str:
+    """
+    :return: Tweet URL
+    """
+    return f"https://x.com/{username}/status/{tweet_id}"
+
+
+def to_datetime(twitter_datetime: str):
+    return datetime.strptime(twitter_datetime, '%a %b %d %H:%M:%S +0000 %Y')
+
+
+def hidden_value(value: str) -> str:
+    start = value[:3]
+    end = value[-3:]
+    return f"{start}**{end}"

tweepy_self-1.0.0b1.dist-info/METADATA

@@ -1,63 +0,0 @@
-Metadata-Version: 2.1
-Name: tweepy-self
-Version: 1.0.0b1
-Summary: Twitter (selfbot) for Python!
-Author: Alen
-Author-email: alen.kimov@gmail.com
-Requires-Python: >=3.9,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-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)
-
-Отдельное спасибо [Кузнице Ботов](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")
-
-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
-

tweepy_self-1.0.0b1.dist-info/RECORD

@@ -1,12 +0,0 @@
-twitter/__init__.py,sha256=nC-rEZfRkk8Bp26yWtlzciR7mdOrfcI_KXHcnkW4hyk,476
-twitter/_account.py,sha256=dTNHdYhAJgznrXp6nRRtswuWMR5LjohrtwmPf53SSDU,2382
-twitter/_client.py,sha256=3QUfb5uH-erDt2STx9BELSB6u_5U1p_oyPs6As0tIOo,479
-twitter/_file_utils.py,sha256=ePgsHMlGmegBBMK5ZhCZVeJp58WRQ7kaArPDAgjSu-c,495
-twitter/_models.py,sha256=3-Lft160msCqOjRPubOmxMqWUkmjlTSzHSGsvZK91nU,1817
-twitter/_session.py,sha256=6-gLhdSCaTCd_zv3YgUtVRGbfiAawXuDRBoo7s5bGSs,2234
-twitter/_twitter_client.py,sha256=l0fztx0sk03ojWStDe0oovQpKWqCj-vNZzLK05b_E-Y,53015
-twitter/errors.py,sha256=7BzHnm3iinbkQrW38PqEqpZNwJCk41l57qQ2hhOV59I,4089
-twitter/utils.py,sha256=AlE1Z7Vxgm9i6vWi8rUso9gPobKnZh-ZFiDBT90YNA8,2188
-tweepy_self-1.0.0b1.dist-info/METADATA,sha256=jb6otKQVeG13qg53hbt4iUdVr1VtPi44gpn1p1qQFaI,2192
-tweepy_self-1.0.0b1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-tweepy_self-1.0.0b1.dist-info/RECORD,,

twitter/_file_utils.py

@@ -1,17 +0,0 @@
-import json
-from pathlib import Path
-from typing import Iterable
-
-
-def load_lines(filepath: Path | str) -> list[str]:
-    with open(filepath, "r") as file:
-        return [line.strip() for line in file.readlines() if line != "\n"]
-
-
-def write_lines(filepath: Path | str, lines: Iterable[str]):
-    with open(filepath, "w") as file:
-        file.write("\n".join(lines))
-
-
-def to_json(obj) -> str:
-    return json.dumps(obj, separators=(',', ':'), ensure_ascii=True, default=str)