TornAPIWrapper 2.9.0__py3-none-any.whl → 2.10.0__py3-none-any.whl

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/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/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/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/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/text_response_endpoints.py

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

{tornapiwrapper-2.9.0.dist-info → tornapiwrapper-2.10.0.dist-info}/METADATA

@@ -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.dist-info → tornapiwrapper-2.10.0.dist-info}/RECORD

@@ -1,12 +1,13 @@
-TornAPIWrapper/__init__.py,sha256=KYA3CC89grnh3B-S1jkYCs_5YrfUFaFA2afhcggfVBg,2763
+TornAPIWrapper/__init__.py,sha256=PeGDDLReUdGrzeAkOxgjVi-U79DNt-hiJe5qYH8HMcE,2764
 TornAPIWrapper/__main__.py,sha256=JKsDOr6esnYwiUO5HypNL_0ieiEc5YCItsLwdMfxyLs,1806
-TornAPIWrapper/client.py,sha256=IFKujsxf2A1buBsQwPmXbxgjRVmXg2rwNBBKv9OXCFc,3199
-TornAPIWrapper/client_async.py,sha256=rn_AtgrtgNeumiwKD29F7f8l-4Oxr41AnMXbSGVQXqY,3976
+TornAPIWrapper/client.py,sha256=2Mn4wNgJm8_9OWl7u5OtKM10XcXbIq71jnCmgyosl_c,3368
+TornAPIWrapper/client_async.py,sha256=AsEQBEuCmUkwtPnimoxBcwYpldn_s5sTCwXF9CnvqXA,4161
 TornAPIWrapper/errors.py,sha256=lq0c7tA7M7-7r7rE7Mt1Edp9lOc4iEGY1BLazYrBEz4,9328
+TornAPIWrapper/text_response_endpoints.py,sha256=h1I5p1PtPz4Z5ebIUxwBPMe13QwC_VP6fQTP3jux5yM,48
 TornAPIWrapper/type_hints.py,sha256=tf0RLIKI4LKupMLyOVywUPvUBO07k0lfrWr2Qmc-d7U,9050
 TornAPIWrapper/endpoints/__init__.py,sha256=UoVUdkQ9O_wgG2QJvIsOMFtYR0n2-XjUCFUccBSbD7A,1126
 TornAPIWrapper/endpoints/company.py,sha256=ibcIZTDJD8RDfH_G_GpaQKpU8A4hceM1OwicwwLSyTM,8699
-TornAPIWrapper/endpoints/faction.py,sha256=sdqaBvckixkCL1zfKqC0B8B0rwKRB7sc8CI6EzQ9qe0,30608
+TornAPIWrapper/endpoints/faction.py,sha256=wjXrUH0RLL5GGE-nzGeYy_tT_dA9fRIxAAXD9xGT0to,31395
 TornAPIWrapper/endpoints/forum.py,sha256=F9ocJ9RAiC67Cvdmgj08GGiqPmITT3-_lZL6Lox8zGY,5701
 TornAPIWrapper/endpoints/key.py,sha256=GC8e7Z28mKViAauqr38gjAMJfWHns5Rn5sNOICHy854,2494
 TornAPIWrapper/endpoints/market.py,sha256=Iv7kQ3tCtayjXG-NQu2uTAW04dbS37zMgJx1KDf7_HU,7113
@@ -16,7 +17,7 @@ TornAPIWrapper/endpoints/torn.py,sha256=utJ4vz3hLXaqNdEq-ycs78nsqwYvyGh3oEJqlZEz
 TornAPIWrapper/endpoints/user.py,sha256=q8kHn2VAnybjAxt3Sr2qJ80nol5YYm6dDJyRic0CLKM,46336
 TornAPIWrapper/endpoints_async/__init__.py,sha256=1x2hi50HSEPTeUVrUD1NQTkhpLjyVGg8kDo4LcXFcP8,1132
 TornAPIWrapper/endpoints_async/company.py,sha256=gCrb2TJYpR93b8-gAfQlW3k0QGCzhUZUzLOwpCUj0Rs,8835
-TornAPIWrapper/endpoints_async/faction.py,sha256=823cLOK4Y9sqWfP_ARJacJrd4eJbTZlGhjLDw8Uh0C8,31032
+TornAPIWrapper/endpoints_async/faction.py,sha256=zWnVhSBpDe-yDLEAQCXjov_UyeqCnRh71w8Hnj15Cjw,31831
 TornAPIWrapper/endpoints_async/forum.py,sha256=rIxZYuViGnUYSerak0whRHdbZlLfCbVJMg3roVRLEGU,5789
 TornAPIWrapper/endpoints_async/key.py,sha256=d04B-YVkghJBqnyroGABlUX_HD-PNFAT-mI1ZYeipbk,2534
 TornAPIWrapper/endpoints_async/market.py,sha256=lfLwbTTUxTajdWM45XEBLVm83UX2oZRXpA7ZDupuA1g,7225
@@ -27,8 +28,8 @@ TornAPIWrapper/endpoints_async/user.py,sha256=cm5d0INBrZ3xukzOhcLIQcDeCqfHnhKGct
 TornAPIWrapper/params/__init__.py,sha256=62xgULpfqEnTYmzSz_6W2MVGtna4DFb6oABy02ZsGcY,1123
 TornAPIWrapper/params/builders.py,sha256=WQIHSmMgJedNpwps8p4QjXvMLG-s09QBsT1Qynaxx1s,2057
 TornAPIWrapper/params/map.py,sha256=rWxyyQBpUsqQYgjoZRqNWYwr0JfinFMpQtX7FNtGTDs,1421
-tornapiwrapper-2.9.0.dist-info/licenses/LICENSE,sha256=tFxfnm48fk5x0JCMs1t7Ao6XDt_bHn_ogl3Y_q2EuPc,1079
-tornapiwrapper-2.9.0.dist-info/METADATA,sha256=pvPj4mjTDHh9hsiZ5ZKvxNQkppQaI9u3UmfBEmTTIOE,5069
-tornapiwrapper-2.9.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-tornapiwrapper-2.9.0.dist-info/top_level.txt,sha256=z3QKLWbCxzb7qZb9LV37myVFXQm3hgA57PGuSWkc4R4,15
-tornapiwrapper-2.9.0.dist-info/RECORD,,
+tornapiwrapper-2.10.0.dist-info/licenses/LICENSE,sha256=tFxfnm48fk5x0JCMs1t7Ao6XDt_bHn_ogl3Y_q2EuPc,1079
+tornapiwrapper-2.10.0.dist-info/METADATA,sha256=yPAp21j5wNaraGdlO6pgUef7wjXkBlmGgLU2raTc99E,5070
+tornapiwrapper-2.10.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+tornapiwrapper-2.10.0.dist-info/top_level.txt,sha256=z3QKLWbCxzb7qZb9LV37myVFXQm3hgA57PGuSWkc4R4,15
+tornapiwrapper-2.10.0.dist-info/RECORD,,

{tornapiwrapper-2.9.0.dist-info → tornapiwrapper-2.10.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any