direct-cli 0.3.5__tar.gz → 0.3.7__tar.gz

{direct_cli-0.3.5 → direct_cli-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.3.5
+Version: 0.3.7
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -88,7 +88,7 @@ direct auth login
 direct auth login --profile agency1
 direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
-printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
+printf '%s\n' abc123 | direct auth login --code - --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -101,8 +101,8 @@ Notes:
 - `--login` remains Direct client login.
 - Authorization is performed via `direct auth login`.
 - OAuth profiles store refresh tokens and refresh access tokens automatically.
-- In a non-interactive shell, run `direct auth login --profile NAME` first, then finish with `direct auth login --code-stdin --profile NAME` and pass the browser code on stdin.
-- `direct auth login --code CODE --profile NAME` remains supported for compatibility, but `--code-stdin` avoids exposing the code in process arguments.
+- In a non-interactive shell, run `direct auth login --profile NAME` first, then finish with `direct auth login --code - --profile NAME` and pass the browser code on stdin.
+- `direct auth login --code CODE --profile NAME` remains supported for compatibility, but automation should use `--code -` to avoid exposing the code in process arguments.
 - If the first non-interactive step includes `--client-secret`, the secret is remembered for the matching completion step.
 - If a profile already stores a confidential OAuth client, `direct auth login --code CODE --profile NAME` reuses the saved `client_id` and `client_secret`.
 - `direct auth login --oauth-token TOKEN` is a manual access-token import and does not auto-refresh.
@@ -158,6 +158,24 @@ direct v4goals get-retargeting-goals --campaign-ids 123,456 --format table
 direct v4goals get-stat-goals --campaign-ids 123 --dry-run
 ```
 
+### V4 Live Tags
+
+Campaign tags are managed as `{TagID, Tag}` pairs. Use `TagID=0` to create a
+new campaign tag. Banner/ad tags are assigned by campaign tag IDs. Update
+methods replace the full tag list for the target campaign or banner, so pass
+existing tags again if they must remain assigned. Ad group tags are filter-only
+through `direct adgroups get --tag-ids/--tags`; this release does not add ad
+group tag mutation commands.
+
+```bash
+direct v4tags get-campaigns --campaign-ids 3193279,1634563
+direct v4tags get-banners --banner-ids 2571700,2571745
+direct v4tags get-banners --campaign-ids 3193279
+direct v4tags update-campaigns --campaign-id 3193279 --tag 0=akapulko --tag 16590=orange --dry-run
+direct v4tags update-banners --banner-ids 2571700,2571745 --tag-ids 16590,16734 --dry-run
+direct v4tags update-banners --banner-ids 2571700 --clear-tags --dry-run
+```
+
 ### V4 Live Events
 
 ```bash
@@ -178,6 +196,19 @@ direct v4wordstat get-report --report-id 123 --format table
 direct v4wordstat delete-report --report-id 123
 ```
 
+### V4 Live Budget Forecasts
+
+Budget forecasts are asynchronous. Direct CLI makes exactly one API call per
+command and does not poll automatically; repeat `list` or `get` yourself until
+the forecast is ready.
+
+```bash
+direct v4forecast create --phrases "buy laptop,buy desktop" --geo-ids 213 --currency RUB
+direct v4forecast list --format table
+direct v4forecast get --forecast-id 123 --format table
+direct v4forecast delete --forecast-id 123
+```
+
 ### V4 Live Finance
 
 Finance methods require an extra financial token for money operations. In the
@@ -562,9 +593,9 @@ Current command surface:
 | WSDL-backed API services | 29 |
 | Supported API services including Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups including `auth` | 39 |
-| CLI subcommands including `auth` | 130 |
-| API CLI subcommands excluding `auth` | 126 |
+| CLI groups including `auth` | 40 |
+| CLI subcommands including `auth` | 144 |
+| API CLI subcommands excluding `auth` | 140 |
 
 ### API Coverage And Drift Monitoring
 
@@ -750,7 +781,7 @@ direct auth login
 direct auth login --profile agency1
 direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
-printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
+printf '%s\n' abc123 | direct auth login --code - --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -759,8 +790,8 @@ direct --profile agency1 campaigns get
 
 Примечания:
 - OAuth profiles сохраняют refresh token и автоматически обновляют access token.
-- В non-interactive shell сначала выполните `direct auth login --profile NAME`, затем завершите через `direct auth login --code-stdin --profile NAME` и передайте browser code через stdin.
-- `direct auth login --code CODE --profile NAME` сохраняется для совместимости, но `--code-stdin` не раскрывает код в process arguments.
+- В non-interactive shell сначала выполните `direct auth login --profile NAME`, затем завершите через `direct auth login --code - --profile NAME` и передайте browser code через stdin.
+- `direct auth login --code CODE --profile NAME` сохраняется для совместимости, но автоматизация должна использовать `--code -`, чтобы не раскрывать код в process arguments.
 - Если первый non-interactive шаг включает `--client-secret`, secret запоминается для последующего completion step.
 - Если profile уже хранит confidential OAuth client, `direct auth login --code CODE --profile NAME` использует сохраненные `client_id` и `client_secret`.
 - `direct auth login --oauth-token TOKEN` импортирует access token вручную и не включает auto-refresh.
@@ -1183,9 +1214,9 @@ YANDEX_DIRECT_LIVE_WRITE=1 pytest -m integration_live_write -v --record-mode=rew
 | WSDL-backed API services | 29 |
 | API services с учётом Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups с `auth` | 39 |
-| CLI subcommands с `auth` | 130 |
-| API CLI subcommands без `auth` | 126 |
+| CLI groups с `auth` | 40 |
+| CLI subcommands с `auth` | 144 |
+| API CLI subcommands без `auth` | 140 |
 
 #### Live sandbox write smoke
 

{direct_cli-0.3.5 → direct_cli-0.3.7}/README.md

@@ -45,7 +45,7 @@ direct auth login
 direct auth login --profile agency1
 direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
-printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
+printf '%s\n' abc123 | direct auth login --code - --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -58,8 +58,8 @@ Notes:
 - `--login` remains Direct client login.
 - Authorization is performed via `direct auth login`.
 - OAuth profiles store refresh tokens and refresh access tokens automatically.
-- In a non-interactive shell, run `direct auth login --profile NAME` first, then finish with `direct auth login --code-stdin --profile NAME` and pass the browser code on stdin.
-- `direct auth login --code CODE --profile NAME` remains supported for compatibility, but `--code-stdin` avoids exposing the code in process arguments.
+- In a non-interactive shell, run `direct auth login --profile NAME` first, then finish with `direct auth login --code - --profile NAME` and pass the browser code on stdin.
+- `direct auth login --code CODE --profile NAME` remains supported for compatibility, but automation should use `--code -` to avoid exposing the code in process arguments.
 - If the first non-interactive step includes `--client-secret`, the secret is remembered for the matching completion step.
 - If a profile already stores a confidential OAuth client, `direct auth login --code CODE --profile NAME` reuses the saved `client_id` and `client_secret`.
 - `direct auth login --oauth-token TOKEN` is a manual access-token import and does not auto-refresh.
@@ -115,6 +115,24 @@ direct v4goals get-retargeting-goals --campaign-ids 123,456 --format table
 direct v4goals get-stat-goals --campaign-ids 123 --dry-run
 ```
 
+### V4 Live Tags
+
+Campaign tags are managed as `{TagID, Tag}` pairs. Use `TagID=0` to create a
+new campaign tag. Banner/ad tags are assigned by campaign tag IDs. Update
+methods replace the full tag list for the target campaign or banner, so pass
+existing tags again if they must remain assigned. Ad group tags are filter-only
+through `direct adgroups get --tag-ids/--tags`; this release does not add ad
+group tag mutation commands.
+
+```bash
+direct v4tags get-campaigns --campaign-ids 3193279,1634563
+direct v4tags get-banners --banner-ids 2571700,2571745
+direct v4tags get-banners --campaign-ids 3193279
+direct v4tags update-campaigns --campaign-id 3193279 --tag 0=akapulko --tag 16590=orange --dry-run
+direct v4tags update-banners --banner-ids 2571700,2571745 --tag-ids 16590,16734 --dry-run
+direct v4tags update-banners --banner-ids 2571700 --clear-tags --dry-run
+```
+
 ### V4 Live Events
 
 ```bash
@@ -135,6 +153,19 @@ direct v4wordstat get-report --report-id 123 --format table
 direct v4wordstat delete-report --report-id 123
 ```
 
+### V4 Live Budget Forecasts
+
+Budget forecasts are asynchronous. Direct CLI makes exactly one API call per
+command and does not poll automatically; repeat `list` or `get` yourself until
+the forecast is ready.
+
+```bash
+direct v4forecast create --phrases "buy laptop,buy desktop" --geo-ids 213 --currency RUB
+direct v4forecast list --format table
+direct v4forecast get --forecast-id 123 --format table
+direct v4forecast delete --forecast-id 123
+```
+
 ### V4 Live Finance
 
 Finance methods require an extra financial token for money operations. In the
@@ -519,9 +550,9 @@ Current command surface:
 | WSDL-backed API services | 29 |
 | Supported API services including Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups including `auth` | 39 |
-| CLI subcommands including `auth` | 130 |
-| API CLI subcommands excluding `auth` | 126 |
+| CLI groups including `auth` | 40 |
+| CLI subcommands including `auth` | 144 |
+| API CLI subcommands excluding `auth` | 140 |
 
 ### API Coverage And Drift Monitoring
 
@@ -707,7 +738,7 @@ direct auth login
 direct auth login --profile agency1
 direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
-printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
+printf '%s\n' abc123 | direct auth login --code - --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -716,8 +747,8 @@ direct --profile agency1 campaigns get
 
 Примечания:
 - OAuth profiles сохраняют refresh token и автоматически обновляют access token.
-- В non-interactive shell сначала выполните `direct auth login --profile NAME`, затем завершите через `direct auth login --code-stdin --profile NAME` и передайте browser code через stdin.
-- `direct auth login --code CODE --profile NAME` сохраняется для совместимости, но `--code-stdin` не раскрывает код в process arguments.
+- В non-interactive shell сначала выполните `direct auth login --profile NAME`, затем завершите через `direct auth login --code - --profile NAME` и передайте browser code через stdin.
+- `direct auth login --code CODE --profile NAME` сохраняется для совместимости, но автоматизация должна использовать `--code -`, чтобы не раскрывать код в process arguments.
 - Если первый non-interactive шаг включает `--client-secret`, secret запоминается для последующего completion step.
 - Если profile уже хранит confidential OAuth client, `direct auth login --code CODE --profile NAME` использует сохраненные `client_id` и `client_secret`.
 - `direct auth login --oauth-token TOKEN` импортирует access token вручную и не включает auto-refresh.
@@ -1140,9 +1171,9 @@ YANDEX_DIRECT_LIVE_WRITE=1 pytest -m integration_live_write -v --record-mode=rew
 | WSDL-backed API services | 29 |
 | API services с учётом Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups с `auth` | 39 |
-| CLI subcommands с `auth` | 130 |
-| API CLI subcommands без `auth` | 126 |
+| CLI groups с `auth` | 40 |
+| CLI subcommands с `auth` | 144 |
+| API CLI subcommands без `auth` | 140 |
 
 #### Live sandbox write smoke
 

{direct_cli-0.3.5 → direct_cli-0.3.7}/direct_cli/cli.py

@@ -43,10 +43,12 @@ from .commands.strategies import strategies
 from .commands.auth import auth
 from .commands.balance import balance
 from .commands.v4events import v4events
+from .commands.v4forecast import v4forecast
 from .commands.v4finance import v4finance
 from .commands.v4account import v4account
-from .commands.v4shells import v4forecast, v4meta
+from .commands.v4shells import v4meta
 from .commands.v4goals import v4goals
+from .commands.v4tags import v4tags
 from .commands.v4wordstat import v4wordstat
 
 # Load .env file
@@ -186,6 +188,7 @@ for command in (
     v4goals,
     v4events,
     v4wordstat,
+    v4tags,
     v4forecast,
     v4meta,
     auth,

{direct_cli-0.3.5 → direct_cli-0.3.7}/direct_cli/commands/auth.py

@@ -35,10 +35,14 @@ def auth():
 
 @auth.command()
 @click.option("--profile", default="default", show_default=True, help="Profile name")
-@click.option("--code", help="OAuth authorization code")
+@click.option(
+    "--code",
+    help="OAuth authorization code; use '-' to read from stdin for automation",
+)
 @click.option(
     "--code-stdin",
     is_flag=True,
+    hidden=True,
     help="Read OAuth authorization code from stdin",
 )
 @click.option("--oauth-token", help="Ready OAuth access token")
@@ -78,9 +82,16 @@ def login(
                 "--code-stdin cannot be combined with --code, "
                 "--oauth-token, or --start-pkce."
             )
+        code = "-"
+
+    if code == "-":
+        if oauth_token or start_pkce:
+            raise click.ClickException(
+                "--code - cannot be combined with --oauth-token or --start-pkce."
+            )
         code = sys.stdin.read().strip()
         if not code:
-            raise click.ClickException("--code-stdin requires a code on stdin.")
+            raise click.ClickException("--code - requires a code on stdin.")
 
     if start_pkce:
         if code or oauth_token or client_secret:

{direct_cli-0.3.5 → direct_cli-0.3.7}/direct_cli/commands/campaigns.py

@@ -2,6 +2,8 @@
 Campaigns commands
 """
 
+from typing import List, Optional
+
 import click
 
 from ..api import create_client
@@ -13,6 +15,7 @@ from ..utils import (
     get_default_fields,
     MICRO_RUBLES,
     parse_ids,
+    parse_csv_strings,
     parse_setting_specs,
 )
 
@@ -22,6 +25,14 @@ def campaigns():
     """Manage campaigns"""
 
 
+def _parse_csv_option(option_name: str, value: Optional[str]) -> Optional[List[str]]:
+    """Parse a CSV option and reject explicitly empty input."""
+    parsed = parse_csv_strings(value)
+    if value is not None and not parsed:
+        raise click.UsageError(f"{option_name} must contain at least one value")
+    return parsed
+
+
 @campaigns.command()
 @click.option("--ids", help="Comma-separated campaign IDs")
 @click.option("--status", help="Filter by status (ACTIVE, SUSPENDED, etc.)")
@@ -41,6 +52,40 @@ def campaigns():
 @click.option(
     "--fields", help="Comma-separated field names (default: all common fields)"
 )
+@click.option("--text-campaign-fields", help="Comma-separated TextCampaignFieldNames")
+@click.option(
+    "--text-campaign-search-strategy-placement-types-fields",
+    help="Comma-separated TextCampaignSearchStrategyPlacementTypesFieldNames",
+)
+@click.option(
+    "--mobile-app-campaign-fields",
+    help="Comma-separated MobileAppCampaignFieldNames",
+)
+@click.option(
+    "--dynamic-text-campaign-fields",
+    help="Comma-separated DynamicTextCampaignFieldNames",
+)
+@click.option(
+    "--dynamic-text-campaign-search-strategy-placement-types-fields",
+    help="Comma-separated DynamicTextCampaignSearchStrategyPlacementTypesFieldNames",
+)
+@click.option(
+    "--cpm-banner-campaign-fields",
+    help="Comma-separated CpmBannerCampaignFieldNames",
+)
+@click.option("--smart-campaign-fields", help="Comma-separated SmartCampaignFieldNames")
+@click.option(
+    "--unified-campaign-fields",
+    help="Comma-separated UnifiedCampaignFieldNames",
+)
+@click.option(
+    "--unified-campaign-search-strategy-placement-types-fields",
+    help="Comma-separated UnifiedCampaignSearchStrategyPlacementTypesFieldNames",
+)
+@click.option(
+    "--unified-campaign-package-bidding-strategy-platforms-fields",
+    help="Comma-separated UnifiedCampaignPackageBiddingStrategyPlatformsFieldNames",
+)
 @click.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
 def get(
@@ -56,6 +101,16 @@ def get(
     output_format,
     output,
     fields,
+    text_campaign_fields,
+    text_campaign_search_strategy_placement_types_fields,
+    mobile_app_campaign_fields,
+    dynamic_text_campaign_fields,
+    dynamic_text_campaign_search_strategy_placement_types_fields,
+    cpm_banner_campaign_fields,
+    smart_campaign_fields,
+    unified_campaign_fields,
+    unified_campaign_search_strategy_placement_types_fields,
+    unified_campaign_package_bidding_strategy_platforms_fields,
     dry_run,
 ):
     """Get campaigns"""
@@ -70,7 +125,11 @@ def get(
         )
 
         # Parse field names
-        field_names = fields.split(",") if fields else get_default_fields("campaigns")
+        field_names = (
+            _parse_csv_option("--fields", fields)
+            if fields is not None
+            else get_default_fields("campaigns")
+        )
 
         # Build selection criteria
         criteria = build_selection_criteria(
@@ -86,6 +145,52 @@ def get(
         params = build_common_params(
             criteria=criteria, field_names=field_names, limit=limit
         )
+        selector_options = {
+            "TextCampaignFieldNames": (
+                "--text-campaign-fields",
+                text_campaign_fields,
+            ),
+            "TextCampaignSearchStrategyPlacementTypesFieldNames": (
+                "--text-campaign-search-strategy-placement-types-fields",
+                text_campaign_search_strategy_placement_types_fields,
+            ),
+            "MobileAppCampaignFieldNames": (
+                "--mobile-app-campaign-fields",
+                mobile_app_campaign_fields,
+            ),
+            "DynamicTextCampaignFieldNames": (
+                "--dynamic-text-campaign-fields",
+                dynamic_text_campaign_fields,
+            ),
+            "DynamicTextCampaignSearchStrategyPlacementTypesFieldNames": (
+                "--dynamic-text-campaign-search-strategy-placement-types-fields",
+                dynamic_text_campaign_search_strategy_placement_types_fields,
+            ),
+            "CpmBannerCampaignFieldNames": (
+                "--cpm-banner-campaign-fields",
+                cpm_banner_campaign_fields,
+            ),
+            "SmartCampaignFieldNames": (
+                "--smart-campaign-fields",
+                smart_campaign_fields,
+            ),
+            "UnifiedCampaignFieldNames": (
+                "--unified-campaign-fields",
+                unified_campaign_fields,
+            ),
+            "UnifiedCampaignSearchStrategyPlacementTypesFieldNames": (
+                "--unified-campaign-search-strategy-placement-types-fields",
+                unified_campaign_search_strategy_placement_types_fields,
+            ),
+            "UnifiedCampaignPackageBiddingStrategyPlatformsFieldNames": (
+                "--unified-campaign-package-bidding-strategy-platforms-fields",
+                unified_campaign_package_bidding_strategy_platforms_fields,
+            ),
+        }
+        for request_key, (option_name, value) in selector_options.items():
+            parsed = _parse_csv_option(option_name, value)
+            if parsed:
+                params[request_key] = parsed
 
         body = {"method": "get", "params": params}
 

direct_cli-0.3.7/direct_cli/commands/v4forecast.py

@@ -0,0 +1,168 @@
+"""Yandex Direct v4 Live budget forecast commands."""
+
+from typing import Optional
+
+import click
+
+from ..api import create_v4_client
+from ..output import format_output, print_error
+from ..utils import parse_csv_strings, parse_ids
+from ..v4 import build_v4_body, call_v4
+from ..v4_contracts import v4_method_contract
+from .v4shells import V4_EPILOG
+
+
+def _forecast_param(
+    phrases: str, geo_ids: Optional[str], currency: str
+) -> dict[str, object]:
+    """Build the v4 Live CreateNewForecast parameter."""
+    phrase_list = parse_csv_strings(phrases)
+    if not phrase_list:
+        raise click.UsageError("--phrases must not be empty")
+    if len(phrase_list) > 100:
+        raise click.UsageError("--phrases accepts at most 100 phrases")
+
+    param: dict[str, object] = {
+        "Phrases": phrase_list,
+        "Currency": currency,
+    }
+    if geo_ids:
+        try:
+            parsed_geo_ids = parse_ids(geo_ids)
+        except ValueError as exc:
+            raise click.UsageError(str(exc)) from exc
+        if parsed_geo_ids:
+            param["GeoID"] = parsed_geo_ids
+    return param
+
+
+def _call_forecast(
+    ctx,
+    method: str,
+    param,
+    output_format: str,
+    output: Optional[str],
+) -> None:
+    """Call one v4 Live budget forecast method and print formatted output."""
+    try:
+        client = create_v4_client(
+            token=ctx.obj.get("token"),
+            login=ctx.obj.get("login"),
+            profile=ctx.obj.get("profile"),
+            sandbox=ctx.obj.get("sandbox"),
+        )
+        data = call_v4(client, method, param)
+        format_output(data, output_format, output)
+    except Exception as e:
+        print_error(str(e))
+        raise click.Abort()
+
+
+@click.group(epilog=V4_EPILOG)
+def v4forecast():
+    """Yandex Direct v4 Live budget forecast commands."""
+
+
+@v4_method_contract("CreateNewForecast")
+@v4forecast.command()
+@click.option("--phrases", required=True, help="Comma-separated phrases, up to 100")
+@click.option("--geo-ids", help="Comma-separated geo region IDs")
+@click.option(
+    "--currency",
+    default="RUB",
+    show_default=True,
+    help="Forecast currency",
+)
+@click.option(
+    "--format",
+    "output_format",
+    default="json",
+    type=click.Choice(["json", "table", "csv", "tsv"]),
+    help="Output format",
+)
+@click.option("--output", help="Output file")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def create(ctx, phrases, geo_ids, currency, output_format, output, dry_run):
+    """Create a v4 Live budget forecast."""
+    param = _forecast_param(phrases, geo_ids, currency)
+    if dry_run:
+        format_output(build_v4_body("CreateNewForecast", param), "json", None)
+        return
+
+    _call_forecast(ctx, "CreateNewForecast", param, output_format, output)
+
+
+@v4_method_contract("GetForecastList")
+@v4forecast.command(name="list")
+@click.option(
+    "--format",
+    "output_format",
+    default="json",
+    type=click.Choice(["json", "table", "csv", "tsv"]),
+    help="Output format",
+)
+@click.option("--output", help="Output file")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def list_forecasts(ctx, output_format, output, dry_run):
+    """List v4 Live budget forecasts."""
+    if dry_run:
+        format_output(build_v4_body("GetForecastList"), "json", None)
+        return
+
+    _call_forecast(ctx, "GetForecastList", None, output_format, output)
+
+
+@v4_method_contract("GetForecast")
+@v4forecast.command()
+@click.option(
+    "--forecast-id",
+    required=True,
+    type=click.IntRange(min=1),
+    help="Forecast ID",
+)
+@click.option(
+    "--format",
+    "output_format",
+    default="json",
+    type=click.Choice(["json", "table", "csv", "tsv"]),
+    help="Output format",
+)
+@click.option("--output", help="Output file")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def get(ctx, forecast_id, output_format, output, dry_run):
+    """Get a ready v4 Live budget forecast."""
+    if dry_run:
+        format_output(build_v4_body("GetForecast", forecast_id), "json", None)
+        return
+
+    _call_forecast(ctx, "GetForecast", forecast_id, output_format, output)
+
+
+@v4_method_contract("DeleteForecastReport")
+@v4forecast.command()
+@click.option(
+    "--forecast-id",
+    required=True,
+    type=click.IntRange(min=1),
+    help="Forecast ID",
+)
+@click.option(
+    "--format",
+    "output_format",
+    default="json",
+    type=click.Choice(["json", "table", "csv", "tsv"]),
+    help="Output format",
+)
+@click.option("--output", help="Output file")
+@click.option("--dry-run", is_flag=True, help="Show request without sending")
+@click.pass_context
+def delete(ctx, forecast_id, output_format, output, dry_run):
+    """Delete a v4 Live budget forecast."""
+    if dry_run:
+        format_output(build_v4_body("DeleteForecastReport", forecast_id), "json", None)
+        return
+
+    _call_forecast(ctx, "DeleteForecastReport", forecast_id, output_format, output)

{direct_cli-0.3.5 → direct_cli-0.3.7}/direct_cli/commands/v4shells.py

@@ -15,11 +15,6 @@ def v4wordstat():
     """Yandex Direct v4 Live wordstat commands."""
 
 
-@click.group(epilog=V4_EPILOG)
-def v4forecast():
-    """Yandex Direct v4 Live forecast commands."""
-
-
 @click.group(epilog=V4_EPILOG)
 def v4meta():
     """Yandex Direct v4 Live metadata commands."""