kensho-kfinance 3.2.11__tar.gz → 3.2.13__tar.gz

{kensho_kfinance-3.2.11/kensho_kfinance.egg-info → kensho_kfinance-3.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kensho-kfinance
-Version: 3.2.11
+Version: 3.2.13
 Summary: Python CLI for kFinance
 Author-email: Luke Brown <luke.brown@kensho.com>, Michelle Keoy <michelle.keoy@kensho.com>, Keith Page <keith.page@kensho.com>, Matthew Rosen <matthew.rosen@kensho.com>, Nick Roshdieh <nick.roshdieh@kensho.com>
 Project-URL: source, https://github.com/kensho-technologies/kfinance

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13/kensho_kfinance.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kensho-kfinance
-Version: 3.2.11
+Version: 3.2.13
 Summary: Python CLI for kFinance
 Author-email: Luke Brown <luke.brown@kensho.com>, Michelle Keoy <michelle.keoy@kensho.com>, Keith Page <keith.page@kensho.com>, Matthew Rosen <matthew.rosen@kensho.com>, Nick Roshdieh <nick.roshdieh@kensho.com>
 Project-URL: source, https://github.com/kensho-technologies/kfinance

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13}/kfinance/CHANGELOG.md

@@ -1,4 +1,10 @@
 # Changelog
+# 3.2.13
+- Fix Prices validator to handle null OHLC price data
+
+# 3.2.12
+- Remove multiples line item support
+
 # 3.2.11
 - Add Handling of status code 400 for Capitalizations, Modify EV/TEV ratio to target quarterly or LTM
 

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13}/kfinance/domains/capitalizations/capitalization_models.py

@@ -2,7 +2,7 @@ from copy import deepcopy
 from datetime import date
 from typing import Any
 
-from pydantic import BaseModel, Field, model_validator
+from pydantic import BaseModel, ConfigDict, Field, model_validator
 from strenum import StrEnum
 
 from kfinance.client.models.decimal_with_unit import Money, Shares
@@ -28,18 +28,9 @@ class DailyCapitalization(BaseModel):
 class Capitalizations(BaseModel):
     """Capitalizations represents market cap, TEV, and shares outstanding for a date range"""
 
+    model_config = ConfigDict(validate_by_name=True)
     capitalizations: list[DailyCapitalization] = Field(validation_alias="market_caps")
 
-    @model_validator(mode="before")
-    @classmethod
-    def handle_field_alias(cls, data: Any) -> Any:
-        """Handle both 'capitalizations' and 'market_caps' field names"""
-        if isinstance(data, dict):
-            if "capitalizations" in data and "market_caps" not in data:
-                data = deepcopy(data)
-                data["market_caps"] = data["capitalizations"]
-        return data
-
     @model_validator(mode="before")
     @classmethod
     def inject_currency_into_data(cls, data: Any) -> Any:

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13}/kfinance/domains/line_items/line_item_models.py

@@ -1599,127 +1599,6 @@ LINE_ITEMS: list[LineItemType] = [
         "dataitemid": 4034,
         "spgi_name": "Total Debt/Equity",
     },
-    {
-        "name": "last_close_tev_to_ebit",
-        "aliases": {
-            "ev_to_ebit",
-            "enterprise_value_to_ebit",
-            "enterprise_value_to_earnings_before_interest_and_taxes",
-            "tev_to_ebit",
-            "total_ev_to_ebit",
-            "total_enterprise_value_to_ebit",
-            "total_enterprise_value_to_earnings_before_interest_and_taxes",
-            "last_tev_to_ebit",
-            "last_total_ev_to_ebit",
-            "last_enterprise_value_to_ebit",
-            "last_enterprise_value_to_earnings_before_interest_and_taxes",
-            "last_total_enterprise_value_to_ebit",
-            "last_total_enterprise_value_to_earnings_before_interest_and_taxes",
-            "last_close_ev_to_ebit",
-            "last_close_enterprise_value_to_ebit",
-            "last_close_total_ev_to_ebit",
-            "last_close_enterprise_value_to_ebit",
-            "last_close_enterprise_value_to_earnings_before_interest_and_taxes",
-            "last_close_total_enterprise_value_to_ebit",
-            "last_close_total_enterprise_value_to_earnings_before_interest_and_taxes",
-        },
-        "dataitemid": 100062,
-        "spgi_name": "Last Close TEV / EBIT",
-    },
-    {
-        "name": "last_close_tev_to_ebitda",
-        "aliases": {
-            "ev_to_ebitda",
-            "enterprise_value_to_ebitda",
-            "enterprise_value_to_earnings_before_interest_taxes_depreciation_and_amortization",
-            "tev_to_ebitda",
-            "total_ev_to_ebitda",
-            "total_enterprise_value_to_ebitda",
-            "total_enterprise_value_to_earnings_before_interest_taxes_depreciation_and_amortization",
-            "last_tev_to_ebitda",
-            "last_total_ev_to_ebitda",
-            "last_enterprise_value_to_ebitda",
-            "last_enterprise_value_to_earnings_before_interest_taxes_depreciation_and_amortization",
-            "last_total_enterprise_value_to_ebitda",
-            "last_total_enterprise_value_to_earnings_before_interest_taxes_depreciation_and_amortization",
-            "last_close_total_ev_to_ebitda",
-            "last_close_enterprise_value_to_ebitda",
-            "last_close_enterprise_value_to_earnings_before_interest_taxes_depreciation_and_amortization",
-            "last_close_total_enterprise_value_to_ebitda",
-            "last_close_total_enterprise_value_to_earnings_before_interest_taxes_depreciation_and_amortization",
-        },
-        "dataitemid": 100063,
-        "spgi_name": "Last Close TEV / EBITDA",
-    },
-    {
-        "name": "ev_to_employees",
-        "aliases": {
-            "ev_to_employee_count",
-            "ev_to_headcount",
-            "enterprise_value_to_employees",
-            "enterprise_value_to_employee_count",
-            "enterprise_value_to_headcount",
-            "tev_to_employees",
-            "tev_to_employee_count",
-            "tev_to_headcount",
-            "total_ev_to_employees",
-            "total_ev_to_employee_count",
-            "total_ev_to_headcount",
-            "total_enterprise_value_to_employees",
-            "total_enterprise_value_to_employee_count",
-            "total_enterprise_value_to_headcount",
-            "last_ev_to_employees",
-            "last_ev_to_employee_count",
-            "last_ev_to_headcount",
-            "last_tev_to_employees",
-            "last_tev_to_employee_count",
-            "last_tev_to_headcount",
-            "last_total_ev_to_employees",
-            "last_total_ev_to_employee_count",
-            "last_total_ev_to_headcount",
-            "last_enterprise_value_to_employees",
-            "last_enterprise_value_to_employee_count",
-            "last_enterprise_value_to_headcount",
-            "last_total_enterprise_value_to_employees",
-            "last_total_enterprise_value_to_employee_count",
-            "last_total_enterprise_value_to_headcount",
-            "last_close_ev_to_employees",
-            "last_close_ev_to_employee_count",
-            "last_close_ev_to_headcount",
-            "last_close_tev_to_employees",
-            "last_close_tev_to_employee_count",
-            "last_close_tev_to_headcount",
-            "last_close_total_ev_to_employees",
-            "last_close_total_ev_to_employee_count",
-            "last_close_total_ev_to_headcount",
-            "last_close_enterprise_value_to_employees",
-            "last_close_enterprise_value_to_employee_count",
-            "last_close_enterprise_value_to_headcount",
-            "last_close_total_enterprise_value_to_employees",
-            "last_close_total_enterprise_value_to_employee_count",
-            "last_close_total_enterprise_value_to_headcount",
-        },
-        "dataitemid": 100070,
-        "spgi_name": "Last Close TEV / Employees",
-    },
-    {
-        "name": "ev_to_total_revenue",
-        "aliases": {
-            "tev_to_total_revenue",
-            "enterprise_value_to_total_revenue",
-            "total_enterprise_value_to_total_revenue",
-            "last_ev_to_total_revenue",
-            "last_tev_to_total_revenue",
-            "last_enterprise_value_to_total_revenue",
-            "last_enterprise_value_to_total_revenue",
-            "last_close_ev_to_total_revenue",
-            "last_close_tev_to_total_revenue",
-            "last_close_enterprise_value_to_total_revenue",
-            "last_close_enterprise_value_to_total_revenue",
-        },
-        "dataitemid": 100061,
-        "spgi_name": "Last Close TEV / Total Revenue",
-    },
 ]
 LINE_ITEM_NAMES_AND_ALIASES: list[str] = list(
     chain(*[[line_item["name"]] + list(line_item["aliases"]) for line_item in LINE_ITEMS])

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13}/kfinance/domains/line_items/line_item_tools.py

@@ -45,12 +45,6 @@ class GetFinancialLineItemFromIdentifiers(KfinanceTool):
         - To fetch the most recent value for the line item, leave start_year, start_quarter, end_year, and end_quarter as None.
         - The tool accepts arguments in calendar years, and all outputs will be presented in terms of calendar years. Please note that these calendar years may not align with the company's fiscal year.
         - All aliases for a line item return identical data (e.g., "revenue", "normal_revenue", and "regular_revenue" all return the same financial data).
-        - For the following Enterprise Value (EV) ratio line items, always specify period_type as either "quarterly" or "ltm" (Last Twelve Months) - do not rely on the default annual period:
-            - last_close_tev_to_ebit (and its aliases: ev_to_ebit, enterprise_value_to_ebit, tev_to_ebit, etc.)
-            - last_close_tev_to_ebitda (and its aliases: ev_to_ebitda, enterprise_value_to_ebitda, tev_to_ebitda, etc.)
-            - ev_to_employees (and its aliases: ev_to_employee_count, tev_to_employees, enterprise_value_to_employees, etc.)
-            - ev_to_total_revenue (and its aliases: tev_to_total_revenue, enterprise_value_to_total_revenue, etc.)
-        - When requesting these EV ratios, explicitly set period_type="quarterly" or period_type="ltm" for optimal data availability.
 
         Example:
         Query: "What are the revenues of Lowe's and Home Depot?"

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13}/kfinance/domains/prices/price_models.py

@@ -15,11 +15,11 @@ class Prices(BaseModel):
     """
 
     date: str
-    open: Money
-    high: Money
-    low: Money
-    close: Money
-    volume: Shares
+    open: Money | None
+    high: Money | None
+    low: Money | None
+    close: Money | None  # For Consistency with other OHLC dtype
+    volume: Shares | None
 
 
 class PriceHistory(BaseModel):
@@ -58,7 +58,8 @@ class PriceHistory(BaseModel):
             currency = data["currency"]
             for capitalization in data["prices"]:
                 for key in ["open", "high", "low", "close"]:
-                    capitalization[key] = dict(unit=currency, value=capitalization[key])
+                    if capitalization[key] is not None:
+                        capitalization[key] = dict(unit=currency, value=capitalization[key])
         return data
 
 

{kensho_kfinance-3.2.11 → kensho_kfinance-3.2.13}/kfinance/version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '3.2.11'
-__version_tuple__ = version_tuple = (3, 2, 11)
+__version__ = version = '3.2.13'
+__version_tuple__ = version_tuple = (3, 2, 13)
 
-__commit_id__ = commit_id = 'gadcf2fd95'
+__commit_id__ = commit_id = 'g54fc4c63f'