django-esi 8.0.0b1__py3-none-any.whl → 8.0.0b2__py3-none-any.whl

{django_esi-8.0.0b1.dist-info → django_esi-8.0.0b2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-esi
-Version: 8.0.0b1
+Version: 8.0.0b2
 Summary: Django app for accessing the EVE Swagger Interface (ESI).
 Keywords: eveonline
 Author-email: Alliance Auth <adarnof@gmail.com>
@@ -9,7 +9,6 @@ Description-Content-Type: text/markdown
 Classifier: Environment :: Web Environment
 Classifier: Framework :: Django
 Classifier: Framework :: Django :: 4.2
-Classifier: Framework :: Django :: 5.1
 Classifier: Framework :: Django :: 5.2
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
@@ -28,8 +27,10 @@ Requires-Dist: aiopenapi3
 Requires-Dist: bravado>=10.6,<12
 Requires-Dist: celery>=4.0.2
 Requires-Dist: django>=4.2,<6
+Requires-Dist: django-redis>=5.2
 Requires-Dist: httpx[brotli, http2, zstd]
 Requires-Dist: jsonschema<4
+Requires-Dist: pydantic>=2.12.3
 Requires-Dist: python-jose>=3.3
 Requires-Dist: requests>=2.26
 Requires-Dist: requests-oauthlib>=0.8

{django_esi-8.0.0b1.dist-info → django_esi-8.0.0b2.dist-info}/RECORD

@@ -1,52 +1,53 @@
-esi/__init__.py,sha256=vsNIce83g99LxdSg1jj7tPr0a4Eq2SwB-9SfKADjZUM,204
+esi/__init__.py,sha256=LAZyiO_5dNVnNVqzSKrR9GaxMevoW_XH4GLTr0VO4pQ,204
 esi/admin.py,sha256=9i68WwW_gR0zsGhJKTWK2yMEi44EkhpAaOW0LDpVfM8,1176
 esi/app_settings.py,sha256=2Jp_1myzKCL8A20RYvwQnQd04Ds_CBGsCqwDtsrYf0M,4289
 esi/apps.py,sha256=HIu1niTkOXYmCzMVAjYcaFhHrrXeBbHvui6I44OCHXw,280
 esi/checks.py,sha256=31puQdsrpRUJB-kedp2k7Evo0x2knTWQPZsCUUrJ3dY,1912
-esi/clients.py,sha256=KNFNa5SXFshifap84Q1rCNgZusQ3vmRlePIQG3XICUE,23894
-esi/decorators.py,sha256=2RmPdkrIAwbxOV5Ls8-RIWd_VhmXEDzIG6g5-bs6WZc,9093
+esi/clients.py,sha256=kFEV9T2GcfWRBhEM7njeantRR8g96LsXo6HNWeQCyoQ,25281
+esi/decorators.py,sha256=OGGpbYaVZESk2BA9o69gBoBAdWUEGP1pUKohAEoykiM,10055
 esi/errors.py,sha256=KfFtgX8Mys4uMoQtco0n_pQeaM83yVrRSyW6StXuUjo,308
-esi/exceptions.py,sha256=nR-Z0BXVt5xSkgUL56E97pqtTyEu3MFr8_P0uCCCQ-E,1448
-esi/helpers.py,sha256=pafq8XZ6NAsaOYNqAvgbJ4n0JHCopDtUd3h_HWLcg4c,2206
+esi/exceptions.py,sha256=-6aAr1JNEeOcVcVteDvSPopQkv5kGEj5sjnUlcJWTZQ,1506
+esi/helpers.py,sha256=GZoDNTjZ0adW1ukhuGY1o58s_sZbvjhbVaJS95wZKpg,2207
 esi/managers.py,sha256=zdri1aSJrSX9W_kwzbXq44CAAhdufikoOViaJntA41A,11443
-esi/managers.pyi,sha256=BxRNX2yOT3domdrxsuGp4G0TrP_bWmf8VVwvM03eHQE,1977
+esi/managers.pyi,sha256=3_GxkRNXK3OzvaTrgW31Syhsns1UBKjr669iFKuhxQE,2065
 esi/models.py,sha256=MEY8jmHGwA8ZJjq37h-vC8LnOVn_Mnv5Gw0NoI9tkXk,11484
-esi/openapi_clients.py,sha256=kmijZukB7wICIG5lCEd_3uRha0qAR_sKyHn48V4azts,41127
-esi/rate_limiting.py,sha256=fUzso1YCHlBes8SVrEAsP58eRWcFNuO2XEkW6RQLhUE,2600
+esi/openapi_clients.py,sha256=hMeFzsovT_tC4x8f9a6u4LaUnL2QIKsKZILGlsCAWEg,45525
+esi/rate_limiting.py,sha256=0lbFyRWbw2dPjJLXMEix8PDNh7nuAw8INaGf2cQaFDU,3353
+esi/signals.py,sha256=JQbkrL9l0EbKoB1EgFl8CwFBlZ2GmWBM5HUp3Rc1uYw,512
 esi/stubs.py,sha256=UakysEAq5V454oKbxyEUewncr5sCFZCgwHFh0SJvU3Y,30
 esi/stubs.pyi,sha256=ua9zHzZtrWct1mj_UV1pN7HJyA2RxqWPYapL7DQMRYA,244089
 esi/tasks.py,sha256=TaE_Q03oLk1ohkPw8KknXpIK-nY47C-oaGUUu4nr8pw,2658
 esi/urls.py,sha256=B4EnmT-MZzs4F8a9ORK1ejAHbpGRN_V4TKks8ww3JGE,151
 esi/views.py,sha256=cq2JkqSAwx-Nqi3amRUA9CKLu3ZLQYHSAH8c8g7xIQ4,3917
-esi/aiopenapi3/plugins.py,sha256=jMW82FM-g_aL-RfmB7ip3xmXF1-Evq-euv3KMbEfWds,7898
-esi/locale/cs_CZ/LC_MESSAGES/django.mo,sha256=WyxsjDEeArGMNhtpY2eCJjdENMDmmxdxz4oW1s4N5eA,391
-esi/locale/cs_CZ/LC_MESSAGES/django.po,sha256=mlmqr5WqKZr7AI1AGPYt7W10vfJmvgLddbD16ClX5hQ,1317
-esi/locale/de/LC_MESSAGES/django.mo,sha256=uNJPd25k3AUU6FceBsJV9pqCpM1ZW4wDDFKNZkPlXqg,874
-esi/locale/de/LC_MESSAGES/django.po,sha256=ahUQxXocWCsyE7xj5OpG4iBDeE4cL1Xdm-OQvf7N-Q4,1563
-esi/locale/en/LC_MESSAGES/django.mo,sha256=gtTXjZjZ18WCvehANkW-Uo_YU4dOolu57DYXtWnOZkA,434
-esi/locale/en/LC_MESSAGES/django.po,sha256=CeihWA8VviLtx-x1sS3lr10nNLOyg1wEQZGeBBbyK8g,1364
-esi/locale/es/LC_MESSAGES/django.mo,sha256=XegUUE14RGv9SYxO7FoJjz2jNvG64hA8oOFhqjYZc8g,791
-esi/locale/es/LC_MESSAGES/django.po,sha256=yAF4Kcv9px0utUmAhYuQnaZzS4SDwEA0cax4hOx_e6k,1567
-esi/locale/fr_FR/LC_MESSAGES/django.mo,sha256=FFAiYNUgD1zv056mRf3actNPDDIagu3Bb13EXaAlV94,697
-esi/locale/fr_FR/LC_MESSAGES/django.po,sha256=L4noD0WBE2389Zzo2k5rxUWWhAO5Obm7eyVOOF4TDxY,1576
-esi/locale/it_IT/LC_MESSAGES/django.mo,sha256=SicuHgSlkdIV-Jc9QuR4JaC8QwfycDznJR0yuP9jCoI,931
-esi/locale/it_IT/LC_MESSAGES/django.po,sha256=DNwyc7pZuFXYthb07SIFTRNowLiXhkk1X9OwuKa-MXE,1623
-esi/locale/ja/LC_MESSAGES/django.mo,sha256=0900q-CQ5WT98zWn746YfdOy51uE_nlEbJyxogqxrvc,761
-esi/locale/ja/LC_MESSAGES/django.po,sha256=kpVz2TLwFYGCc1vkCXiMBhLk9LkBypox6oIF0rmGBW8,1536
-esi/locale/ko_KR/LC_MESSAGES/django.mo,sha256=7NktQKVols2D9r8LH0fVmNXtF4L3tmKyAf90IoRhSAY,800
-esi/locale/ko_KR/LC_MESSAGES/django.po,sha256=PQrNrTxw6bTU43KUSNc0okGXes21cSZ3_4MAhBIA1jw,1571
-esi/locale/nl_NL/LC_MESSAGES/django.mo,sha256=WyxsjDEeArGMNhtpY2eCJjdENMDmmxdxz4oW1s4N5eA,391
-esi/locale/nl_NL/LC_MESSAGES/django.po,sha256=mlmqr5WqKZr7AI1AGPYt7W10vfJmvgLddbD16ClX5hQ,1317
-esi/locale/pl_PL/LC_MESSAGES/django.mo,sha256=WyxsjDEeArGMNhtpY2eCJjdENMDmmxdxz4oW1s4N5eA,391
-esi/locale/pl_PL/LC_MESSAGES/django.po,sha256=mlmqr5WqKZr7AI1AGPYt7W10vfJmvgLddbD16ClX5hQ,1317
-esi/locale/ru/LC_MESSAGES/django.mo,sha256=g9515s_BB2pyCJe9-oqPXGEU7vc0EdFoh1SpTUCkGus,1128
-esi/locale/ru/LC_MESSAGES/django.po,sha256=pBczyt5Ri0MD7NB_zCC7FFxFOrTOFIMeN7zMi8b0slM,1878
-esi/locale/sk/LC_MESSAGES/django.mo,sha256=eWUijXSFZNruadb-y-FXso0-1a9lbp6zUPWS2kMoZi4,509
-esi/locale/sk/LC_MESSAGES/django.po,sha256=9QbaP8YZzsA3IJMq9hNprU3DxeQteaTfXZlqKloGYMM,1442
-esi/locale/uk/LC_MESSAGES/django.mo,sha256=LlEo98zaX1whlyZTn_UqXyNOa5rKleqem1XcoKvZ40E,656
-esi/locale/uk/LC_MESSAGES/django.po,sha256=-NCRwISPt1wkk-LQKkCbYupI5ouDVNtRrum_1vqqS3A,1595
-esi/locale/zh_Hans/LC_MESSAGES/django.mo,sha256=O2csJQMFxmvSWM4iNfNozHAQjAAd76LwFy0sx3oLHCY,735
-esi/locale/zh_Hans/LC_MESSAGES/django.po,sha256=vcU0X-11Pj6WJNXcMRR7HaQ-7JcETNgiTFQKru5IL0Y,1511
+esi/aiopenapi3/plugins.py,sha256=YpDn5cRLi6t9dtpnmSHo-Wl6Or4R0LRQY22ZKWLFolk,8269
+esi/locale/cs_CZ/LC_MESSAGES/django.mo,sha256=3a89M28nD3rnPeG3u0p9XZrasew2oDpvg0dRhlwW5l4,391
+esi/locale/cs_CZ/LC_MESSAGES/django.po,sha256=4-C8ELza_J3-ExnfMx1-XD1l6LA01IYxLeKra1FID4A,1317
+esi/locale/de/LC_MESSAGES/django.mo,sha256=a9XLVfAxszxPY0DQegtSG6VJzV5QhdXZH1LdZa8t7Kw,874
+esi/locale/de/LC_MESSAGES/django.po,sha256=QWBbIAxSEPEGZ2y2G3Ox8sw7ye3WrZBG-bigZFS__ZA,1563
+esi/locale/en/LC_MESSAGES/django.mo,sha256=AcLiFv8Ch9eSXQY4XXFJILtnWuMW5xsTc41U7bf02Zw,434
+esi/locale/en/LC_MESSAGES/django.po,sha256=UoFGhStLCb53j8jFDZFj2RPnRzZK31x2If-unnXrUcI,1364
+esi/locale/es/LC_MESSAGES/django.mo,sha256=PUG8ZeipGOVYeOHzwum1CmgPLfOO0T2Fbw0w0XoRMxE,791
+esi/locale/es/LC_MESSAGES/django.po,sha256=2iMKh-JyFqKJzdFWP90qwaG6YZ9PNP-JpeaOEI4gAlM,1567
+esi/locale/fr_FR/LC_MESSAGES/django.mo,sha256=IVLtTvbYL1RSC2TUmQaS8XHqqq-nAieJ7y1iU2K5GEg,697
+esi/locale/fr_FR/LC_MESSAGES/django.po,sha256=zohifdzM0Id0eD-tDsAUfSv6ivhlIR09IqjlUhQPZU0,1576
+esi/locale/it_IT/LC_MESSAGES/django.mo,sha256=74zINJDrN03tah_3hs5OxtrqOwGGCQqJHj0Q_fdZkRg,931
+esi/locale/it_IT/LC_MESSAGES/django.po,sha256=k-SUOUQUWoIVzZjQDPJZPDnyHznBVDsv__OAy9-qFgc,1623
+esi/locale/ja/LC_MESSAGES/django.mo,sha256=3UhDTEtBm6XdY_NBtNGwpoKQvzgPJVc-E4bBST4LuXg,761
+esi/locale/ja/LC_MESSAGES/django.po,sha256=zWf0y38JbzlVVaENvK16emzSlFGdTwM2b9ap4NOWsE8,1536
+esi/locale/ko_KR/LC_MESSAGES/django.mo,sha256=wUhdQt0lbIhzilvTIF2u2CLqx25IUQIs_I2dok5ldT0,800
+esi/locale/ko_KR/LC_MESSAGES/django.po,sha256=YPTvyMEmJPdvCwPuJYZb0hU4-LEoF9Cd_gLt8J4SA1s,1571
+esi/locale/nl_NL/LC_MESSAGES/django.mo,sha256=3a89M28nD3rnPeG3u0p9XZrasew2oDpvg0dRhlwW5l4,391
+esi/locale/nl_NL/LC_MESSAGES/django.po,sha256=4-C8ELza_J3-ExnfMx1-XD1l6LA01IYxLeKra1FID4A,1317
+esi/locale/pl_PL/LC_MESSAGES/django.mo,sha256=3a89M28nD3rnPeG3u0p9XZrasew2oDpvg0dRhlwW5l4,391
+esi/locale/pl_PL/LC_MESSAGES/django.po,sha256=4-C8ELza_J3-ExnfMx1-XD1l6LA01IYxLeKra1FID4A,1317
+esi/locale/ru/LC_MESSAGES/django.mo,sha256=fpU4q7cD7UUd7EXqxSkRinujmqaHw56mJilBeA-6JlU,1128
+esi/locale/ru/LC_MESSAGES/django.po,sha256=1UrIOg2Ff4IaKnApdXULs__XcgRHYC0-I7R4qxNdC_A,1878
+esi/locale/sk/LC_MESSAGES/django.mo,sha256=U1ACkWEmbwABZ7SoLiRyE7a2exXUoezT-F3mwIJ2se0,509
+esi/locale/sk/LC_MESSAGES/django.po,sha256=g3DYCmxk_L7Q8V_BHgcAdQp4Ct5e6hPlrUiTDakNwO0,1442
+esi/locale/uk/LC_MESSAGES/django.mo,sha256=M94bI7wiqPEHODk0MiuXvcvwkHsbJjml-JNtXKwBw5Q,656
+esi/locale/uk/LC_MESSAGES/django.po,sha256=1ylXyZuZZx6ZNdLVfvm7mROkjs9VqUYpgK5m_4qR948,1595
+esi/locale/zh_Hans/LC_MESSAGES/django.mo,sha256=P-oIXYliRFn9qWM1cBbBbkg0bnLN_pKTfHLiwlPN2xw,735
+esi/locale/zh_Hans/LC_MESSAGES/django.po,sha256=AN10U8DZ0LsIN8_TmVHDXbgZM34nGmZ3ouM-55OVyi8,1511
 esi/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 esi/management/commands/generate_esi_stubs.py,sha256=dunWHFSRb6NFu5emeDdskqIt3YqnEqQLBiuNERMkdmE,9798
 esi/management/commands/migrate_to_ssov2.py,sha256=x9W4xaefrNoG_dNscHIWrWTRk4SuVGIW0s44q2QBN9k,6427
@@ -71,7 +72,7 @@ esi/static/esi/img/EVE_SSO_Login_Buttons_Small_White.png,sha256=al3NRjIngZtrNzEx
 esi/templates/esi/select_token.html,sha256=qofOjKWHco_sSuoEJoLRsXP_doK_barHvkF7h5LLxjY,6941
 esi/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 esi/templatetags/scope_tags.py,sha256=5-7vEwe-B91xo7oSnn-tSuudHSJCoGIhbddDpNrqUnw,167
-esi/tests/__init__.py,sha256=SWXR4QgKWg_ZdwOG4vJoRKcd8zQ11dz3z2-Oifdq5kA,3091
+esi/tests/__init__.py,sha256=yecRpeG9tsVnyeKm6jEo2QcO2QeYJF_vOT5ACzfNSec,3704
 esi/tests/client_authed_pilot.py,sha256=GN0J59TcscHM9HZH6OaPODM9Zel3mvObjJ4Dmmzc2j8,1622
 esi/tests/client_public_pilot.py,sha256=u6P-qbdYSvQ6A_MJqt8Jrkswt-u-FlvYDKtCvA5-PMo,1252
 esi/tests/factories.py,sha256=2pjkSYKDfO50bzX1nNcUHz_FAAJs7k07u7R8om6AlP0,1375
@@ -79,19 +80,19 @@ esi/tests/factories_2.py,sha256=25NqVe9zzHkl4U1EN3R7pjdN2ahIBXxrrJhQzZhvw58,1972
 esi/tests/jwt_factory.py,sha256=0Jj9TjEv18h2XVsRpYc7BWHr3CPtQJgfKeB-9mdHevk,4919
 esi/tests/test_checks.py,sha256=ntq2ijuJ-6pxGruNh21rM4GlXDLVm-o3sy8DrFbjwEM,1846
 esi/tests/test_clients.py,sha256=qoiv3OztuhjizNknZplJhwnMzAlX689MGad4Azu809M,44163
-esi/tests/test_decorators.py,sha256=I5MhcLKhN5xD4PxgEQqOWQ2kiXquDqQIEve9dbTOsho,15069
+esi/tests/test_decorators.py,sha256=XvnubUR7ue3tG2chc2rSMw737tCN6r7SYxf-V8KJED8,16595
 esi/tests/test_management_command.py,sha256=mtxfBtG6CHP1bTy1tJEO-djX4SQwMT3T_mqGnUIM6qs,9863
 esi/tests/test_managers.py,sha256=CEpjXSXyVY6xxgrs0f9FnEh-KY9JPaKjKYiutXLLShE,24309
 esi/tests/test_models.py,sha256=lDj5IcYgXHeOFTHXTsWGg13CSooFaxD0c51kJn_ytAc,13748
-esi/tests/test_openapi.json,sha256=rGvX02M_LmMoWRTVZZ7NkGzc3-lQy7-2WQCrt6DlqM0,11828
-esi/tests/test_openapi.py,sha256=VCDbEENoHZbrNJiLzSTvjIkMNR3huAl3522v5XJ3XRg,12445
+esi/tests/test_openapi.json,sha256=3jGT9Vo75wEOqJY1Iy4_uJSJfEs8iwSv107fIsspWM8,13901
+esi/tests/test_openapi.py,sha256=XERYRw-cFbb2XCuW28AEybsTcT-_up9wEumcL57Nexw,22837
 esi/tests/test_swagger.json,sha256=HOrPgbvwm5N521QNcE3baWcZJkSjmuN_VWrR06wEQoo,17241
 esi/tests/test_swagger_full.json,sha256=JCEAZNMFhkdZhquTx4lDhrqGgCrzzzlYU64HdbEv8E4,2548369
 esi/tests/test_tasks.py,sha256=nIvfXax_8nQCxNQeT-4TJ84i0__t1qWe155z5rnsktQ,4399
 esi/tests/test_templatetags.py,sha256=b68JWE3HvOlr2aUisJHsTsDS4e7IMjDeqTuzMqC7Re4,517
 esi/tests/test_views.py,sha256=Kj_f2yIpmPG0kx-lAX_sfkaHlIpgbkm02ieA1V3o-k4,13073
 esi/tests/threading_pilot.py,sha256=ax_dEdnTNibA-UQHqbZle_2dh_3jcHKRyrYSOKuE_6U,1931
-django_esi-8.0.0b1.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-django_esi-8.0.0b1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-django_esi-8.0.0b1.dist-info/METADATA,sha256=jGWQujfVYTjC6wNdXUx6toYBwn5jV0QisqQuUJC9-QY,4789
-django_esi-8.0.0b1.dist-info/RECORD,,
+django_esi-8.0.0b2.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+django_esi-8.0.0b2.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+django_esi-8.0.0b2.dist-info/METADATA,sha256=JYa14wSYhfIBFbXE5gInFnIMEcJf2b2_21NQUQc0dq4,4815
+django_esi-8.0.0b2.dist-info/RECORD,,

esi/__init__.py

@@ -1,6 +1,6 @@
 """Django app for accessing the EVE Swagger Interface (ESI)."""
 
-__version__ = "8.0.0-beta.1"
+__version__ = "8.0.0-beta.2"
 __title__ = 'Django-ESI'
 __url__ = 'https://gitlab.com/allianceauth/django-esi'
 __build_date__ = "2025-09-18"

esi/aiopenapi3/plugins.py

@@ -1,6 +1,9 @@
 import logging
 from typing import Any
+
 from collections.abc import Generator
+from django.conf import settings
+
 from aiopenapi3.plugin import Document, Init
 
 logger = logging.getLogger(__name__)
@@ -54,9 +57,16 @@ class MinifySpec(Document):
         self.keep_ops = operations
 
     def parsed(self, ctx: Document.Context) -> Document.Context:
-        if self.keep_tags == set() and self.keep_ops == []:
-            logger.error("No tag/path filtering supplied to ESI Client. Using all tags. This will bloat memory use!")
+
+        if len(self.keep_tags) == 0 and self.keep_ops == []:
+            logger.error("No tag/path filtering supplied to ESI Client. Using all tags. This throw an error with `DEBUG=False`!", stack_info=True)
+            if not getattr(settings, "DEBUG", False):
+                # we are in production mode throw error to protect RAM.
+                raise AttributeError("No tag/path filtering supplied to ESI Client.")
+            # We are in debug mode allow an unfiltered client.
             return ctx
+
+        # filter the client.
         spec = ctx.document
 
         remove_paths = set()

esi/clients.py

@@ -1,5 +1,6 @@
 import json
 import logging
+from timeit import default_timer
 import warnings
 import datetime as dt
 from hashlib import md5
@@ -10,7 +11,7 @@ from urllib import parse as urlparse
 from bravado import requests_client
 from bravado.client import SwaggerClient
 from bravado.exception import (
-    HTTPBadGateway, HTTPGatewayTimeout, HTTPServiceUnavailable,
+    HTTPBadGateway, HTTPGatewayTimeout, HTTPServiceUnavailable, HTTPError,
 )
 from bravado.http_future import HttpFuture
 from bravado.swagger_model import Loader
@@ -22,6 +23,7 @@ from django.core.cache import cache
 
 from . import __title__, __url__, __version__, app_settings
 from .errors import TokenExpiredError
+from .signals import esi_request_statistics
 
 logger = logging.getLogger(__name__)
 
@@ -144,6 +146,19 @@ class CachingHttpFuture(HttpFuture):
             for language in my_languages
         }
 
+    def _send_signal(self, status_code: int, headers: dict = {}, latency: float = 0) -> None:
+        """
+            Dispatch the esi request statistics signal
+        """
+        esi_request_statistics.send(
+            sender=self.__class__,
+            operation=self.operation.path_name,
+            status_code=status_code,
+            headers=headers,
+            latency=latency,
+            bucket=""
+        )
+
     def result(self, **kwargs) -> Any | tuple[Any, IncomingResponse]:
         """Executes the request and returns the response from ESI. Response will
         include the requested / first page only if there are more pages available.
@@ -191,6 +206,9 @@ class CachingHttpFuture(HttpFuture):
                 )
 
             if cached:
+                self._send_signal(
+                    status_code=0
+                )
                 result, response = cached
                 expiry = self._time_to_expiry(str(response.headers.get('Expires')))
                 if expiry < 0:
@@ -245,6 +263,7 @@ class CachingHttpFuture(HttpFuture):
 
         retries = 0
         while retries <= max_retries:
+            _t = default_timer()
             try:
                 if app_settings.ESI_INFO_LOGGING_ENABLED:
                     params = self.future.request.params
@@ -269,6 +288,11 @@ class CachingHttpFuture(HttpFuture):
                     logger.debug('ESI response content: %s', response.text)
                 break
             except (HTTPBadGateway, HTTPGatewayTimeout, HTTPServiceUnavailable) as ex:
+                self._send_signal(
+                    status_code=ex.status_code,
+                    headers=ex.response.headers,
+                    latency=default_timer() - _t
+                )
                 if retries < max_retries:
                     retries += 1
                     logger.warning(
@@ -285,7 +309,23 @@ class CachingHttpFuture(HttpFuture):
                     sleep(wait_secs)
                 else:
                     raise ex
+            except HTTPError as ex:
+                """
+                    Throw any other error into the signal
+                    then just re-raise
+                """
+                self._send_signal(
+                    status_code=ex.status_code,
+                    headers=ex.response.headers,
+                    latency=default_timer() - _t
+                )
+                raise ex
 
+        self._send_signal(
+            status_code=response.status_code,
+            headers=response.headers,
+            latency=default_timer() - _t
+        )
         # restore original value
         self.request_config.also_return_response = _also_return_response
         return result, response

esi/decorators.py

@@ -1,7 +1,8 @@
-import functools
 import logging
 import time
 from functools import wraps
+from typing import Any
+from collections.abc import Callable
 
 from django.core.cache import cache
 
@@ -227,12 +228,20 @@ def single_use_token(scopes='', new=False):
     return decorator
 
 
-def wait_for_esi_errorlimit_reset(cache_key="esi_error_limit_reset", poll_interval=1):
+def wait_for_esi_errorlimit_reset(cache_key="esi_error_limit_reset", poll_interval=1) -> Callable[..., Callable[..., Any]]:
+    """
+    Decorator to apply a polling sleep while the ESI Server/Client is in an Error Limit state
+    The preferred non-blocking method is to retry your tasks after the limit reset time has passed
+
+    Args:
+        cache_key (str, optional):  NOT USUALLY CHANGED. Defaults to "esi_error_limit_reset".
+        poll_interval (int, optional): Interval in seconds to poll redis. Defaults to 1.
+    """
     def decorator(func):
         def wrapper(*args, **kwargs):
             reset = cache.get(cache_key)
             if reset is not None:
-                print(f"ESI Error Limited, waiting {reset}s before retrying...")
+                logger.error(f"ESI Error Limited, waiting {reset}s before retrying...")
                 while cache.get(cache_key):
                     time.sleep(poll_interval)
             return func(*args, **kwargs)
@@ -240,16 +249,23 @@ def wait_for_esi_errorlimit_reset(cache_key="esi_error_limit_reset", poll_interv
     return decorator
 
 
-def esi_rate_limiter_bucketed(
-    bucket: ESIRateLimitBucket,
-    raise_on_limit: bool = True,
-):
-    # TODO Investigate esi cache hits.
+def esi_rate_limiter_bucketed(bucket: ESIRateLimitBucket, raise_on_limit: bool = True):
+    """
+    Decorator for custom manual rate limits on some endpoints to apply a polling sleep while the bucket is exhausted.
+    MARKET_DATA_HISTORY
+    CHARACTER_CORPORATION_HISTORY
+    The preferred non-blocking method is to retry your tasks after the limit reset time has passed
+
 
+    Args:
+        bucket (ESIRateLimitBucket): The Bucket to rate limit against
+        raise_on_limit (bool, optional): Whether to raise an Exception when the limit is reached. Defaults to True.
+    """
+    # TODO Investigate esi cache hits.
     def decorator(func):
-        @functools.wraps(func)
+        @wraps(func)
         def wrapper(*args, **kwargs):
-            ESIRateLimits.check_bucket(bucket, raise_on_limit)
+            ESIRateLimits.check_decr_bucket(bucket, raise_on_limit)
             return func(*args, **kwargs)
         return wrapper
     return decorator

esi/exceptions.py

@@ -4,10 +4,12 @@ from aiopenapi3.errors import HTTPServerError as base_HTTPServerError
 from aiopenapi3.errors import HTTPClientError as base_HTTPClientError
 from aiopenapi3.errors import HTTPError
 
+
 class ESIErrorLimitException(Exception):
     """ESI Global Error Limit Exceeded
     https://developers.eveonline.com/docs/services/esi/best-practices/#error-limit
     """
+
     def __init__(self, reset=None, *args, **kwargs) -> None:
         self.reset = reset
         msg = kwargs.get("message") or (
@@ -18,8 +20,10 @@ class ESIErrorLimitException(Exception):
 
 class ESIBucketLimitException(Exception):
     """Endpoint (Bucket) Specific Rate Limit Exceeded"""
-    def __init__(self, bucket, *args, **kwargs) -> None:
+
+    def __init__(self, bucket, reset: float = 0, *args, **kwargs) -> None:
         self.bucket = bucket
+        self.reset = reset
         msg = kwargs.get("message") or f"ESI bucket limit reached for {bucket}."
         super().__init__(msg, *args)
 
@@ -37,11 +41,11 @@ class HTTPNotModified(HTTPError):
 
 @dataclasses.dataclass(repr=False)
 class HTTPClientError(base_HTTPClientError):
-    """response code 4xx"""
+    """HTTP Response Code 4xx"""
     pass
 
 
 @dataclasses.dataclass(repr=False)
 class HTTPServerError(base_HTTPServerError):
-    """response code 5xx"""
+    """HTTP Response Code 5xx"""
     pass

esi/helpers.py

@@ -25,6 +25,7 @@ def get_token(character_id: int, scopes: list) -> Token:
         )
     return token
 
+
 def pascal_case_string(string: str) -> str:
     """
     Convert a string to PascalCase by capitalizing the first letter of each word and removing spaces,

esi/locale/cs_CZ/LC_MESSAGES/django.po

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"

esi/locale/de/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: Peter Pfeufer, 2023\n"
 "Language-Team: German (https://app.transifex.com/alliance-auth/teams/107430/"

esi/locale/en/LC_MESSAGES/django.po

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"

esi/locale/es/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: trenus, 2023\n"
 "Language-Team: Spanish (https://app.transifex.com/alliance-auth/teams/107430/"

esi/locale/fr_FR/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2020-12-28 06:44+0000\n"
 "Last-Translator: rockclodbuster, 2023\n"
 "Language-Team: French (France) (https://app.transifex.com/alliance-auth/"

esi/locale/it_IT/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: Thomas Turini, 2024\n"
 "Language-Team: Italian (Italy) (https://app.transifex.com/alliance-auth/"

esi/locale/ja/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: kotaneko, 2023\n"
 "Language-Team: Japanese (https://app.transifex.com/alliance-auth/"

esi/locale/ko_KR/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: Seowon Jung <seowon@hawaii.edu>, 2023\n"
 "Language-Team: Korean (Korea) (https://app.transifex.com/alliance-auth/"

esi/locale/nl_NL/LC_MESSAGES/django.po

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"

esi/locale/pl_PL/LC_MESSAGES/django.po

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"

esi/locale/ru/LC_MESSAGES/django.po

@@ -10,9 +10,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: Gnevich <and.vareba81@gmail.com>, 2025\n"
 "Language-Team: Russian (https://app.transifex.com/alliance-auth/teams/107430/"

esi/locale/sk/LC_MESSAGES/django.po

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"

esi/locale/uk/LC_MESSAGES/django.po

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"

esi/locale/zh_Hans/LC_MESSAGES/django.po

@@ -9,9 +9,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Django ESI 8.0.0-beta.1\n"
+"Project-Id-Version: Django ESI 8.0.0-beta.2\n"
 "Report-Msgid-Bugs-To: https://gitlab.com/allianceauth/django-esi/-/issues\n"
-"POT-Creation-Date: 2025-10-17 15:19+1000\n"
+"POT-Creation-Date: 2025-10-31 15:18+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
 "Last-Translator: heguyChen, 2023\n"
 "Language-Team: Chinese Simplified (https://app.transifex.com/alliance-auth/"

esi/managers.pyi

@@ -54,6 +54,9 @@ class TokenManager(Manager[Token]):
     def get_queryset(self) -> "TokenQueryset":
         ...
 
+    def require_scopes(self, scope_string: str | list) -> "TokenQueryset":
+        ...
+
     def filter(self, *args: Any, **kwargs: Any) -> "TokenQueryset":
         ...