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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.3.1
+Version: 0.3.2
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -147,6 +147,39 @@ direct v4goals get-retargeting-goals --campaign-ids 123,456 --format table
 direct v4goals get-stat-goals --campaign-ids 123 --dry-run
 ```
 
+### V4 Live Events
+
+```bash
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00 --currency RUB --limit 100 --offset 0 --format table
+```
+
+### 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.
+
+```bash
+direct v4finance get-credit-limits --logins client-login --finance-token FINANCE_TOKEN --operation-num 123
+direct v4finance get-credit-limits --logins client-login,other-client --format table
+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
+```
+
+### V4 Live Shared Account
+
+Shared-account mutations are dry-run-only in this release and always require
+`--dry-run`.
+
+```bash
+direct v4account enable-shared-account --client-login client-login --dry-run
+direct v4account account-management --action Update --account-id 1327944 --day-budget 100.50 --spend-mode Default --money-in-sms Yes --money-out-sms No --email ops@example.com --money-warning-value 25 --dry-run
+```
+
 ### CLI Convention
 
 The current CLI convention is defined as follows.
@@ -344,6 +377,7 @@ direct keywords delete --id 88888
 ```bash
 # Get a report (saved to file)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "January Report" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Goals Report" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # List available report types
 direct reports list-types
@@ -509,9 +543,9 @@ Current command surface:
 | WSDL-backed API services | 29 |
 | Supported API services including Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups including `auth` | 31 |
-| CLI subcommands including `auth` | 122 |
-| API CLI subcommands excluding `auth` | 118 |
+| CLI groups including `auth` | 39 |
+| CLI subcommands including `auth` | 130 |
+| API CLI subcommands excluding `auth` | 126 |
 
 ### API Coverage And Drift Monitoring
 
@@ -966,6 +1000,7 @@ direct keywords delete --id 88888
 ```bash
 # Сформировать отчёт (сохраняется в файл)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт за январь" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт по целям" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # Список доступных типов отчётов
 direct reports list-types
@@ -1132,9 +1167,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` | 31 |
-| CLI subcommands с `auth` | 122 |
-| API CLI subcommands без `auth` | 118 |
+| CLI groups с `auth` | 39 |
+| CLI subcommands с `auth` | 130 |
+| API CLI subcommands без `auth` | 126 |
 
 #### Live sandbox write smoke
 

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

@@ -108,6 +108,39 @@ direct v4goals get-retargeting-goals --campaign-ids 123,456 --format table
 direct v4goals get-stat-goals --campaign-ids 123 --dry-run
 ```
 
+### V4 Live Events
+
+```bash
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00
+direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00 --currency RUB --limit 100 --offset 0 --format table
+```
+
+### 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.
+
+```bash
+direct v4finance get-credit-limits --logins client-login --finance-token FINANCE_TOKEN --operation-num 123
+direct v4finance get-credit-limits --logins client-login,other-client --format table
+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
+```
+
+### V4 Live Shared Account
+
+Shared-account mutations are dry-run-only in this release and always require
+`--dry-run`.
+
+```bash
+direct v4account enable-shared-account --client-login client-login --dry-run
+direct v4account account-management --action Update --account-id 1327944 --day-budget 100.50 --spend-mode Default --money-in-sms Yes --money-out-sms No --email ops@example.com --money-warning-value 25 --dry-run
+```
+
 ### CLI Convention
 
 The current CLI convention is defined as follows.
@@ -305,6 +338,7 @@ direct keywords delete --id 88888
 ```bash
 # Get a report (saved to file)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "January Report" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Goals Report" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # List available report types
 direct reports list-types
@@ -470,9 +504,9 @@ Current command surface:
 | WSDL-backed API services | 29 |
 | Supported API services including Reports | 30 |
 | WSDL operations | 112 |
-| CLI groups including `auth` | 31 |
-| CLI subcommands including `auth` | 122 |
-| API CLI subcommands excluding `auth` | 118 |
+| CLI groups including `auth` | 39 |
+| CLI subcommands including `auth` | 130 |
+| API CLI subcommands excluding `auth` | 126 |
 
 ### API Coverage And Drift Monitoring
 
@@ -927,6 +961,7 @@ direct keywords delete --id 88888
 ```bash
 # Сформировать отчёт (сохраняется в файл)
 direct reports get --type CAMPAIGN_PERFORMANCE_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт за январь" --fields "Date,CampaignId,Clicks,Cost" --format csv --output report.csv
+direct reports get --type CUSTOM_REPORT --from 2024-01-01 --to 2024-01-31 --name "Отчёт по целям" --fields "Date,CampaignId,GoalsRoi" --goals 12345,67890 --attribution-models AUTO --format csv --output goals-report.csv
 
 # Список доступных типов отчётов
 direct reports list-types
@@ -1093,9 +1128,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` | 31 |
-| CLI subcommands с `auth` | 122 |
-| API CLI subcommands без `auth` | 118 |
+| CLI groups с `auth` | 39 |
+| CLI subcommands с `auth` | 130 |
+| API CLI subcommands без `auth` | 126 |
 
 #### Live sandbox write smoke
 

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

@@ -43,11 +43,14 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
         token = api_params.get("access_token")
         login = api_params.get("login")
         language = api_params.get("language", "en")
-
-        # Enrich the JSON body with token / locale. format_data_to_request does
-        # not see api_params, so we do this here, after super() has already
-        # serialised the user data. Agency/client selection is transport-level
-        # (Client-Login header); method params must stay schema-shaped.
+        finance_token = api_params.get("finance_token")
+        operation_num = api_params.get("operation_num")
+
+        # Enrich the JSON body with top-level v4 Live fields.
+        # format_data_to_request does not see api_params, so we do this here,
+        # after super() has already serialised the user data. Agency/client
+        # selection is transport-level (Client-Login header); method params
+        # must stay schema-shaped.
         raw = params.get("data")
         if raw:
             if isinstance(raw, (bytes, bytearray)):
@@ -67,6 +70,10 @@ class V4LiveClientAdapter(JSONAdapterMixin, TapiAdapter):
                 body.setdefault("token", token)
             if language:
                 body.setdefault("locale", language)
+            if finance_token:
+                body.setdefault("finance_token", finance_token)
+            if operation_num is not None:
+                body.setdefault("operation_num", operation_num)
 
             params["data"] = orjson.dumps(body)
 

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/_vendor/tapi_yandex_direct/v4/adapter.pyi

@@ -49,6 +49,8 @@ class YandexDirectV4Live:
         language: str = "en",
         retry_if_exceeded_limit: bool = True,
         retries_if_server_error: int = 5,
+        finance_token: Optional[str] = None,
+        operation_num: Optional[int] = None,
     ) -> None: ...
 
     def v4live(self) -> V4LiveExecutor: ...

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/api.py

@@ -80,6 +80,8 @@ def create_v4_client(
     language: Optional[str] = None,
     retry_if_exceeded_limit: bool = True,
     retries_if_server_error: int = 5,
+    finance_token: Optional[str] = None,
+    operation_num: Optional[int] = None,
 ) -> YandexDirectV4Live:
     """
     Create YandexDirect v4 Live client.
@@ -96,6 +98,8 @@ def create_v4_client(
         language: API locale
         retry_if_exceeded_limit: Retry when the API limit is exceeded
         retries_if_server_error: Number of retries for server errors
+        finance_token: Financial token for v4 Live finance methods
+        operation_num: Financial operation number for v4 Live finance methods
 
     Returns:
         YandexDirect v4 Live client instance
@@ -117,6 +121,8 @@ def create_v4_client(
         language=language or "en",
         retry_if_exceeded_limit=retry_if_exceeded_limit,
         retries_if_server_error=retries_if_server_error,
+        finance_token=finance_token,
+        operation_num=operation_num,
     )
 
 

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/cli.py

@@ -42,10 +42,10 @@ from .commands.dynamicfeedadtargets import dynamicfeedadtargets
 from .commands.strategies import strategies
 from .commands.auth import auth
 from .commands.balance import balance
+from .commands.v4events import v4events
+from .commands.v4finance import v4finance
+from .commands.v4account import v4account
 from .commands.v4shells import (
-    v4account,
-    v4events,
-    v4finance,
     v4forecast,
     v4meta,
     v4wordstat,

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/commands/adextensions.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 add_criteria_csv, get_default_fields, parse_ids
 
 
 @click.group()
@@ -17,13 +17,30 @@ def adextensions():
 @adextensions.command()
 @click.option("--ids", help="Comma-separated extension IDs")
 @click.option("--types", help="Filter by types")
+@click.option("--states", help="Comma-separated states")
+@click.option("--statuses", help="Comma-separated statuses")
+@click.option("--modified-since", help="ModifiedSince datetime")
 @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.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
-def get(ctx, ids, types, limit, fetch_all, output_format, output, fields):
+def get(
+    ctx,
+    ids,
+    types,
+    states,
+    statuses,
+    modified_since,
+    limit,
+    fetch_all,
+    output_format,
+    output,
+    fields,
+    dry_run,
+):
     """Get ad extensions"""
     try:
         client = create_client(
@@ -41,6 +58,10 @@ def get(ctx, ids, types, limit, fetch_all, output_format, output, fields):
             criteria["Ids"] = parse_ids(ids)
         if types:
             criteria["Types"] = types.split(",")
+        add_criteria_csv(criteria, "States", states, upper=True)
+        add_criteria_csv(criteria, "Statuses", statuses, upper=True)
+        if modified_since:
+            criteria["ModifiedSince"] = modified_since
 
         params = {"SelectionCriteria": criteria, "FieldNames": field_names}
 
@@ -49,6 +70,10 @@ def get(ctx, ids, types, limit, fetch_all, output_format, output, fields):
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.adextensions().post(data=body)
 
         if fetch_all:

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/commands/adgroups.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 add_criteria_csv, get_default_fields, parse_ids
 
 
 @click.group()
@@ -18,26 +18,46 @@ def adgroups():
 @click.option("--ids", help="Comma-separated ad group IDs")
 @click.option("--campaign-ids", help="Comma-separated campaign IDs")
 @click.option("--status", help="Filter by status")
+@click.option("--statuses", help="Comma-separated statuses")
 @click.option("--types", help="Filter by types")
+@click.option("--tag-ids", help="Comma-separated tag IDs")
+@click.option("--tags", help="Comma-separated tag names")
+@click.option("--app-icon-statuses", help="Comma-separated app icon statuses")
+@click.option("--serving-statuses", help="Comma-separated serving statuses")
+@click.option(
+    "--negative-keyword-shared-set-ids",
+    help="Comma-separated negative keyword shared set IDs",
+)
 @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.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
 def get(
     ctx,
     ids,
     campaign_ids,
     status,
+    statuses,
     types,
+    tag_ids,
+    tags,
+    app_icon_statuses,
+    serving_statuses,
+    negative_keyword_shared_set_ids,
     limit,
     fetch_all,
     output_format,
     output,
     fields,
+    dry_run,
 ):
     """Get ad groups"""
+    if status and statuses:
+        raise click.UsageError("--status and --statuses are mutually exclusive")
+
     try:
         client = create_client(
             token=ctx.obj.get("token"),
@@ -54,8 +74,19 @@ def get(
             criteria["CampaignIds"] = parse_ids(campaign_ids)
         if status:
             criteria["Statuses"] = [status]
+        add_criteria_csv(criteria, "Statuses", statuses, upper=True)
         if types:
             criteria["Types"] = types.split(",")
+        add_criteria_csv(criteria, "TagIds", tag_ids, integers=True)
+        add_criteria_csv(criteria, "Tags", tags)
+        add_criteria_csv(criteria, "AppIconStatuses", app_icon_statuses, upper=True)
+        add_criteria_csv(criteria, "ServingStatuses", serving_statuses, upper=True)
+        add_criteria_csv(
+            criteria,
+            "NegativeKeywordSharedSetIds",
+            negative_keyword_shared_set_ids,
+            integers=True,
+        )
 
         params = {"SelectionCriteria": criteria, "FieldNames": field_names}
 
@@ -64,6 +95,10 @@ def get(
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.adgroups().post(data=body)
 
         if fetch_all:

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/commands/adimages.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, load_base64_file, parse_ids
+from ..utils import add_criteria_csv, get_default_fields, load_base64_file, parse_ids
 
 
 @click.group()
@@ -16,13 +16,27 @@ def adimages():
 
 @adimages.command()
 @click.option("--ids", help="Comma-separated image IDs")
+@click.option("--image-hashes", help="Comma-separated ad image hashes")
+@click.option("--associated", type=click.Choice(["YES", "NO"], case_sensitive=False))
 @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.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
-def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+def get(
+    ctx,
+    ids,
+    image_hashes,
+    associated,
+    limit,
+    fetch_all,
+    output_format,
+    output,
+    fields,
+    dry_run,
+):
     """Get ad images"""
     try:
         client = create_client(
@@ -31,21 +45,28 @@ def get(ctx, ids, limit, fetch_all, output_format, output, fields):
             sandbox=ctx.obj.get("sandbox"),
         )
 
-        field_names = (
-            fields.split(",") if fields else get_default_fields("adimages")
-        )
+        field_names = fields.split(",") if fields else get_default_fields("adimages")
 
         criteria = {}
         if ids:
             criteria["Ids"] = parse_ids(ids)
+        add_criteria_csv(criteria, "AdImageHashes", image_hashes)
+        if associated:
+            criteria["Associated"] = associated.upper()
 
-        params = {"SelectionCriteria": criteria, "FieldNames": field_names}
+        params = {"FieldNames": field_names}
+        if criteria:
+            params["SelectionCriteria"] = criteria
 
         if limit:
             params["Page"] = {"Limit": limit}
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.adimages().post(data=body)
 
         if fetch_all:

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/commands/ads.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 add_criteria_csv, get_default_fields, parse_ids
 
 
 @click.group()
@@ -19,6 +19,24 @@ def ads():
 @click.option("--campaign-ids", help="Comma-separated campaign IDs")
 @click.option("--adgroup-ids", help="Comma-separated ad group IDs")
 @click.option("--status", help="Filter by status")
+@click.option("--statuses", help="Comma-separated statuses")
+@click.option("--states", help="Comma-separated states")
+@click.option("--types", help="Comma-separated ad types")
+@click.option("--mobile", type=click.Choice(["YES", "NO"], case_sensitive=False))
+@click.option("--vcard-ids", help="Comma-separated vCard IDs")
+@click.option("--sitelink-set-ids", help="Comma-separated sitelink set IDs")
+@click.option("--image-hashes", help="Comma-separated ad image hashes")
+@click.option(
+    "--vcard-moderation-statuses", help="Comma-separated vCard moderation statuses"
+)
+@click.option(
+    "--sitelinks-moderation-statuses",
+    help="Comma-separated sitelinks moderation statuses",
+)
+@click.option(
+    "--image-moderation-statuses", help="Comma-separated image moderation statuses"
+)
+@click.option("--adextension-ids", help="Comma-separated ad extension IDs")
 @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")
@@ -35,6 +53,17 @@ def get(
     campaign_ids,
     adgroup_ids,
     status,
+    statuses,
+    states,
+    types,
+    mobile,
+    vcard_ids,
+    sitelink_set_ids,
+    image_hashes,
+    vcard_moderation_statuses,
+    sitelinks_moderation_statuses,
+    image_moderation_statuses,
+    adextension_ids,
     limit,
     fetch_all,
     output_format,
@@ -44,6 +73,9 @@ def get(
     dry_run,
 ):
     """Get ads"""
+    if status and statuses:
+        raise click.UsageError("--status and --statuses are mutually exclusive")
+
     try:
         field_names = (
             fields.split(",") if fields else get_default_fields("ads", "FieldNames")
@@ -64,6 +96,27 @@ def get(
             criteria["AdGroupIds"] = parse_ids(adgroup_ids)
         if status:
             criteria["Statuses"] = [status]
+        add_criteria_csv(criteria, "Statuses", statuses, upper=True)
+        add_criteria_csv(criteria, "States", states, upper=True)
+        add_criteria_csv(criteria, "Types", types, upper=True)
+        if mobile:
+            criteria["Mobile"] = mobile.upper()
+        add_criteria_csv(criteria, "VCardIds", vcard_ids, integers=True)
+        add_criteria_csv(criteria, "SitelinkSetIds", sitelink_set_ids, integers=True)
+        add_criteria_csv(criteria, "AdImageHashes", image_hashes)
+        add_criteria_csv(
+            criteria, "VCardModerationStatuses", vcard_moderation_statuses, upper=True
+        )
+        add_criteria_csv(
+            criteria,
+            "SitelinksModerationStatuses",
+            sitelinks_moderation_statuses,
+            upper=True,
+        )
+        add_criteria_csv(
+            criteria, "AdImageModerationStatuses", image_moderation_statuses, upper=True
+        )
+        add_criteria_csv(criteria, "AdExtensionIds", adextension_ids, integers=True)
 
         params = {
             "SelectionCriteria": criteria,
@@ -139,9 +192,7 @@ def add(ctx, adgroup_id, ad_type, title, text, href, image_hash, dry_run):
                 if not value
             ]
             if missing_fields:
-                raise click.UsageError(
-                    "TEXT_AD requires " + ", ".join(missing_fields)
-                )
+                raise click.UsageError("TEXT_AD requires " + ", ".join(missing_fields))
             ad_data["TextAd"] = {
                 "Mobile": "NO",
                 "Title": title,

{direct_cli-0.3.1 → direct_cli-0.3.2}/direct_cli/commands/advideos.py

@@ -15,14 +15,15 @@ def advideos():
 
 
 @advideos.command()
-@click.option("--ids", help="Comma-separated video IDs")
+@click.option("--ids", required=True, help="Comma-separated video IDs")
 @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.option("--dry-run", is_flag=True, help="Show request without sending")
 @click.pass_context
-def get(ctx, ids, limit, fetch_all, output_format, output, fields):
+def get(ctx, ids, limit, fetch_all, output_format, output, fields, dry_run):
     """Get ad videos"""
     try:
         client = create_client(
@@ -33,9 +34,7 @@ def get(ctx, ids, limit, fetch_all, output_format, output, fields):
 
         field_names = fields.split(",") if fields else get_default_fields("advideos")
 
-        criteria = {}
-        if ids:
-            criteria["Ids"] = [x.strip() for x in ids.split(",")]
+        criteria = {"Ids": [x.strip() for x in ids.split(",") if x.strip()]}
 
         params = {
             "SelectionCriteria": criteria,
@@ -47,6 +46,10 @@ def get(ctx, ids, limit, fetch_all, output_format, output, fields):
 
         body = {"method": "get", "params": params}
 
+        if dry_run:
+            format_output(body, "json", None)
+            return
+
         result = client.advideos().post(data=body)
 
         if fetch_all:
@@ -64,7 +67,9 @@ def get(ctx, ids, limit, fetch_all, output_format, output, fields):
 
 
 @advideos.command()
-@click.option("--url", help="Video URL (mutually exclusive with --video-data/--video-file)")
+@click.option(
+    "--url", help="Video URL (mutually exclusive with --video-data/--video-file)"
+)
 @click.option("--video-data", help="Base64-encoded video binary")
 @click.option("--video-file", help="Path to a video file to base64-encode")
 @click.option("--name", help="Video name")