django-esi 8.0.0a2__py3-none-any.whl → 8.0.0a3__py3-none-any.whl

{django_esi-8.0.0a2.dist-info → django_esi-8.0.0a3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-esi
-Version: 8.0.0a2
+Version: 8.0.0a3
 Summary: Django app for accessing the EVE Swagger Interface (ESI).
 Keywords: eveonline
 Author-email: Alliance Auth <adarnof@gmail.com>

{django_esi-8.0.0a2.dist-info → django_esi-8.0.0a3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-esi/__init__.py,sha256=x_GMW2iG9w-jeVStEapSJo_3MzGJm8XDnCJ6cTscRq4,199
+esi/__init__.py,sha256=h7UNGlHMW_Mr3hZ1uc6-nP6J4YJU0GnnNvq1WRgx1Eo,199
 esi/admin.py,sha256=9i68WwW_gR0zsGhJKTWK2yMEi44EkhpAaOW0LDpVfM8,1176
 esi/app_settings.py,sha256=2Jp_1myzKCL8A20RYvwQnQd04Ds_CBGsCqwDtsrYf0M,4289
 esi/apps.py,sha256=HIu1niTkOXYmCzMVAjYcaFhHrrXeBbHvui6I44OCHXw,280
@@ -6,23 +6,23 @@ esi/checks.py,sha256=31puQdsrpRUJB-kedp2k7Evo0x2knTWQPZsCUUrJ3dY,1912
 esi/clients.py,sha256=WB5YseJnfZdTeJ9C1Eze-iWXEqIpo5i_8uiQ6w0VkCw,23503
 esi/decorators.py,sha256=2RmPdkrIAwbxOV5Ls8-RIWd_VhmXEDzIG6g5-bs6WZc,9093
 esi/errors.py,sha256=KfFtgX8Mys4uMoQtco0n_pQeaM83yVrRSyW6StXuUjo,308
-esi/exceptions.py,sha256=Zf2cPFFbIYL90sYVtGeZXmna2n_3VyLdVApa5BRUvKc,747
+esi/exceptions.py,sha256=nR-Z0BXVt5xSkgUL56E97pqtTyEu3MFr8_P0uCCCQ-E,1448
 esi/helpers.py,sha256=-lYojtcWYWtlC_olSItWR3O3zJpjMYTQpNvsax81us8,672
 esi/managers.py,sha256=zdri1aSJrSX9W_kwzbXq44CAAhdufikoOViaJntA41A,11443
 esi/managers.pyi,sha256=BxRNX2yOT3domdrxsuGp4G0TrP_bWmf8VVwvM03eHQE,1977
 esi/models.py,sha256=v33dvnWoiDwhcwc5Y4CvNOtAJocNd2qh5JtyNTtu-P8,11483
-esi/openapi_clients.py,sha256=l7XVB9cXiW04aG18Knb_gsCmQP20TghpyDPuyjUzr1Y,34385
+esi/openapi_clients.py,sha256=ORYRPjW4pqmmMFmaK6oiIHsCpVlLL-s7LTKcXA3xhSM,36874
 esi/rate_limiting.py,sha256=fUzso1YCHlBes8SVrEAsP58eRWcFNuO2XEkW6RQLhUE,2600
 esi/stubs.py,sha256=UakysEAq5V454oKbxyEUewncr5sCFZCgwHFh0SJvU3Y,30
-esi/stubs.pyi,sha256=wT1aqp4eATKrReFupxmTz4wpvHNBQ0TpCJ-_zf2TjJg,231643
+esi/stubs.pyi,sha256=rmWy-cM_qcZyEIAQcAbNJ2jMtgPU4Ai-SOncFmuBHSA,233649
 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=hHvWA_Sil5VTR1KLyF8dPSppx4g-daY9cj0kUSUZKxc,3914
+esi/aiopenapi3/plugins.py,sha256=1JGDhsca2vO_R_J5Gi4b5_lK0VDQ_AoyMHHyvzYoLrM,4673
 esi/locale/de/LC_MESSAGES/django.mo,sha256=9_Fc_R8oZpT_CojH8gBxdSqj2K84EMEMn4wkvmOr7Dg,820
 esi/locale/de/LC_MESSAGES/django.po,sha256=2NQVGYzLroHPPrWgmACSnb2d3nwlkMBLxA1uWU3K0FA,1503
 esi/locale/en/LC_MESSAGES/django.mo,sha256=N1pb17IfLd0ASiKO8d68-B4ygSpDkhKOCs8YTzMXQo0,380
-esi/locale/en/LC_MESSAGES/django.po,sha256=-y3WrC0mq4OoKp_xwmBqOaoPwEQA_P09J7Mgm1TKTRs,1305
+esi/locale/en/LC_MESSAGES/django.po,sha256=Ex11J8RaZM4KuP8xGtRi-TrSSAG05jU-KiemYeG84yc,1305
 esi/locale/es/LC_MESSAGES/django.mo,sha256=dtCivRk6vD0mT2Wx9kcBRtMhU41bdqERHkBYPLoI5qg,737
 esi/locale/es/LC_MESSAGES/django.po,sha256=KvCk4FLdPl_SMEcEWL6KAr870ScmsL5jnyCJvpglOB4,1504
 esi/locale/fr_FR/LC_MESSAGES/django.mo,sha256=CG7EL6JGYoSVaAggmIvwerXuzf55b6VWmcOSK_1okik,643
@@ -34,7 +34,7 @@ esi/locale/ja/LC_MESSAGES/django.po,sha256=uWDpo_f8YyTn6VIH1S87PbGvQnsCiKe_i9LYm
 esi/locale/ko_KR/LC_MESSAGES/django.mo,sha256=-GXsBq-bhlghnrxsuNfS2rirCJn9sPQi1whTvRCvGV4,746
 esi/locale/ko_KR/LC_MESSAGES/django.po,sha256=gjPHlrraWxVBS-H4n88y-5a2n7PbwvwZzeaZdP5aquc,1511
 esi/locale/ru/LC_MESSAGES/django.mo,sha256=WbKkLTav0kXvfTadQ6fccwh0T7iI_1wmPVu_LjQaYMo,915
-esi/locale/ru/LC_MESSAGES/django.po,sha256=_pMs3mMOGMiHGpk27p8ykllpGnw20l5sSDg-N27RNDY,1703
+esi/locale/ru/LC_MESSAGES/django.po,sha256=zQm-QOcIIu3vfU60bG2zFXv1sstsEV39EcN0VJErHrs,1812
 esi/locale/zh_Hans/LC_MESSAGES/django.mo,sha256=hPSO7wlU9cN8f32Qo1Dztq6AHUm2hZfL1hHIDW1R1F4,681
 esi/locale/zh_Hans/LC_MESSAGES/django.po,sha256=fZhif8jOUvY22xurl7eBYsHNKoqf7obtkW5L3894hk4,1451
 esi/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -73,13 +73,14 @@ esi/tests/test_decorators.py,sha256=I5MhcLKhN5xD4PxgEQqOWQ2kiXquDqQIEve9dbTOsho,
 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.py,sha256=UJB6g8Olpb71OenLmuoQEok4RNWo2F3-37wL-HtV-RI,459
 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.0a2.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-django_esi-8.0.0a2.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-django_esi-8.0.0a2.dist-info/METADATA,sha256=nYKhXDNlrzlcplbMUL_eWoZcHQZ3B-oT4S1pgs8elAM,4738
-django_esi-8.0.0a2.dist-info/RECORD,,
+django_esi-8.0.0a3.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+django_esi-8.0.0a3.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+django_esi-8.0.0a3.dist-info/METADATA,sha256=Q_uxmC2AihrvgYtxiVATgX0MFhM3bmrAk81axnHUyP4,4738
+django_esi-8.0.0a3.dist-info/RECORD,,

esi/__init__.py

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

esi/aiopenapi3/plugins.py

@@ -19,6 +19,27 @@ class Trim204ContentType(Document):
         return ctx
 
 
+class Add304ContentType(Document):
+    """
+    Adds 304 content-type to responses
+    A 304 never has content. ESI defualt has application/json
+    This is a hack for now
+    """
+    def parsed(self, ctx: Document.Context) -> Document.Context:
+        spec = ctx.document
+        # Patch all paths
+        for path_item in spec.get("paths", {}).values():
+            for method_name in ("get", "post", "put", "delete", "patch", "options", "head"):
+                method = path_item.get(method_name)
+                if not method:
+                    continue
+                if "304" not in method['responses']:
+                    method['responses']["304"]={
+                        "description": "Not Modified"
+                    }
+        return ctx
+
+
 class RemoveSecurityParameter(Document):
     """
     Removes the whole OAuth2 securityScheme

esi/exceptions.py

@@ -1,3 +1,9 @@
+import dataclasses
+
+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
@@ -16,3 +22,26 @@ class ESIBucketLimitException(Exception):
         self.bucket = bucket
         msg = kwargs.get("message") or f"ESI bucket limit reached for {bucket}."
         super().__init__(msg, *args)
+
+
+@dataclasses.dataclass(repr=False)
+class HTTPNotModified(HTTPError):
+    """The HTTP Status is 304"""
+
+    status_code: int
+    headers: dict[str, str]
+
+    def __str__(self):
+        return f"""<{self.__class__.__name__} {self.status_code} {self.headers}>"""
+
+
+@dataclasses.dataclass(repr=False)
+class HTTPClientError(base_HTTPClientError):
+    """response code 4xx"""
+    pass
+
+
+@dataclasses.dataclass(repr=False)
+class HTTPServerError(base_HTTPServerError):
+    """response code 5xx"""
+    pass

esi/locale/en/LC_MESSAGES/django.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-06-30 10:57+1000\n"
+"POT-Creation-Date: 2025-09-04 13:41+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"
@@ -18,11 +18,11 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: esi/models.py:73
+#: esi/models.py:66
 msgid "Character"
 msgstr ""
 
-#: esi/models.py:74
+#: esi/models.py:67
 msgid "Corporation"
 msgstr ""
 

esi/locale/ru/LC_MESSAGES/django.po

@@ -5,15 +5,16 @@
 # 
 # Translators:
 # Filipp Chertiev <f@fzfx.ru>, 2023
+# Gnevich <and.vareba81@gmail.com>, 2025
 # 
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-10-08 23:42+1000\n"
+"POT-Creation-Date: 2025-06-30 10:57+1000\n"
 "PO-Revision-Date: 2023-10-25 11:04+0000\n"
-"Last-Translator: Filipp Chertiev <f@fzfx.ru>, 2023\n"
+"Last-Translator: Gnevich <and.vareba81@gmail.com>, 2025\n"
 "Language-Team: Russian (https://app.transifex.com/alliance-auth/teams/107430/ru/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -21,13 +22,13 @@ msgstr ""
 "Language: ru\n"
 "Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n"
 
-#: esi/models.py:72
+#: esi/models.py:73
 msgid "Character"
-msgstr ""
+msgstr "Персонаж"
 
-#: esi/models.py:73
+#: esi/models.py:74
 msgid "Corporation"
-msgstr ""
+msgstr "Корпорация"
 
 #: esi/templates/esi/select_token.html:13
 msgid "ESI Token Selection"
@@ -49,7 +50,7 @@ msgstr "Новый персонаж"
 #: esi/templates/esi/select_token.html:71
 #: esi/templates/esi/select_token.html:107
 msgid "Add Token"
-msgstr ""
+msgstr "Добавить токен"
 
 #: esi/templates/esi/select_token.html:88
 #: esi/templates/esi/select_token.html:89

esi/openapi_clients.py

@@ -1,11 +1,13 @@
 import logging
 import warnings
-from datetime import datetime
+from datetime import datetime, date
 from hashlib import md5
 from typing import Any
 
 from aiopenapi3 import OpenAPI
 from aiopenapi3._types import ResponseDataType, ResponseHeadersType
+from aiopenapi3.errors import HTTPServerError as base_HTTPServerError
+from aiopenapi3.errors import HTTPClientError as base_HTTPClientError
 from aiopenapi3.request import OperationIndex, RequestBase
 from httpx import (
     AsyncClient, Client, HTTPStatusError, RequestError, Response, Timeout,
@@ -18,7 +20,8 @@ from tenacity import (
 from django.core.cache import cache
 
 from esi import app_settings
-from esi.aiopenapi3.plugins import PatchCompatibilityDatePlugin, Trim204ContentType
+from esi.exceptions import HTTPClientError, HTTPServerError, HTTPNotModified
+from esi.aiopenapi3.plugins import Add304ContentType, PatchCompatibilityDatePlugin, Trim204ContentType
 from esi.exceptions import ESIErrorLimitException
 from esi.models import Token
 from esi.stubs import ESIClientStub
@@ -121,14 +124,14 @@ def _load_aiopenapi_client_sync(
             path=spec_file,
             session_factory=session_factory,
             use_operation_tags=True,
-            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType()]
+            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType(), Add304ContentType()]
         )
     else:
         return OpenAPI.load_sync(
             url=spec_url,
             session_factory=session_factory,
             use_operation_tags=True,
-            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType()]
+            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType(), Add304ContentType()]
         )
 
 
@@ -176,14 +179,14 @@ async def _load_aiopenapi_client_async(
             path=spec_file,
             session_factory=session_factory,
             use_operation_tags=True,
-            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType()]
+            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType(), Add304ContentType()]
         )
     else:
         return await OpenAPI.load_async(
             url=spec_url,
             session_factory=session_factory,
             use_operation_tags=True,
-            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType()]
+            plugins=[PatchCompatibilityDatePlugin(), Trim204ContentType(), Add304ContentType()]
         )
 
 
@@ -322,7 +325,12 @@ class BaseEsiOperation():
         Returns:
             str: Key name
         """
-        data = (self.method + self.url + str(self._args) + str(self._kwargs)).encode('utf-8')
+        # ignore the token this will break the cache
+        ignore_keys = [
+            "token",
+        ]
+        _kwargs = { key:value for key, value in self._kwargs.items() if key not in ignore_keys }
+        data = (self.method + self.url + str(self._args) + str(_kwargs)).encode('utf-8')
         str_hash = md5(data).hexdigest()  # nosec B303
         return f'esi_{str_hash}'
 
@@ -360,7 +368,7 @@ class BaseEsiOperation():
         """
         return any(p.name == "before" or p.name == "after" for p in self.operation.parameters)
 
-    def _get_cache(self, cache_key: str) -> tuple[ResponseHeadersType | None, Any, Response | None]:
+    def _get_cache(self, cache_key: str, etag: str) -> tuple[ResponseHeadersType | None, Any, Response | None]:
         """Retrieve cached response and validate expiry
         Args:
             cache_key (str): The cache key to retrieve
@@ -376,12 +384,23 @@ class BaseEsiOperation():
 
         if cached_response:
             logger.debug(f"Cache Hit {self.url}")
-            headers, data = self.parse_cached_request(cached_response)
+            expiry = _time_to_expiry(str(cached_response.headers.get('Expires')))
 
-            expiry = _time_to_expiry(str(headers.get('Expires')))
+            # force check to ensure cache isn't expired
             if expiry < 0:
                 logger.warning("Cache expired by %d seconds, forcing expiry", expiry)
                 return None, None, None
+
+            # check if etag is same before building models from cache
+            if etag:
+                if cached_response.headers.get('Expires') == etag:
+                    raise HTTPNotModified(
+                        status_code=304,
+                        headers=cached_response.headers
+                    )
+
+            # build models
+            headers, data = self.parse_cached_request(cached_response)
             return headers, data, cached_response
 
         return None, None, None
@@ -485,7 +504,7 @@ class EsiOperation(BaseEsiOperation):
         if not etag and app_settings.ESI_CACHE_RESPONSE:
             etag = cache.get(etag_key)
 
-        headers, data, response = self._get_cache(cache_key)
+        headers, data, response = self._get_cache(cache_key, etag=etag) if use_cache else (None, None, None)
 
         if response and use_cache:
             expiry = _time_to_expiry(str(headers.get('Expires')))
@@ -499,17 +518,41 @@ class EsiOperation(BaseEsiOperation):
 
         if not response:
             logger.debug(f"Cache Miss {self.url}")
-            headers, data, response = self._make_request(parameters, etag)
-            if response.status_code == 420:
-                reset = response.headers.get("X-RateLimit-Reset", None)
-                cache.set("esi_error_limit_reset", reset, timeout=reset)
-                raise ESIErrorLimitException(reset=reset)
-            # if response.status_code == 304 and app_settings.ESI_CACHE_RESPONSE:
-            #     cached = cache.get(cache_key)
-            #     if cached:
-            #         return (cached, response) if return_response else cached
-            # we dont want to do this, if we do this we have to store data longer than ttl. rip ram
-            self._store_cache(cache_key, response)
+            try:
+                headers, data, response = self._make_request(parameters, etag)
+                if response.status_code == 420:
+                    reset = response.headers.get("X-RateLimit-Reset", None)
+                    cache.set("esi_error_limit_reset", reset, timeout=reset)
+                    raise ESIErrorLimitException(reset=reset)
+                self._store_cache(cache_key, response)
+
+                # if response.status_code == 304 and app_settings.ESI_CACHE_RESPONSE:
+                #     cached = cache.get(cache_key)
+                #     if cached:
+                #         return (cached, response) if return_response else cached
+                # we dont want to do this, if we do this we have to store data longer than ttl. rip ram
+
+            # Shim our exceptions into Django-ESI
+            except base_HTTPServerError as e:
+                raise HTTPServerError(
+                    status_code=e.status_code,
+                    headers=e.headers,
+                    data=e.data
+                )
+
+            except base_HTTPClientError as e:
+                raise HTTPClientError(
+                    status_code=e.status_code,
+                    headers=e.headers,
+                    data=e.data
+                )
+
+            # Throw a 304 exception for catching.
+            if response.status_code == 304:
+                raise HTTPNotModified(
+                    status_code=304,
+                    headers=response.headers
+                )
 
         return (data, response) if return_response else data
 
@@ -590,7 +633,7 @@ class EsiOperation(BaseEsiOperation):
                 my_languages.append(lang)
 
         return {
-            language: self.results(language=language, **kwargs)
+            language: self.results(accept_language=language, **kwargs)
             for language in my_languages
         }
 
@@ -732,7 +775,7 @@ class EsiOperationAsync(BaseEsiOperation):
                 my_languages.append(lang)
 
         return {
-            language: self.results(language=language, **extra)
+            language: self.results(accept_language=language, **kwargs)
             for language in my_languages
         }
 
@@ -804,7 +847,11 @@ class ESIClient(ESIClientStub):
         if tag == "_":
             return self.api._operationindex
 
-        elif tag in set(self.api._operationindex._tags.keys()):
+        # convert pythonic Planetary_Interaction to Planetary Interaction
+        if "_" in tag:
+            tag = tag.replace("_", " ")
+
+        if tag in set(self.api._operationindex._tags.keys()):
             return ESITag(self.api._operationindex._tags[tag], self.api)
 
         raise AttributeError(
@@ -827,7 +874,11 @@ class ESIClientAsync(ESIClientStub):
         if tag == "_":
             return self.api._operationindex
 
-        elif tag in set(self.api._operationindex._tags.keys()):
+        # convert pythonic Planetary_Interaction to Planetary Interaction
+        if "_" in tag:
+            tag = tag.replace("_", " ")
+
+        if tag in set(self.api._operationindex._tags.keys()):
             return ESITagAsync(self.api._operationindex._tags[tag], self.api)
 
         raise AttributeError(
@@ -839,7 +890,7 @@ class ESIClientAsync(ESIClientStub):
 class ESIClientProvider:
     """Class for providing a single ESI client instance for a whole app
     Args:
-        compatibility_date (str): The compatibility date for the ESI client.
+        compatibility_date (str | date): The compatibility date for the ESI client.
         ua_appname (str): Name of the App for generating a User-Agent,
         ua_version (str): Version of the App for generating a User-Agent,
         ua_url (str, Optional): URL To the Source Code or Documentation for generating a User-Agent,
@@ -855,7 +906,7 @@ class ESIClientProvider:
 
     def __init__(
         self,
-        compatibility_date: str,
+        compatibility_date: str | date,
         ua_appname: str,
         ua_version: str,
         ua_url: str | None = None,
@@ -863,7 +914,10 @@ class ESIClientProvider:
         tenant: str = "tranquility",
         **kwargs
     ) -> None:
-        self._compatibility_date = compatibility_date
+        if type(compatibility_date) is date:
+            self._compatibility_date = self._date_to_string(compatibility_date)
+        else:
+            self._compatibility_date = compatibility_date
         self._ua_appname = ua_appname
         self._ua_version = ua_version
         self._ua_url = ua_url
@@ -899,5 +953,11 @@ class ESIClientProvider:
             self._client_async = ESIClientAsync(api)
         return self._client_async
 
+    @classmethod
+    def _date_to_string(cls, compatibility_date: date) -> str:
+        """Turns a date object in a compatibility_date string"""
+        return f"{compatibility_date.year}-{compatibility_date.month:02}-{compatibility_date.day:02}"
+
+
     def __str__(self) -> str:
         return "ESIClientProvider"

esi/stubs.pyi

@@ -2010,6 +2010,36 @@ class GetMarketsStructuresStructureIdOperation(EsiOperation):
         ...
 
 
+class GetMetaChangelogOperation(EsiOperation):
+    """EsiOperation, use result(), results() or results_localized()"""
+    def result(self, etag: str | None = None, return_response: bool = False, use_cache: bool = True, **extra) -> dict[str, Any]:
+        """Get the changelog of this API."""
+        ...
+
+    def results(self, etag: str | None = None, return_response: bool = False, use_cache: bool = True, **extra) -> list[dict[str, Any]]:
+        """Get the changelog of this API."""
+        ...
+
+    def results_localized(self, languages: list[str] | str | None = None, **extra) -> dict[str, list[dict[str, Any]]]:
+        """Get the changelog of this API."""
+        ...
+
+
+class GetMetaCompatibilityDatesOperation(EsiOperation):
+    """EsiOperation, use result(), results() or results_localized()"""
+    def result(self, etag: str | None = None, return_response: bool = False, use_cache: bool = True, **extra) -> dict[str, Any]:
+        """Get a list of compatibility dates."""
+        ...
+
+    def results(self, etag: str | None = None, return_response: bool = False, use_cache: bool = True, **extra) -> list[dict[str, Any]]:
+        """Get a list of compatibility dates."""
+        ...
+
+    def results_localized(self, languages: list[str] | str | None = None, **extra) -> dict[str, list[dict[str, Any]]]:
+        """Get a list of compatibility dates."""
+        ...
+
+
 class GetCharactersCharacterIdPlanetsOperation(EsiOperation):
     """EsiOperation, use result(), results() or results_localized()"""
     def result(self, etag: str | None = None, return_response: bool = False, use_cache: bool = True, **extra) -> list[dict[str, Any]]:
@@ -3518,6 +3548,18 @@ class ESIClientStub:
 
     Market: _Market = _Market()
 
+    class _Meta:
+        def GetMetaChangelog(self, Accept_Language: str | None = ..., If_None_Match: str | None = ..., X_Compatibility_Date: str | None = ..., X_Tenant: str | None = ..., **kwargs: Any) -> GetMetaChangelogOperation:
+            """Get the changelog of this API."""
+            ...
+
+        def GetMetaCompatibilityDates(self, Accept_Language: str | None = ..., If_None_Match: str | None = ..., X_Compatibility_Date: str | None = ..., X_Tenant: str | None = ..., **kwargs: Any) -> GetMetaCompatibilityDatesOperation:
+            """Get a list of compatibility dates."""
+            ...
+
+
+    Meta: _Meta = _Meta()
+
     class _Planetary_Interaction:
         def GetCharactersCharacterIdPlanets(self, character_id: int, token: Token, Accept_Language: str | None = ..., If_None_Match: str | None = ..., X_Compatibility_Date: str | None = ..., X_Tenant: str | None = ..., **kwargs: Any) -> GetCharactersCharacterIdPlanetsOperation:
             """Returns a list of all planetary colonies owned by a character."""

esi/tests/test_openapi.py

@@ -0,0 +1,14 @@
+from django.test import TestCase
+from datetime import date
+
+from esi.openapi_clients import ESIClientProvider
+
+
+class TestOpenapiClientProvider(TestCase):
+
+    def test_compatibilitydate_date_to_string(self):
+        testdate_1 = date(2024, 1, 1)
+        testdate_2 = date(2025, 8, 26)
+
+        self.assertEqual("2024-01-01", ESIClientProvider._date_to_string(testdate_1))
+        self.assertEqual("2025-08-26", ESIClientProvider._date_to_string(testdate_2))