tweepy-self 1.6.3__py3-none-any.whl → 1.10.0b9__py3-none-any.whl

twitter/errors.py

@@ -61,12 +61,17 @@ class HTTPException(TwitterException):
         self.api_codes: list[int] = []
         self.api_messages: list[str] = []
         self.detail: str | None = None
+        self.html: str | None = None
 
         # Если ответ — строка, то это html
         if isinstance(data, str):
-            exception_message = (
-                f"(response status: {response.status_code}) HTML Response:\n{data}"
-            )
+            if not data:
+                exception_message = (
+                    f"(response status: {response.status_code}) Empty response body."
+                )
+            else:
+                self.html = data
+                exception_message = f"(response status: {response.status_code}) HTML Response:\n{self.html}"
             if response.status_code == 429:
                 exception_message = (
                     f"(response status: {response.status_code}) Rate limit exceeded."
@@ -75,7 +80,7 @@ class HTTPException(TwitterException):
             super().__init__(exception_message)
             return
 
-        self.api_errors = data.get("errors", [])
+        self.api_errors = data.get("errors", [data])
         self.detail = data.get("detail")
 
         for error in self.api_errors:
@@ -146,7 +151,9 @@ class BadAccount(TwitterException):
 
 class BadToken(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
-        exception_message = "Bad Twitter account's auth_token."
+        exception_message = (
+            "Bad Twitter account's auth_token. Relogin to get new token."
+        )
         super().__init__(http_exception, account, exception_message)
 
 
@@ -154,14 +161,14 @@ class Locked(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
         exception_message = (
             f"Twitter account is locked."
-            f" Set CapSolver API key (capsolver_api_key) to autounlock."
+            f" Set CapSolver API key (capsolver_api_key) to auto-unlock."
         )
         super().__init__(http_exception, account, exception_message)
 
 
 class ConsentLocked(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
-        exception_message = f"Twitter account is consent locked. Relogin to unlock."
+        exception_message = f"Twitter account is locked."
         super().__init__(http_exception, account, exception_message)
 
 

twitter/models.py

@@ -1,26 +1,53 @@
-from datetime import datetime
+from typing import Optional, Any
+from datetime import datetime, timedelta
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field, field_validator
 
-from .utils import to_datetime
+from .utils import to_datetime, tweet_url
 
 
-class UserData(BaseModel):
-    id: int
-    username: str
-    name: str
-    created_at: datetime
-    description: str
-    location: str
-    followers_count: int
-    friends_count: int
-    raw_data: dict
+class Image(BaseModel):
+    type: str = Field(..., alias="image_type")
+    width: int = Field(..., alias="w")
+    height: int = Field(..., alias="h")
+
+
+class Media(BaseModel):
+    id: int = Field(..., alias="media_id")
+    image: Image
+    size: int
+    expires_at: datetime = Field(..., alias="expires_after_secs")
+
+    @field_validator("expires_at", mode="before")
+    @classmethod
+    def set_expires_at(cls, v):
+        return datetime.now() + timedelta(seconds=v)
 
     def __str__(self):
-        return f"({self.id}) @{self.username}"
+        return str(self.id)
+
+
+class User(BaseModel):
+    # fmt: off
+    id:              int      | None = None
+    username:        str      | None = None
+    name:            str      | None = None  # 50
+    created_at:      datetime | None = None
+    description:     str      | None = None  # 160
+    location:        str      | None = None  # 30
+    followers_count: int      | None = None
+    friends_count:   int      | None = None
+    raw_data:        dict     | None = None
+    # fmt: on
+
+    def __str__(self):
+        return str(self.id)
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}(id={self.id}, username={self.username})"
 
     @classmethod
-    def from_raw_user_data(cls, data: dict):
+    def from_raw_data(cls, data: dict):
         legacy = data["legacy"]
         keys = ("name", "description", "location", "followers_count", "friends_count")
         values = {key: legacy[key] for key in keys}
@@ -36,44 +63,114 @@ class UserData(BaseModel):
 
 
 class Tweet(BaseModel):
-    user_id: int
-    id: int
-    created_at: datetime
-    full_text: str
-    lang: str
-    favorite_count: int
-    quote_count: int
-    reply_count: int
-    retweet_count: int
-    retweeted: bool
-    raw_data: dict
-    url: str | None = None
+    # fmt: off
+    id:              int
+    text:            str
+    language:        str
+    created_at:      datetime
+
+    conversation_id: int
+
+    quoted:          bool
+    retweeted:       bool
+    bookmarked:      bool
+    favorited:       bool
+
+    quote_count:     int
+    retweet_count:   int
+    bookmark_count:  int
+    favorite_count:  int
+    reply_count:     int
+
+    quoted_tweet:    Optional["Tweet"] = None
+    retweeted_tweet: Optional["Tweet"] = None
+
+    user:            User
+    url:             str
+
+    raw_data:        dict
+
+    # TODO hashtags
+    # TODO media
+    # TODO symbols
+    # TODO timestamps
+    # TODO urls
+    # TODO user_mentions
+    # TODO views
+    # fmt: on
 
     def __str__(self):
-        short_text = (
-            f"{self.full_text[:32]}..." if len(self.full_text) > 16 else self.full_text
-        )
-        return f"({self.id}) {short_text}"
+        return str(self.id)
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}(id={self.id}, user_id={self.user.id})"
+
+    @property
+    def short_text(self) -> str:
+        return f"{self.text[:32]}..." if len(self.text) > 16 else self.text
 
     @classmethod
     def from_raw_data(cls, data: dict):
-        legacy = data["legacy"]
-        keys = (
-            "full_text",
-            "lang",
-            "favorite_count",
-            "quote_count",
-            "reply_count",
-            "retweet_count",
-            "retweeted",
-        )
-        values = {key: legacy[key] for key in keys}
-        values.update(
-            {
-                "user_id": int(legacy["user_id_str"]),
-                "id": int(legacy["id_str"]),
-                "created_at": to_datetime(legacy["created_at"]),
-                "raw_data": data,
-            }
-        )
+        legacy_data = data["legacy"]
+
+        user_data = data["core"]["user_results"]["result"]
+        user = User.from_raw_data(user_data)
+
+        id = int(legacy_data["id_str"])
+        url = tweet_url(user.username, id)
+
+        retweeted_tweet = None
+        if "retweeted_status_result" in legacy_data:
+            retweeted_tweet_data = legacy_data["retweeted_status_result"]["result"]
+            retweeted_tweet = cls.from_raw_data(retweeted_tweet_data)
+
+        quoted_tweet = None
+        if "quoted_status_result" in data:
+            quoted_tweet_data = data["quoted_status_result"]["result"]
+            quoted_tweet = cls.from_raw_data(quoted_tweet_data)
+
+        values = {
+            "id": id,
+            "text": legacy_data["full_text"],
+            "language": legacy_data["lang"],
+            "created_at": to_datetime(legacy_data["created_at"]),
+            "conversation_id": int(legacy_data["conversation_id_str"]),
+            "quoted": legacy_data["is_quote_status"],
+            "retweeted": legacy_data["retweeted"],
+            "bookmarked": legacy_data["bookmarked"],
+            "favorited": legacy_data["favorited"],
+            "quote_count": legacy_data["quote_count"],
+            "retweet_count": legacy_data["retweet_count"],
+            "bookmark_count": legacy_data["bookmark_count"],
+            "favorite_count": legacy_data["favorite_count"],
+            "reply_count": legacy_data["reply_count"],
+            "user": user.model_dump(),
+            "quoted_tweet": quoted_tweet.model_dump() if quoted_tweet else None,
+            "retweeted_tweet": (
+                retweeted_tweet.model_dump() if retweeted_tweet else None
+            ),
+            "url": url,
+            "raw_data": data,
+        }
         return cls(**values)
+
+
+class Subtask(BaseModel):
+    id: str
+    primary_text: Optional[str] = None
+    secondary_text: Optional[str] = None
+    detail_text: Optional[str] = None
+    raw_data: dict
+
+    @classmethod
+    def from_raw_data(cls, data: dict) -> "Subtask":
+        task = {"id": data["subtask_id"]}
+        if enter_text := data.get("enter_text"):
+            if header := enter_text.get("header"):
+                if primary_text := header.get("primary_text"):
+                    task["primary_text"] = primary_text["text"]
+                if secondary_text := header.get("secondary_text"):
+                    task["secondary_text"] = secondary_text["text"]
+                if detail_text := header.get("detail_text"):
+                    task["detail_text"] = detail_text["text"]
+        return cls(**task, raw_data=data)

twitter/utils/__init__.py

@@ -16,6 +16,7 @@ from .other import (
     tweet_url,
     to_datetime,
     hidden_value,
+    tweets_data_from_instructions,
 )
 
 
@@ -33,4 +34,5 @@ __all__ = [
     "tweet_url",
     "to_datetime",
     "hidden_value",
+    "tweets_data_from_instructions",
 ]

twitter/utils/html.py

@@ -21,9 +21,11 @@ def parse_oauth_html(html: str) -> tuple[str | None, str | None, str | None]:
     return authenticity_token, redirect_url, redirect_after_login_url
 
 
-def parse_unlock_html(html: str) -> tuple[str | None, str | None, bool, bool, bool]:
+def parse_unlock_html(
+    html: str,
+) -> tuple[str | None, str | None, bool, bool, bool, bool]:
     """
-    :return: authenticity_token, assignment_token, needs_unlock, start_button, finish_button
+    :return: authenticity_token, assignment_token, needs_unlock, start_button, finish_button, delete_button
     """
     soup = BeautifulSoup(html, "lxml")
     authenticity_token_element = soup.find("input", {"name": "authenticity_token"})
@@ -38,10 +40,12 @@ def parse_unlock_html(html: str) -> tuple[str | None, str | None, bool, bool, bo
     needs_unlock = bool(verification_string)
     start_button = bool(soup.find("input", value="Start"))
     finish_button = bool(soup.find("input", value="Continue to X"))
+    delete_button = bool(soup.find("input", value="Delete"))
     return (
         authenticity_token,
         assignment_token,
         needs_unlock,
         start_button,
         finish_button,
+        delete_button,
     )

twitter/utils/other.py

@@ -14,6 +14,19 @@ def tweet_url(username: str, tweet_id: int) -> str:
     return f"https://x.com/{username}/status/{tweet_id}"
 
 
+def tweets_data_from_instructions(instructions: dict) -> list[dict]:
+    tweets = []
+    for instruction in instructions:
+        if instruction["type"] == "TimelineAddEntries":
+            for entry in instruction["entries"]:
+                if entry["entryId"].startswith("tweet-"):
+                    tweet_data = entry["content"]["itemContent"]["tweet_results"][
+                        "result"
+                    ]
+                    tweets.append(tweet_data)
+    return tweets
+
+
 def to_datetime(twitter_datetime: str):
     return datetime.strptime(twitter_datetime, "%a %b %d %H:%M:%S +0000 %Y")
 

tweepy_self-1.6.3.dist-info/METADATA

@@ -1,218 +0,0 @@
-Metadata-Version: 2.1
-Name: tweepy-self
-Version: 1.6.3
-Summary: Twitter (selfbot) for Python!
-Home-page: https://github.com/alenkimov/tweepy-self
-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 (==1.1.1)
-Requires-Dist: curl_cffi (==0.6.0b9)
-Requires-Dist: lxml (>=5,<6)
-Requires-Dist: pydantic (>=1)
-Requires-Dist: pyotp (>=2,<3)
-Requires-Dist: python3-capsolver (>=0.9,<0.10)
-Requires-Dist: yarl (>=1,<2)
-Project-URL: Repository, https://github.com/alenkimov/tweepy-self
-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)
-[![PyPI downloads per month](https://img.shields.io/pypi/dm/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-proxy](https://github.com/alenkimov/better_proxy)
-- [better-web3](https://github.com/alenkimov/better_web3)
-
-Отдельное спасибо [Кузнице Ботов](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.6.3.dist-info/RECORD

@@ -1,16 +0,0 @@
-twitter/__init__.py,sha256=hdrsdbH_qFhx6ro1ct79qF9SpkgFhxgbYUw9A4RVuec,684
-twitter/account.py,sha256=tHzBdc34pEJI2SRbjLcmKtwAzjhzUFsa4vIQqtXAc1s,3015
-twitter/base/__init__.py,sha256=x0EHKv4q_FI6xEq2nL4V9s8P6VWr6IaHTqdH9sXB5d8,133
-twitter/base/client.py,sha256=7byb0Psai-dvg_ww6Y7uyE2hV1pfTU653hFgVdRiqXo,478
-twitter/base/session.py,sha256=JFPS-9Qae1iY3NfNcywxvWWmRDijaU_Rjs3WaQ00iFA,2071
-twitter/client.py,sha256=TXcIr-HnuqEtYOAiS5fmvY2P7KumlLE0lOAytMq89N8,61346
-twitter/enums.py,sha256=-OH6Ibxarq5qt4E2AhkProVawcEyIf5YG_h_G5xiV9Y,270
-twitter/errors.py,sha256=PsvGP3hps1HNWdKbUPhEkuDqLUmmqzhpAkRtVrJr5jc,5007
-twitter/models.py,sha256=ttSNuhY1knTdI-Yty54OCJF5YzARc8IaA11zKNHV9p0,2063
-twitter/utils/__init__.py,sha256=pyhQXwTdp0HFwV_UNF4dTyklLD9RtaefA16SrQXeNlg,589
-twitter/utils/file.py,sha256=Sz2KEF9DnL04aOP1XabuMYMMF4VR8dJ_KWMEVvQ666Y,1120
-twitter/utils/html.py,sha256=hVtIRFI2yRAdWEaShFNBG-_ZWxd16og8i8OVDnFy5Hc,1971
-twitter/utils/other.py,sha256=UnUxS3uDR4eggbNN16xiw96VC_MNt9tOgnBlNWvRBoY,559
-tweepy_self-1.6.3.dist-info/METADATA,sha256=Nl46Hi1yQY6s47FPLnT0bMjhWTYR7gM18SJsZaDxhJQ,9304
-tweepy_self-1.6.3.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-tweepy_self-1.6.3.dist-info/RECORD,,