TornAPIWrapper 2.9.0__tar.gz → 2.10.0__tar.gz

{tornapiwrapper-2.9.0/src/TornAPIWrapper.egg-info → tornapiwrapper-2.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.9.0
+Version: 2.10.0
 Summary: A Python wrapper for the Torn City API, providing access to Torn City data.
 Author: cxdzc
 License: The MIT License (MIT)
@@ -53,7 +53,7 @@ Dynamic: license-file
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/v/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/pyversions/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pepy/dt/tornapiwrapper?color=blue&cacheSeconds=300></a>
-<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-01.06.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-16.07.2026-c4c4c4?cacheSeconds=300></a>
 <a rel="license" href="https://github.com/cxdzc/TornAPIWrapper/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-ab1436"/></a>
 </div>
 

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/README.md

@@ -6,7 +6,7 @@
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/v/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/pyversions/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pepy/dt/tornapiwrapper?color=blue&cacheSeconds=300></a>
-<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-01.06.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-16.07.2026-c4c4c4?cacheSeconds=300></a>
 <a rel="license" href="https://github.com/cxdzc/TornAPIWrapper/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-ab1436"/></a>
 </div>
 

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/src/TornAPIWrapper/__init__.py

@@ -26,8 +26,8 @@ __author__ = "cxdzc"
 __copyright__ = "Copyright 2023-Present cxdzc"
 __license__ = "MIT"
 __title__ = "TornAPIWrapper"
-__version__ = "2.9.0"
-__patch__ = "01.06.2026"
+__version__ = "2.10.0"
+__patch__ = "16.07.2026"
 
 from .errors import (
     WrapperError,

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/src/TornAPIWrapper/client.py

@@ -35,6 +35,8 @@ from .endpoints.racing import Racing
 from .endpoints.torn import Torn
 from .endpoints.user import User
 from .errors import TornAPIErrorHandler
+from .text_response_endpoints import text_response_endpoints
+
 
 class TornAPIWrapper:
     """
@@ -59,16 +61,18 @@ class TornAPIWrapper:
         self.key: Key = Key(self)
         self.torn: Torn = Torn(self)
 
-    def request(self, endpoint: str, params: dict | None) -> dict:
+    def request(self, endpoint: str, params: dict | None) -> dict | str:
         """
-        Sends a request to the Torn API and returns the JSON response.
+        Sends a request to the Torn API and returns either JSON data or raw text.
         :param endpoint: Torn API endpoint path.
         :param params: Query parameters to include in the request.
         :return: API response data.
-        :rtype: dict
+        :rtype: dict | str
         """
         api_request = self.session.get(url=f"{self.BASE_URL}{endpoint}", params=params, timeout=self.request_timeout)
         api_request.raise_for_status()
+        if endpoint in text_response_endpoints:
+            return api_request.text
         api_request_json = api_request.json()
         api_request_error = api_request_json.get("error")
         if api_request_error:

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/src/TornAPIWrapper/client_async.py

@@ -35,6 +35,8 @@ from .endpoints_async.racing import Racing
 from .endpoints_async.torn import Torn
 from .endpoints_async.user import User
 from .errors import TornAPIErrorHandler
+from .text_response_endpoints import text_response_endpoints
+
 
 class TornAPIWrapperAsync:
     """
@@ -65,16 +67,18 @@ class TornAPIWrapperAsync:
         self.key: Key = Key(self)
         self.torn: Torn = Torn(self)
 
-    async def request(self, endpoint: str, params: dict | None) -> dict:
+    async def request(self, endpoint: str, params: dict | None) -> dict | str:
         """
-        Sends a request to the Torn API and returns the JSON response.
+        Sends a request to the Torn API and returns either JSON data or raw text.
         :param endpoint: Torn API endpoint path.
         :param params: Query parameters to include in the request.
         :return: API response data.
-        :rtype: dict
+        :rtype: dict | str
         """
         async with self.session.get(url=f"{self.BASE_URL}{endpoint}", params=params) as api_request:
             api_request.raise_for_status()
+            if endpoint in text_response_endpoints:
+                return await api_request.text()
             api_request_json = await api_request.json()
         api_request_error = api_request_json.get("error")
         if api_request_error:

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/src/TornAPIWrapper/endpoints/faction.py

@@ -402,6 +402,20 @@ class Faction:
         """
         return self.api.request("/faction/search", build_params(self.get_search, locals()))
 
+    def get_snapshot(self, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get daily factions snapshot CSV.
+        API key (Public).
+        Returns a CSV daily snapshot of factions.
+        This selection is standalone and cannot be used together with other selections.
+        CSV columns: id, name, tag, tag_image, banner_image, leader_id, co_leader_id, respect, days_old, rank, members, members_max, member_list, recruiting, destroyed_timestamp
+        :param timestamp: Timestamp to bypass cache.
+        :param comment: Comment for your tool/service/bot/website to be visible in the logs.
+        :return: API response data.
+        :rtype: dict
+        """
+        return self.api.request("/faction/snapshot", build_params(self.get_snapshot, locals()))
+
     def get_stats(self, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your faction's challenges stats.

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/src/TornAPIWrapper/endpoints_async/faction.py

@@ -402,6 +402,20 @@ class Faction:
         """
         return await self.api.request("/faction/search", build_params(self.get_search, locals()))
 
+    async def get_snapshot(self, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get daily factions snapshot CSV.
+        API key (Public).
+        Returns a CSV daily snapshot of factions.
+        This selection is standalone and cannot be used together with other selections.
+        CSV columns: id, name, tag, tag_image, banner_image, leader_id, co_leader_id, respect, days_old, rank, members, members_max, member_list, recruiting, destroyed_timestamp
+        :param timestamp: Timestamp to bypass cache.
+        :param comment: Comment for your tool/service/bot/website to be visible in the logs.
+        :return: API response data.
+        :rtype: dict
+        """
+        return await self.api.request("/faction/snapshot", build_params(self.get_snapshot, locals()))
+
     async def get_stats(self, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your faction's challenges stats.

tornapiwrapper-2.10.0/src/TornAPIWrapper/text_response_endpoints.py

@@ -0,0 +1 @@
+text_response_endpoints = {"/company/snapshot"}

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0/src/TornAPIWrapper.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.9.0
+Version: 2.10.0
 Summary: A Python wrapper for the Torn City API, providing access to Torn City data.
 Author: cxdzc
 License: The MIT License (MIT)
@@ -53,7 +53,7 @@ Dynamic: license-file
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/v/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/pyversions/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pepy/dt/tornapiwrapper?color=blue&cacheSeconds=300></a>
-<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-01.06.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-16.07.2026-c4c4c4?cacheSeconds=300></a>
 <a rel="license" href="https://github.com/cxdzc/TornAPIWrapper/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-ab1436"/></a>
 </div>
 

{tornapiwrapper-2.9.0 → tornapiwrapper-2.10.0}/src/TornAPIWrapper.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ src/TornAPIWrapper/__main__.py
 src/TornAPIWrapper/client.py
 src/TornAPIWrapper/client_async.py
 src/TornAPIWrapper/errors.py
+src/TornAPIWrapper/text_response_endpoints.py
 src/TornAPIWrapper/type_hints.py
 src/TornAPIWrapper.egg-info/PKG-INFO
 src/TornAPIWrapper.egg-info/SOURCES.txt