TornAPIWrapper 2.8.0__tar.gz → 2.9.1__tar.gz

{tornapiwrapper-2.8.0/src/TornAPIWrapper.egg-info → tornapiwrapper-2.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.8.0
+Version: 2.9.1
 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-21.05.2026-c4c4c4?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 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.8.0 → tornapiwrapper-2.9.1}/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-21.05.2026-c4c4c4?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 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.8.0 → tornapiwrapper-2.9.1}/src/TornAPIWrapper/__init__.py

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

{tornapiwrapper-2.8.0 → tornapiwrapper-2.9.1}/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.8.0 → tornapiwrapper-2.9.1}/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.8.0 → tornapiwrapper-2.9.1}/src/TornAPIWrapper/endpoints/company.py

@@ -111,6 +111,36 @@ class Company:
         """
         return self.api.request("/company/profile", build_params(self.get_profile, locals()))
 
+    def get_search(self, company_name: str = None, filters: list[str] = None, limit: int = 20, offset: int = 0, timestamp: int = None, comment: str = None) -> dict: #1F4A9 endpoint
+        """
+        Search companies by name or other criteria.
+        API key (Public).
+        This selection is standalone and cannot be used together with other selections.
+        :param company_name: Name to search for.
+        :param filters: A filtering query parameter allowing a comma-separated list of filters.
+        :param limit: Number of results to return.
+        :param offset: Number of rows to skip before returning results.
+        :param timestamp: Timestamp to bypass cache or get the data in specific point in time.
+        :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("/company/search", build_params(self.get_search, locals()))
+
+    def get_snapshot(self, timestamp: int = None, comment: str = None):
+        """
+        Get daily companies snapshot CSV.
+        API key (Public).
+        Returns a CSV daily snapshot of companies.
+        This selection is standalone and cannot be used together with other selections.
+        CSV columns: id, name, created_at, days_old, image, type, rating, director_id, employees_hired, employees_capacity, daily_income, daily_customers, weekly_income, weekly_customers, applications_allowed
+        :param timestamp: Timestamp to bypass cache or get the data in specific point in time.
+        :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("/company/snapshot", build_params(self.get_snapshot, locals()))
+
     def get_stock(self, timestamp: int = None, comment: str = None):
         """
         Get your company's stock.

{tornapiwrapper-2.8.0 → tornapiwrapper-2.9.1}/src/TornAPIWrapper/endpoints_async/company.py

@@ -111,6 +111,36 @@ class Company:
         """
         return await self.api.request("/company/profile", build_params(self.get_profile, locals()))
 
+    async def get_search(self, company_name: str = None, filters: list[str] = None, limit: int = 20, offset: int = 0, timestamp: int = None, comment: str = None) -> dict: #1F4A9 endpoint
+        """
+        Search companies by name or other criteria.
+        API key (Public).
+        This selection is standalone and cannot be used together with other selections.
+        :param company_name: Name to search for.
+        :param filters: A filtering query parameter allowing a comma-separated list of filters.
+        :param limit: Number of results to return.
+        :param offset: Number of rows to skip before returning results.
+        :param timestamp: Timestamp to bypass cache or get the data in specific point in time.
+        :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("/company/search", build_params(self.get_search, locals()))
+
+    async def get_snapshot(self, timestamp: int = None, comment: str = None):
+        """
+        Get daily companies snapshot CSV.
+        API key (Public).
+        Returns a CSV daily snapshot of companies.
+        This selection is standalone and cannot be used together with other selections.
+        CSV columns: id, name, created_at, days_old, image, type, rating, director_id, employees_hired, employees_capacity, daily_income, daily_customers, weekly_income, weekly_customers, applications_allowed
+        :param timestamp: Timestamp to bypass cache or get the data in specific point in time.
+        :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("/company/snapshot", build_params(self.get_snapshot, locals()))
+
     async def get_stock(self, timestamp: int = None, comment: str = None):
         """
         Get your company's stock.

{tornapiwrapper-2.8.0 → tornapiwrapper-2.9.1}/src/TornAPIWrapper/params/map.py

@@ -1,6 +1,6 @@
 param_from = {"from_"}
 param_target = {"target_id"}
-param_name = {"faction_name"}
+param_name = {"company_name", "faction_name"}
 param_stat = {"stat_key", "stat_keys"}
 param_log = {"attack_log_id", "log_id"}
 param_ids = {"category_ids", "honor_ids", "item_ids", "medals_ids", "territory_ids"}

tornapiwrapper-2.9.1/src/TornAPIWrapper/text_response_endpoints.py

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

{tornapiwrapper-2.8.0 → tornapiwrapper-2.9.1/src/TornAPIWrapper.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.8.0
+Version: 2.9.1
 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-21.05.2026-c4c4c4?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 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.8.0 → tornapiwrapper-2.9.1}/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