tako-sdk 2.2.2__tar.gz → 2.2.4__tar.gz

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: tako-sdk
-Version: 2.2.2
+Version: 2.2.4
 Summary: The official Python library for the tako API
 Project-URL: Homepage, https://tako.com
 Project-URL: Documentation, https://docs.tako.com
@@ -13,7 +13,6 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -21,13 +20,13 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: httpx-sse>=0.4
 Requires-Dist: httpx<1,>=0.27
 Requires-Dist: pydantic<3,>=2
 Requires-Dist: python-dateutil>=2.8.2
 Requires-Dist: typing-extensions>=4.7.1
-Requires-Dist: urllib3<3,>=2.1.0
+Requires-Dist: urllib3<3,>=2.7.0
 Provides-Extra: pandas
 Requires-Dist: pandas>=1.5; extra == 'pandas'
 Description-Content-Type: text/markdown

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tako-sdk"
-version = "2.2.2"
+version = "2.2.4"
 description = "The official Python library for the tako API"
 readme = "README.md"
 license = "MIT"
@@ -13,7 +13,7 @@ authors = [
 #   httpx                                                      -> async (tako/aio/) client
 #   httpx-sse                                                  -> hand-written SSE layer (tako/lib)
 dependencies = [
-  "urllib3>=2.1.0,<3",
+  "urllib3>=2.7.0,<3",
   "python-dateutil>=2.8.2",
   "pydantic>=2,<3",
   "typing-extensions>=4.7.1",
@@ -21,11 +21,10 @@ dependencies = [
   "httpx-sse>=0.4",
 ]
 
-requires-python = ">= 3.9"
+requires-python = ">= 3.10"
 classifiers = [
   "Typing :: Typed",
   "Intended Audience :: Developers",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
@@ -96,7 +95,7 @@ markers = [
 # reproducible; they are exercised by the import check and tests, not pyright.
 [tool.pyright]
 typeCheckingMode = "strict"
-pythonVersion = "3.9"
+pythonVersion = "3.10"
 include = ["tako/lib"]
 exclude = [".venv", ".nox", ".git"]
 reportImplicitOverride = true
@@ -118,7 +117,7 @@ disallow_incomplete_defs = true
 [tool.ruff]
 line-length = 120
 output-format = "grouped"
-target-version = "py39"
+target-version = "py310"
 # Lint only hand-written code; generated clients are produced by openapi-generator.
 extend-exclude = [
   "tako/api",

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/__init__.py

@@ -69,6 +69,7 @@ __all__ = [
     "ContentsResponse",
     "CreateCard400Response",
     "CreateCardRequest",
+    "DataFreshness",
     "DataPipelineAnswerEvent",
     "DataSourceSettings",
     "EntityClassName",
@@ -83,6 +84,7 @@ __all__ = [
     "HeartbeatEvent",
     "KnowledgeCardMethodology",
     "KnowledgeCardRelevance",
+    "MetricDefinition",
     "NerLabel",
     "OutputSettings",
     "ReasoningEvent",
@@ -175,6 +177,7 @@ from tako.models.contents_request import ContentsRequest as ContentsRequest
 from tako.models.contents_response import ContentsResponse as ContentsResponse
 from tako.models.create_card400_response import CreateCard400Response as CreateCard400Response
 from tako.models.create_card_request import CreateCardRequest as CreateCardRequest
+from tako.models.data_freshness import DataFreshness as DataFreshness
 from tako.models.data_pipeline_answer_event import DataPipelineAnswerEvent as DataPipelineAnswerEvent
 from tako.models.data_source_settings import DataSourceSettings as DataSourceSettings
 from tako.models.entity_class_name import EntityClassName as EntityClassName
@@ -189,6 +192,7 @@ from tako.models.graph_search_response import GraphSearchResponse as GraphSearch
 from tako.models.heartbeat_event import HeartbeatEvent as HeartbeatEvent
 from tako.models.knowledge_card_methodology import KnowledgeCardMethodology as KnowledgeCardMethodology
 from tako.models.knowledge_card_relevance import KnowledgeCardRelevance as KnowledgeCardRelevance
+from tako.models.metric_definition import MetricDefinition as MetricDefinition
 from tako.models.ner_label import NerLabel as NerLabel
 from tako.models.output_settings import OutputSettings as OutputSettings
 from tako.models.reasoning_event import ReasoningEvent as ReasoningEvent

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/aio/__init__.py

@@ -69,6 +69,7 @@ __all__ = [
     "ContentsResponse",
     "CreateCard400Response",
     "CreateCardRequest",
+    "DataFreshness",
     "DataPipelineAnswerEvent",
     "DataSourceSettings",
     "EntityClassName",
@@ -83,6 +84,7 @@ __all__ = [
     "HeartbeatEvent",
     "KnowledgeCardMethodology",
     "KnowledgeCardRelevance",
+    "MetricDefinition",
     "NerLabel",
     "OutputSettings",
     "ReasoningEvent",
@@ -175,6 +177,7 @@ from tako.aio.models.contents_request import ContentsRequest as ContentsRequest
 from tako.aio.models.contents_response import ContentsResponse as ContentsResponse
 from tako.aio.models.create_card400_response import CreateCard400Response as CreateCard400Response
 from tako.aio.models.create_card_request import CreateCardRequest as CreateCardRequest
+from tako.aio.models.data_freshness import DataFreshness as DataFreshness
 from tako.aio.models.data_pipeline_answer_event import DataPipelineAnswerEvent as DataPipelineAnswerEvent
 from tako.aio.models.data_source_settings import DataSourceSettings as DataSourceSettings
 from tako.aio.models.entity_class_name import EntityClassName as EntityClassName
@@ -189,6 +192,7 @@ from tako.aio.models.graph_search_response import GraphSearchResponse as GraphSe
 from tako.aio.models.heartbeat_event import HeartbeatEvent as HeartbeatEvent
 from tako.aio.models.knowledge_card_methodology import KnowledgeCardMethodology as KnowledgeCardMethodology
 from tako.aio.models.knowledge_card_relevance import KnowledgeCardRelevance as KnowledgeCardRelevance
+from tako.aio.models.metric_definition import MetricDefinition as MetricDefinition
 from tako.aio.models.ner_label import NerLabel as NerLabel
 from tako.aio.models.output_settings import OutputSettings as OutputSettings
 from tako.aio.models.reasoning_event import ReasoningEvent as ReasoningEvent

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/aio/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/2.2.1/python'
+        self.user_agent = 'OpenAPI-Generator/2.2.3/python'
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/aio/configuration.py

@@ -552,7 +552,7 @@ conf = tako.aio.Configuration(
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 1.0.0\n"\
-               "SDK Package Version: 2.2.1".\
+               "SDK Package Version: 2.2.3".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/aio/models/__init__.py

@@ -43,6 +43,7 @@ from tako.aio.models.contents_request import ContentsRequest
 from tako.aio.models.contents_response import ContentsResponse
 from tako.aio.models.create_card400_response import CreateCard400Response
 from tako.aio.models.create_card_request import CreateCardRequest
+from tako.aio.models.data_freshness import DataFreshness
 from tako.aio.models.data_pipeline_answer_event import DataPipelineAnswerEvent
 from tako.aio.models.data_source_settings import DataSourceSettings
 from tako.aio.models.entity_class_name import EntityClassName
@@ -57,6 +58,7 @@ from tako.aio.models.graph_search_response import GraphSearchResponse
 from tako.aio.models.heartbeat_event import HeartbeatEvent
 from tako.aio.models.knowledge_card_methodology import KnowledgeCardMethodology
 from tako.aio.models.knowledge_card_relevance import KnowledgeCardRelevance
+from tako.aio.models.metric_definition import MetricDefinition
 from tako.aio.models.ner_label import NerLabel
 from tako.aio.models.output_settings import OutputSettings
 from tako.aio.models.reasoning_event import ReasoningEvent

tako_sdk-2.2.4/tako/aio/models/data_freshness.py

@@ -0,0 +1,100 @@
+# coding: utf-8
+
+"""
+    Knowledge Search API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class DataFreshness(BaseModel):
+    """
+    When the card's data was last observed and last refreshed. Either field may be null when that date isn't available for the card type.
+    """ # noqa: E501
+    data_as_of: Optional[StrictStr] = Field(default=None, description="Date of the most recent observation in the card's data, as an ISO date (YYYY-MM-DD). Null for card types without a coverage date.")
+    last_updated: Optional[StrictStr] = Field(default=None, description="Date Tako last refreshed the underlying data, as an ISO date (YYYY-MM-DD).")
+    __properties: ClassVar[List[str]] = ["data_as_of", "last_updated"]
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of DataFreshness from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if data_as_of (nullable) is None
+        # and model_fields_set contains the field
+        if self.data_as_of is None and "data_as_of" in self.model_fields_set:
+            _dict['data_as_of'] = None
+
+        # set to None if last_updated (nullable) is None
+        # and model_fields_set contains the field
+        if self.last_updated is None and "last_updated" in self.model_fields_set:
+            _dict['last_updated'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of DataFreshness from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "data_as_of": obj.get("data_as_of"),
+            "last_updated": obj.get("last_updated")
+        })
+        return _obj
+
+

{tako_sdk-2.2.2/tako → tako_sdk-2.2.4/tako/aio}/models/knowledge_card_methodology.py

@@ -28,7 +28,7 @@ class KnowledgeCardMethodology(BaseModel):
     KnowledgeCardMethodology
     """ # noqa: E501
     methodology_name: Optional[StrictStr] = Field(description="The name of the methodology")
-    methodology_description: Optional[StrictStr] = Field(description="The description of the methodology")
+    methodology_description: Optional[StrictStr] = Field(description="A concise, one-sentence summary of the methodology (source and what is measured). Falls back to the full methodology text when no concise summary is available.")
     __properties: ClassVar[List[str]] = ["methodology_name", "methodology_description"]
 
     model_config = ConfigDict(

tako_sdk-2.2.4/tako/aio/models/metric_definition.py

@@ -0,0 +1,90 @@
+# coding: utf-8
+
+"""
+    Knowledge Search API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class MetricDefinition(BaseModel):
+    """
+    Definition of a metric shown on a card. Sourced from the metric's ValueType definition — the same text as the in-app methodology 'Metrics' tab.
+    """ # noqa: E501
+    name: StrictStr = Field(description="The metric's display name")
+    definition: StrictStr = Field(description="Human-readable definition of the metric")
+    __properties: ClassVar[List[str]] = ["name", "definition"]
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of MetricDefinition from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of MetricDefinition from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "definition": obj.get("definition")
+        })
+        return _obj
+
+

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/aio/models/tako_card.py

@@ -19,8 +19,10 @@ import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional, Union
+from tako.aio.models.data_freshness import DataFreshness
 from tako.aio.models.knowledge_card_methodology import KnowledgeCardMethodology
 from tako.aio.models.knowledge_card_relevance import KnowledgeCardRelevance
+from tako.aio.models.metric_definition import MetricDefinition
 from tako.aio.models.result_content import ResultContent
 from tako.aio.models.tako_card_node import TakoCardNode
 from tako.aio.models.tako_card_source import TakoCardSource
@@ -48,7 +50,9 @@ class TakoCard(BaseModel):
     content: Optional[ResultContent] = None
     relevance_score: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="Numeric relevance of this card to the query on a 1.0-5.0 scale (5.0 = exact match; higher is more relevant). Only populated for entitled accounts; null otherwise.")
     nodes: Optional[List[TakoCardNode]] = Field(default=None, description="Graph nodes (entities and metrics) this card was built from, returned by default. Absent for web-only cards or when node resolution was unavailable. Use each id with /beta/graph/node/{id} for full detail (aliases, subtype), or pass ids in sources.data.node_ids to pin these nodes in future searches.")
-    __properties: ClassVar[List[str]] = ["card_id", "title", "description", "semantic_description", "webpage_url", "image_url", "embed_url", "sources", "methodologies", "source_indexes", "card_type", "relevance", "content", "relevance_score", "nodes"]
+    metric_definitions: Optional[List[MetricDefinition]] = Field(default=None, description="Definitions of the metrics this card displays (name + definition). Null when no displayed metric has a definition available.")
+    data_freshness: Optional[DataFreshness] = Field(default=None, description="Freshness dates for the card's data: the coverage date (data_as_of) and the last refresh date (last_updated). Null when neither date is available.")
+    __properties: ClassVar[List[str]] = ["card_id", "title", "description", "semantic_description", "webpage_url", "image_url", "embed_url", "sources", "methodologies", "source_indexes", "card_type", "relevance", "content", "relevance_score", "nodes", "metric_definitions", "data_freshness"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -113,6 +117,16 @@ class TakoCard(BaseModel):
                 if _item_nodes:
                     _items.append(_item_nodes.to_dict())
             _dict['nodes'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in metric_definitions (list)
+        _items = []
+        if self.metric_definitions:
+            for _item_metric_definitions in self.metric_definitions:
+                if _item_metric_definitions:
+                    _items.append(_item_metric_definitions.to_dict())
+            _dict['metric_definitions'] = _items
+        # override the default output from pydantic by calling `to_dict()` of data_freshness
+        if self.data_freshness:
+            _dict['data_freshness'] = self.data_freshness.to_dict()
         # set to None if card_id (nullable) is None
         # and model_fields_set contains the field
         if self.card_id is None and "card_id" in self.model_fields_set:
@@ -188,6 +202,16 @@ class TakoCard(BaseModel):
         if self.nodes is None and "nodes" in self.model_fields_set:
             _dict['nodes'] = None
 
+        # set to None if metric_definitions (nullable) is None
+        # and model_fields_set contains the field
+        if self.metric_definitions is None and "metric_definitions" in self.model_fields_set:
+            _dict['metric_definitions'] = None
+
+        # set to None if data_freshness (nullable) is None
+        # and model_fields_set contains the field
+        if self.data_freshness is None and "data_freshness" in self.model_fields_set:
+            _dict['data_freshness'] = None
+
         return _dict
 
     @classmethod
@@ -214,7 +238,9 @@ class TakoCard(BaseModel):
             "relevance": obj.get("relevance"),
             "content": ResultContent.from_dict(obj["content"]) if obj.get("content") is not None else None,
             "relevance_score": obj.get("relevance_score"),
-            "nodes": [TakoCardNode.from_dict(_item) for _item in obj["nodes"]] if obj.get("nodes") is not None else None
+            "nodes": [TakoCardNode.from_dict(_item) for _item in obj["nodes"]] if obj.get("nodes") is not None else None,
+            "metric_definitions": [MetricDefinition.from_dict(_item) for _item in obj["metric_definitions"]] if obj.get("metric_definitions") is not None else None,
+            "data_freshness": DataFreshness.from_dict(obj["data_freshness"]) if obj.get("data_freshness") is not None else None
         })
         return _obj
 

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/2.2.1/python'
+        self.user_agent = 'OpenAPI-Generator/2.2.3/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/configuration.py

@@ -554,7 +554,7 @@ conf = tako.Configuration(
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 1.0.0\n"\
-               "SDK Package Version: 2.2.1".\
+               "SDK Package Version: 2.2.3".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/lib/dataset.py

@@ -80,7 +80,7 @@ class TakoDatasetView:
     def records(self) -> List[Dict[str, Any]]:
         """One dict per row, keyed by column name. No third-party dependency."""
         names = self.column_names
-        return [dict(zip(names, row)) for row in self._normalized_rows()]
+        return [dict(zip(names, row, strict=False)) for row in self._normalized_rows()]
 
     def to_dataframe(self) -> Any:
         """A pandas ``DataFrame`` with dtypes coerced from the ``columns`` header.
@@ -114,7 +114,8 @@ class TakoDatasetView:
                     frame[name] = pd.to_numeric(frame[name], errors="coerce")
                 elif col_type == "boolean":
                     frame[name] = frame[name].astype("boolean")
-                # "string" (and anything unrecognized) stays object
+                # "string" (and anything unrecognized) stays uncoerced: object
+                # under pandas < 3, the new str/string dtype under pandas 3
             except (ValueError, TypeError):
                 pass  # leave the column untouched on an unexpected value
         return frame

{tako_sdk-2.2.2 → tako_sdk-2.2.4}/tako/models/__init__.py

@@ -43,6 +43,7 @@ from tako.models.contents_request import ContentsRequest
 from tako.models.contents_response import ContentsResponse
 from tako.models.create_card400_response import CreateCard400Response
 from tako.models.create_card_request import CreateCardRequest
+from tako.models.data_freshness import DataFreshness
 from tako.models.data_pipeline_answer_event import DataPipelineAnswerEvent
 from tako.models.data_source_settings import DataSourceSettings
 from tako.models.entity_class_name import EntityClassName
@@ -57,6 +58,7 @@ from tako.models.graph_search_response import GraphSearchResponse
 from tako.models.heartbeat_event import HeartbeatEvent
 from tako.models.knowledge_card_methodology import KnowledgeCardMethodology
 from tako.models.knowledge_card_relevance import KnowledgeCardRelevance
+from tako.models.metric_definition import MetricDefinition
 from tako.models.ner_label import NerLabel
 from tako.models.output_settings import OutputSettings
 from tako.models.reasoning_event import ReasoningEvent

tako_sdk-2.2.4/tako/models/data_freshness.py

@@ -0,0 +1,100 @@
+# coding: utf-8
+
+"""
+    Knowledge Search API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class DataFreshness(BaseModel):
+    """
+    When the card's data was last observed and last refreshed. Either field may be null when that date isn't available for the card type.
+    """ # noqa: E501
+    data_as_of: Optional[StrictStr] = Field(default=None, description="Date of the most recent observation in the card's data, as an ISO date (YYYY-MM-DD). Null for card types without a coverage date.")
+    last_updated: Optional[StrictStr] = Field(default=None, description="Date Tako last refreshed the underlying data, as an ISO date (YYYY-MM-DD).")
+    __properties: ClassVar[List[str]] = ["data_as_of", "last_updated"]
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of DataFreshness from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if data_as_of (nullable) is None
+        # and model_fields_set contains the field
+        if self.data_as_of is None and "data_as_of" in self.model_fields_set:
+            _dict['data_as_of'] = None
+
+        # set to None if last_updated (nullable) is None
+        # and model_fields_set contains the field
+        if self.last_updated is None and "last_updated" in self.model_fields_set:
+            _dict['last_updated'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of DataFreshness from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "data_as_of": obj.get("data_as_of"),
+            "last_updated": obj.get("last_updated")
+        })
+        return _obj
+
+

{tako_sdk-2.2.2/tako/aio → tako_sdk-2.2.4/tako}/models/knowledge_card_methodology.py

@@ -28,7 +28,7 @@ class KnowledgeCardMethodology(BaseModel):
     KnowledgeCardMethodology
     """ # noqa: E501
     methodology_name: Optional[StrictStr] = Field(description="The name of the methodology")
-    methodology_description: Optional[StrictStr] = Field(description="The description of the methodology")
+    methodology_description: Optional[StrictStr] = Field(description="A concise, one-sentence summary of the methodology (source and what is measured). Falls back to the full methodology text when no concise summary is available.")
     __properties: ClassVar[List[str]] = ["methodology_name", "methodology_description"]
 
     model_config = ConfigDict(