twitter-openapi-python 0.0.23__tar.gz → 0.0.26__tar.gz

twitter_openapi_python-0.0.26/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: twitter_openapi_python
+Version: 0.0.26
+Summary: Twitter OpenAPI
+Home-page: https://github.com/fa0311/twitter_openapi_python
+Author: fa0311
+Author-email: yuki@yuki0311.com
+License: proprietary or AGPL-3.0-or-later
+Keywords: OpenAPI,OpenAPI-Generator,Twitter OpenAPI
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE.AGPL
+
+# twitter_openapi_python
+
+Twitter scraping with data validation by pydantic.
+
+![1691572735537](https://raw.githubusercontent.com/fa0311/twitter_openapi_python/refs/heads/master/twitter_openapi_python/docs/image/README/1691572735537.png)
+
+## Setup
+
+```shell
+pip install twitter-openapi-python
+```
+
+## Usage
+
+```python
+import json
+import datetime
+
+from pathlib import Path
+from tweepy_authlib import CookieSessionUserHandler
+from twitter_openapi_python import TwitterOpenapiPython
+
+# login by tweepy_authlib
+if Path("cookie.json").exists():
+    with open("cookie.json", "r") as f:
+        cookies_dict = json.load(f)
+        if isinstance(cookies_dict, list):
+            cookies_dict = {k["name"]: k["value"] for k in cookies_dict}
+else:
+    auth_handler = CookieSessionUserHandler(
+        screen_name=input("screen_name: "),
+        password=input("password: "),
+    )
+    cookies_dict = auth_handler.get_cookies().get_dict()
+
+# To extract cookies from Windows (Linux by default)
+# If you use tweepy_authlib, you must be on Windows
+client = TwitterOpenapiPython()
+client.additional_api_headers = {
+    "sec-ch-ua-platform": '"Windows"',
+}
+client.additional_browser_headers = {
+    "sec-ch-ua-platform": '"Windows"',
+}
+
+# get client from cookies
+撫 = client.get_client_from_cookies(cookies=cookies_dict)
+
+# tweet "Hello World!!" with current time
+time = datetime.datetime.now().strftime("%Y-%m-%dT%H:%M:%SZ")
+撫.get_post_api().post_create_tweet(tweet_text=f"Hello World!!{time}")
+
+# get user info
+response = 撫.get_user_api().get_user_by_screen_name("elonmusk")
+```
+
+### Login
+
+```python
+from twitter_openapi_python import TwitterOpenapiPython
+
+# guest client
+撫 = TwitterOpenapiPython().get_guest_client()
+tweet = 撫.get_default_api().get_tweet_result_by_rest_id("1349129669258448897")
+assert tweet.data is not None
+assert tweet.data.tweet.legacy is not None
+print(tweet.data.tweet.legacy.full_text)
+```
+
+### Multiple OS
+
+The Token can only be used on the same OS that issued the Token
+In other words, if the sec-ch-ua-platform does not match, the Token cannot be used.
+This library uses the Linux Chrome header by default.
+To use Token issued by Windows, do the following.
+
+```python
+client = TwitterOpenapiPython()
+client.additional_api_headers = {
+  "sec-ch-ua-platform": '"Windows"',
+};
+```
+
+## License
+
+This project is dual licensed. You can choose one of the following licenses:
+
+- [Custom License](./LICENSE)
+- [GNU Affero General Public License v3.0](./LICENSE.AGPL)

{twitter_openapi_python-0.0.23 → twitter_openapi_python-0.0.26}/README.md

@@ -1,14 +1,17 @@
-
 # twitter_openapi_python
 
 Twitter scraping with data validation by pydantic.
 
 ![1691572735537](docs/image/README/1691572735537.png)
 
+## Setup
+
 ```shell
 pip install twitter-openapi-python
 ```
 
+## Usage
+
 ```python
 import json
 import datetime
@@ -30,8 +33,18 @@ else:
     )
     cookies_dict = auth_handler.get_cookies().get_dict()
 
+# To extract cookies from Windows (Linux by default)
+# If you use tweepy_authlib, you must be on Windows
+client = TwitterOpenapiPython()
+client.additional_api_headers = {
+    "sec-ch-ua-platform": '"Windows"',
+}
+client.additional_browser_headers = {
+    "sec-ch-ua-platform": '"Windows"',
+}
+
 # get client from cookies
-𝕏 = TwitterOpenapiPython().get_client_from_cookies(cookies=cookies_dict)
+𝕏 = client.get_client_from_cookies(cookies=cookies_dict)
 
 # tweet "Hello World!!" with current time
 time = datetime.datetime.now().strftime("%Y-%m-%dT%H:%M:%SZ")
@@ -41,6 +54,8 @@ time = datetime.datetime.now().strftime("%Y-%m-%dT%H:%M:%SZ")
 response = 𝕏.get_user_api().get_user_by_screen_name("elonmusk")
 ```
 
+### Login
+
 ```python
 from twitter_openapi_python import TwitterOpenapiPython
 
@@ -50,4 +65,25 @@ tweet = 𝕏.get_default_api().get_tweet_result_by_rest_id("1349129669258448897"
 assert tweet.data is not None
 assert tweet.data.tweet.legacy is not None
 print(tweet.data.tweet.legacy.full_text)
-``````
+```
+
+### Multiple OS
+
+The Token can only be used on the same OS that issued the Token
+In other words, if the sec-ch-ua-platform does not match, the Token cannot be used.
+This library uses the Linux Chrome header by default.
+To use Token issued by Windows, do the following.
+
+```python
+client = TwitterOpenapiPython()
+client.additional_api_headers = {
+  "sec-ch-ua-platform": '"Windows"',
+};
+```
+
+## License
+
+This project is dual licensed. You can choose one of the following licenses:
+
+- [Custom License](./LICENSE)
+- [GNU Affero General Public License v3.0](./LICENSE.AGPL)

{twitter_openapi_python-0.0.23 → twitter_openapi_python-0.0.26}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "twitter_openapi_python"
-version = "0.0.23"
+version = "0.0.26"
 description = "Twitter OpenAPI"
 authors = ["fa0311 <yuki@yuki0311.com>"]
 license = "proprietary" # or "AGPL-3.0-only"
@@ -14,7 +14,7 @@ include = ["twitter_openapi_python/py.typed"]
 python = "^3.7"
 pydantic = ">=2.6"
 
-twitter-openapi-python-generated = "0.0.20"
+twitter-openapi-python-generated = "0.0.24"
 
 [tool.poetry.dev-dependencies]
 

{twitter_openapi_python-0.0.23 → twitter_openapi_python-0.0.26}/setup.py

@@ -1,14 +1,26 @@
 # coding: utf-8
 
+import re
+
 from setuptools import find_packages, setup
 
 NAME = "twitter_openapi_python"
-VERSION = "0.0.23"
+VERSION = "0.0.26"
 PYTHON_REQUIRES = ">=3.7"
 REQUIRES = [
-    "twitter_openapi_python_generated == 0.0.20",
+    "twitter_openapi_python_generated == 0.0.24",
     "pydantic >= 2.6",
 ]
+GITHUB_RAW_URL = "https://raw.githubusercontent.com/fa0311/twitter_openapi_python/refs/heads/master/twitter_openapi_python/"
+
+
+def image_replace(text: str, url: str):
+    return re.sub(
+        r"!\[(.*?)\]\((.*?)\)",
+        r"![\1](" + url + r"\2)",
+        text,
+    )
+
 
 setup(
     name=NAME,
@@ -23,8 +35,6 @@ setup(
     include_package_data=True,
     license="proprietary or AGPL-3.0-or-later",
     long_description_content_type="text/markdown",
-    long_description="""\
-        Twitter scraping with data validation by pydantic.
-    """,  # noqa: E501
+    long_description=image_replace(open("README.md").read(), GITHUB_RAW_URL),
     package_data={"twitter_openapi_python": ["py.typed"]},
 )

{twitter_openapi_python-0.0.23 → twitter_openapi_python-0.0.26}/twitter_openapi_python/api/post_api.py

@@ -31,6 +31,10 @@ class PostApiUtils:
         self,
         tweet_text: str,
         media_ids: Optional[list[str]] = None,
+        tagged_users: Optional[list[list[str]]] = None,
+        in_reply_to_tweet_id: Optional[str] = None,
+        attachment_url: Optional[str] = None,
+        conversation_control: Optional[str] = None,
     ) -> ResponseType[models.CreateTweetResponse]:
         variables = non_nullable(
             twitter.PostCreateTweetRequestVariables.from_dict(
@@ -43,13 +47,28 @@ class PostApiUtils:
             )
         )
         variables.tweet_text = tweet_text
-        variables.media.media_entities = [
-            twitter.PostCreateTweetRequestVariablesMediaMediaEntitiesInner(
-                media_id=media_id,
-                tagged_users=[],
+        if media_ids:
+            tagged_or = tagged_users or []
+            variables.media.media_entities = [
+                twitter.PostCreateTweetRequestVariablesMediaMediaEntitiesInner(
+                    media_id=media_id,
+                    tagged_users=tagged_or[idx] if len(tagged_or) > idx else [],
+                )
+                for idx, media_id in enumerate(media_ids)
+            ]
+        variables.attachment_url = attachment_url
+        if conversation_control:
+            variables.conversation_control = (
+                twitter.PostCreateTweetRequestVariablesConversationControl(
+                    mode=conversation_control
+                )
+            )
+
+        if in_reply_to_tweet_id:
+            variables.reply = twitter.PostCreateTweetRequestVariablesReply(
+                exclude_reply_user_ids=[],
+                in_reply_to_tweet_id=in_reply_to_tweet_id,
             )
-            for media_id in media_ids or []
-        ]
 
         res = self.api.post_create_tweet_with_http_info(
             path_query_id=self.flag["CreateTweet"]["queryId"],

{twitter_openapi_python-0.0.23 → twitter_openapi_python-0.0.26}/twitter_openapi_python/client.py

@@ -58,43 +58,60 @@ class TwitterOpenapiPythonClient:
 
 
 class TwitterOpenapiPython:
-    hash: str = "a18a24e4fd96967314c452a6ec2fe6e54f112351"
+    hash: str = "4b27150977e1bdd807de8969dc0ddd7918ac9923"
     placeholder_url = "https://raw.githubusercontent.com/fa0311/twitter-openapi/{hash}/src/config/placeholder.json"
-    placeholder: ParamType
-    user_agent: str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36"
+    header = "https://raw.githubusercontent.com/fa0311/latest-user-agent/refs/heads/main/header.json"
     access_token: str = "AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA"
+    twitter_url: str = "https://x.com/home"
+    additional_browser_headers = {}
+    additional_api_headers = {}
+
+    def get_header(self) -> tuple[dict[str, str], dict[str, str]]:
+        http = urllib3.PoolManager()
+        res = http.request("GET", self.header)
+        data = json.loads(res.data)
+        ignore = ["host", "connection"]
 
-    api_key = {
-        "Accept": "*/*",
-        # "AcceptEncoding": "gzip, deflate, br",
-        # "AcceptEncoding": "deflate, br",
-        "AcceptLanguage": "en-US,en;q=0.9",
-        "CacheControl": "no-cache",
-        "Pragma": "no-cache",
-        "SecChUa": '"Chromium";v="116", "Not)A;Brand";v="24", "Google Chrome";v="116"',
-        "SecChUaMobile": "?0",
-        "SecChUaPlatform": '"Windows"',
-        "SecFetchDest": "empty",
-        "SecFetchMode": "cors",
-        "SecFetchSite": "same-origin",
-        "ClientLanguage": "en",
-        "ActiveUser": "yes",
-    }
-
-    browser_headers = {
-        "accept": "text/plain, */*; q=0.01",
-        "accept-encoding": "gzip, deflate, br",
-        "accept-language": "en-US,en;q=0.9",
-        "cache-control": "no-cache",
-        "pragma": "no-cache",
-        "sec-ch-ua": '"Chromium";v="116", "Not)A;Brand";v="24", "Google Chrome";v="116"',
-        "sec-ch-ua-mobile": "?0",
-        "sec-ch-ua-platform": '"Windows"',
-        "sec-fetch-dest": "empty",
-        "sec-fetch-mode": "cors",
-        "sec-fetch-site": "same-site",
-        "user-agent": user_agent,
-    }
+        def getHader(name: str) -> dict[str, str]:
+            return {
+                key: value for key, value in data[name].items() if key not in ignore
+            }
+
+        return (
+            {
+                **getHader("chrome-fetch"),
+                "accept-encoding": "identity",
+                "referer": self.twitter_url,
+                "priority": "u=1, i",
+                "x-twitter-client-language": "en",
+                "x-twitter-active-user": "yes",
+                # 'x-twitter-auth-type': 'xxxx'
+                # 'x-csrf-token': 'xxxx',
+                # 'x-guest-token': 'xxxx',
+                "authorization": f"Bearer {self.access_token}",
+                **self.additional_api_headers,
+            },
+            {
+                **getHader("chrome"),
+                **self.additional_browser_headers,
+            },
+        )
+
+    def remove_prefix(self, text: str) -> str:
+        if text.startswith("x-twitter-"):
+            return text[10:]
+        if text.startswith("x-"):
+            return text[2:]
+        return text
+
+    def kebab_to_upper_camel(self, text: dict[str, Any]) -> dict[str, Any]:
+        res = {}
+        for key, value in text.items():
+            new_key = "".join(
+                [x.capitalize() for x in self.remove_prefix(key).split("-")]
+            )
+            res[new_key] = value
+        return res
 
     def cookie_normalize(self, cookie: list[str]) -> dict[str, str]:
         return {
@@ -117,7 +134,7 @@ class TwitterOpenapiPython:
         self,
         cookies: dict[str, str],
     ) -> TwitterOpenapiPythonClient:
-        api_key = self.api_key.copy()
+        api_key = self.kebab_to_upper_camel(self.get_header()[0])
 
         if cookies.get("ct0"):
             api_key.update({"AuthType": "OAuth2Session"})
@@ -132,27 +149,28 @@ class TwitterOpenapiPython:
             configuration=api_conf,
             cookie=self.cookie_to_str(cookies),
         )
-        api_client.user_agent = self.user_agent
+        api_client.user_agent = api_key["UserAgent"]
         return self.get_twitter_openapi_python_client(api_client)
 
     def get_guest_client(self) -> TwitterOpenapiPythonClient:
         http = urllib3.PoolManager()
         session = {}
 
+        header = self.get_header()
+
         res_1 = http.request(
             "GET",
-            "https://x.com",
+            self.twitter_url,
             redirect=False,
-            headers=self.browser_headers.copy(),
+            headers=header[1],
         )
         cookie = res_1.headers._container["set-cookie"][1:]
         session.update(self.cookie_normalize(cookie))
         res_2 = http.request(
             "GET",
-            "https://x.com",
+            self.twitter_url,
             redirect=False,
-            headers=self.browser_headers.copy()
-            | {"Cookie": self.cookie_to_str(session)},
+            headers=header[1],
         )
 
         find = re.findall(r'document.cookie="(.*?)";', res_2.data.decode())
@@ -161,15 +179,13 @@ class TwitterOpenapiPython:
         session.pop("ct0")
 
         if not session.get("gt"):
-            activate_header = self.browser_headers.copy() | {
-                "authorization": "Bearer {}".format(self.access_token),
-                "x-twitter-active-user": "yes",
-                "x-twitter-client-language": "en",
+            activate_header = header[0] | {
+                "cookie": self.cookie_to_str(session),
             }
             res_3 = http.request(
                 "POST",
                 "https://api.x.com/1.1/guest/activate.json",
-                headers=activate_header | {"Cookie": self.cookie_to_str(session)},
+                headers=activate_header,
             )
             gt = json.loads(res_3.data.decode())["guest_token"]
             session.update({"gt": gt})

twitter_openapi_python-0.0.26/twitter_openapi_python.egg-info/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: twitter-openapi-python
+Version: 0.0.26
+Summary: Twitter OpenAPI
+Home-page: https://github.com/fa0311/twitter_openapi_python
+Author: fa0311
+Author-email: yuki@yuki0311.com
+License: proprietary or AGPL-3.0-or-later
+Keywords: OpenAPI,OpenAPI-Generator,Twitter OpenAPI
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE.AGPL
+
+# twitter_openapi_python
+
+Twitter scraping with data validation by pydantic.
+
+![1691572735537](https://raw.githubusercontent.com/fa0311/twitter_openapi_python/refs/heads/master/twitter_openapi_python/docs/image/README/1691572735537.png)
+
+## Setup
+
+```shell
+pip install twitter-openapi-python
+```
+
+## Usage
+
+```python
+import json
+import datetime
+
+from pathlib import Path
+from tweepy_authlib import CookieSessionUserHandler
+from twitter_openapi_python import TwitterOpenapiPython
+
+# login by tweepy_authlib
+if Path("cookie.json").exists():
+    with open("cookie.json", "r") as f:
+        cookies_dict = json.load(f)
+        if isinstance(cookies_dict, list):
+            cookies_dict = {k["name"]: k["value"] for k in cookies_dict}
+else:
+    auth_handler = CookieSessionUserHandler(
+        screen_name=input("screen_name: "),
+        password=input("password: "),
+    )
+    cookies_dict = auth_handler.get_cookies().get_dict()
+
+# To extract cookies from Windows (Linux by default)
+# If you use tweepy_authlib, you must be on Windows
+client = TwitterOpenapiPython()
+client.additional_api_headers = {
+    "sec-ch-ua-platform": '"Windows"',
+}
+client.additional_browser_headers = {
+    "sec-ch-ua-platform": '"Windows"',
+}
+
+# get client from cookies
+撫 = client.get_client_from_cookies(cookies=cookies_dict)
+
+# tweet "Hello World!!" with current time
+time = datetime.datetime.now().strftime("%Y-%m-%dT%H:%M:%SZ")
+撫.get_post_api().post_create_tweet(tweet_text=f"Hello World!!{time}")
+
+# get user info
+response = 撫.get_user_api().get_user_by_screen_name("elonmusk")
+```
+
+### Login
+
+```python
+from twitter_openapi_python import TwitterOpenapiPython
+
+# guest client
+撫 = TwitterOpenapiPython().get_guest_client()
+tweet = 撫.get_default_api().get_tweet_result_by_rest_id("1349129669258448897")
+assert tweet.data is not None
+assert tweet.data.tweet.legacy is not None
+print(tweet.data.tweet.legacy.full_text)
+```
+
+### Multiple OS
+
+The Token can only be used on the same OS that issued the Token
+In other words, if the sec-ch-ua-platform does not match, the Token cannot be used.
+This library uses the Linux Chrome header by default.
+To use Token issued by Windows, do the following.
+
+```python
+client = TwitterOpenapiPython()
+client.additional_api_headers = {
+  "sec-ch-ua-platform": '"Windows"',
+};
+```
+
+## License
+
+This project is dual licensed. You can choose one of the following licenses:
+
+- [Custom License](./LICENSE)
+- [GNU Affero General Public License v3.0](./LICENSE.AGPL)

twitter_openapi_python-0.0.26/twitter_openapi_python.egg-info/requires.txt

@@ -0,0 +1,2 @@
+twitter_openapi_python_generated==0.0.24
+pydantic>=2.6

twitter_openapi_python-0.0.23/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.1
-Name: twitter_openapi_python
-Version: 0.0.23
-Summary: Twitter OpenAPI
-Home-page: https://github.com/fa0311/twitter_openapi_python
-Author: fa0311
-Author-email: yuki@yuki0311.com
-License: proprietary or AGPL-3.0-or-later
-Keywords: OpenAPI,OpenAPI-Generator,Twitter OpenAPI
-Description-Content-Type: text/markdown
-License-File: LICENSE
-License-File: LICENSE.AGPL
-
-        Twitter scraping with data validation by pydantic.
-    

twitter_openapi_python-0.0.23/twitter_openapi_python.egg-info/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.1
-Name: twitter-openapi-python
-Version: 0.0.23
-Summary: Twitter OpenAPI
-Home-page: https://github.com/fa0311/twitter_openapi_python
-Author: fa0311
-Author-email: yuki@yuki0311.com
-License: proprietary or AGPL-3.0-or-later
-Keywords: OpenAPI,OpenAPI-Generator,Twitter OpenAPI
-Description-Content-Type: text/markdown
-License-File: LICENSE
-License-File: LICENSE.AGPL
-
-        Twitter scraping with data validation by pydantic.
-    

twitter_openapi_python-0.0.23/twitter_openapi_python.egg-info/requires.txt

@@ -1,2 +0,0 @@
-twitter_openapi_python_generated==0.0.20
-pydantic>=2.6