direct-cli 0.3.2__tar.gz → 0.3.4__tar.gz

direct_cli-0.3.4/.github/workflows/quality.yml

@@ -0,0 +1,33 @@
+name: Quality
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  quality:
+    name: quality
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install package with dev dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Type check
+        run: mypy .
+
+      - name: Run offline tests
+        run: pytest -m "not integration"

direct_cli-0.3.4/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.3.3
+
+**BREAKING CHANGE:** OAuth profiles created before 0.3.3 (without `refresh_token` and `expires_at`) are no longer accepted. Any such profile will fail immediately with an "incomplete profile" error. Run `direct auth login --profile <name>` to re-authenticate and create a valid 0.3.3 profile.
+
+- Added refresh token persistence for OAuth profiles.
+- Added automatic OAuth access token refresh before expiry.
+- Added `expires_in` details to `direct auth status`.
+- Added JSON output for `direct auth status`.
+- Kept `direct auth login --oauth-token` as a manual access-token import without auto-refresh.

{direct_cli-0.3.2 → direct_cli-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.3.2
+Version: 0.3.4
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -33,9 +33,13 @@ Requires-Dist: pytest-recording>=0.13; extra == "dev"
 Requires-Dist: vcrpy>=6.0; extra == "dev"
 Requires-Dist: black>=22.0; extra == "dev"
 Requires-Dist: flake8>=4.0; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
 Requires-Dist: requests>=2.0; extra == "dev"
 Requires-Dist: beautifulsoup4>=4.12; extra == "dev"
 Requires-Dist: lxml>=4.9; extra == "dev"
+Requires-Dist: types-setuptools; extra == "dev"
+Requires-Dist: types-tabulate; extra == "dev"
 
 # Direct CLI
 
@@ -83,7 +87,6 @@ OAuth and profile commands:
 direct auth login
 direct auth login --profile agency1
 direct auth login --code abc123 --profile agency1
-direct auth login --oauth-token y0_example --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -95,6 +98,8 @@ Notes:
 - Select credentials with `--profile`.
 - `--login` remains Direct client login.
 - Authorization is performed via `direct auth login`.
+- OAuth profiles store refresh tokens and refresh access tokens automatically.
+- `direct auth login --oauth-token TOKEN` is a manual access-token import and does not auto-refresh.
 - Alias `auth_login` is not supported.
 
 Credential resolution priority:
@@ -156,24 +161,35 @@ direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:
 
 ### V4 Live Finance
 
-`get-credit-limits` requires a financial token and operation number. Pass them
-with `--finance-token` and `--operation-num`, or set
-`YANDEX_DIRECT_FINANCE_TOKEN` and `YANDEX_DIRECT_OPERATION_NUM`.
-Money mutation commands are dry-run-only in this release and always require
-`--dry-run`; dry-run output masks the financial token.
+Finance methods require an extra financial token for money operations. In the
+Yandex Direct web UI, open Tools -> API -> Financial operations, enable the
+financial operations checkbox, click Save, then issue the master token on the
+same Financial operations page and confirm by SMS. Direct CLI can compute the
+per-request token from `--master-token`, `--operation-num`, and
+`--finance-login`; alternatively pass a precomputed token with `--finance-token`.
+Environment variables are
+`YANDEX_DIRECT_MASTER_TOKEN`, `YANDEX_DIRECT_FINANCE_LOGIN`,
+`YANDEX_DIRECT_FINANCE_TOKEN`, and `YANDEX_DIRECT_OPERATION_NUM`.
+`transfer-money` and `pay-campaigns` are dry-run-only in this release and
+always require `--dry-run`; `create-invoice` can be sent live when `--dry-run`
+is omitted. Dry-run output masks the financial token.
 
 ```bash
-direct v4finance get-credit-limits --logins client-login --finance-token FINANCE_TOKEN --operation-num 123
+direct v4finance get-clients-units --logins client-login,other-client --format table
+direct v4finance get-credit-limits --logins client-login --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login
 direct v4finance get-credit-limits --logins client-login,other-client --format table
+direct v4finance create-invoice --payment 123=100.50 --payment 456=25 --currency RUB --master-token MASTER_TOKEN --operation-num 124 --finance-login agency-login --dry-run
 direct v4finance check-payment --custom-transaction-id A123456789012345678901234567890B
-direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
-direct v4finance pay-campaigns --campaign-id 123 --amount 100.50 --contract-id CONTRACT_ID --pay-method CREDIT --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
+direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --currency RUB --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
+direct v4finance pay-campaigns --campaign-ids 123,456 --amount 100.50 --currency RUB --contract-id CONTRACT_ID --pay-method Bank --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
 ```
 
 ### V4 Live Shared Account
 
 Shared-account mutations are dry-run-only in this release and always require
-`--dry-run`.
+`--dry-run`. These commands follow the official v4 Live shared-account method
+shapes: `EnableSharedAccount` accepts one client `Login`, and
+`AccountManagement` updates shared-account settings through `Accounts`.
 
 ```bash
 direct v4account enable-shared-account --client-login client-login --dry-run
@@ -583,7 +599,7 @@ CI runs a scheduled API coverage workflow that:
 
 `WRITE_SANDBOX` smoke is a live check against the Yandex Direct **sandbox**.
 It does not replay stored HTTP traffic and it does not create new recordings.
-Run it only when you intentionally want to call `api-sandbox.direct.yandex.com`:
+Run it only when you intentionally want to call `api-sandbox.direct.yandex.ru`:
 
 ```bash
 set -a && source .env && set +a
@@ -725,13 +741,16 @@ OAuth и profile-команды:
 direct auth login
 direct auth login --profile agency1
 direct auth login --code abc123 --profile agency1
-direct auth login --oauth-token y0_example --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
 direct --profile agency1 campaigns get
 ```
 
+Примечания:
+- OAuth profiles сохраняют refresh token и автоматически обновляют access token.
+- `direct auth login --oauth-token TOKEN` импортирует access token вручную и не включает auto-refresh.
+
 Порядок выбора credentials:
 
 | Приоритет | Источник | Пример |
@@ -1176,7 +1195,7 @@ YANDEX_DIRECT_LIVE_WRITE=1 pytest -m integration_live_write -v --record-mode=rew
 `WRITE_SANDBOX` smoke — это live-проверка против **sandbox-окружения**
 Яндекс Директа. Она не воспроизводит сохранённый HTTP-трафик и не создаёт
 новые записи. Запускайте её только когда намеренно хотите обратиться к
-`api-sandbox.direct.yandex.com`:
+`api-sandbox.direct.yandex.ru`:
 
 ```bash
 set -a && source .env && set +a

{direct_cli-0.3.2 → direct_cli-0.3.4}/README.md

@@ -44,7 +44,6 @@ OAuth and profile commands:
 direct auth login
 direct auth login --profile agency1
 direct auth login --code abc123 --profile agency1
-direct auth login --oauth-token y0_example --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -56,6 +55,8 @@ Notes:
 - Select credentials with `--profile`.
 - `--login` remains Direct client login.
 - Authorization is performed via `direct auth login`.
+- OAuth profiles store refresh tokens and refresh access tokens automatically.
+- `direct auth login --oauth-token TOKEN` is a manual access-token import and does not auto-refresh.
 - Alias `auth_login` is not supported.
 
 Credential resolution priority:
@@ -117,24 +118,35 @@ direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:
 
 ### V4 Live Finance
 
-`get-credit-limits` requires a financial token and operation number. Pass them
-with `--finance-token` and `--operation-num`, or set
-`YANDEX_DIRECT_FINANCE_TOKEN` and `YANDEX_DIRECT_OPERATION_NUM`.
-Money mutation commands are dry-run-only in this release and always require
-`--dry-run`; dry-run output masks the financial token.
+Finance methods require an extra financial token for money operations. In the
+Yandex Direct web UI, open Tools -> API -> Financial operations, enable the
+financial operations checkbox, click Save, then issue the master token on the
+same Financial operations page and confirm by SMS. Direct CLI can compute the
+per-request token from `--master-token`, `--operation-num`, and
+`--finance-login`; alternatively pass a precomputed token with `--finance-token`.
+Environment variables are
+`YANDEX_DIRECT_MASTER_TOKEN`, `YANDEX_DIRECT_FINANCE_LOGIN`,
+`YANDEX_DIRECT_FINANCE_TOKEN`, and `YANDEX_DIRECT_OPERATION_NUM`.
+`transfer-money` and `pay-campaigns` are dry-run-only in this release and
+always require `--dry-run`; `create-invoice` can be sent live when `--dry-run`
+is omitted. Dry-run output masks the financial token.
 
 ```bash
-direct v4finance get-credit-limits --logins client-login --finance-token FINANCE_TOKEN --operation-num 123
+direct v4finance get-clients-units --logins client-login,other-client --format table
+direct v4finance get-credit-limits --logins client-login --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login
 direct v4finance get-credit-limits --logins client-login,other-client --format table
+direct v4finance create-invoice --payment 123=100.50 --payment 456=25 --currency RUB --master-token MASTER_TOKEN --operation-num 124 --finance-login agency-login --dry-run
 direct v4finance check-payment --custom-transaction-id A123456789012345678901234567890B
-direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
-direct v4finance pay-campaigns --campaign-id 123 --amount 100.50 --contract-id CONTRACT_ID --pay-method CREDIT --finance-token FINANCE_TOKEN --operation-num 123 --dry-run
+direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --currency RUB --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
+direct v4finance pay-campaigns --campaign-ids 123,456 --amount 100.50 --currency RUB --contract-id CONTRACT_ID --pay-method Bank --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
 ```
 
 ### V4 Live Shared Account
 
 Shared-account mutations are dry-run-only in this release and always require
-`--dry-run`.
+`--dry-run`. These commands follow the official v4 Live shared-account method
+shapes: `EnableSharedAccount` accepts one client `Login`, and
+`AccountManagement` updates shared-account settings through `Accounts`.
 
 ```bash
 direct v4account enable-shared-account --client-login client-login --dry-run
@@ -544,7 +556,7 @@ CI runs a scheduled API coverage workflow that:
 
 `WRITE_SANDBOX` smoke is a live check against the Yandex Direct **sandbox**.
 It does not replay stored HTTP traffic and it does not create new recordings.
-Run it only when you intentionally want to call `api-sandbox.direct.yandex.com`:
+Run it only when you intentionally want to call `api-sandbox.direct.yandex.ru`:
 
 ```bash
 set -a && source .env && set +a
@@ -686,13 +698,16 @@ OAuth и profile-команды:
 direct auth login
 direct auth login --profile agency1
 direct auth login --code abc123 --profile agency1
-direct auth login --oauth-token y0_example --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
 direct --profile agency1 campaigns get
 ```
 
+Примечания:
+- OAuth profiles сохраняют refresh token и автоматически обновляют access token.
+- `direct auth login --oauth-token TOKEN` импортирует access token вручную и не включает auto-refresh.
+
 Порядок выбора credentials:
 
 | Приоритет | Источник | Пример |
@@ -1137,7 +1152,7 @@ YANDEX_DIRECT_LIVE_WRITE=1 pytest -m integration_live_write -v --record-mode=rew
 `WRITE_SANDBOX` smoke — это live-проверка против **sandbox-окружения**
 Яндекс Директа. Она не воспроизводит сохранённый HTTP-трафик и не создаёт
 новые записи. Запускайте её только когда намеренно хотите обратиться к
-`api-sandbox.direct.yandex.com`:
+`api-sandbox.direct.yandex.ru`:
 
 ```bash
 set -a && source .env && set +a

direct_cli-0.3.4/direct_cli/_vendor/tapi_yandex_direct/endpoints.py

@@ -0,0 +1,14 @@
+"""Runtime endpoints for Yandex Direct API transports."""
+
+from typing import Any, Dict
+
+DIRECT_API_PRODUCTION_ROOT = "https://api.direct.yandex.ru/"
+DIRECT_API_SANDBOX_ROOT = "https://api-sandbox.direct.yandex.ru/"
+DIRECT_DEBUG_ROOT = "https://"
+
+
+def get_direct_api_root(api_params: Dict[str, Any]) -> str:
+    """Return the Direct API root for production or sandbox requests."""
+    if api_params.get("is_sandbox"):
+        return DIRECT_API_SANDBOX_ROOT
+    return DIRECT_API_PRODUCTION_ROOT

{direct_cli-0.3.2 → direct_cli-0.3.4}/direct_cli/_vendor/tapi_yandex_direct/tapi_yandex_direct.py

@@ -1,5 +1,6 @@
 import io
 import logging
+import re
 import time
 from typing import Union, Optional, Dict, List, Iterator
 
@@ -9,6 +10,7 @@ from tapi2 import TapiAdapter, generate_wrapper_from_adapter, JSONAdapterMixin
 from tapi2.exceptions import ResponseProcessException, ClientError, TapiException
 
 from . import exceptions
+from .endpoints import DIRECT_DEBUG_ROOT, get_direct_api_root
 from .resource_mapping import RESOURCE_MAPPING_V5
 
 logger = logging.getLogger(__name__)
@@ -62,6 +64,7 @@ RESULT_DICTIONARY_KEYS_OF_API_METHODS = {
     },
 }
 REPORTS_RESOURCE_URL = "/json/v5/reports"
+REPORT_SUMMARY_RE = re.compile(r"^Total rows: \d+$")
 
 
 class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
@@ -72,11 +75,8 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
 
     def get_api_root(self, api_params: dict, resource_name: str) -> str:
         if resource_name == "debugtoken":
-            return "https://"
-        elif api_params.get("is_sandbox"):
-            return "https://api-sandbox.direct.yandex.com/"
-        else:
-            return "https://api.direct.yandex.com/"
+            return DIRECT_DEBUG_ROOT
+        return get_direct_api_root(api_params)
 
     def get_request_kwargs(self, api_params: dict, *args, **kwargs) -> dict:
         """Обогащение запроса, параметрами"""
@@ -154,7 +154,7 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
                 "The report generation time has exceeded the server limit. "
                 "Please try to change the request parameters, "
                 "reduce the period or the amount of requested data.",
-                **kwargs
+                **kwargs,
             )
         elif response.status_code == 405:
             raise exceptions.YandexDirectApiError(
@@ -162,7 +162,7 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
                 "This resource does not support the HTTP method {}\n".format(
                     response.request.method
                 ),
-                **kwargs
+                **kwargs,
             )
 
         data = self.response_to_native(response)
@@ -175,10 +175,15 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
             data = super().process_response(response, request_kwargs, **kwargs)
 
         if response.request.path_url == REPORTS_RESOURCE_URL:
-            lines = self._iter_lines(data=data, response=response, **kwargs)
-            kwargs["store"]["columns"] = next(lines).split("\t")
+            self._store_report_columns(data, response, request_kwargs, **kwargs)
+            kwargs["store"]["skip_report_summary"] = self._is_skip_report_summary(
+                request_kwargs
+            )
         else:
             kwargs["store"].pop("columns", None)
+            kwargs["store"].pop("report_data_start_line", None)
+            kwargs["store"].pop("report_header_offset", None)
+            kwargs["store"].pop("skip_report_summary", None)
 
         return data
 
@@ -190,7 +195,7 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
         response: Response,
         request_kwargs: dict,
         api_params: dict,
-        **kwargs
+        **kwargs,
     ) -> None:
         if response.status_code in (201, 202):
             pass
@@ -230,7 +235,7 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
         response: Response,
         request_kwargs: dict,
         api_params: dict,
-        **kwargs
+        **kwargs,
     ) -> bool:
         status_code = response.status_code
         error_data = error_message.get("error", {})
@@ -283,7 +288,7 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
         response: Response,
         request_kwargs: dict,
         api_params: dict,
-        **kwargs
+        **kwargs,
     ) -> Optional[dict]:
         limit = response_data["result"].get("LimitedBy")
         if limit:
@@ -308,22 +313,109 @@ class YandexDirectClientAdapter(JSONAdapterMixin, TapiAdapter):
             raise NotImplementedError("For reports resource only")
 
         lines = io.StringIO(data)
-        iterator = (line.replace("\n", "") for line in lines)
+        iterator = (line.rstrip("\r\n") for line in lines)
 
         return iterator
 
+    def _store_report_columns(
+        self,
+        data: str,
+        response: Response,
+        request_kwargs: dict,
+        **kwargs,
+    ) -> None:
+        field_names = self._get_report_field_names(request_kwargs)
+        if self._is_skip_column_header(request_kwargs):
+            if not field_names:
+                raise ValueError("Report response has no column header or FieldNames")
+            data_start_line = self._find_first_report_data_line(
+                data, response, **kwargs
+            )
+            kwargs["store"]["columns"] = field_names
+            kwargs["store"]["report_data_start_line"] = data_start_line
+            kwargs["store"]["report_header_offset"] = data_start_line
+            return
+
+        for index, line in enumerate(
+            self._iter_lines(data=data, response=response, **kwargs)
+        ):
+            if self._is_report_prelude_line(line):
+                continue
+            values = line.split("\t")
+            if field_names and values == field_names:
+                kwargs["store"]["columns"] = values
+                kwargs["store"]["report_data_start_line"] = index + 1
+                kwargs["store"]["report_header_offset"] = index
+                return
+            if "\t" in line:
+                kwargs["store"]["columns"] = values
+                kwargs["store"]["report_data_start_line"] = index + 1
+                kwargs["store"]["report_header_offset"] = index
+                return
+
+        raise ValueError("Report response has no column header")
+
+    def _find_first_report_data_line(
+        self, data: str, response: Response, **kwargs
+    ) -> int:
+        for index, line in enumerate(
+            self._iter_lines(data=data, response=response, **kwargs)
+        ):
+            if self._is_report_prelude_line(line) or self._is_report_summary_line(line):
+                continue
+            return index
+        return index + 1 if "index" in locals() else 0
+
+    @staticmethod
+    def _get_report_field_names(request_kwargs: dict) -> List[str]:
+        params = request_kwargs.get("data", {}).get("params", {})
+        return list(params.get("FieldNames") or [])
+
+    @staticmethod
+    def _is_skip_column_header(request_kwargs: dict) -> bool:
+        value = request_kwargs.get("headers", {}).get("skipColumnHeader")
+        return str(value).lower() == "true"
+
+    @staticmethod
+    def _is_skip_report_summary(request_kwargs: dict) -> bool:
+        value = request_kwargs.get("headers", {}).get("skipReportSummary", True)
+        return str(value).lower() == "true"
+
+    @staticmethod
+    def _is_report_title_line(line: str) -> bool:
+        return "\t" not in line and line.strip().startswith('"')
+
+    @staticmethod
+    def _is_report_summary_line(line: str) -> bool:
+        return bool(REPORT_SUMMARY_RE.match(line.strip()))
+
+    def _is_report_prelude_line(self, line: str) -> bool:
+        return not line.strip() or self._is_report_title_line(line)
+
     def iter_lines(self, **kwargs) -> Iterator[str]:
         iterator = self._iter_lines(**kwargs)
-        next(iterator)  # skipping columns
-        yield from iterator
+        data_start_line = kwargs["store"].get("report_data_start_line", 1)
+        skip_report_summary = kwargs["store"].get("skip_report_summary", True)
+        for index, line in enumerate(iterator):
+            if index < data_start_line:
+                continue
+            if not line.strip():
+                continue
+            if skip_report_summary and self._is_report_summary_line(line):
+                continue
+            yield line
 
     def iter_values(self, **kwargs) -> Iterator[list]:
         for line in self.iter_lines(**kwargs):
-            yield line.split("\t")
+            values = line.split("\t")
+            if self._is_report_summary_line(line):
+                columns_count = len(kwargs["store"]["columns"])
+                values.extend([""] * (columns_count - len(values)))
+            yield values
 
     def iter_dicts(self, **kwargs) -> Iterator[dict]:
-        for line in self.iter_lines(**kwargs):
-            yield dict(zip(kwargs["store"]["columns"], line.split("\t")))
+        for values in self.iter_values(**kwargs):
+            yield dict(zip(kwargs["store"]["columns"], values))
 
     def to_values(self, **kwargs) -> List[list]:
         return list(self.iter_values(**kwargs))

{direct_cli-0.3.2 → direct_cli-0.3.4}/direct_cli/_vendor/tapi_yandex_direct/v4/adapter.py

@@ -18,6 +18,7 @@ from tapi2 import JSONAdapterMixin, TapiAdapter, generate_wrapper_from_adapter
 from tapi2.exceptions import ClientError, ResponseProcessException, TapiException
 
 from .. import exceptions
+from ..endpoints import get_direct_api_root
 from .resource_mapping import (
     RESOURCE_MAPPING_V4_LIVE,
     SUPPORTED_V4_METHODS,
@@ -33,9 +34,7 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
         super().__init__(*args, **kwargs)
 
     def get_api_root(self, api_params: dict, resource_name: str) -> str:
-        if api_params.get("is_sandbox"):
-            return "https://api-sandbox.direct.yandex.ru/"
-        return "https://api.direct.yandex.ru/"
+        return get_direct_api_root(api_params)
 
     def get_request_kwargs(self, api_params: dict, *args, **kwargs) -> dict:
         params = super().get_request_kwargs(api_params, *args, **kwargs)
@@ -107,7 +106,9 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
                 data = None
         return data
 
-    def process_response(self, response: Response, request_kwargs: dict, **kwargs) -> dict:
+    def process_response(
+        self, response: Response, request_kwargs: dict, **kwargs
+    ) -> dict:
         # Mirror the v5 behaviour: turn the serialised body back into a dict so
         # downstream hooks (extract, retry) can read it.
         if isinstance(request_kwargs.get("data"), (bytes, bytearray, str)):
@@ -187,8 +188,13 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
 
         return False
 
-    def extract(self, data, response: Optional[Response] = None,
-                request_kwargs: Optional[dict] = None, **kwargs):
+    def extract(
+        self,
+        data,
+        response: Optional[Response] = None,
+        request_kwargs: Optional[dict] = None,
+        **kwargs,
+    ):
         # v4 Live always nests payload under "data". For methods returning a
         # bare scalar (TransferMoney → 1), the scalar comes through unchanged.
         # response / request_kwargs are accepted but unused — they are kept