TornAPIWrapper 2.5.0__py3-none-any.whl → 2.6.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.5.0"
-__patch__ = "20.04.2026"
+__version__ = "2.6.0"
+__patch__ = "30.04.2026"
 
 from .errors import (
     WrapperError,

TornAPIWrapper/client.py

@@ -25,6 +25,7 @@ DEALINGS IN THE SOFTWARE.
 import requests
 
 from . import __version__
+from .endpoints.company import Company
 from .endpoints.faction import Faction
 from .endpoints.forum import Forum
 from .endpoints.key import Key
@@ -50,6 +51,7 @@ class TornAPIWrapper:
 
         self.user: User = User(self)
         self.faction: Faction = Faction(self)
+        self.company: Company = Company(self)
         self.market: Market = Market(self)
         self.forum: Forum = Forum(self)
         self.racing: Racing = Racing(self)

TornAPIWrapper/client_async.py

@@ -25,6 +25,7 @@ DEALINGS IN THE SOFTWARE.
 import aiohttp
 
 from . import __version__
+from .endpoints_async.company import Company
 from .endpoints_async.faction import Faction
 from .endpoints_async.forum import Forum
 from .endpoints_async.key import Key
@@ -56,6 +57,7 @@ class TornAPIWrapperAsync:
 
         self.user: User = User(self)
         self.faction: Faction = Faction(self)
+        self.company: Company = Company(self)
         self.market: Market = Market(self)
         self.forum: Forum = Forum(self)
         self.racing: Racing = Racing(self)

TornAPIWrapper/endpoints/company.py

@@ -0,0 +1,111 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2023-Present cxdzc
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..params.builders import build_params
+
+if TYPE_CHECKING:
+    from ..client import TornAPIWrapper
+
+class Company:
+    """
+    Company API endpoints.
+    """
+
+    def __init__(self, api: TornAPIWrapper):
+        self.api = api
+
+    def get_applications(self, timestamp: int = None, comment: str = None):
+        """
+        Get your company's applications.
+        API key (Limited).
+        :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("/company/applications", build_params(self.get_applications, locals()))
+
+    def get_employees(self, company_id: int = None, striptags: bool = True, timestamp: int = None, comment: str = None):
+        """
+        Get my company's employees.
+        API key (Public).
+        When using Limited, Custom or Full access API keys, the response will be of type CompanyEmployeeExtended, otherwise it will be of type CompanyEmployee.
+        :param company_id: Company id.
+        :param striptags: Determines if fields include HTML or not ('Hospitalized by user' vs 'Hospitalized by user').
+        :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("/company/employees", build_params(self.get_employees, locals()))
+
+    def get_profile(self, company_id: int = None, striptags: bool = True, timestamp: int = None, comment: str = None):
+        """
+        Get a company's profile.
+        API key (Public).
+        When using Limited, Custom or Full access API keys, the response will be of type CompanyEmployeeExtended, otherwise it will be of type CompanyEmployee.
+        :param company_id: Company id.
+        :param striptags: Determines if fields include HTML or not ('Hospitalized by user' vs 'Hospitalized by user').
+        :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("/company/profile", build_params(self.get_profile, locals()))
+
+    def get_stock(self, timestamp: int = None, comment: str = None):
+        """
+        Get your company's stock.
+        API key (Limited).
+        :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("/company/stock", build_params(self.get_stock, locals()))
+
+    def get_lookup(self, timestamp: int = None, comment: str = None):
+        """
+        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("/company/lookup", build_params(self.get_lookup, locals()))
+
+    def get_timestamp(self, timestamp: int = None, comment: str = None):
+        """
+        Get current server time.
+        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("/company/timestamp", build_params(self.get_timestamp, locals()))

TornAPIWrapper/endpoints_async/company.py

@@ -0,0 +1,111 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2023-Present cxdzc
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..params.builders import build_params
+
+if TYPE_CHECKING:
+    from ..client_async import TornAPIWrapperAsync
+
+class Company:
+    """
+    Company API endpoints.
+    """
+
+    def __init__(self, api: TornAPIWrapperAsync):
+        self.api = api
+
+    async def get_applications(self, timestamp: int = None, comment: str = None):
+        """
+        Get your company's applications.
+        API key (Limited).
+        :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("/company/applications", build_params(self.get_applications, locals()))
+
+    async def get_employees(self, company_id: int = None, striptags: bool = True, timestamp: int = None, comment: str = None):
+        """
+        Get my company's employees.
+        API key (Public).
+        When using Limited, Custom or Full access API keys, the response will be of type CompanyEmployeeExtended, otherwise it will be of type CompanyEmployee.
+        :param company_id: Company id.
+        :param striptags: Determines if fields include HTML or not ('Hospitalized by user' vs 'Hospitalized by user').
+        :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("/company/employees", build_params(self.get_employees, locals()))
+
+    async def get_profile(self, company_id: int = None, striptags: bool = True, timestamp: int = None, comment: str = None):
+        """
+        Get a company's profile.
+        API key (Public).
+        When using Limited, Custom or Full access API keys, the response will be of type CompanyEmployeeExtended, otherwise it will be of type CompanyEmployee.
+        :param company_id: Company id.
+        :param striptags: Determines if fields include HTML or not ('Hospitalized by user' vs 'Hospitalized by user').
+        :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("/company/profile", build_params(self.get_profile, locals()))
+
+    async def get_stock(self, timestamp: int = None, comment: str = None):
+        """
+        Get your company's stock.
+        API key (Limited).
+        :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("/company/stock", build_params(self.get_stock, locals()))
+
+    async def get_lookup(self, timestamp: int = None, comment: str = None):
+        """
+        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 await self.api.request("/company/lookup", build_params(self.get_lookup, locals()))
+
+    async def get_timestamp(self, timestamp: int = None, comment: str = None):
+        """
+        Get current server time.
+        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 await self.api.request("/company/timestamp", build_params(self.get_timestamp, locals()))

TornAPIWrapper/params/map.py

@@ -7,6 +7,7 @@ param_ids = {"category_ids", "honor_ids", "item_ids", "medals_ids", "territory_i
 param_filters = {"attack_filters", "crimes_filter", "property_filters"}
 param_id = {
     "chain_id",
+    "company_id",
     "crime_id",
     "faction_id",
     "item_id",

{tornapiwrapper-2.5.0.dist-info → tornapiwrapper-2.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.5.0
+Version: 2.6.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-20.04.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-30.04.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.5.0.dist-info → tornapiwrapper-2.6.0.dist-info}/RECORD

@@ -1,10 +1,11 @@
-TornAPIWrapper/__init__.py,sha256=5UVw9XlrU2w9mmcTO4yZjauCnIcvMIvbCFjoXs7dfIY,2763
+TornAPIWrapper/__init__.py,sha256=I9doGBtL4Cb-X4uXjaG7IT91KVi-6qB73NmRAj9mMNc,2763
 TornAPIWrapper/__main__.py,sha256=JKsDOr6esnYwiUO5HypNL_0ieiEc5YCItsLwdMfxyLs,1806
-TornAPIWrapper/client.py,sha256=W8S0lSwx5sz-rZWhUjBwJqMov_zFplDbJVZPsNis8os,3114
-TornAPIWrapper/client_async.py,sha256=vqL4-ZOEGdSLlqsluA_UI17TE86qlpYbCQ7MkXEahc0,3885
+TornAPIWrapper/client.py,sha256=IFKujsxf2A1buBsQwPmXbxgjRVmXg2rwNBBKv9OXCFc,3199
+TornAPIWrapper/client_async.py,sha256=rn_AtgrtgNeumiwKD29F7f8l-4Oxr41AnMXbSGVQXqY,3976
 TornAPIWrapper/errors.py,sha256=lq0c7tA7M7-7r7rE7Mt1Edp9lOc4iEGY1BLazYrBEz4,9328
 TornAPIWrapper/type_hints.py,sha256=B5xgRDSptf7jfUAhJ4qvaZMlSoXjwLfMFuqJbWsQvFM,8971
 TornAPIWrapper/endpoints/__init__.py,sha256=UoVUdkQ9O_wgG2QJvIsOMFtYR0n2-XjUCFUccBSbD7A,1126
+TornAPIWrapper/endpoints/company.py,sha256=IGs8KoGpBwsgfUQiB9YYyoHb1DC5J6N6TlGekoPhQiU,4831
 TornAPIWrapper/endpoints/faction.py,sha256=sdqaBvckixkCL1zfKqC0B8B0rwKRB7sc8CI6EzQ9qe0,30608
 TornAPIWrapper/endpoints/forum.py,sha256=F9ocJ9RAiC67Cvdmgj08GGiqPmITT3-_lZL6Lox8zGY,5701
 TornAPIWrapper/endpoints/key.py,sha256=GC8e7Z28mKViAauqr38gjAMJfWHns5Rn5sNOICHy854,2494
@@ -14,6 +15,7 @@ TornAPIWrapper/endpoints/racing.py,sha256=xjoGHTNmnqbqyhZeetBXRVcFdKYUAM_m6paomP
 TornAPIWrapper/endpoints/torn.py,sha256=utJ4vz3hLXaqNdEq-ycs78nsqwYvyGh3oEJqlZEzz6E,16558
 TornAPIWrapper/endpoints/user.py,sha256=Uig-vvDMK5_8FbUaOpUmh_05XcJPIZ8FNWgEzIfwLMQ,45853
 TornAPIWrapper/endpoints_async/__init__.py,sha256=1x2hi50HSEPTeUVrUD1NQTkhpLjyVGg8kDo4LcXFcP8,1132
+TornAPIWrapper/endpoints_async/company.py,sha256=8y_vky7HpG1J6jsfuebatdiRRB7tArcjJYBXM7jx-kA,4919
 TornAPIWrapper/endpoints_async/faction.py,sha256=823cLOK4Y9sqWfP_ARJacJrd4eJbTZlGhjLDw8Uh0C8,31032
 TornAPIWrapper/endpoints_async/forum.py,sha256=rIxZYuViGnUYSerak0whRHdbZlLfCbVJMg3roVRLEGU,5789
 TornAPIWrapper/endpoints_async/key.py,sha256=d04B-YVkghJBqnyroGABlUX_HD-PNFAT-mI1ZYeipbk,2534
@@ -24,9 +26,9 @@ TornAPIWrapper/endpoints_async/torn.py,sha256=wo1yecshY3wXDbzGpUC7nA_0GCznBQvRT2
 TornAPIWrapper/endpoints_async/user.py,sha256=wg1oi-aSOXBmoV6CnOTqeXDKtd8tqbe_tCPJZWP1Q40,46625
 TornAPIWrapper/params/__init__.py,sha256=62xgULpfqEnTYmzSz_6W2MVGtna4DFb6oABy02ZsGcY,1123
 TornAPIWrapper/params/builders.py,sha256=WQIHSmMgJedNpwps8p4QjXvMLG-s09QBsT1Qynaxx1s,2057
-TornAPIWrapper/params/map.py,sha256=VIc9tKoxPWETwJA2-t4NUlIVg7QmqBXcda9QGccuxrs,1364
-tornapiwrapper-2.5.0.dist-info/licenses/LICENSE,sha256=tFxfnm48fk5x0JCMs1t7Ao6XDt_bHn_ogl3Y_q2EuPc,1079
-tornapiwrapper-2.5.0.dist-info/METADATA,sha256=OXmXVr6nrSd2W9J2-0svxYP_nkSU1PFrxG7rzyn7Uuo,5069
-tornapiwrapper-2.5.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-tornapiwrapper-2.5.0.dist-info/top_level.txt,sha256=z3QKLWbCxzb7qZb9LV37myVFXQm3hgA57PGuSWkc4R4,15
-tornapiwrapper-2.5.0.dist-info/RECORD,,
+TornAPIWrapper/params/map.py,sha256=nvZEklgS1IZYmwTY1vv9HQZjV8zJdU9xL3DAXGCtCno,1382
+tornapiwrapper-2.6.0.dist-info/licenses/LICENSE,sha256=tFxfnm48fk5x0JCMs1t7Ao6XDt_bHn_ogl3Y_q2EuPc,1079
+tornapiwrapper-2.6.0.dist-info/METADATA,sha256=p-q7bHp0ZLap4JalfPiAUuzmJfJRTdyMp7JnbRJwVAg,5069
+tornapiwrapper-2.6.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+tornapiwrapper-2.6.0.dist-info/top_level.txt,sha256=z3QKLWbCxzb7qZb9LV37myVFXQm3hgA57PGuSWkc4R4,15
+tornapiwrapper-2.6.0.dist-info/RECORD,,