finbrain-python 0.2.5__tar.gz → 0.2.7__tar.gz

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/.github/workflows/ci.yml

@@ -1,6 +1,9 @@
 name: CI
 
-on: [push, pull_request]
+on:
+  push:
+    branches: ['**']          # tags are covered by the gate in release.yml
+  pull_request:
 
 jobs:
   test:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/.github/workflows/release.yml

@@ -5,7 +5,29 @@ on:
     tags: ['v[0-9]*']         # e.g. v0.1.0, v1.2.3
 
 jobs:
+  # Gate the upload on the tagged commit actually passing. The publish job
+  # previously ran straight off the tag push with no dependency on CI, so a
+  # commit with failing checks could still reach PyPI -- and PyPI versions are
+  # immutable, so a bad upload cannot be replaced, only superseded.
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: pip install -e .[dev]
+      - run: ruff check .
+      - run: mypy
+      - run: pytest -q
+
   build:
+    needs: test
     runs-on: ubuntu-latest
 
     steps:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.7] - 2026-07-24
+
+### Changed
+
+- **Tooling**: pinned the ruff rule set to `E4`/`E7`/`E9`/`F` in `[tool.ruff.lint]`. `ruff check .` previously ran with no ruff configuration, so it followed whatever ruff's current defaults were; 0.16.0 widened that selection and turned CI red with 455 findings in unchanged code. These four groups are ruff's long-standing defaults, so enforcement is unchanged — it just no longer moves when ruff releases
+- **Tooling**: mypy no longer follows numpy's stubs. numpy ships inline stubs using PEP 695 `type` statements, which mypy only parses when both its target `python_version` and the interpreter it runs under are 3.12+, so a numpy release aborted the entire run on the lower matrix jobs. Raising `python_version` alone does not fix this — it clears the target check but not the interpreter one. `python_version` stays at `3.10`, so the 3.9 target is still exercised, and no public API surfaces numpy types
+
+## [0.2.6] - 2026-07-24
+
+### Added
+
+- **Congressional disclosure date**: House and Senate trade rows now carry `disclosureDate` alongside the transaction `date` — the date the trade was publicly disclosed in the member's periodic transaction report. The gap between the two is the reporting lag. Available on `fb.house_trades.ticker()`, `fb.senate_trades.ticker()`, their async equivalents, and the `fb.screener.congress_house()` / `fb.screener.congress_senate()` rows
+- **Congressional trade date documentation**: README section explaining the two dates, and expanded docstrings on the sync/async ticker and screener methods
+- **Tests**: Unit tests assert `disclosureDate` passes through in both the raw-dict and DataFrame branches, including the null case for historical rows; integration tests assert the key is present on live responses
+
+### Changed
+
+- **DataFrame shape**: `fb.house_trades.ticker(..., as_dataframe=True)`, `fb.senate_trades.ticker(..., as_dataframe=True)` and the congress screener frames gain a `disclosureDate` column. Code that asserts an exact column set (`set(df.columns) == {...}`) or compares frames for equality needs updating
+
+### Notes
+
+- `disclosureDate` is `null` for rows collected before the upstream pipeline captured the field. In a DataFrame the missing value reads as `None` or `NaN` depending on the pandas version, so test it with `pandas.isna()` rather than `is None`
+- **`.dropna()` caveat**: because historical rows have no disclosure date, calling `.dropna()` on a congressional trades DataFrame now drops those rows entirely. Use `.dropna(subset=[...])` if that is not what you want
+- `date_from` / `date_to` bound the transaction date, not the disclosure date
+- The raw-dict branch is purely additive — no call-site changes are required there to receive the new field
+
 ## [0.2.5] - 2026-06-18
 
 ### Added

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finbrain-python
-Version: 0.2.5
+Version: 0.2.7
 Summary: Official Python client for the FinBrain API
 Author-email: Ahmet Salim Bilgin <ahmet@finbrain.tech>
 License-Expression: MIT
@@ -84,6 +84,7 @@ fb.analyst_ratings.ticker("AMZN",
                           as_dataframe=True)
 
 # ---------- house trades ----------
+# Rows include `disclosureDate` alongside the transaction `date`.
 fb.house_trades.ticker("AMZN",
                        date_from="2025-01-01",
                        date_to="2025-06-30",
@@ -155,12 +156,45 @@ fb.screener.insider_trading(limit=50)
 fb.screener.reddit_mentions(limit=100, as_dataframe=True)
 fb.screener.government_contracts(limit=100, as_dataframe=True)
 fb.screener.patent_filings(limit=100, as_dataframe=True)
+fb.screener.congress_house(limit=50)     # rows carry `disclosureDate`
+fb.screener.congress_senate(limit=50)
 
 # ---------- recent data ----------
 fb.recent.news(limit=100, as_dataframe=True)
 fb.recent.analyst_ratings(limit=50)
 ```
 
+### Congressional trade dates
+
+House and Senate trade rows carry **two** dates, and the gap between them is
+the reporting lag — often weeks:
+
+| Field            | Meaning                                                          |
+| ---------------- | ---------------------------------------------------------------- |
+| `date`           | Transaction date — when the member actually bought or sold        |
+| `disclosureDate` | Public disclosure date — when the periodic transaction report ran |
+
+`disclosureDate` is `null` on historical rows collected before the field was
+captured upstream. With `as_dataframe=True`, `date` is the **index** and
+`disclosureDate` is a column whose missing values read as `None` or `NaN`
+depending on your pandas version — test them with `pandas.isna()` rather than
+`is None`. Note that `.dropna()` on such a frame will now discard every
+historical row. The same field is present on `fb.screener.congress_house()`
+and `fb.screener.congress_senate()` rows.
+
+`date_from` / `date_to` bound the **transaction** date, not the disclosure
+date — a trade executed inside the window is returned even if it was disclosed
+after `date_to`.
+
+```python
+trades = fb.house_trades.ticker("AMZN")["trades"]
+lag_days = [
+    (pd.Timestamp(t["disclosureDate"]) - pd.Timestamp(t["date"])).days
+    for t in trades
+    if t["disclosureDate"]
+]
+```
+
 ## ⚡ Async Usage
 
 For async/await support, install with the `async` extra:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/README.md

@@ -56,6 +56,7 @@ fb.analyst_ratings.ticker("AMZN",
                           as_dataframe=True)
 
 # ---------- house trades ----------
+# Rows include `disclosureDate` alongside the transaction `date`.
 fb.house_trades.ticker("AMZN",
                        date_from="2025-01-01",
                        date_to="2025-06-30",
@@ -127,12 +128,45 @@ fb.screener.insider_trading(limit=50)
 fb.screener.reddit_mentions(limit=100, as_dataframe=True)
 fb.screener.government_contracts(limit=100, as_dataframe=True)
 fb.screener.patent_filings(limit=100, as_dataframe=True)
+fb.screener.congress_house(limit=50)     # rows carry `disclosureDate`
+fb.screener.congress_senate(limit=50)
 
 # ---------- recent data ----------
 fb.recent.news(limit=100, as_dataframe=True)
 fb.recent.analyst_ratings(limit=50)
 ```
 
+### Congressional trade dates
+
+House and Senate trade rows carry **two** dates, and the gap between them is
+the reporting lag — often weeks:
+
+| Field            | Meaning                                                          |
+| ---------------- | ---------------------------------------------------------------- |
+| `date`           | Transaction date — when the member actually bought or sold        |
+| `disclosureDate` | Public disclosure date — when the periodic transaction report ran |
+
+`disclosureDate` is `null` on historical rows collected before the field was
+captured upstream. With `as_dataframe=True`, `date` is the **index** and
+`disclosureDate` is a column whose missing values read as `None` or `NaN`
+depending on your pandas version — test them with `pandas.isna()` rather than
+`is None`. Note that `.dropna()` on such a frame will now discard every
+historical row. The same field is present on `fb.screener.congress_house()`
+and `fb.screener.congress_senate()` rows.
+
+`date_from` / `date_to` bound the **transaction** date, not the disclosure
+date — a trade executed inside the window is returned even if it was disclosed
+after `date_to`.
+
+```python
+trades = fb.house_trades.ticker("AMZN")["trades"]
+lag_days = [
+    (pd.Timestamp(t["disclosureDate"]) - pd.Timestamp(t["date"])).days
+    for t in trades
+    if t["disclosureDate"]
+]
+```
+
 ## ⚡ Async Usage
 
 For async/await support, install with the `async` extra:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/pyproject.toml

@@ -60,3 +60,22 @@ markers = [
 python_version = "3.10"
 files = ["src/finbrain"]
 ignore_missing_imports = true   # third-party libs (pandas, plotly, …) ship no stubs here
+
+# numpy ships inline stubs that use PEP 695 `type` statements. mypy refuses to
+# parse those unless BOTH its target `python_version` and the interpreter it is
+# running under are 3.12+, so a numpy release can abort the whole run ("Type
+# statement is only supported in Python 3.12 and greater") on any matrix job
+# below 3.12 -- with no change to this codebase. Nothing in the public API
+# surfaces numpy types, so skip its stubs rather than chasing numpy's baseline.
+[[tool.mypy.overrides]]
+module = ["numpy.*"]
+follow_imports = "skip"
+follow_imports_for_stubs = true
+
+[tool.ruff.lint]
+# Pin the rule set explicitly. `ruff check .` otherwise follows whatever ruff's
+# current defaults happen to be, so a new ruff release can turn CI red with no
+# code change (0.16.0 widened the defaults and surfaced hundreds of findings in
+# code that had been passing). These four are ruff's long-standing defaults, so
+# this preserves existing behaviour rather than changing it.
+select = ["E4", "E7", "E9", "F"]

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain/aio/endpoints/house_trades.py

@@ -24,7 +24,19 @@ class AsyncHouseTradesAPI:
         limit: int | None = None,
         as_dataframe: bool = False,
     ) -> Dict[str, Any] | pd.DataFrame:
-        """Fetch House-member trades for a symbol (async)."""
+        """
+        Fetch House-member trades for a symbol (async).
+
+        Each row in ``trades`` carries ``date`` (the transaction date),
+        ``politician``, ``transactionType``, ``amount`` and
+        ``disclosureDate`` — the date the trade was publicly disclosed in the
+        member's periodic transaction report. ``disclosureDate`` is ``None``
+        for historical rows collected before the field was captured (``NaN``
+        in the DataFrame branch on newer pandas — use ``pandas.isna``).
+
+        ``date_from``/``date_to`` bound the transaction date, not the
+        disclosure date.
+        """
         params: Dict[str, str] = {}
         if date_from:
             params["startDate"] = to_datestr(date_from)

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain/aio/endpoints/screener.py

@@ -107,7 +107,13 @@ class AsyncScreenerAPI:
         limit: int | None = None,
         as_dataframe: bool = False,
     ) -> List[Dict[str, Any]] | pd.DataFrame:
-        """Screen House trades across all tickers."""
+        """
+        Screen House trades across all tickers.
+
+        Rows carry ``symbol``, ``name``, ``date``, ``politician``,
+        ``transactionType``, ``amount`` and ``disclosureDate`` (the public
+        disclosure date, ``None`` on historical rows).
+        """
         params = self._build_params(limit=limit)
         return await self._get("screener/congress/house", params, as_dataframe)
 
@@ -119,7 +125,13 @@ class AsyncScreenerAPI:
         limit: int | None = None,
         as_dataframe: bool = False,
     ) -> List[Dict[str, Any]] | pd.DataFrame:
-        """Screen Senate trades across all tickers."""
+        """
+        Screen Senate trades across all tickers.
+
+        Rows carry ``symbol``, ``name``, ``date``, ``politician``,
+        ``transactionType``, ``amount`` and ``disclosureDate`` (the public
+        disclosure date, ``None`` on historical rows).
+        """
         params = self._build_params(limit=limit)
         return await self._get("screener/congress/senate", params, as_dataframe)
 

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain/aio/endpoints/senate_trades.py

@@ -24,7 +24,19 @@ class AsyncSenateTradesAPI:
         limit: int | None = None,
         as_dataframe: bool = False,
     ) -> Dict[str, Any] | pd.DataFrame:
-        """Fetch Senate-member trades for a symbol (async)."""
+        """
+        Fetch Senate-member trades for a symbol (async).
+
+        Each row in ``trades`` carries ``date`` (the transaction date),
+        ``politician``, ``transactionType``, ``amount`` and
+        ``disclosureDate`` — the date the trade was publicly disclosed in the
+        member's periodic transaction report. ``disclosureDate`` is ``None``
+        for historical rows collected before the field was captured (``NaN``
+        in the DataFrame branch on newer pandas — use ``pandas.isna``).
+
+        ``date_from``/``date_to`` bound the transaction date, not the
+        disclosure date.
+        """
         params: Dict[str, str] = {}
         if date_from:
             params["startDate"] = to_datestr(date_from)

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain/endpoints/house_trades.py

@@ -49,6 +49,30 @@ class HouseTradesAPI:
         Returns
         -------
         dict | pandas.DataFrame
+            The raw dict has a ``trades`` list whose rows carry ``date``
+            (the transaction date), ``politician``, ``transactionType``,
+            ``amount`` and ``disclosureDate`` — the date the trade was
+            publicly disclosed in the member's periodic transaction report.
+            The gap between the two dates is the reporting lag.
+
+            ``disclosureDate`` is ``None`` for historical rows collected
+            before the field was captured upstream. In the DataFrame branch
+            ``date`` becomes the index and ``disclosureDate`` is a column
+            whose missing values read as ``None`` or ``NaN`` depending on the
+            pandas version — test them with :func:`pandas.isna`.
+
+        Notes
+        -----
+        ``date_from`` and ``date_to`` bound the **transaction** date, not the
+        disclosure date. A trade executed inside the window is returned even
+        if it was disclosed after ``date_to``.
+
+        Example row::
+
+            {"date": "2026-06-15", "politician": "Jane Doe",
+             "transactionType": "Purchase", "amount": "$1,001 - $15,000",
+             "disclosureDate": "2026-07-01"}
+
         """
         params: Dict[str, str] = {}
         if date_from:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain/endpoints/screener.py

@@ -112,7 +112,13 @@ class ScreenerAPI:
         limit: int | None = None,
         as_dataframe: bool = False,
     ) -> List[Dict[str, Any]] | pd.DataFrame:
-        """Screen House trades across all tickers."""
+        """
+        Screen House trades across all tickers.
+
+        Rows carry ``symbol``, ``name``, ``date``, ``politician``,
+        ``transactionType``, ``amount`` and ``disclosureDate`` (the public
+        disclosure date, ``None`` on historical rows).
+        """
         params = self._build_params(limit=limit)
         return self._get("screener/congress/house", params, as_dataframe)
 
@@ -124,7 +130,13 @@ class ScreenerAPI:
         limit: int | None = None,
         as_dataframe: bool = False,
     ) -> List[Dict[str, Any]] | pd.DataFrame:
-        """Screen Senate trades across all tickers."""
+        """
+        Screen Senate trades across all tickers.
+
+        Rows carry ``symbol``, ``name``, ``date``, ``politician``,
+        ``transactionType``, ``amount`` and ``disclosureDate`` (the public
+        disclosure date, ``None`` on historical rows).
+        """
         params = self._build_params(limit=limit)
         return self._get("screener/congress/senate", params, as_dataframe)
 

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain/endpoints/senate_trades.py

@@ -49,6 +49,30 @@ class SenateTradesAPI:
         Returns
         -------
         dict | pandas.DataFrame
+            The raw dict has a ``trades`` list whose rows carry ``date``
+            (the transaction date), ``politician``, ``transactionType``,
+            ``amount`` and ``disclosureDate`` — the date the trade was
+            publicly disclosed in the member's periodic transaction report.
+            The gap between the two dates is the reporting lag.
+
+            ``disclosureDate`` is ``None`` for historical rows collected
+            before the field was captured upstream. In the DataFrame branch
+            ``date`` becomes the index and ``disclosureDate`` is a column
+            whose missing values read as ``None`` or ``NaN`` depending on the
+            pandas version — test them with :func:`pandas.isna`.
+
+        Notes
+        -----
+        ``date_from`` and ``date_to`` bound the **transaction** date, not the
+        disclosure date. A trade executed inside the window is returned even
+        if it was disclosed after ``date_to``.
+
+        Example row::
+
+            {"date": "2026-06-10", "politician": "Jane Doe",
+             "transactionType": "Purchase", "amount": "$1,001 - $15,000",
+             "disclosureDate": "2026-06-25"}
+
         """
         params: Dict[str, str] = {}
         if date_from:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finbrain-python
-Version: 0.2.5
+Version: 0.2.7
 Summary: Official Python client for the FinBrain API
 Author-email: Ahmet Salim Bilgin <ahmet@finbrain.tech>
 License-Expression: MIT
@@ -84,6 +84,7 @@ fb.analyst_ratings.ticker("AMZN",
                           as_dataframe=True)
 
 # ---------- house trades ----------
+# Rows include `disclosureDate` alongside the transaction `date`.
 fb.house_trades.ticker("AMZN",
                        date_from="2025-01-01",
                        date_to="2025-06-30",
@@ -155,12 +156,45 @@ fb.screener.insider_trading(limit=50)
 fb.screener.reddit_mentions(limit=100, as_dataframe=True)
 fb.screener.government_contracts(limit=100, as_dataframe=True)
 fb.screener.patent_filings(limit=100, as_dataframe=True)
+fb.screener.congress_house(limit=50)     # rows carry `disclosureDate`
+fb.screener.congress_senate(limit=50)
 
 # ---------- recent data ----------
 fb.recent.news(limit=100, as_dataframe=True)
 fb.recent.analyst_ratings(limit=50)
 ```
 
+### Congressional trade dates
+
+House and Senate trade rows carry **two** dates, and the gap between them is
+the reporting lag — often weeks:
+
+| Field            | Meaning                                                          |
+| ---------------- | ---------------------------------------------------------------- |
+| `date`           | Transaction date — when the member actually bought or sold        |
+| `disclosureDate` | Public disclosure date — when the periodic transaction report ran |
+
+`disclosureDate` is `null` on historical rows collected before the field was
+captured upstream. With `as_dataframe=True`, `date` is the **index** and
+`disclosureDate` is a column whose missing values read as `None` or `NaN`
+depending on your pandas version — test them with `pandas.isna()` rather than
+`is None`. Note that `.dropna()` on such a frame will now discard every
+historical row. The same field is present on `fb.screener.congress_house()`
+and `fb.screener.congress_senate()` rows.
+
+`date_from` / `date_to` bound the **transaction** date, not the disclosure
+date — a trade executed inside the window is returned even if it was disclosed
+after `date_to`.
+
+```python
+trades = fb.house_trades.ticker("AMZN")["trades"]
+lag_days = [
+    (pd.Timestamp(t["disclosureDate"]) - pd.Timestamp(t["date"])).days
+    for t in trades
+    if t["disclosureDate"]
+]
+```
+
 ## ⚡ Async Usage
 
 For async/await support, install with the `async` extra:

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/src/finbrain_python.egg-info/SOURCES.txt

@@ -58,6 +58,8 @@ src/finbrain_python.egg-info/PKG-INFO
 src/finbrain_python.egg-info/SOURCES.txt
 src/finbrain_python.egg-info/dependency_links.txt
 src/finbrain_python.egg-info/requires.txt
+src/finbrain_python.egg-info/scm_file_list.json
+src/finbrain_python.egg-info/scm_version.json
 src/finbrain_python.egg-info/top_level.txt
 tests/__init__.py
 tests/conftest.py

finbrain_python-0.2.7/src/finbrain_python.egg-info/scm_file_list.json

@@ -0,0 +1,85 @@
+{
+  "files": [
+    "CHANGELOG.md",
+    ".gitattributes",
+    "pyproject.toml",
+    "LICENSE",
+    "README.md",
+    "RELEASE.md",
+    ".gitignore",
+    ".github/workflows/ci.yml",
+    ".github/workflows/release.yml",
+    "examples/transactions_plotting_example.py",
+    "examples/async_example.py",
+    "tests/test_available.py",
+    "tests/test_async_client.py",
+    "tests/test_insider_transactions.py",
+    "tests/test_reddit_mentions.py",
+    "tests/test_plotting.py",
+    "tests/test_house_trades.py",
+    "tests/test_sentiments.py",
+    "tests/test_corporate_lobbying.py",
+    "tests/test_options.py",
+    "tests/test_envelope.py",
+    "tests/__init__.py",
+    "tests/test_patent_filings.py",
+    "tests/test_integration.py",
+    "tests/test_linkedin_data.py",
+    "tests/test_client.py",
+    "tests/test_app_ratings.py",
+    "tests/test_recent.py",
+    "tests/test_screener.py",
+    "tests/test_news.py",
+    "tests/conftest.py",
+    "tests/test_utils.py",
+    "tests/test_analyst_ratings.py",
+    "tests/test_predictions.py",
+    "tests/test_senate_trades.py",
+    "tests/test_government_contracts.py",
+    "src/finbrain/py.typed",
+    "src/finbrain/__init__.py",
+    "src/finbrain/client.py",
+    "src/finbrain/exceptions.py",
+    "src/finbrain/plotting.py",
+    "src/finbrain/aio/__init__.py",
+    "src/finbrain/aio/client.py",
+    "src/finbrain/aio/endpoints/app_ratings.py",
+    "src/finbrain/aio/endpoints/available.py",
+    "src/finbrain/aio/endpoints/predictions.py",
+    "src/finbrain/aio/endpoints/corporate_lobbying.py",
+    "src/finbrain/aio/endpoints/reddit_mentions.py",
+    "src/finbrain/aio/endpoints/__init__.py",
+    "src/finbrain/aio/endpoints/patent_filings.py",
+    "src/finbrain/aio/endpoints/options.py",
+    "src/finbrain/aio/endpoints/linkedin_data.py",
+    "src/finbrain/aio/endpoints/_utils.py",
+    "src/finbrain/aio/endpoints/senate_trades.py",
+    "src/finbrain/aio/endpoints/insider_transactions.py",
+    "src/finbrain/aio/endpoints/analyst_ratings.py",
+    "src/finbrain/aio/endpoints/house_trades.py",
+    "src/finbrain/aio/endpoints/news.py",
+    "src/finbrain/aio/endpoints/sentiments.py",
+    "src/finbrain/aio/endpoints/recent.py",
+    "src/finbrain/aio/endpoints/screener.py",
+    "src/finbrain/aio/endpoints/government_contracts.py",
+    "src/finbrain/endpoints/app_ratings.py",
+    "src/finbrain/endpoints/available.py",
+    "src/finbrain/endpoints/predictions.py",
+    "src/finbrain/endpoints/corporate_lobbying.py",
+    "src/finbrain/endpoints/reddit_mentions.py",
+    "src/finbrain/endpoints/__init__.py",
+    "src/finbrain/endpoints/patent_filings.py",
+    "src/finbrain/endpoints/options.py",
+    "src/finbrain/endpoints/linkedin_data.py",
+    "src/finbrain/endpoints/_utils.py",
+    "src/finbrain/endpoints/senate_trades.py",
+    "src/finbrain/endpoints/insider_transactions.py",
+    "src/finbrain/endpoints/analyst_ratings.py",
+    "src/finbrain/endpoints/house_trades.py",
+    "src/finbrain/endpoints/news.py",
+    "src/finbrain/endpoints/sentiments.py",
+    "src/finbrain/endpoints/recent.py",
+    "src/finbrain/endpoints/screener.py",
+    "src/finbrain/endpoints/government_contracts.py"
+  ]
+}

finbrain_python-0.2.7/src/finbrain_python.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.2.7",
+  "distance": 0,
+  "node": "g417d20b49dbd91b3e9804d09e94527a560dce33e",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-24"
+}

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/tests/test_house_trades.py

@@ -21,6 +21,7 @@ def test_house_trades_raw_ok(client, _activate_responses):
                 "politician": "Nancy Pelosi",
                 "transactionType": "Purchase",
                 "amount": "$15,001 - $50,000",
+                "disclosureDate": "2024-02-05",
             }
         ],
     })
@@ -31,6 +32,7 @@ def test_house_trades_raw_ok(client, _activate_responses):
     assert data["symbol"] == TICKER
     assert isinstance(data["trades"], list)
     assert data["trades"][0]["politician"] == "Nancy Pelosi"
+    assert data["trades"][0]["disclosureDate"] == "2024-02-05"
 
 
 # ─────────── DataFrame branch ───────────────────────────────────────────
@@ -46,12 +48,14 @@ def test_house_trades_dataframe_ok(client, _activate_responses):
                 "politician": "Nancy Pelosi",
                 "transactionType": "Purchase",
                 "amount": "$15,001 - $50,000",
+                "disclosureDate": "2024-02-05",
             },
             {
                 "date": "2024-01-10",
                 "politician": "Pete Sessions",
                 "transactionType": "Sale",
                 "amount": "$1,001 - $15,000",
+                "disclosureDate": None,
             },
         ],
     })
@@ -62,7 +66,12 @@ def test_house_trades_dataframe_ok(client, _activate_responses):
 
     assert isinstance(df, pd.DataFrame)
     assert len(df) == 2
-    assert set(df.columns) == {"politician", "transactionType", "amount"}
+    assert set(df.columns) == {
+        "politician",
+        "transactionType",
+        "amount",
+        "disclosureDate",
+    }
     assert df.index.name == "date"
     assert pd.api.types.is_datetime64_any_dtype(df.index)
     assert pd.Timestamp("2024-01-15") in df.index
@@ -70,6 +79,10 @@ def test_house_trades_dataframe_ok(client, _activate_responses):
     assert df.loc["2024-01-10", "politician"] == "Pete Sessions"
     assert df.loc["2024-01-15", "transactionType"] == "Purchase"
     assert df.loc["2024-01-15", "amount"] == "$15,001 - $50,000"
+    assert df.loc["2024-01-15", "disclosureDate"] == "2024-02-05"
+    # Historical rows predate the disclosure-date field; JSON null becomes
+    # NaN once pandas builds the column.
+    assert pd.isna(df.loc["2024-01-10", "disclosureDate"])
 
 
 # ─────────── error mapping ──────────────────────────────────────────────

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/tests/test_integration.py

@@ -230,6 +230,9 @@ class TestHouseTrades:
             assert "date" in trades[0]
             assert "politician" in trades[0]
             assert "transactionType" in trades[0]
+            # Present on every row; null on rows collected before the
+            # disclosure-date field was added to the pipeline.
+            assert "disclosureDate" in trades[0]
 
     def test_dataframe(self, fb):
         df = fb.house_trades.ticker(TICKER, as_dataframe=True)
@@ -237,6 +240,9 @@ class TestHouseTrades:
         if len(df) > 0:
             assert df.index.name == "date"
             assert "politician" in df.columns
+            # Survives the DataFrame conversion as a column (values may be
+            # null on rows predating the upstream field).
+            assert "disclosureDate" in df.columns
 
 
 # =====================================================================
@@ -252,6 +258,9 @@ class TestSenateTrades:
         if len(trades) > 0:
             assert "date" in trades[0]
             assert "politician" in trades[0]
+            # Present on every row; null on rows collected before the
+            # disclosure-date field was added to the pipeline.
+            assert "disclosureDate" in trades[0]
 
     def test_dataframe(self, fb):
         df = fb.senate_trades.ticker(TICKER, as_dataframe=True)
@@ -259,6 +268,9 @@ class TestSenateTrades:
         if len(df) > 0:
             assert df.index.name == "date"
             assert "politician" in df.columns
+            # Survives the DataFrame conversion as a column (values may be
+            # null on rows predating the upstream field).
+            assert "disclosureDate" in df.columns
 
 
 # =====================================================================
@@ -503,10 +515,14 @@ class TestScreener:
     def test_congress_house(self, fb):
         data = fb.screener.congress_house(limit=5)
         assert isinstance(data, list)
+        if data:
+            assert "disclosureDate" in data[0]
 
     def test_congress_senate(self, fb):
         data = fb.screener.congress_senate(limit=5)
         assert isinstance(data, list)
+        if data:
+            assert "disclosureDate" in data[0]
 
     def test_news(self, fb):
         data = fb.screener.news(limit=5)

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/tests/test_screener.py

@@ -95,53 +95,93 @@ def test_screener_insider_trading_dataframe(client, _activate_responses):
 # ── congress house ─────────────────────────────────────────────────────
 def test_screener_congress_house(client, _activate_responses):
     payload = wrap_v2([
-        {"symbol": "AAPL", "name": "Apple", "politician": "Nancy Pelosi"},
+        {
+            "symbol": "AAPL",
+            "name": "Apple",
+            "politician": "Nancy Pelosi",
+            "disclosureDate": "2026-02-05",
+        },
     ])
     stub_json(_activate_responses, "GET", "screener/congress/house", payload, params={"limit": "5"})
     data = client.screener.congress_house(limit=5)
     assert isinstance(data, list)
     assert len(data) == 1
     assert data[0]["politician"] == "Nancy Pelosi"
+    assert data[0]["disclosureDate"] == "2026-02-05"
 
 
 def test_screener_congress_house_dataframe(client, _activate_responses):
     payload = wrap_v2([
-        {"symbol": "AAPL", "name": "Apple", "politician": "Nancy Pelosi"},
-        {"symbol": "MSFT", "name": "Microsoft", "politician": "Dan Crenshaw"},
+        {
+            "symbol": "AAPL",
+            "name": "Apple",
+            "politician": "Nancy Pelosi",
+            "disclosureDate": "2026-02-05",
+        },
+        {
+            "symbol": "MSFT",
+            "name": "Microsoft",
+            "politician": "Dan Crenshaw",
+            "disclosureDate": None,
+        },
     ])
     stub_json(_activate_responses, "GET", "screener/congress/house", payload, params={"limit": "5"})
     df = client.screener.congress_house(limit=5, as_dataframe=True)
     assert isinstance(df, pd.DataFrame)
     assert len(df) == 2
     assert df.index.name == "symbol"
-    assert set(df.columns) == {"name", "politician"}
+    assert set(df.columns) == {"name", "politician", "disclosureDate"}
     assert df.loc["AAPL", "politician"] == "Nancy Pelosi"
+    assert df.loc["AAPL", "disclosureDate"] == "2026-02-05"
+    # Historical rows predate the disclosure-date field; JSON null becomes
+    # NaN once pandas builds the column.
+    assert pd.isna(df.loc["MSFT", "disclosureDate"])
 
 
 # ── congress senate ────────────────────────────────────────────────────
 def test_screener_congress_senate(client, _activate_responses):
     payload = wrap_v2([
-        {"symbol": "AAPL", "name": "Apple", "politician": "John Boozman"},
+        {
+            "symbol": "AAPL",
+            "name": "Apple",
+            "politician": "John Boozman",
+            "disclosureDate": "2026-01-22",
+        },
     ])
     stub_json(_activate_responses, "GET", "screener/congress/senate", payload, params={"limit": "5"})
     data = client.screener.congress_senate(limit=5)
     assert isinstance(data, list)
     assert len(data) == 1
     assert data[0]["politician"] == "John Boozman"
+    assert data[0]["disclosureDate"] == "2026-01-22"
 
 
 def test_screener_congress_senate_dataframe(client, _activate_responses):
     payload = wrap_v2([
-        {"symbol": "AAPL", "name": "Apple", "politician": "John Boozman"},
-        {"symbol": "NVDA", "name": "NVIDIA", "politician": "Tommy Tuberville"},
+        {
+            "symbol": "AAPL",
+            "name": "Apple",
+            "politician": "John Boozman",
+            "disclosureDate": "2026-01-22",
+        },
+        {
+            "symbol": "NVDA",
+            "name": "NVIDIA",
+            "politician": "Tommy Tuberville",
+            "disclosureDate": None,
+        },
     ])
     stub_json(_activate_responses, "GET", "screener/congress/senate", payload, params={"limit": "5"})
     df = client.screener.congress_senate(limit=5, as_dataframe=True)
     assert isinstance(df, pd.DataFrame)
     assert len(df) == 2
     assert df.index.name == "symbol"
-    assert set(df.columns) == {"name", "politician"}
+    assert set(df.columns) == {"name", "politician", "disclosureDate"}
     assert df.loc["NVDA", "politician"] == "Tommy Tuberville"
+    assert df.loc["AAPL", "disclosureDate"] == "2026-01-22"
+    # Historical rows predate the disclosure-date field; JSON null becomes
+    # NaN once pandas builds the column.
+    assert pd.isna(df.loc["NVDA", "disclosureDate"])
 
 
 # ── news ───────────────────────────────────────────────────────────────

{finbrain_python-0.2.5 → finbrain_python-0.2.7}/tests/test_senate_trades.py

@@ -21,6 +21,7 @@ def test_senate_trades_raw_ok(client, _activate_responses):
                 "politician": "Shelley Moore Capito",
                 "transactionType": "Purchase",
                 "amount": "$1,001 - $15,000",
+                "disclosureDate": "2024-01-30",
             }
         ],
     })
@@ -31,6 +32,7 @@ def test_senate_trades_raw_ok(client, _activate_responses):
     assert data["symbol"] == TICKER
     assert isinstance(data["trades"], list)
     assert data["trades"][0]["politician"] == "Shelley Moore Capito"
+    assert data["trades"][0]["disclosureDate"] == "2024-01-30"
 
 
 # ─────────── DataFrame branch ───────────────────────────────────────────
@@ -46,12 +48,14 @@ def test_senate_trades_dataframe_ok(client, _activate_responses):
                 "politician": "Shelley Moore Capito",
                 "transactionType": "Purchase",
                 "amount": "$1,001 - $15,000",
+                "disclosureDate": "2024-01-30",
             },
             {
                 "date": "2024-01-08",
                 "politician": "John Boozman",
                 "transactionType": "Purchase",
                 "amount": "$1,001 - $15,000",
+                "disclosureDate": None,
             },
         ],
     })
@@ -62,7 +66,12 @@ def test_senate_trades_dataframe_ok(client, _activate_responses):
 
     assert isinstance(df, pd.DataFrame)
     assert len(df) == 2
-    assert set(df.columns) == {"politician", "transactionType", "amount"}
+    assert set(df.columns) == {
+        "politician",
+        "transactionType",
+        "amount",
+        "disclosureDate",
+    }
     assert df.index.name == "date"
     assert pd.api.types.is_datetime64_any_dtype(df.index)
     assert pd.Timestamp("2024-01-15") in df.index
@@ -70,6 +79,10 @@ def test_senate_trades_dataframe_ok(client, _activate_responses):
     assert df.loc["2024-01-08", "politician"] == "John Boozman"
     assert df.loc["2024-01-15", "transactionType"] == "Purchase"
     assert df.loc["2024-01-08", "amount"] == "$1,001 - $15,000"
+    assert df.loc["2024-01-15", "disclosureDate"] == "2024-01-30"
+    # Historical rows predate the disclosure-date field; JSON null becomes
+    # NaN once pandas builds the column.
+    assert pd.isna(df.loc["2024-01-08", "disclosureDate"])
 
 
 # ─────────── error mapping ──────────────────────────────────────────────