mcm-cli 1.3.1__py3-none-any.whl → 1.4.0__py3-none-any.whl

{mcm_cli-1.3.1.dist-info → mcm_cli-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mcm-cli
-Version: 1.3.1
+Version: 1.4.0
 Summary: A command-line interface for Moloco Commerde Media
 Home-page: https://github.com/moloco-mcm/mcm-cli
 Author: Moloco MCM Team

{mcm_cli-1.3.1.dist-info → mcm_cli-1.4.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
 mcmcli/__init__.py,sha256=-U6lMZ9_99IXAKwnqnYXYr6NcO6TSmG-kxewgvJjU4k,575
-mcmcli/__main__.py,sha256=Rnx3sLJc0OObJic70Z0I6h0-pjTaKK-qYqj42nzcskw,1616
+mcmcli/__main__.py,sha256=eoXcJ-YvL7VS-qI3tzWEm2Zz9Mc3aKMC2WRgr8nxDAY,1616
 mcmcli/logging.py,sha256=xjRS5ey1ONx_d34qB1Fetb_SwPysoh2hzNDuNAaYYWQ,1739
 mcmcli/requests.py,sha256=IuySBQ8P_GoGF3f_TRysfgQNOhi2n9M84WK_eRXnoEU,2945
 mcmcli/command/account.py,sha256=kxJbBKYrw6OyCdaNZ0K0BEvKgZEAjj5azO-lNSeYLTM,25107
-mcmcli/command/admin.py,sha256=nJ7rm0nm0jHPobg0PjNHIWaWURTQu6QEUEUKIo__GO0,3010
+mcmcli/command/admin.py,sha256=mDngighzQZPWlq0hOex2qzW8GNcZmvzVOTWre5RTJRE,5520
 mcmcli/command/auth.py,sha256=QLdr_XFW5BVw9r4a7Kjj5BTBXpSux3AWI9eI03S8aiA,2480
 mcmcli/command/config.py,sha256=sdzge-l_Yi2P_TlTgSLqShcGyPCzpW3QJzctpIvc-g4,4195
 mcmcli/command/decision.py,sha256=Zjbmt71OVU-oL8Itt9O-SvwT9Lbxw-PAgRZaIgiXi-E,8411
@@ -13,13 +13,14 @@ mcmcli/data/account_user.py,sha256=27nQp52nMma5a3QszSJGqgq5Z0ivIb-nMZcZuhEgbEg,1
 mcmcli/data/decision.py,sha256=bQ5j_PbPRSFa0sY5g9UVqdNzl_2epchcz1lHoDVuV90,2880
 mcmcli/data/error.py,sha256=d6xa_jTXumlA0EzXy2PJQ86ajBb0Pm90fss9R3LuHUc,1094
 mcmcli/data/item.py,sha256=Z2xTRhU8T4vyJADO0l6-XPyQXvb9DX_OAjExhSXpW2A,1091
+mcmcli/data/item_blocking_result.py,sha256=daK4c8--aCe2vRsnTzLBjgKQo0C-zcDH09dC0GgrN7E,1429
 mcmcli/data/seller.py,sha256=40SA7QekM3a3svDrDYLo_QYJ68VUxDO0KeGejJMp4k4,1004
 mcmcli/data/token.py,sha256=11wtyLHCAZHu0LVbNDPa-yipcL6lenxoYIKEI58VzFs,1744
 mcmcli/data/wallet.py,sha256=eMUi8N0vJdg_E10TPhSPoZkZtmIG7gHyqgabQ8C5Lg8,3217
-mcm_cli-1.3.1.dist-info/LICENSE,sha256=RFhQPdSOiMTguUX7JSoIuTxA7HVzCbj_p8WU36HjUQQ,10947
-mcm_cli-1.3.1.dist-info/METADATA,sha256=GMtyMAiGd5DxGm7v7Id5AcSgtW5tcq5paDD1XrXlaag,3018
-mcm_cli-1.3.1.dist-info/NOTICE,sha256=Ldnl2MjRaXPxcldUdbI2NTybq60XAa2LowRhFrRTuiI,76
-mcm_cli-1.3.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-mcm_cli-1.3.1.dist-info/entry_points.txt,sha256=qTHAWZ-ejSiU4t11RYwtAU8ScqhQPDeMVTG9y4wMVLg,60
-mcm_cli-1.3.1.dist-info/top_level.txt,sha256=sh7oqIaqLQlMtKHlxHHgpV2xGMrBMPFWpSp0C6nvJ_Y,7
-mcm_cli-1.3.1.dist-info/RECORD,,
+mcm_cli-1.4.0.dist-info/LICENSE,sha256=RFhQPdSOiMTguUX7JSoIuTxA7HVzCbj_p8WU36HjUQQ,10947
+mcm_cli-1.4.0.dist-info/METADATA,sha256=qRht0jD47cuF5FQN1JwCZPlVWsIWNrsMl_sdY4VF7Rs,3018
+mcm_cli-1.4.0.dist-info/NOTICE,sha256=Ldnl2MjRaXPxcldUdbI2NTybq60XAa2LowRhFrRTuiI,76
+mcm_cli-1.4.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+mcm_cli-1.4.0.dist-info/entry_points.txt,sha256=qTHAWZ-ejSiU4t11RYwtAU8ScqhQPDeMVTG9y4wMVLg,60
+mcm_cli-1.4.0.dist-info/top_level.txt,sha256=sh7oqIaqLQlMtKHlxHHgpV2xGMrBMPFWpSp0C6nvJ_Y,7
+mcm_cli-1.4.0.dist-info/RECORD,,

mcmcli/__main__.py

@@ -35,7 +35,7 @@ def version():
 	"""
 	Show the tool version
 	"""
-	typer.echo(f"Version: mcm-cli v1.3.1")
+	typer.echo(f"Version: mcm-cli v1.4.0")
 
 app.add_typer(mcmcli.command.account.app, name="account", help="Ad account management")
 app.add_typer(mcmcli.command.admin.app, name="admin", help="Platform administration")

mcmcli/command/admin.py

@@ -11,6 +11,11 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
+from datetime import datetime, timedelta, timezone
+from mcmcli.data.error import Error
+from mcmcli.data.item_blocking_result import ItemBlockingResult
+from mcmcli.requests import CurlString, api_request
+from typing import Optional
 
 import mcmcli.command.account
 import mcmcli.command.auth
@@ -43,6 +48,35 @@ def list_wallet_balances(
     admin.list_wallet_balances()
 
 
+@app.command()
+def block_item(
+    item_id: str = typer.Option(help="Item ID"),
+    account_id: str = typer.Option(None, help="The Ad Account ID is applicable only for MSPI catalogs. If this value is provided, only the item associated with the specified seller ID will be removed from ad serving. If it is not provided, the specified item will be removed for all sellers in the MSPI catalog."),
+    to_curl: bool = typer.Option(False, help="Generate the curl command instead of executing it."),
+    profile: str = typer.Option("default", help="Profile name of the MCM CLI."),
+):
+    """
+    Item Kill Switch Command.
+    This API immediately blocks an item or an ad account item from appearing in ads by marking it as “blocked.”
+    """
+    timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%fZ")
+
+    # print(f"invoked block_item(item_id={item_id}, account_id={account_id}, blocked='Requested at {timestamp}')");
+    admin = _create_admin_command(profile)
+    if admin is None:
+        return
+    
+    curl, error, result = admin.block_item(item_id=item_id, account_id=account_id, to_curl=to_curl)
+    if curl:
+        print(curl)
+        return
+    if error:
+        print(f"ERROR: {error.message}", file=sys.stderr, flush=True)
+        return
+    
+    print(result.model_dump_json())
+    return
+
 class AdminCommand:
     def __init__(
         self,
@@ -63,6 +97,36 @@ class AdminCommand:
             "Authorization": f"Bearer {token}"
         }
 
+    def block_item(
+        self,
+        item_id,
+        account_id,
+        to_curl,
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Optional[ItemBlockingResult],
+    ]:
+        _api_url = f"{self.api_base_url}/item-status-bulk"
+        _requested_at = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%fZ")
+        _payload = { 
+            "items": [{
+                "item_id": item_id,
+                "seller_id": account_id,
+                "updated_time": _requested_at,
+                "blocked": f'Requested at {_requested_at}',
+            }]
+        }
+        if account_id is None:
+            del _payload["items"][0]["seller_id"]
+        
+        curl, error, json_obj = api_request('POST', to_curl, _api_url, self.headers, _payload)
+        if curl:
+            return curl, None, None
+        if error:
+            return None, error, None
+        return None, None, ItemBlockingResult(**json_obj)
+    
     def list_wallet_balances(
         self
     ):

mcmcli/data/item_blocking_result.py

@@ -0,0 +1,54 @@
+# Copyright 2023 Moloco, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pydantic import BaseModel
+from typing import Optional
+
+#
+# API response dataclasse of the item kill switch API
+#
+# The example response is as below:
+# {
+#   "success_items": [
+#     {
+#       "item_id": "item_1",
+#       "seller_id": "seller_1",
+#       "region": ""
+#     }
+#   ],
+#   "failure_items": [
+#     {
+#       "item_id": "item_2",
+#       "seller_id": "seller_2",
+#       "region": "",
+#       "message": "rpc error: code = Internal desc = ad account not found"
+#     }
+#   ]
+# }
+
+class SucceededItemBlockingAttempt(BaseModel):
+    item_id: str
+    seller_id: str
+    region: str
+
+class FailedItemBlockingAttempt(BaseModel):
+    item_id: str
+    seller_id: str
+    region: str
+    message: str
+
+
+class ItemBlockingResult(BaseModel):
+    success_items: list[SucceededItemBlockingAttempt]
+    failure_items: list[FailedItemBlockingAttempt]