tweepy-self 1.9.0__py3-none-any.whl → 1.10.0__py3-none-any.whl

twitter/errors.py

@@ -20,7 +20,6 @@ __all__ = [
 ]
 
 
-# TODO Возвращать аккаунт в теле исключения
 class TwitterException(Exception):
     pass
 
@@ -62,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."
@@ -147,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)
 
 
@@ -155,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,50 +1,40 @@
-from typing import Optional
+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, tweet_url
 
 
 class Image(BaseModel):
-    type: str
-    width: int
-    height: int
+    type: str = Field(..., alias="image_type")
+    width: int = Field(..., alias="w")
+    height: int = Field(..., alias="h")
 
 
 class Media(BaseModel):
-    id: int
+    id: int = Field(..., alias="media_id")
     image: Image
     size: int
-    expires_at: datetime
+    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 str(self.id)
 
-    @classmethod
-    def from_raw_data(cls, data: dict):
-        expires_at = datetime.now() + timedelta(seconds=data["expires_after_secs"])
-        values = {
-            "image": {
-                "type": data["image"]["image_type"],
-                "width": data["image"]["w"],
-                "height": data["image"]["h"],
-            },
-            "size": data["size"],
-            "id": data["media_id"],
-            "expires_at": expires_at,
-        }
-        return cls(**values)
-
 
 class User(BaseModel):
     # fmt: off
     id:              int      | None = None
     username:        str      | None = None
-    name:            str      | None = None
+    name:            str      | None = None  # 50
     created_at:      datetime | None = None
-    description:     str      | None = None
-    location:        str      | 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
@@ -163,3 +153,24 @@ class Tweet(BaseModel):
             "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/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,
     )

tweepy_self-1.9.0.dist-info/METADATA

@@ -1,225 +0,0 @@
-Metadata-Version: 2.1
-Name: tweepy-self
-Version: 1.9.0
-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: aiohttp (>=3.9,<4.0)
-Requires-Dist: beautifulsoup4 (>=4,<5)
-Requires-Dist: better-proxy (>=1.1,<2.0)
-Requires-Dist: curl_cffi (==0.6.0b9)
-Requires-Dist: loguru (>=0.7,<0.8)
-Requires-Dist: lxml (>=5,<6)
-Requires-Dist: pydantic (>=1)
-Requires-Dist: pyotp (>=2,<3)
-Requires-Dist: requests (>=2,<3)
-Requires-Dist: tenacity (>=8,<9)
-Requires-Dist: yarl (>=1,<2)
-Project-URL: Repository, https://github.com/alenkimov/tweepy-self
-Project-URL: Source, 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()
-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("@elonmusk")
-print(elonmusk)
-```
-
-Смена имени пользователя и пароля:
-
-```python
-account = twitter.Account("auth_token", password="password")
-...
-await twitter_client.change_username("new_username")
-await twitter_client.request_user()
-print(f"New username: {account.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("@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)
-```