TornAPIWrapper 2.15.0__tar.gz → 2.17.0__tar.gz

{tornapiwrapper-2.15.0/src/TornAPIWrapper.egg-info → tornapiwrapper-2.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.15.0
+Version: 2.17.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-18.08.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-21.08.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.15.0 → tornapiwrapper-2.17.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-18.08.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-21.08.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.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/__init__.py

@@ -26,9 +26,11 @@ __author__ = "cxdzc"
 __copyright__ = "Copyright 2023-Present cxdzc"
 __license__ = "MIT"
 __title__ = "TornAPIWrapper"
-__version__ = "2.15.0"
-__patch__ = "18.08.2026"
+__version__ = "2.17.0"
+__patch__ = "21.08.2026"
 
+from .client import TornAPIWrapper
+from .client_async import TornAPIWrapperAsync
 from .errors import (
     WrapperError,
     UnhandledAPIError,
@@ -63,9 +65,8 @@ from .errors import (
     MigrationRequiredOC2,
     InvalidLogId,
     InvalidInteractionLogCategory,
+    FileDoesNotExist,
 )
-from .client import TornAPIWrapper
-from .client_async import TornAPIWrapperAsync
 
 __all__ = [
     "TornAPIWrapper",
@@ -105,4 +106,5 @@ __all__ = [
     "MigrationRequiredOC2",
     "InvalidLogId",
     "InvalidInteractionLogCategory",
+    "FileDoesNotExist",
 ]

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/client.py

@@ -35,7 +35,6 @@ 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:
@@ -71,7 +70,7 @@ class TornAPIWrapper:
         """
         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:
+        if api_request.headers.get("Content-Type", None) == "text/csv":
             return api_request.text
         api_request_json = api_request.json()
         api_request_error = api_request_json.get("error")

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/client_async.py

@@ -35,7 +35,6 @@ 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:
@@ -77,7 +76,7 @@ class TornAPIWrapperAsync:
         """
         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:
+            if api_request.headers.get("Content-Type", None) == "text/csv":
                 return await api_request.text()
             api_request_json = await api_request.json()
         api_request_error = api_request_json.get("error")

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/endpoints/faction.py

@@ -28,7 +28,8 @@ from typing import TYPE_CHECKING
 
 from ..params.builders import build_params
 from ..type_hints import SortOptions, FacScopeCatOptions, AttackFiltersOptions, FacContributorsStatOptions, \
-    FacCrimesCatOptions, FacCrimesFiltersOptions, FacNewsCatOptions, ReportCatOptions, FacWarChainsCatOptions
+    FacCrimesCatOptions, FacCrimesFiltersOptions, FacNewsCatOptions, ReportCatOptions, FacWarChainsCatOptions, \
+    FacInventoryCatOptions
 
 if TYPE_CHECKING:
     from ..client import TornAPIWrapper
@@ -170,6 +171,17 @@ class Faction:
         """
         return self.api.request("/faction/contributors", build_params(self.get_contributors, locals()))
 
+    def get_crimeexp(self, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your faction members crime experience.
+        API key (Minimal).
+        :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/crimeexp", build_params(self.get_crimeexp, locals()))
+
     def get_crimes(self, crimes_category: FacCrimesCatOptions = "all", crimes_filter: FacCrimesFiltersOptions = None, limit: int = 20, offset: int = 0, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your faction's organized crimes.
@@ -230,6 +242,21 @@ class Faction:
         """
         return self.api.request("/faction/hof", build_params(self.get_hof, locals()))
 
+    def get_inventory(self, armory_category: FacInventoryCatOptions, limit: int = 20, offset: int = 0, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your faction's inventory items.
+        API key (Limited).
+        Cached selection (1 hour, all items cached at once).
+        :param armory_category: Armory category.
+        :param limit: Number of results to return.
+        :param offset: Number of rows to skip before returning results.
+        :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/inventory", build_params(self.get_inventory, locals()))
+
     def get_members(self, faction_id: int = None, striptags: bool = True, timestamp: int = None, comment: str = None) -> dict:
         """
         Get a list of members for your faction or a specific faction.

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/endpoints/torn.py

@@ -247,11 +247,11 @@ class Torn:
         """
         return self.api.request("/torn/itemammo", build_params(self.get_itemammo, locals()))
 
-    def get_itemdetails(self, item_id: int, timestamp: int = None, comment: str = None) -> dict:
+    def get_itemdetails(self, item_ids: list[int], timestamp: int = None, comment: str = None) -> dict:
         """
-        Get information about a specific item.
+        Get details for specific item(s).
         API key (Public).
-        :param item_id: Item uid.
+        :param item_ids: Item uid or a list of item uids (comma separated), 25 uids maximum.
         :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.
@@ -270,6 +270,18 @@ class Torn:
         """
         return self.api.request("/torn/itemmods", build_params(self.get_itemmods, locals()))
 
+    def get_itemstats(self, item_ids: list[int], timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get specific item(s) stats.
+        API key (Public).
+        :param item_ids: Item uid or a list of item uids (comma separated), 25 uids maximum.
+        :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("/torn/itemstats", build_params(self.get_itemstats, locals()))
+
     def get_items(self, item_ids: list[int] = None, item_category: TornItemsCatOptions = None, sort: SortOptions = "ASC", timestamp: int = None, comment: str = None) -> dict:
         """
         Get information about items.
@@ -378,6 +390,17 @@ class Torn:
         """
         return self.api.request("/torn/properties", build_params(self.get_properties, locals()))
 
+    def get_rockpaperscissors(self, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get rock paper scissors competition stats.
+        API key (Public).
+        :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("/torn/rockpaperscissors", build_params(self.get_rockpaperscissors, locals()))
+
     def get_searchforcash(self, timestamp: int = None, comment: str = None) -> dict:
         """
         Get search for cash crime statuses.
@@ -400,6 +423,17 @@ class Torn:
         """
         return self.api.request("/torn/shoplifting", build_params(self.get_shoplifting, locals()))
 
+    def get_stats(self, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get daily city stats.
+        API key (Public).
+        :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("/torn/stats", build_params(self.get_stats, locals()))
+
     def get_stocks(self, stock_id: int = None, timestamp: int = None, comment: str = None) -> dict:
         """
         Get all stocks or specific stock with chart history.

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/endpoints_async/faction.py

@@ -28,7 +28,8 @@ from typing import TYPE_CHECKING
 
 from ..params.builders import build_params
 from ..type_hints import SortOptions, FacScopeCatOptions, AttackFiltersOptions, FacContributorsStatOptions, \
-    FacCrimesCatOptions, FacCrimesFiltersOptions, FacNewsCatOptions, ReportCatOptions, FacWarChainsCatOptions
+    FacCrimesCatOptions, FacCrimesFiltersOptions, FacNewsCatOptions, ReportCatOptions, FacWarChainsCatOptions, \
+    FacInventoryCatOptions
 
 if TYPE_CHECKING:
     from ..client_async import TornAPIWrapperAsync
@@ -170,6 +171,17 @@ class Faction:
         """
         return await self.api.request("/faction/contributors", build_params(self.get_contributors, locals()))
 
+    async def get_crimeexp(self, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your faction members crime experience.
+        API key (Minimal).
+        :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/crimeexp", build_params(self.get_crimeexp, locals()))
+
     async def get_crimes(self, crimes_category: FacCrimesCatOptions = "all", crimes_filter: FacCrimesFiltersOptions = None, limit: int = 20, offset: int = 0, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your faction's organized crimes.
@@ -230,6 +242,21 @@ class Faction:
         """
         return await self.api.request("/faction/hof", build_params(self.get_hof, locals()))
 
+    async def get_inventory(self, armory_category: FacInventoryCatOptions, limit: int = 20, offset: int = 0, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your faction's inventory items.
+        API key (Limited).
+        Cached selection (1 hour, all items cached at once).
+        :param armory_category: Armory category.
+        :param limit: Number of results to return.
+        :param offset: Number of rows to skip before returning results.
+        :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/inventory", build_params(self.get_inventory, locals()))
+
     async def get_members(self, faction_id: int = None, striptags: bool = True, timestamp: int = None, comment: str = None) -> dict:
         """
         Get a list of members for your faction or a specific faction.

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/errors.py

@@ -260,7 +260,6 @@ class MigrationRequiredOC2(APIError):
     """
     pass
 
-
 class InvalidLogId(APIError):
     """
     28
@@ -268,7 +267,6 @@ class InvalidLogId(APIError):
     """
     pass
 
-
 class InvalidInteractionLogCategory(APIError):
     """
     29
@@ -276,6 +274,13 @@ class InvalidInteractionLogCategory(APIError):
     """
     pass
 
+class FileDoesNotExist(APIError):
+    """
+    30
+    File does not exist.
+    """
+    pass
+
 class TornAPIErrorHandler:
     """
     Handle Torn API error codes and raise appropriate exceptions.
@@ -311,6 +316,7 @@ class TornAPIErrorHandler:
         27: (MigrationRequiredOC2, "Must be migrated to organized crimes 2.0."),
         28: (InvalidLogId, "Incorrect log ID."),
         29: (InvalidInteractionLogCategory, "Category selection is not available for interaction logs."),
+        30: (FileDoesNotExist, "File does not exist."),
     }
 
     def raise_code(self, error_code: int):

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/params/map.py

@@ -28,6 +28,7 @@ param_id = {
     "user_id",
 }
 param_cat = {
+    "armory_category",
     "balance_category",
     "bazaar_category",
     "car_category",

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper/type_hints.py

@@ -40,6 +40,7 @@ FacScopeCatOptions = Literal["all", "current"]
 FacWarChainsCatOptions = Literal["active", "complete"]
 FacCrimesFiltersOptions = Literal["created_at", "executed_at", "ready_at", "expired_at"]
 FacCrimesCatOptions = Literal["all", "recruiting", "planning", "failure", "successful", "expired", "available", "completed"]
+FacInventoryCatOptions = Literal["weapons", "armor", "temporary", "medical", "consumables", "drugs", "boosters", "utilities", "loot"]
 FacNewsCatOptions = Literal["main", "attack", "armoryDeposit", "armoryAction", "territoryWar", "rankedWar", "territoryGain", "chain", "crime", "membership", "depositFunds", "giveFunds"]
 FacContributorsStatOptions = Literal["medicalitemsused", "criminaloffences", "organisedcrimerespect", "organisedcrimemoney", "organisedcrimesuccess", "organisedcrimefail", "attackswon", "attackslost", "attackschain", "attacksleave", "attacksmug", "attackshosp", "bestchain", "busts", "revives", "jails", "hosps", "medicalitemrecovery", "medicalcooldownused", "gymtrains", "gymstrength", "gymspeed", "gymenergy", "gymdefense", "gymdexterity", "candyused", "alcoholused", "energydrinkused", "drugsused", "drugoverdoses", "rehabs", "caymaninterest", "traveltimes", "traveltime", "hunting", "attacksdamagehits", "attacksdamage", "hosptimegiven", "hosptimereceived", "attacksdamaging", "attacksrunaway", "highestterritories", "territoryrespect", "membersamount", "factionage", "upgradesamount"]
 

{tornapiwrapper-2.15.0 → tornapiwrapper-2.17.0/src/TornAPIWrapper.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.15.0
+Version: 2.17.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-18.08.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-21.08.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.15.0 → tornapiwrapper-2.17.0}/src/TornAPIWrapper.egg-info/SOURCES.txt

@@ -6,7 +6,6 @@ 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

tornapiwrapper-2.15.0/src/TornAPIWrapper/text_response_endpoints.py

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