fmp-data 2.2.1__tar.gz → 2.3.1__tar.gz

{fmp_data-2.2.1 → fmp_data-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmp-data
-Version: 2.2.1
+Version: 2.3.1
 Summary: Python client for the Financial Modeling Prep API
 Project-URL: Homepage, https://github.com/MehdiZare/fmp-data
 Project-URL: Repository, https://github.com/MehdiZare/fmp-data
@@ -29,42 +29,42 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.10
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.12.5
-Requires-Dist: tenacity>=9.1.2
+Requires-Dist: tenacity>=9.1.4
 Provides-Extra: cache-redis
-Requires-Dist: redis>=5.0.0; extra == 'cache-redis'
+Requires-Dist: redis>=7.4.0; extra == 'cache-redis'
 Provides-Extra: dev
-Requires-Dist: bandit[toml]>=1.9.3; extra == 'dev'
-Requires-Dist: coverage>=7.13.1; extra == 'dev'
+Requires-Dist: bandit[toml]>=1.9.4; extra == 'dev'
+Requires-Dist: coverage>=7.13.5; extra == 'dev'
 Requires-Dist: freezegun>=1.5.5; extra == 'dev'
-Requires-Dist: mypy>=1.19.1; extra == 'dev'
-Requires-Dist: nox>=2025.11.12; extra == 'dev'
+Requires-Dist: mypy>=1.20.0; extra == 'dev'
+Requires-Dist: nox>=2026.2.9; extra == 'dev'
 Requires-Dist: pip-audit>=2.10.0; extra == 'dev'
 Requires-Dist: pre-commit>=4.5.1; extra == 'dev'
 Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
-Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
 Requires-Dist: pytest-mock>=3.15.1; extra == 'dev'
 Requires-Dist: pytest-xdist>=3.6.1; extra == 'dev'
 Requires-Dist: pytest>=9.0.2; extra == 'dev'
-Requires-Dist: python-dotenv>=1.1.1; extra == 'dev'
-Requires-Dist: responses>=0.25.8; extra == 'dev'
-Requires-Dist: rich>=14.3.2; extra == 'dev'
-Requires-Dist: ruff>=0.14.13; extra == 'dev'
+Requires-Dist: python-dotenv>=1.2.2; extra == 'dev'
+Requires-Dist: responses>=0.26.0; extra == 'dev'
+Requires-Dist: rich>=14.3.3; extra == 'dev'
+Requires-Dist: ruff>=0.15.9; extra == 'dev'
 Requires-Dist: twine>=6.2.0; extra == 'dev'
 Requires-Dist: vcrpy>=8.1.1; extra == 'dev'
 Provides-Extra: docs
-Requires-Dist: mkdocs-material>=9.7.1; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.7.6; extra == 'docs'
 Requires-Dist: mkdocs>=1.6.1; extra == 'docs'
-Requires-Dist: mkdocstrings-python>=2.0.1; extra == 'docs'
+Requires-Dist: mkdocstrings-python>=2.0.3; extra == 'docs'
 Provides-Extra: langchain
 Requires-Dist: faiss-cpu>=1.13.2; extra == 'langchain'
 Requires-Dist: langchain-community>=0.4.1; extra == 'langchain'
-Requires-Dist: langchain-core>=1.2.8; extra == 'langchain'
-Requires-Dist: langchain-openai>=1.1.7; extra == 'langchain'
-Requires-Dist: langgraph>=1.0.6; extra == 'langchain'
-Requires-Dist: openai>=2.15.0; extra == 'langchain'
+Requires-Dist: langchain-core>=1.2.26; extra == 'langchain'
+Requires-Dist: langchain-openai>=1.1.12; extra == 'langchain'
+Requires-Dist: langgraph>=1.1.6; extra == 'langchain'
+Requires-Dist: openai>=2.30.0; extra == 'langchain'
 Requires-Dist: tiktoken>=0.12.0; extra == 'langchain'
 Provides-Extra: mcp
-Requires-Dist: mcp[cli]>=1.25.0; extra == 'mcp'
+Requires-Dist: mcp[cli]>=1.27.0; extra == 'mcp'
 Requires-Dist: pyyaml>=6.0.3; extra == 'mcp'
 Description-Content-Type: text/markdown
 
@@ -118,6 +118,12 @@ To use this library, you'll need an API key from Financial Modeling Prep (FMP).
 
 ## Installation
 
+## Launch Notes
+
+- Price-history volume fields now normalize to `float` so integer and fractional FMP payloads share one stable return type.
+- This affects `alternative.HistoricalPrice.volume`, `alternative.HistoricalPrice.unadjusted_volume`, and `company.IntradayPrice.volume`.
+- Whole-number payloads for those models now deserialize as values like `123.0`, which is why this ships as a minor release instead of a patch.
+
 ### Using UV (Recommended)
 
 ```bash

{fmp_data-2.2.1 → fmp_data-2.3.1}/README.md

@@ -48,6 +48,12 @@ To use this library, you'll need an API key from Financial Modeling Prep (FMP).
 
 ## Installation
 
+## Launch Notes
+
+- Price-history volume fields now normalize to `float` so integer and fractional FMP payloads share one stable return type.
+- This affects `alternative.HistoricalPrice.volume`, `alternative.HistoricalPrice.unadjusted_volume`, and `company.IntradayPrice.volume`.
+- Whole-number payloads for those models now deserialize as values like `123.0`, which is why this ships as a minor release instead of a patch.
+
 ### Using UV (Recommended)
 
 ```bash

{fmp_data-2.2.1 → fmp_data-2.3.1}/fmp_data/alternative/models.py

@@ -119,8 +119,8 @@ class HistoricalPrice(BaseModel):
     adj_close: float | None = Field(
         None, alias="adjClose", description="Adjusted closing price"
     )
-    volume: int = Field(description="Volume traded")
-    unadjusted_volume: int | None = Field(
+    volume: float = Field(description="Volume traded")
+    unadjusted_volume: float | None = Field(
         None, alias="unadjustedVolume", description="Unadjusted trading volume"
     )
     change: float = Field(description="Price change")

{fmp_data-2.2.1 → fmp_data-2.3.1}/fmp_data/base.py

@@ -564,27 +564,27 @@ class BaseClient:
                 status_code=429,
                 response=error_details,
                 retry_after=wait_time,
-            ) from error
+            ) from None
 
         if status_code == 401:
             raise AuthenticationError(
                 "Invalid API key or authentication failed",
                 status_code=401,
                 response=error_details,
-            ) from error
+            ) from None
 
         if status_code == 400:
             raise ValidationError(
                 f"Invalid request parameters: {error_details}",
                 status_code=400,
                 response=error_details,
-            ) from error
+            ) from None
 
         raise FMPError(
             f"HTTP {status_code} error occurred: {error_details}",
             status_code=status_code,
             response=error_details,
-        ) from error
+        ) from None
 
     @staticmethod
     def _check_error_response(data: dict[str, Any]) -> None:

{fmp_data-2.2.1 → fmp_data-2.3.1}/fmp_data/cache/redis_backend.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import json
 import logging
-from typing import Any
+from typing import Any, cast
 
 from fmp_data.cache.base import CacheBackend
 
@@ -44,7 +44,7 @@ class RedisCache(CacheBackend):
 
     def get(self, key: str) -> Any | None:
         try:
-            raw = self._client.get(self._prefixed(key))
+            raw = cast(str | None, self._client.get(self._prefixed(key)))
         except Exception:
             logger.warning("Redis get error for key %s", key, exc_info=True)
             return None
@@ -74,7 +74,10 @@ class RedisCache(CacheBackend):
         cursor: int = 0
         try:
             while True:
-                cursor, keys = self._client.scan(cursor, match=pattern, count=100)
+                cursor, keys = cast(
+                    tuple[int, list[str]],
+                    self._client.scan(cursor, match=pattern, count=100),
+                )
                 if keys:
                     self._client.delete(*keys)
                 if cursor == 0:

{fmp_data-2.2.1 → fmp_data-2.3.1}/fmp_data/company/models.py

@@ -517,7 +517,7 @@ class IntradayPrice(BaseModel):
     low: float = Field(description="Low price")
     high: float = Field(description="High price")
     close: float = Field(description="Closing price")
-    volume: int = Field(description="Trading volume")
+    volume: float = Field(description="Trading volume")
 
 
 class ExecutiveCompensation(BaseModel):

{fmp_data-2.2.1 → fmp_data-2.3.1}/fmp_data/lc/embedding.py

@@ -64,7 +64,7 @@ class EmbeddingConfig(BaseModel):
                 from langchain_openai import OpenAIEmbeddings
 
                 return OpenAIEmbeddings(
-                    api_key=self.api_key,
+                    openai_api_key=self.api_key,
                     model=self.model_name or "text-embedding-ada-002",
                     **self.additional_kwargs,
                 )

{fmp_data-2.2.1 → fmp_data-2.3.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [build-system]
 requires = [
-    "hatchling>=1.22.0",
-    "hatch-vcs>=0.4.0",
+    "hatchling>=1.29.0",
+    "hatch-vcs>=0.5.0",
 ]
 build-backend = "hatchling.build"
 
@@ -48,7 +48,7 @@ classifiers = [
 dependencies = [
     "httpx>=0.28.1",
     "pydantic>=2.12.5",
-    "tenacity>=9.1.2",
+    "tenacity>=9.1.4",
 ]
 
 [project.license]
@@ -64,84 +64,84 @@ fmp-mcp = "fmp_data.mcp.cli:main"
 
 [project.optional-dependencies]
 mcp = [
-    "mcp[cli]>=1.25.0",
+    "mcp[cli]>=1.27.0",
     "pyyaml>=6.0.3",
 ]
 cache-redis = [
-    "redis>=5.0.0",
+    "redis>=7.4.0",
 ]
 langchain = [
     "faiss-cpu>=1.13.2",
-    "langchain-core>=1.2.8",
+    "langchain-core>=1.2.26",
     "langchain-community>=0.4.1",
-    "langchain-openai>=1.1.7",
-    "langgraph>=1.0.6",
-    "openai>=2.15.0",
+    "langchain-openai>=1.1.12",
+    "langgraph>=1.1.6",
+    "openai>=2.30.0",
     "tiktoken>=0.12.0",
 ]
 dev = [
-    "ruff>=0.14.13",
-    "mypy>=1.19.1",
-    "bandit[toml]>=1.9.3",
+    "ruff>=0.15.9",
+    "mypy>=1.20.0",
+    "bandit[toml]>=1.9.4",
     "pip-audit>=2.10.0",
-    "python-dotenv>=1.1.1",
+    "python-dotenv>=1.2.2",
     "pytest>=9.0.2",
     "pytest-asyncio>=1.3.0",
-    "pytest-cov>=7.0.0",
+    "pytest-cov>=7.1.0",
     "pytest-mock>=3.15.1",
     "pytest-xdist>=3.6.1",
     "freezegun>=1.5.5",
-    "responses>=0.25.8",
+    "responses>=0.26.0",
     "vcrpy>=8.1.1",
-    "coverage>=7.13.1",
+    "coverage>=7.13.5",
     "pre-commit>=4.5.1",
-    "rich>=14.3.2",
+    "rich>=14.3.3",
     "twine>=6.2.0",
-    "nox>=2025.11.12",
+    "nox>=2026.2.9",
 ]
 docs = [
     "mkdocs>=1.6.1",
-    "mkdocs-material>=9.7.1",
-    "mkdocstrings-python>=2.0.1",
+    "mkdocs-material>=9.7.6",
+    "mkdocstrings-python>=2.0.3",
 ]
 
 [dependency-groups]
 dev = [
-    "ruff>=0.14.13",
-    "mypy>=1.19.1",
-    "bandit[toml]>=1.9.3",
+    "ruff>=0.15.9",
+    "mypy>=1.20.0",
+    "bandit[toml]>=1.9.4",
     "pip-audit>=2.10.0",
-    "python-dotenv>=1.1.1",
+    "python-dotenv>=1.2.2",
     "pytest>=9.0.2",
     "pytest-asyncio>=1.3.0",
-    "pytest-cov>=7.0.0",
+    "pytest-cov>=7.1.0",
     "pytest-mock>=3.15.1",
     "pytest-xdist>=3.6.1",
     "freezegun>=1.5.5",
-    "responses>=0.25.8",
+    "responses>=0.26.0",
     "vcrpy>=8.1.1",
-    "coverage>=7.13.1",
+    "coverage>=7.13.5",
     "pre-commit>=4.5.1",
-    "rich>=14.3.2",
+    "rich>=14.3.3",
     "twine>=6.2.0",
-    "nox>=2025.11.12",
+    "nox>=2026.2.9",
 ]
 docs = [
     "mkdocs>=1.6.1",
-    "mkdocs-material>=9.7.1",
-    "mkdocstrings-python>=2.0.1",
+    "mkdocs-material>=9.7.6",
+    "mkdocstrings-python>=2.0.3",
 ]
 langchain = [
     "faiss-cpu>=1.13.2",
-    "langchain-core>=1.2.8",
+    "langchain-core>=1.2.26",
     "langchain-community>=0.4.1",
-    "langchain-openai>=1.1.7",
-    "langgraph>=1.0.6",
-    "openai>=2.15.0",
+    "langchain-openai>=1.1.12",
+    "langgraph>=1.1.6",
+    "openai>=2.30.0",
     "tiktoken>=0.12.0",
 ]
 mcp = [
-    "mcp[cli]>=1.25.0",
+    "mcp[cli]>=1.27.0",
     "pyyaml>=6.0.3",
 ]
 

{fmp_data-2.2.1 → fmp_data-2.3.1}/tests/integration/test_company.py

@@ -130,7 +130,7 @@ class TestCompanyEndpoints(BaseTestCase):
                 assert isinstance(price.high, float)
                 assert isinstance(price.low, float)
                 assert isinstance(price.close, float)
-                assert isinstance(price.volume, int)
+                assert isinstance(price.volume, float)
 
     def test_get_market_cap(self, fmp_client: FMPDataClient, vcr_instance):
         """Test getting market capitalization data"""

{fmp_data-2.2.1 → fmp_data-2.3.1}/tests/unit/lc/test_embedding.py

@@ -54,7 +54,7 @@ def test_get_embeddings_openai(mock_openai):
 
     config.get_embeddings()
     mock_openai.assert_called_once_with(
-        api_key="test-key", model="text-embedding-ada-002"
+        openai_api_key="test-key", model="text-embedding-ada-002"
     )
 
 

{fmp_data-2.2.1 → fmp_data-2.3.1}/tests/unit/test_alternative.py

@@ -9,6 +9,9 @@ from fmp_data.alternative.models import (
     CryptoQuote,
     ForexQuote,
 )
+from fmp_data.alternative.models import (
+    HistoricalPrice as AlternativeHistoricalPrice,
+)
 
 
 @pytest.fixture
@@ -155,7 +158,36 @@ def test_crypto_historical_price_model(mock_crypto_historical):
     assert price.low == 43500.00
     assert price.close == 45000.00
     assert price.adj_close == 45000.00
-    assert price.volume == 25000000000
+    assert price.volume == pytest.approx(25000000000.0)
+    assert isinstance(price.volume, float)
     assert price.change == 1250.00
     assert price.change_percent == 2.85
     assert price.vwap == 44500.00
+
+
+def test_alternative_historical_price_accepts_float_volume(mock_crypto_historical):
+    """Test alternative historical price models accept float volume values."""
+    historical_data = dict(mock_crypto_historical["historical"][0])
+    historical_data["volume"] = 25000000000.75
+    historical_data["unadjustedVolume"] = 24999999999.25
+
+    price = AlternativeHistoricalPrice.model_validate(historical_data)
+
+    assert price.volume == pytest.approx(25000000000.75)
+    assert price.unadjusted_volume == pytest.approx(24999999999.25)
+
+
+def test_alternative_historical_price_normalizes_integer_volume_to_float(
+    mock_crypto_historical,
+):
+    """Test integer volume payloads normalize to float for a single API shape."""
+    historical_data = dict(mock_crypto_historical["historical"][0])
+    historical_data["volume"] = 123456789
+    historical_data["unadjustedVolume"] = 123456700
+
+    price = AlternativeHistoricalPrice.model_validate(historical_data)
+
+    assert price.volume == pytest.approx(123456789.0)
+    assert isinstance(price.volume, float)
+    assert price.unadjusted_volume == pytest.approx(123456700.0)
+    assert isinstance(price.unadjusted_volume, float)

{fmp_data-2.2.1 → fmp_data-2.3.1}/tests/unit/test_base.py

@@ -1,4 +1,5 @@
 import json
+import traceback
 from unittest.mock import MagicMock, Mock, patch
 
 import httpx
@@ -273,6 +274,47 @@ def test_handle_http_status_error_uses_retry_after_header(base_client):
     assert exc_info.value.retry_after == 12.0
 
 
+@pytest.mark.parametrize(
+    ("status_code", "expected_exception"),
+    [
+        (429, RateLimitError),
+        (401, AuthenticationError),
+        (400, ValidationError),
+        (500, FMPError),
+    ],
+)
+def test_handle_http_status_error_redacts_chained_apikey_traceback(
+    base_client: BaseClient,
+    status_code: int,
+    expected_exception: type[FMPError],
+) -> None:
+    """Test HTTP error tracebacks do not expose the API key query parameter."""
+    marker = "TRACEBACK_REDACTION_SENTINEL"
+    request = httpx.Request(
+        "GET",
+        f"https://financialmodelingprep.com/stable/quote?symbol=AAPL&apikey={marker}",
+    )
+    response = httpx.Response(
+        status_code,
+        request=request,
+        json={"message": "Rate limit exceeded"},
+    )
+
+    try:
+        base_client.handle_response(response)
+    except FMPError as exc:
+        assert isinstance(exc, expected_exception)
+        formatted_traceback = traceback.format_exc()
+        assert "apikey=" not in formatted_traceback
+        assert marker not in formatted_traceback
+        assert "apikey=" not in str(exc)
+        assert marker not in str(exc)
+        assert exc.__cause__ is None
+        assert exc.__suppress_context__ is True
+    else:
+        pytest.fail(f"Expected {expected_exception.__name__}")
+
+
 @pytest.mark.parametrize(
     "payload",
     [

{fmp_data-2.2.1 → fmp_data-2.3.1}/tests/unit/test_company.py

@@ -11,6 +11,7 @@ from fmp_data.company.models import (
     ExecutiveCompensationBenchmark,
     HistoricalData,
     HistoricalPrice,
+    IntradayPrice,
     MergerAcquisition,
     PriceTarget,
     PriceTargetSummary,
@@ -444,6 +445,42 @@ class TestSimpleQuoteModel:
         """Test SimpleQuote volume validator handles None."""
         assert SimpleQuote.coerce_volume_to_int(None) is None
 
+
+class TestIntradayPriceModel:
+    """Tests for intraday price model validation"""
+
+    def test_intraday_price_accepts_float_volume(self):
+        """Test intraday prices accept float volume values from the API."""
+        data = {
+            "date": "2024-01-05T16:00:00",
+            "open": 149.00,
+            "low": 148.50,
+            "high": 151.00,
+            "close": 150.25,
+            "volume": 28541.004200000316,
+        }
+
+        price = IntradayPrice.model_validate(data)
+
+        assert price.volume == pytest.approx(28541.004200000316)
+        assert isinstance(price.volume, float)
+
+    def test_intraday_price_normalizes_integer_volume_to_float(self):
+        """Test integer intraday volume payloads normalize to float."""
+        data = {
+            "date": "2024-01-05T16:00:00",
+            "open": 149.00,
+            "low": 148.50,
+            "high": 151.00,
+            "close": 150.25,
+            "volume": 28541,
+        }
+
+        price = IntradayPrice.model_validate(data)
+
+        assert price.volume == pytest.approx(28541.0)
+        assert isinstance(price.volume, float)
+
     def test_simple_quote_volume_validator_string(self):
         """Test SimpleQuote volume validator passes non-numeric values."""
         assert SimpleQuote.coerce_volume_to_int("abc") == "abc"