direct-cli 0.2.10__tar.gz → 0.2.11__tar.gz

{direct_cli-0.2.10 → direct_cli-0.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.2.10
+Version: 0.2.11
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -97,6 +97,23 @@ Notes:
 - Authorization is performed via `direct auth login`.
 - Alias `auth_login` is not supported.
 
+Credential resolution priority:
+
+| Priority | Source | Example |
+|----------|--------|---------|
+| 1 | Explicit CLI options | `direct --token TOKEN --login LOGIN campaigns get` |
+| 2 | OAuth profile storage | `direct --profile agency1 campaigns get` |
+| 3 | Profile-specific env vars | `YANDEX_DIRECT_TOKEN_AGENCY1`, `YANDEX_DIRECT_LOGIN_AGENCY1` |
+| 4 | Base env vars or project `.env` | `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_LOGIN` |
+| 5 | 1Password references | `--op-token-ref`, `YANDEX_DIRECT_OP_TOKEN_REF` |
+| 6 | Bitwarden references | `--bw-token-ref`, `YANDEX_DIRECT_BW_TOKEN_REF` |
+
+The project `.env` file is loaded automatically. If a profile is selected
+with `--profile` or `direct auth use --profile NAME`, Direct CLI does not
+fall back to base `YANDEX_DIRECT_LOGIN`; this prevents mixing a profile token
+with a login from the project `.env`. For multi-account setups, prefer OAuth
+profiles or profile-specific env vars instead of base credentials.
+
 Install with `pip install direct-cli`, then run commands with `direct`.
 Invoking the deprecated `direct-cli` entrypoint exits with
 `use direct instead of direct-cli`.
@@ -634,6 +651,45 @@ YANDEX_DIRECT_LOGIN=ваш_логин_на_яндексе
 direct --token ВАШ_ТОКЕН --login ВАШ_ЛОГИН campaigns get
 ```
 
+Используйте профильные credentials из `.env`:
+
+```env
+YANDEX_DIRECT_TOKEN_AGENCY1=token-1
+YANDEX_DIRECT_LOGIN_AGENCY1=client-login-1
+YANDEX_DIRECT_TOKEN_AGENCY2=token-2
+YANDEX_DIRECT_LOGIN_AGENCY2=client-login-2
+```
+
+OAuth и profile-команды:
+
+```bash
+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
+```
+
+Порядок выбора credentials:
+
+| Приоритет | Источник | Пример |
+|-----------|----------|--------|
+| 1 | Явные CLI-опции | `direct --token TOKEN --login LOGIN campaigns get` |
+| 2 | OAuth profile storage | `direct --profile agency1 campaigns get` |
+| 3 | Профильные env vars | `YANDEX_DIRECT_TOKEN_AGENCY1`, `YANDEX_DIRECT_LOGIN_AGENCY1` |
+| 4 | Базовые env vars или project `.env` | `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_LOGIN` |
+| 5 | 1Password references | `--op-token-ref`, `YANDEX_DIRECT_OP_TOKEN_REF` |
+| 6 | Bitwarden references | `--bw-token-ref`, `YANDEX_DIRECT_BW_TOKEN_REF` |
+
+Файл `.env` в проекте загружается автоматически. Если профиль выбран через
+`--profile` или `direct auth use --profile NAME`, Direct CLI не подставляет
+base `YANDEX_DIRECT_LOGIN`; это защищает от смешивания токена из профиля с
+логином из project `.env`. Для нескольких аккаунтов используйте OAuth profiles
+или профильные env vars, а не базовые credentials.
+
 Установка остаётся через `pip install direct-cli`, а запуск команд теперь идет
 через `direct`. Вызов deprecated entrypoint `direct-cli` завершается ошибкой с
 подсказкой `use direct instead of direct-cli`.
@@ -644,6 +700,7 @@ direct --token ВАШ_ТОКЕН --login ВАШ_ЛОГИН campaigns get
 |-------|----------|
 | `--token` | OAuth-токен доступа к API |
 | `--login` | Direct client login |
+| `--profile` | Имя credential profile |
 | `--sandbox` | Использовать тестовое API (песочница) |
 
 ### Использование

{direct_cli-0.2.10 → direct_cli-0.2.11}/README.md

@@ -58,6 +58,23 @@ Notes:
 - Authorization is performed via `direct auth login`.
 - Alias `auth_login` is not supported.
 
+Credential resolution priority:
+
+| Priority | Source | Example |
+|----------|--------|---------|
+| 1 | Explicit CLI options | `direct --token TOKEN --login LOGIN campaigns get` |
+| 2 | OAuth profile storage | `direct --profile agency1 campaigns get` |
+| 3 | Profile-specific env vars | `YANDEX_DIRECT_TOKEN_AGENCY1`, `YANDEX_DIRECT_LOGIN_AGENCY1` |
+| 4 | Base env vars or project `.env` | `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_LOGIN` |
+| 5 | 1Password references | `--op-token-ref`, `YANDEX_DIRECT_OP_TOKEN_REF` |
+| 6 | Bitwarden references | `--bw-token-ref`, `YANDEX_DIRECT_BW_TOKEN_REF` |
+
+The project `.env` file is loaded automatically. If a profile is selected
+with `--profile` or `direct auth use --profile NAME`, Direct CLI does not
+fall back to base `YANDEX_DIRECT_LOGIN`; this prevents mixing a profile token
+with a login from the project `.env`. For multi-account setups, prefer OAuth
+profiles or profile-specific env vars instead of base credentials.
+
 Install with `pip install direct-cli`, then run commands with `direct`.
 Invoking the deprecated `direct-cli` entrypoint exits with
 `use direct instead of direct-cli`.
@@ -595,6 +612,45 @@ YANDEX_DIRECT_LOGIN=ваш_логин_на_яндексе
 direct --token ВАШ_ТОКЕН --login ВАШ_ЛОГИН campaigns get
 ```
 
+Используйте профильные credentials из `.env`:
+
+```env
+YANDEX_DIRECT_TOKEN_AGENCY1=token-1
+YANDEX_DIRECT_LOGIN_AGENCY1=client-login-1
+YANDEX_DIRECT_TOKEN_AGENCY2=token-2
+YANDEX_DIRECT_LOGIN_AGENCY2=client-login-2
+```
+
+OAuth и profile-команды:
+
+```bash
+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
+```
+
+Порядок выбора credentials:
+
+| Приоритет | Источник | Пример |
+|-----------|----------|--------|
+| 1 | Явные CLI-опции | `direct --token TOKEN --login LOGIN campaigns get` |
+| 2 | OAuth profile storage | `direct --profile agency1 campaigns get` |
+| 3 | Профильные env vars | `YANDEX_DIRECT_TOKEN_AGENCY1`, `YANDEX_DIRECT_LOGIN_AGENCY1` |
+| 4 | Базовые env vars или project `.env` | `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_LOGIN` |
+| 5 | 1Password references | `--op-token-ref`, `YANDEX_DIRECT_OP_TOKEN_REF` |
+| 6 | Bitwarden references | `--bw-token-ref`, `YANDEX_DIRECT_BW_TOKEN_REF` |
+
+Файл `.env` в проекте загружается автоматически. Если профиль выбран через
+`--profile` или `direct auth use --profile NAME`, Direct CLI не подставляет
+base `YANDEX_DIRECT_LOGIN`; это защищает от смешивания токена из профиля с
+логином из project `.env`. Для нескольких аккаунтов используйте OAuth profiles
+или профильные env vars, а не базовые credentials.
+
 Установка остаётся через `pip install direct-cli`, а запуск команд теперь идет
 через `direct`. Вызов deprecated entrypoint `direct-cli` завершается ошибкой с
 подсказкой `use direct instead of direct-cli`.
@@ -605,6 +661,7 @@ direct --token ВАШ_ТОКЕН --login ВАШ_ЛОГИН campaigns get
 |-------|----------|
 | `--token` | OAuth-токен доступа к API |
 | `--login` | Direct client login |
+| `--profile` | Имя credential profile |
 | `--sandbox` | Использовать тестовое API (песочница) |
 
 ### Использование

{direct_cli-0.2.10 → direct_cli-0.2.11}/direct_cli/cli.py

@@ -8,6 +8,7 @@ from dotenv import load_dotenv
 
 from . import __version__
 from .auth import get_active_profile, get_credentials
+from .utils import get_docs_url
 
 from .commands.campaigns import campaigns
 from .commands.adgroups import adgroups
@@ -129,38 +130,52 @@ def cli(
         ctx.obj["login"] = login
 
 
+def _register_command(command: click.Command) -> None:
+    """Register a command and append mapped documentation URL to group help."""
+    docs_url = get_docs_url(command.name or "")
+    if docs_url:
+        docs_line = f"\b\nDocumentation: {docs_url}"
+        command.epilog = (
+            f"{command.epilog}\n\n{docs_line}" if command.epilog else docs_line
+        )
+    cli.add_command(command)
+
+
 # Register all commands
-cli.add_command(campaigns)
-cli.add_command(adgroups)
-cli.add_command(ads)
-cli.add_command(keywords)
-cli.add_command(keywordbids)
-cli.add_command(bids)
-cli.add_command(bidmodifiers)
-cli.add_command(audiencetargets)
-cli.add_command(retargeting)
-cli.add_command(creatives)
-cli.add_command(adimages)
-cli.add_command(adextensions)
-cli.add_command(sitelinks)
-cli.add_command(vcards)
-cli.add_command(leads)
-cli.add_command(clients)
-cli.add_command(agencyclients)
-cli.add_command(dictionaries)
-cli.add_command(changes)
-cli.add_command(reports)
-cli.add_command(turbopages)
-cli.add_command(negativekeywordsharedsets)
-cli.add_command(feeds)
-cli.add_command(smartadtargets)
-cli.add_command(businesses)
-cli.add_command(keywordsresearch)
-cli.add_command(dynamicads)
-cli.add_command(advideos)
-cli.add_command(dynamicfeedadtargets)
-cli.add_command(strategies)
-cli.add_command(auth)
+for command in (
+    campaigns,
+    adgroups,
+    ads,
+    keywords,
+    keywordbids,
+    bids,
+    bidmodifiers,
+    audiencetargets,
+    retargeting,
+    creatives,
+    adimages,
+    adextensions,
+    sitelinks,
+    vcards,
+    leads,
+    clients,
+    agencyclients,
+    dictionaries,
+    changes,
+    reports,
+    turbopages,
+    negativekeywordsharedsets,
+    feeds,
+    smartadtargets,
+    businesses,
+    keywordsresearch,
+    dynamicads,
+    advideos,
+    dynamicfeedadtargets,
+    strategies,
+    auth,
+):
+    _register_command(command)
 
 
 if __name__ == "__main__":

{direct_cli-0.2.10 → direct_cli-0.2.11}/direct_cli/commands/agencyclients.py

@@ -6,7 +6,7 @@ import click
 
 from ..api import create_client
 from ..output import format_output, print_error
-from ..utils import get_default_fields, parse_ids
+from ..utils import get_default_fields
 
 
 def _build_notification(
@@ -21,10 +21,24 @@ def _build_notification(
         notification["Email"] = notification_email
     if notification_lang:
         notification["Lang"] = notification_lang
-    if send_account_news is not None:
-        notification["SendAccountNews"] = "YES" if send_account_news else "NO"
-    if send_warnings is not None:
-        notification["SendWarnings"] = "YES" if send_warnings else "NO"
+    if notification_email:
+        subscriptions = []
+        if send_account_news is not None:
+            subscriptions.append(
+                {
+                    "Option": "RECEIVE_RECOMMENDATIONS",
+                    "Value": "YES" if send_account_news else "NO",
+                }
+            )
+        if send_warnings is not None:
+            subscriptions.append(
+                {
+                    "Option": "TRACK_POSITION_CHANGES",
+                    "Value": "YES" if send_warnings else "NO",
+                }
+            )
+        if subscriptions:
+            notification["EmailSubscriptions"] = subscriptions
     return notification
 
 
@@ -34,14 +48,21 @@ def agencyclients():
 
 
 @agencyclients.command()
-@click.option("--ids", help="Comma-separated client IDs")
+@click.option("--logins", help="Comma-separated client logins")
+@click.option(
+    "--archived",
+    type=click.Choice(["YES", "NO"]),
+    default="NO",
+    show_default=True,
+    help="Filter archived clients",
+)
 @click.option("--limit", type=int, help="Limit number of results")
 @click.option("--fetch-all", is_flag=True, help="Fetch all pages")
 @click.option("--format", "output_format", default="json", help="Output format")
 @click.option("--output", help="Output file")
 @click.option("--fields", help="Comma-separated field names")
 @click.pass_context
-def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+def get(ctx, logins, archived, limit, fetch_all, output_format, output, fields):
     """Get agency clients"""
     try:
         client = create_client(
@@ -52,14 +73,11 @@ def get(ctx, ids, limit, fetch_all, output_format, output, fields):
 
         field_names = fields.split(",") if fields else get_default_fields("clients")
 
-        criteria = {}
-        if ids:
-            criteria["ClientIds"] = parse_ids(ids)
-
-        params = {"FieldNames": field_names}
+        criteria = {"Archived": archived}
+        if logins:
+            criteria["Logins"] = [login.strip() for login in logins.split(",")]
 
-        if criteria:
-            params["SelectionCriteria"] = criteria
+        params = {"SelectionCriteria": criteria, "FieldNames": field_names}
 
         if limit:
             params["Page"] = {"Limit": limit}

{direct_cli-0.2.10 → direct_cli-0.2.11}/direct_cli/reports_coverage.py

@@ -11,12 +11,22 @@ import json
 import re
 from pathlib import Path
 
-# Real working URLs (yandex.ru, static HTML with content in page text)
+from .utils import get_docs_pages
+
+
+_REPORTS_DOCS_PAGES = get_docs_pages("reports")
+_REQUIRED_DOCS_KEYS = ("type", "period", "fields-list", "headers")
+_missing_docs_keys = [k for k in _REQUIRED_DOCS_KEYS if k not in _REPORTS_DOCS_PAGES]
+if _missing_docs_keys:
+    raise RuntimeError(
+        "reports docs_pages mapping missing required keys "
+        f"{_missing_docs_keys}; vendored resource_mapping.py is out of sync"
+    )
 REPORTS_SPEC_URLS: dict[str, str] = {
-    "type": "https://yandex.ru/dev/direct/doc/reports/type.html",
-    "spec": "https://yandex.ru/dev/direct/doc/reports/period.html",
-    "fields-list": "https://yandex.ru/dev/direct/doc/reports/fields-list.html",
-    "headers": "https://yandex.ru/dev/direct/doc/reports/headers.html",
+    "type": _REPORTS_DOCS_PAGES["type"],
+    "spec": _REPORTS_DOCS_PAGES["period"],
+    "fields-list": _REPORTS_DOCS_PAGES["fields-list"],
+    "headers": _REPORTS_DOCS_PAGES["headers"],
 }
 
 REPORTS_CACHE_DIR = Path(__file__).resolve().parent.parent / "tests" / "reports_cache"

{direct_cli-0.2.10 → direct_cli-0.2.11}/direct_cli/utils.py

@@ -296,3 +296,10 @@ def get_docs_url(service: str) -> Optional[str]:
     """Return documentation URL for a service from tapi resource mapping."""
     entry = RESOURCE_MAPPING_V5.get(service)
     return entry.get("docs") if entry else None
+
+
+def get_docs_pages(service: str) -> Dict[str, str]:
+    """Return documentation page URLs for a service from tapi resource mapping."""
+    entry = RESOURCE_MAPPING_V5.get(service)
+    docs_pages = entry.get("docs_pages") if entry else None
+    return dict(docs_pages) if docs_pages else {}

{direct_cli-0.2.10 → direct_cli-0.2.11}/direct_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.2.10
+Version: 0.2.11
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -97,6 +97,23 @@ Notes:
 - Authorization is performed via `direct auth login`.
 - Alias `auth_login` is not supported.
 
+Credential resolution priority:
+
+| Priority | Source | Example |
+|----------|--------|---------|
+| 1 | Explicit CLI options | `direct --token TOKEN --login LOGIN campaigns get` |
+| 2 | OAuth profile storage | `direct --profile agency1 campaigns get` |
+| 3 | Profile-specific env vars | `YANDEX_DIRECT_TOKEN_AGENCY1`, `YANDEX_DIRECT_LOGIN_AGENCY1` |
+| 4 | Base env vars or project `.env` | `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_LOGIN` |
+| 5 | 1Password references | `--op-token-ref`, `YANDEX_DIRECT_OP_TOKEN_REF` |
+| 6 | Bitwarden references | `--bw-token-ref`, `YANDEX_DIRECT_BW_TOKEN_REF` |
+
+The project `.env` file is loaded automatically. If a profile is selected
+with `--profile` or `direct auth use --profile NAME`, Direct CLI does not
+fall back to base `YANDEX_DIRECT_LOGIN`; this prevents mixing a profile token
+with a login from the project `.env`. For multi-account setups, prefer OAuth
+profiles or profile-specific env vars instead of base credentials.
+
 Install with `pip install direct-cli`, then run commands with `direct`.
 Invoking the deprecated `direct-cli` entrypoint exits with
 `use direct instead of direct-cli`.
@@ -634,6 +651,45 @@ YANDEX_DIRECT_LOGIN=ваш_логин_на_яндексе
 direct --token ВАШ_ТОКЕН --login ВАШ_ЛОГИН campaigns get
 ```
 
+Используйте профильные credentials из `.env`:
+
+```env
+YANDEX_DIRECT_TOKEN_AGENCY1=token-1
+YANDEX_DIRECT_LOGIN_AGENCY1=client-login-1
+YANDEX_DIRECT_TOKEN_AGENCY2=token-2
+YANDEX_DIRECT_LOGIN_AGENCY2=client-login-2
+```
+
+OAuth и profile-команды:
+
+```bash
+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
+```
+
+Порядок выбора credentials:
+
+| Приоритет | Источник | Пример |
+|-----------|----------|--------|
+| 1 | Явные CLI-опции | `direct --token TOKEN --login LOGIN campaigns get` |
+| 2 | OAuth profile storage | `direct --profile agency1 campaigns get` |
+| 3 | Профильные env vars | `YANDEX_DIRECT_TOKEN_AGENCY1`, `YANDEX_DIRECT_LOGIN_AGENCY1` |
+| 4 | Базовые env vars или project `.env` | `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_LOGIN` |
+| 5 | 1Password references | `--op-token-ref`, `YANDEX_DIRECT_OP_TOKEN_REF` |
+| 6 | Bitwarden references | `--bw-token-ref`, `YANDEX_DIRECT_BW_TOKEN_REF` |
+
+Файл `.env` в проекте загружается автоматически. Если профиль выбран через
+`--profile` или `direct auth use --profile NAME`, Direct CLI не подставляет
+base `YANDEX_DIRECT_LOGIN`; это защищает от смешивания токена из профиля с
+логином из project `.env`. Для нескольких аккаунтов используйте OAuth profiles
+или профильные env vars, а не базовые credentials.
+
 Установка остаётся через `pip install direct-cli`, а запуск команд теперь идет
 через `direct`. Вызов deprecated entrypoint `direct-cli` завершается ошибкой с
 подсказкой `use direct instead of direct-cli`.
@@ -644,6 +700,7 @@ direct --token ВАШ_ТОКЕН --login ВАШ_ЛОГИН campaigns get
 |-------|----------|
 | `--token` | OAuth-токен доступа к API |
 | `--login` | Direct client login |
+| `--profile` | Имя credential profile |
 | `--sandbox` | Использовать тестовое API (песочница) |
 
 ### Использование

{direct_cli-0.2.10 → direct_cli-0.2.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "direct-cli"
-version = "0.2.10"
+version = "0.2.11"
 description = "Command-line interface for Yandex Direct API"
 readme = "README.md"
 license = {text = "MIT"}

{direct_cli-0.2.10 → direct_cli-0.2.11}/scripts/test_safe_commands.sh

@@ -165,9 +165,7 @@ run_test "sitelinks get --ids (env auth)"          direct sitelinks get --ids 1
 run_test "vcards get --ids (env auth)"             direct vcards get --ids 1
 run_test "leads get --turbo-page-ids (env auth)" direct leads get --turbo-page-ids 1 --limit 1
 run_test "clients get (env auth)"                  direct clients get
-# agencyclients requires agency account — tracked in #73
-echo -e "  ${CYAN}[BUG #73]${RESET} agencyclients get — требует агентский аккаунт (sandbox)"
-((KNOWN++)) || true
+skip_bug 73 "agencyclients get — требует агентский аккаунт (sandbox)"
 run_test "feeds get --ids (env auth)"          direct feeds get --ids 1
 run_test "creatives get (env auth)"                direct creatives get
 # businesses requires Ids/Name/Url in SelectionCriteria

{direct_cli-0.2.10 → direct_cli-0.2.11}/tests/API_COVERAGE.md

@@ -105,6 +105,20 @@ Sandbox re-check is not useful — this is an account-tier limitation.
 Testing strategy: manual-only on an account where DYNAMIC_TEXT_CAMPAIGN and
 SMART_CAMPAIGN are enabled. See `tests/MANUAL_COVERAGE.md`.
 
+### Category C — account-permission limited (code 3001)
+
+The endpoint is available, but the current sandbox agency account does not
+have rights to create agency clients. This differs from read-only
+`agencyclients get`, which is covered against sandbox.
+
+| Scenario | Symptom | Error code | Test class |
+|---|---|---|---|
+| agencyclients add-passport-organization | no rights to create clients | 3001 | manual-only |
+
+Testing strategy: keep `agencyclients get` in read-only integration coverage;
+keep agency-client creation manual-only unless a sandbox agency account with
+client-creation rights is available.
+
 Originally classified in
 [#28 issuecomment-4275359621](https://github.com/axisrow/direct-cli/issues/28#issuecomment-4275359621)
 and

{direct_cli-0.2.10 → direct_cli-0.2.11}/tests/MANUAL_COVERAGE.md

@@ -14,9 +14,12 @@ account requirements, or external dependencies.
 ## Account-Scoped Operations
 
 - **agencyclients add/update/delete** — requires an agency-type account.
-  Non-agency accounts receive 403.
+  Non-agency accounts receive 403. The current sandbox agency account can
+  read agency clients, but creation returns error 3001: "No rights to create
+  clients".
 - **agencyclients add-passport-organization** — creates a real Passport
-  organization linked to the account.
+  organization linked to the account. The current sandbox agency account is
+  sandbox-limited for this operation with error 3001.
 - **agencyclients add-passport-organization-member** — sends an invitation
   email to an external user.
 
@@ -64,8 +67,8 @@ Live tests skip gracefully when the API returns error 3500.
 |---|---|---|
 | ads moderate | Irreversible | Moderate |
 | campaigns/ads suspend/resume (live) | Traffic impact | High |
-| agencyclients add/update/delete | Account type | None (403) |
-| agencyclients add-passport-organization* | External state | Moderate |
+| agencyclients add/update/delete | Account type / sandbox rights (403 or 3001) | None (skip) |
+| agencyclients add-passport-organization* | External state / sandbox rights (3001) | Moderate |
 | bids/keywordbids/bidmodifiers set | Financial | High |
 | dynamicads (all) | Account type (3500) | None (skip) |
 | smartadtargets (all) | Account type (3500) | None (skip) |

{direct_cli-0.2.10 → direct_cli-0.2.11}/tests/test_api_coverage.py

@@ -1119,6 +1119,22 @@ class TestApiCoverage:
 class TestReportsCoverage:
     """Tests for Reports API spec snapshot and CLI parity."""
 
+    def test_reports_spec_urls_come_from_resource_mapping(self):
+        """Reports docs URLs must be derived from the vendored resource mapping."""
+        from direct_cli._vendor.tapi_yandex_direct.resource_mapping import (
+            RESOURCE_MAPPING_V5,
+        )
+        from direct_cli.reports_coverage import REPORTS_SPEC_URLS
+
+        docs_pages = RESOURCE_MAPPING_V5["reports"]["docs_pages"]
+        assert REPORTS_SPEC_URLS == {
+            "type": docs_pages["type"],
+            "spec": docs_pages["period"],
+            "fields-list": docs_pages["fields-list"],
+            "headers": docs_pages["headers"],
+        }
+        assert all(not url.endswith(".html") for url in REPORTS_SPEC_URLS.values())
+
     def test_reports_cache_files_exist(self):
         """All 4 raw HTML files and spec.json must be committed."""
         from direct_cli.reports_coverage import REPORTS_CACHE_DIR

{direct_cli-0.2.10 → direct_cli-0.2.11}/tests/test_cli.py

@@ -12,8 +12,10 @@ from unittest.mock import patch
 
 from click.testing import CliRunner
 
-from direct_cli.cli import cli
+from direct_cli._vendor.tapi_yandex_direct.resource_mapping import RESOURCE_MAPPING_V5
 from direct_cli._deprecated import DEPRECATED_ENTRYPOINT_MESSAGE, deprecated_main
+from direct_cli.cli import cli
+from direct_cli.utils import get_docs_url
 
 
 class TestCLI(unittest.TestCase):
@@ -42,6 +44,7 @@ class TestCLI(unittest.TestCase):
         self.assertEqual(result.exit_code, 0)
         self.assertIn("Manage campaigns", result.output)
         self.assertIn("Usage: direct campaigns", result.output)
+        self.assertIn(f"Documentation: {get_docs_url('campaigns')}", result.output)
 
     def test_adgroups_help(self):
         """Test adgroups help"""
@@ -60,6 +63,26 @@ class TestCLI(unittest.TestCase):
         result = self.runner.invoke(cli, ["reports", "--help"])
         self.assertEqual(result.exit_code, 0)
         self.assertIn("Generate and manage reports", result.output)
+        self.assertIn(f"Documentation: {get_docs_url('reports')}", result.output)
+
+    def test_registered_mapped_groups_show_docs_url(self):
+        """Registered groups from resource mapping show their documentation URL."""
+        mapped_groups = sorted(set(cli.commands) & set(RESOURCE_MAPPING_V5))
+        self.assertTrue(mapped_groups)
+        for group in mapped_groups:
+            with self.subTest(group=group):
+                result = self.runner.invoke(cli, [group, "--help"])
+                self.assertEqual(result.exit_code, 0)
+                self.assertIn(
+                    f"Documentation: {get_docs_url(group)}",
+                    result.output,
+                )
+
+    def test_auth_help_has_no_docs_url(self):
+        """Auth is not a Yandex Direct API resource and has no docs epilog."""
+        result = self.runner.invoke(cli, ["auth", "--help"])
+        self.assertEqual(result.exit_code, 0)
+        self.assertNotIn("Documentation:", result.output)
 
     def test_canonical_groups_in_help(self):
         """Test canonical transport groups"""

{direct_cli-0.2.10 → direct_cli-0.2.11}/tests/test_dry_run.py

@@ -1378,8 +1378,10 @@ def test_agencyclients_add_builds_notification_from_typed_flags():
         "Notification": {
             "Email": "ops@example.com",
             "Lang": "RU",
-            "SendAccountNews": "YES",
-            "SendWarnings": "NO",
+            "EmailSubscriptions": [
+                {"Option": "RECEIVE_RECOMMENDATIONS", "Value": "YES"},
+                {"Option": "TRACK_POSITION_CHANGES", "Value": "NO"},
+            ],
         },
     }
     body = _dry_run(
@@ -1584,8 +1586,10 @@ def test_agencyclients_add_passport_organization_payload():
         "Notification": {
             "Email": "ops@example.com",
             "Lang": "EN",
-            "SendAccountNews": "NO",
-            "SendWarnings": "YES",
+            "EmailSubscriptions": [
+                {"Option": "RECEIVE_RECOMMENDATIONS", "Value": "NO"},
+                {"Option": "TRACK_POSITION_CHANGES", "Value": "YES"},
+            ],
         },
     }