mcm-cli 0.45__py3-none-any.whl → 0.49__py3-none-any.whl

{mcm_cli-0.45.dist-info → mcm_cli-0.49.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mcm-cli
-Version: 0.45
+Version: 0.49.0
 Summary: A command-line interface for Moloco Commerde Media
 Home-page: https://github.com/moloco-mcm/mcm-cli
 Author: Moloco MCM Team
@@ -32,30 +32,43 @@ Please contact the Moloco representative for more details.
 
 ## How to install
 
-Run the command from a terminal.
+To install, run:
+```
+pip install mcm-cli
+```
+
+For installation from the source code, use:
 ```
 git clone https://github.com/moloco-mcm/mcm-cli.git && pip install mcm-cli
 ```
 
 ## How to upgrade
 
-Run the command from a terminal.
+To upgrade, run:
+```
+pip install --upgrade mcm-cli
+```
+
+Or, if installed from the source code:
 ```
 git -C mcm-cli pull && pip install mcm-cli
 ```
 
 ## How to uninstall
 
-Run the command from a terminal.
+To uninstall, run:
 ```
 pip uninstall mcm-cli
 ```
 
 ## How to use
-Run `$ mcm config init` to initialize the configuration. It saves the configuration to `~/.mcm/config.toml`.
-
-Use `--help` option to learn more of each command.
+Initialize the configuration with:
+```
+mcm config init
+```
+This saves the configuration to `~/.mcm/config.toml`.
 
+For more details on each command, use the `--help` option.
 ```
 $ mcm --help
 
@@ -65,9 +78,11 @@ $ mcm --help
 │ --help          Show this message and exit.                      │
 ╰──────────────────────────────────────────────────────────────────╯
 ╭─ Commands ───────────────────────────────────────────────────────╮
+│ account    Ad account management                                 │
 │ auth       Authentication management                             │
 │ config     Configurations                                        │
-│ version                                                          │
+│ decision   Decision command                                      │
+│ version    Show the tool version                                 │
 │ wallet     Wallet management                                     │
 ╰──────────────────────────────────────────────────────────────────╯
 

mcm_cli-0.49.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+mcmcli/__init__.py,sha256=-U6lMZ9_99IXAKwnqnYXYr6NcO6TSmG-kxewgvJjU4k,575
+mcmcli/__main__.py,sha256=RN_N--yPkndsO-Hya-yuQCrGY9JYFszO1kuJ6iFLw9c,1474
+mcmcli/logging.py,sha256=xjRS5ey1ONx_d34qB1Fetb_SwPysoh2hzNDuNAaYYWQ,1739
+mcmcli/requests.py,sha256=50N_LiWIWr8-3EPs_yR9f4uEQf8rQ68s_FoMYRhgjzI,2343
+mcmcli/command/account.py,sha256=EtcYZsC5LL5ue-hKsZZl3_0oZ09nJdVi774yqiTykl8,14712
+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
+mcmcli/command/wallet.py,sha256=TB3WrmniREsDk0ui20p3ha6OZMwA2wAJaxQ9QDGtKnA,8968
+mcmcli/data/account.py,sha256=pe7tPapP6vlUD5D5L5Nh5k2bkWdYOK01Mpt5fBYFnJs,1782
+mcmcli/data/account_user.py,sha256=27nQp52nMma5a3QszSJGqgq5Z0ivIb-nMZcZuhEgbEg,1328
+mcmcli/data/decision.py,sha256=bQ5j_PbPRSFa0sY5g9UVqdNzl_2epchcz1lHoDVuV90,2880
+mcmcli/data/error.py,sha256=d6xa_jTXumlA0EzXy2PJQ86ajBb0Pm90fss9R3LuHUc,1094
+mcmcli/data/seller.py,sha256=40SA7QekM3a3svDrDYLo_QYJ68VUxDO0KeGejJMp4k4,1004
+mcmcli/data/token.py,sha256=11wtyLHCAZHu0LVbNDPa-yipcL6lenxoYIKEI58VzFs,1744
+mcmcli/data/wallet.py,sha256=W-CksF9SPqiv3jZg07Wy8ehVUP5Ot1Gbq2LEGNQCOC8,1906
+mcm_cli-0.49.0.dist-info/LICENSE,sha256=RFhQPdSOiMTguUX7JSoIuTxA7HVzCbj_p8WU36HjUQQ,10947
+mcm_cli-0.49.0.dist-info/METADATA,sha256=WkQSZEIyOkyjuChZpPHaEyToWLg6cTCrAzIEMmqB_hU,3019
+mcm_cli-0.49.0.dist-info/NOTICE,sha256=Ldnl2MjRaXPxcldUdbI2NTybq60XAa2LowRhFrRTuiI,76
+mcm_cli-0.49.0.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
+mcm_cli-0.49.0.dist-info/entry_points.txt,sha256=qTHAWZ-ejSiU4t11RYwtAU8ScqhQPDeMVTG9y4wMVLg,60
+mcm_cli-0.49.0.dist-info/top_level.txt,sha256=sh7oqIaqLQlMtKHlxHHgpV2xGMrBMPFWpSp0C6nvJ_Y,7
+mcm_cli-0.49.0.dist-info/RECORD,,

mcmcli/__main__.py

@@ -17,10 +17,10 @@
 """mcm cli entry point script."""
 # mcmcli/__main__.py
 
-from typing import Optional
-
+import mcmcli.command.account
 import mcmcli.command.auth
 import mcmcli.command.config
+import mcmcli.command.decision
 import mcmcli.command.wallet
 import mcmcli.logging
 import typer
@@ -32,10 +32,12 @@ def version():
 	"""
 	Show the tool version
 	"""
-	typer.echo(f"Version: mcm-cli v0.45")
+	typer.echo(f"Version: mcm-cli v0.49.0")
 
+app.add_typer(mcmcli.command.account.app, name="account", help="Ad account management")
 app.add_typer(mcmcli.command.auth.app, name="auth", help="Authentication management")
 app.add_typer(mcmcli.command.config.app, name="config", help="Configurations")
+app.add_typer(mcmcli.command.decision.app, name="decision", help="Decision command")
 app.add_typer(mcmcli.command.wallet.app, name="wallet", help="Wallet management")
 
 if __name__ == "__main__":

mcmcli/command/account.py

@@ -0,0 +1,461 @@
+# 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 enum import Enum
+from mcmcli.data.account import Account, AccountListWrapper
+from mcmcli.data.account_user import User, UserWrapper, UserListWrapper
+from mcmcli.data.error import Error
+from mcmcli.data.seller import Seller, SellerListWrapper
+from mcmcli.requests import CurlString, api_request
+from typing import Any, Callable, Dict, Optional, Tuple, TypeVar
+
+import csv
+import mcmcli.command.auth
+import mcmcli.command.config
+import mcmcli.logging
+import mcmcli.requests
+import sys
+import time
+import typer
+
+MAX_NUM_ITEMS_PER_PAGE = 5000
+T = TypeVar('T')
+
+class UserRole(Enum):
+    AD_ACCOUNT_OWNER = "AD_ACCOUNT_OWNER"
+
+app = typer.Typer(add_completion=False)
+
+
+@app.command()
+def bulk_invite_ad_account_owners(
+    csv_file: str = typer.Option(help="CSV file path that contains the list of ad account id, user email address, and the user name."),
+    dry_run: bool = typer.Option(True, help="Perform a dry run without sending emails."),
+    skip_csv_header: bool = typer.Option(False, help="Skip the first line of the CSV file."),
+    create_account: bool = typer.Option(False, help="Create the ad account if it doesn't exist."),
+    create_user: bool = typer.Option(False, help="Create the ad account user if it doesn't exist."),
+    profile: str = typer.Option("default", help="profile name of the MCM CLI."),
+):
+    """
+    Send campaign manager invitation emails to ad account owners. Ensure the CSV file has three columns:
+    ad account ID, user email address, and user name. Extra columns are ignored.
+    """
+    csv_data = _read_csv_file(csv_file, skip_csv_header)
+    if csv_data is None:
+        return 
+
+    a = _create_account_command(profile)
+    if a is None:
+        return
+
+    if dry_run:
+        print(f"Dry run initiated.")
+
+    #
+    # get the list of sellers
+    #
+    _, error, seller_dictionary = a.list_sellers()
+    if error:
+        print(f"ERROR: {error.message}", file=sys.stderr, flush=True)
+        return
+
+
+    print('Processing the command ', end='', file=sys.stderr, flush=True)
+    total_count = len(csv_data)
+    success_count = 0
+    account_creation_count = 0
+    for row in csv_data:
+        account_id = row[0].strip()
+        email_address = row[1].strip()
+        user_name = row[2].strip()
+        print('.', end='', file=sys.stderr, flush=True)
+
+        # Check if the ad account exists
+        if _lookup_dict(account_id, seller_dictionary) is None:
+            print(f"\nERROR: Could not find the ad account ID {account_id}", file=sys.stderr, flush=True)
+            continue
+
+        # Create the ad account if the seller doesn't have one yet and the CLI command tells to create the ad account.
+        seller_info = seller_dictionary[account_id]
+        if not seller_info.is_registered and create_account:
+            error, _ = a.create_account_with_retry(seller_info.id, seller_info.title, dry_run)
+            if error:
+                print(f"\nERROR: Failed to create the ad account {account_id}. {error.message}.", file=sys.stderr, flush=True)
+                continue
+            account_creation_count += 1
+
+        error = a.send_invitation_email_with_retry(account_id, email_address, user_name, create_user, dry_run)
+        if error:
+            print(f"\nERROR: Failed to send the mail for the ad account ID {account_id}. {error.message}.", file=sys.stderr, flush=True)
+            continue
+
+        success_count += 1
+
+    print(' Done', file=sys.stderr, flush=True)
+    if dry_run:
+        print(f"If this wasn't a dry-run, it would have sent {success_count} out of {total_count} emails and created {account_creation_count} new ad accounts.", flush=True)
+    else:
+        print(f'Sent {success_count} out of {total_count} emails, and created {account_creation_count} new ad accounts.', flush=True)
+    return
+
+
+@app.command()
+def bulk_check_user_registrations(
+    csv_file: str = typer.Option(help="CSV file path that contains the list of ad account id and user email address."),
+    skip_csv_header: bool = typer.Option(False, help="Skip the first line of the CSV file."),
+    profile: str = typer.Option("default", help="profile name of the MCM CLI."),
+):
+    """
+    Check user status. Ensure the CSV file has two columns: ad account ID and user email address. Extra columns are ignored.
+    """
+    csv_data = _read_csv_file(csv_file, skip_csv_header)
+    if csv_data is None:
+        return 
+
+    a = _create_account_command(profile)
+    if a is None:
+        return
+
+    _, error, account_dictionary = a.list_accounts(to_curl=False)
+    if error:
+        print(f"ERROR: {error.message}", file=sys.stderr, flush=True)
+        return
+
+    print('"Ad Account ID","Is Ad Account Exist","User Email","Is User Exist","User Role","User Status"')
+    for row in csv_data:
+        account_id = row[0].strip()
+        email_address = row[1].strip()
+        account = _lookup_dict(account_id, account_dictionary)
+        is_account_exist = "No Account Exists" if account is None else "Account Exists"
+
+        error, user_dictionary = a.list_account_users_with_retry(account_id)
+        if error:
+            print(f"\nERROR: {error.message}", file=sys.stderr, flush=True)
+            return
+
+        user = _lookup_dict(email_address, user_dictionary)
+        is_user_exist = "No User Exist" if user is None else "User Exists"
+        user_role = "" if user is None else user.role
+        user_status = "" if user is None else user.status
+        print(f'"{account_id}","{is_account_exist}","{email_address}","{is_user_exist}","{user_role}","{user_status}"')
+    return
+
+
+class AccountCommand:
+    def __init__(
+        self,
+        profile,
+        auth_command: mcmcli.command.auth.AuthCommand,
+        token
+    ):
+        self.config = mcmcli.command.config.get_config(profile)
+        if (self.config is None):
+            print(f"ERROR: Failed to load the CLI profile", file=sys.stderr, flush=True)
+            sys.exit()
+
+        self.profile = profile
+        self.auth_command = auth_command
+        self.api_base_url = f"{self.config['management_api_hostname']}/rmp/mgmt/v1/platforms/{self.config['platform_id']}"
+        self.headers = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "Authorization": f"Bearer {token}"
+        }
+
+
+    def refresh_token(
+        self,
+    ) -> None:
+        _, error, token = self.auth_command.get_token()
+        if error:
+            print(f"ERROR: {error.message}", file=sys.stderr, flush=True)
+            return
+        self.headers["Authorization"] = f"Bearer {token.token}"
+
+
+    def retry_with_token_refresh(
+        self,
+        operation: Callable[[], Tuple[Optional[Error], Any]],
+        max_retries: int = 3,
+        delay: int = 1,
+    ) -> Tuple[
+        Optional[Error],
+        Any
+    ]:
+        retries = 0
+        while retries < max_retries:
+            error, result = operation()
+            if error and error.code == 16:
+                print(f"\nERROR: authentication token expired. Retrying...", file=sys.stderr, flush=True)
+                self.refresh_token()
+                retries += 1
+                time.sleep(delay)
+                continue
+            return error, result
+        return Error(code=16, message="Failed to regain an authentication token"), None
+
+
+    def send_invitation_email(
+        self,
+        account_id: str,
+        email_address: str,
+        user_name: str,
+        create_user: bool,
+    ) -> Optional[Error]:
+
+        error, user_dictionary = self.list_account_users(account_id)
+        if error:
+            return error
+
+        user = _lookup_dict(email_address, user_dictionary)
+        if user is None:
+            if not create_user:
+                _msg = f"\nERROR: The ad account {account_id} exists. But we could not find the user with email {email_address}"
+                print(_msg, file=sys.stderr, flush=True)
+                return Error(code=1, message = _msg)
+
+            _, error, _ = self.invite_user(account_id, email_address, user_name, to_curl=False)
+            return error
+
+        #
+        # The ad account and the user exists. We can just send the password reset email
+        #
+        _api_url = f"{self.api_base_url}/users/{user.id}/password-reset-tokens"
+        _, error, _ = api_request('POST', False, _api_url, self.headers)
+        return error
+
+    def send_invitation_email_with_retry(
+        self,
+        account_id: str,
+        email_address: str,
+        user_name: str,
+        create_user: bool,
+        dry_run: bool,
+    ) -> Optional[Error]:
+        if dry_run:
+            return None
+
+        error, _ = self.retry_with_token_refresh(
+            lambda: (
+                self.send_invitation_email(account_id, email_address, user_name, create_user),
+                None,
+            ),
+        )
+        return error
+
+
+    def invite_user(
+        self,
+        account_id,
+        user_email,
+        user_name,
+        role = UserRole.AD_ACCOUNT_OWNER,
+        to_curl = True,
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Optional[User]
+    ]:
+        _api_url = f"{self.api_base_url}/ad-accounts/{account_id}/users"
+        _payload = {
+            "user": {
+                "ad_account_id": account_id,
+                "email": user_email,
+                "name": user_name,
+                "role": role.value,
+            }
+        }
+        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
+
+        ret = UserWrapper(**json_obj).user
+        return None, None, ret
+
+    def create_account(
+        self,
+        account_id,
+        account_name,
+        to_curl
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Optional[Account]
+    ]:
+        _api_url = f"{self.api_base_url}/ad-accounts"
+        _payload = {
+            "ad_account": {
+                "id": account_id,
+                "title": account_name                
+            }
+        }
+
+        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
+        
+        account_info = Account(**json_obj['ad_account'])
+        return None, None, account_info
+
+
+    def create_account_with_retry(
+        self,
+        account_id: str,
+        account_name: str,
+        dry_run: bool,
+    ) -> tuple[
+        Optional[Error],
+        Optional[Account],
+    ]:
+        if dry_run:
+            #print(f"\nDRY RUN: create_account({account_id}, {account_name})")
+            return None, None
+
+        retries = 0
+        delay = 1
+        max_retries = 3
+        while retries < max_retries:
+            _, error, account = self.create_account(account_id, account_name, to_curl=False)
+            if error and error.code == 16:
+                print(f"\nERROR: authentication token expired. Retrying...", file=sys.stderr, flush=True)
+                self.refresh_token()
+                retries += 1
+                time.sleep(delay)
+                continue
+            return error, account
+        return Error(code=16, message="Failed to regain an authentication token"), None
+
+
+    def list_accounts(
+        self,
+        to_curl=False
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Dict[str, Account],
+    ]:
+        _api_url = f"{self.api_base_url}/ad-accounts"
+
+        curl, error, json_obj = api_request('GET', to_curl, _api_url, self.headers)
+        if curl:
+            return curl, None, {}
+        if error:
+            return None, error, {}
+
+        account_list = AccountListWrapper(**json_obj).ad_accounts
+
+        accounts = {}
+        for x in account_list:
+            accounts[x.id] = x
+        return None, None, accounts
+
+
+    def list_sellers(
+        self,
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Dict[str, Seller],
+    ]:
+        _api_url = f"{self.api_base_url}/sellers"
+
+        curl, error, json_obj = api_request('GET', False, _api_url, self.headers)
+        if curl:
+            return curl, None, {}
+        if error:
+            return None, error, {}
+
+        seller_list = SellerListWrapper(**json_obj).sellers
+
+        sellers = {}
+        for x in seller_list:
+            sellers[x.id] = x
+        return None, None, sellers
+
+
+    def list_account_users(
+        self,
+        account_id: str,
+    ) -> tuple [
+        Optional[Error],
+        Dict[str, User],
+    ]:
+        _api_url = f"{self.api_base_url}/ad-accounts/{account_id}/users"
+
+        _, error, json_obj = api_request('GET', False, _api_url, self.headers)
+        if error:
+            return error, {}
+        user_list = UserListWrapper(**json_obj).users
+
+        users = {}
+        for x in user_list:
+            users[x.email] = x
+
+        return None, users
+
+    def list_account_users_with_retry(
+        self,
+        account_id: str
+    ) -> tuple [
+        Optional[Error],
+        Dict[str, User],
+    ]:
+        return self.retry_with_token_refresh(
+            lambda: self.list_account_users(account_id),
+        )
+
+
+
+#
+# Helper functions
+#
+def _create_account_command(
+        profile: str
+) -> Optional[AccountCommand]:
+    auth = mcmcli.command.auth.AuthCommand(profile)
+    _, error, token = auth.get_token()
+    if error:
+        print(f"ERROR: {error.message}", file=sys.stderr, flush=True)
+        return None
+    return AccountCommand(profile, auth, token.token)
+
+
+def _read_csv_file(
+    csv_file: str,
+    skip_csv_header: bool,
+) -> Optional[list[list]]:
+    try:
+        with open(csv_file, mode='r', newline='') as file:
+            csv_reader = csv.reader(file)
+            if skip_csv_header:
+                next(csv_reader)
+            return list(csv_reader)
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr, flush=True)
+        return None
+
+
+def _lookup_dict(
+    id: str,
+    dictionary: Dict[str, T],
+) -> Optional[T]:
+    if id in dictionary:
+        return dictionary[id]
+    return None
+
+

mcmcli/command/decision.py

@@ -0,0 +1,265 @@
+# 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 mcmcli.data.error import Error
+from mcmcli.data.decision import DecidedCreative, DecidedCreativeBulkList, DecidedItemList
+from mcmcli.requests import CurlString, api_request
+from typing import Any, Callable, Dict, Optional, Tuple, TypeVar
+
+import json
+import mcmcli.command.auth
+import mcmcli.command.config
+import mcmcli.logging
+import sys
+import typer
+
+MAX_NUM_ITEMS_PER_PAGE = 5000
+
+app = typer.Typer(add_completion=False)
+
+@app.command()
+def decide_items(
+    inventory_id: str = typer.Option(help="Ad inventory ID"),
+    num_items: int = typer.Option(help="Number of items requested for the inventory."),
+    items: str = typer.Option(None, help="The main item ids of the page. For example, homepage inventories don't have any main items, and product-detail-page inventories have one main item."),
+    location_filter: str = typer.Option(None, help="Location filter value"),
+    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."),
+):
+    """
+    Request item decision by auction.
+    """
+    d = DecisionCommand(profile)
+
+    curl, error, ret = d.decide_items(inventory_id, num_items, items, location_filter, to_curl)
+    if to_curl:
+        print(curl)
+        return
+    if error:
+        print(f"ERROR: {error.message}")
+        return
+    if ret is None:
+        print(f"ERROR: Unknown error")
+        return
+
+    print(ret.model_dump_json())
+    return
+
+
+@app.command()
+def decide_creative(
+    inventory_id: str = typer.Option(help="Ad inventory ID"),
+    items: str = typer.Option(None, help="The main item ids of the page. For example, homepage inventories don't have any main items, and product-detail-page inventories have one main item."),
+    location_filter: str = typer.Option(None, help="Location filter value"),
+    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."),
+):
+    """
+    Request item decision by creative auction.
+    """
+    d = DecisionCommand(profile)
+
+    curl, error, ret = d.decide_creative(inventory_id, items, location_filter, to_curl)
+    if to_curl:
+        print(curl)
+        return
+    if error:
+        print(f"ERROR: {error.message}")
+        return
+    if ret is None:
+        print(f"ERROR: Unknown error")
+        return
+
+    print(ret.model_dump_json())
+    return
+
+
+@app.command()
+def decide_creative_bulk(
+    inventory_id_list: str = typer.Option(help="Ad inventory IDs separated by comma(,)"),
+    items: str = typer.Option(None, help="The main item ids of the page. For example, homepage inventories don't have any main items, and product-detail-page inventories have one main item."),
+    location_filter: str = typer.Option(None, help="Location filter value"),
+    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."),
+):
+    """
+    Request item decision by creative auction for multiple inventories.
+    """
+    d = DecisionCommand(profile)
+
+    curl, error, ret = d.decide_creative_bulk(inventory_id_list, items, location_filter, to_curl)
+    if to_curl:
+        print(curl)
+        return
+    if error:
+        print(f"ERROR: {error.message}")
+        return
+    if ret is None:
+        print(f"ERROR: Unknown error")
+        return
+
+    print(ret.model_dump_json())
+    return
+    
+
+
+class DecisionCommand:
+    def __init__(
+        self,
+        profile,
+    ):
+        self.config = mcmcli.command.config.get_config(profile)
+        if (self.config is None):
+            print(f"ERROR: Failed to load the CLI profile", file=sys.stderr, flush=True)
+            sys.exit()
+
+        self.profile = profile
+        self.api_base_url = f"{self.config['decision_api_hostname']}/rmp/decision/v1/platforms/{self.config['platform_id']}"
+        self.headers = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "x-api-key": self.config['decision_api_key']
+        }
+    
+    def decide_items(
+        self, 
+        inventory_id, 
+        num_items, 
+        items,
+        location_filter, 
+        to_curl,
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Optional[DecidedItemList],
+    ]:
+        _api_url = f"{self.api_base_url}/auction"
+        _payload = {
+            "request_id": "request-1",
+            "inventory": {
+                "inventory_id": inventory_id,
+                "num_items": num_items
+            },
+            "user": {
+                "user_id": "user-1"
+            },
+            "device": {
+                "persistent_id": "persistent-device-1"
+            },
+        }
+        if items:
+            _payload["inventory"]["items"] = items.split(',')
+
+        if location_filter:
+            _payload["filtering"] = {
+                "location": {
+                    "locations": location_filter.split(',')
+                }
+            }
+        
+        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
+
+        decided_items = DecidedItemList(**json_obj)
+        return None, None, decided_items
+
+
+    def decide_creative(
+        self,
+        inventory_id,
+        items,
+        location_filter,
+        to_curl
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error],
+        Optional[DecidedCreative],
+    ]:
+        _api_url = f"{self.api_base_url}/creative-auction"
+        _payload = {
+            "request_id": "request-1",
+            "inventory": {
+                "inventory_id": inventory_id
+            },
+            "user": {
+                "user_id": "user-1"
+            },
+            "device": {
+                "persistent_id": "persistent-device-1"
+            },
+        }
+        if items:
+            _payload["inventory"]["items"] = items.split(',')
+
+        if location_filter:
+            _payload["filtering"] = {
+                "location": {
+                    "locations": location_filter.split(',')
+                }
+            }
+        
+        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
+
+        decided_creative = DecidedCreative(**json_obj)
+        return None, None, decided_creative
+
+
+    def decide_creative_bulk(
+        self, 
+        inventory_id_list, 
+        items,
+        location_filter, 
+        to_curl
+    ) -> tuple[
+        Optional[CurlString],
+        Optional[Error], 
+        Optional[DecidedCreativeBulkList],
+    ]:
+        _api_url = f"{self.api_base_url}/creative-auction-bulk"
+        _payload = {
+            "request_id": "request-1",
+            "inventories": list(map(lambda x: { "inventory_id": x }, inventory_id_list.split(','))),
+            "user": {
+                "user_id": "user-1"
+            },
+            "device": {
+                "persistent_id": "persistent-device-1"
+            },
+        }
+        if items:
+            for inventory in _payload["inventories"]:
+                inventory["items"] = items.split(',')
+
+        if location_filter:
+            _payload["filtering"] = {
+                "location": {
+                    "locations": location_filter.split(',')
+                }
+            }
+
+        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, DecidedCreativeBulkList(**json_obj)
+

mcmcli/data/account.py

@@ -0,0 +1,59 @@
+# 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
+
+#
+# API error response dataclasses
+#
+# list-accounts command's example response is as below:
+#
+# {
+#     "ad_accounts": [
+#         {
+#             "id": "0d139a1b-abcd-11ee-b5f8-12f12be0eb51",
+#             "title": "Smoke Distribution Inc.",
+#             "timezone": "America/New_York",
+#             "state_info": {
+#                 "ad_account_id": "0d139a1b-abcd-11ee-b5f8-12f12be0eb51",
+#                 "state": "ACTIVE",
+#                 "state_case": "INIT_BY_PLATFORM",
+#                 "state_updated_at": "2023-10-23T12:43:31.542660Z",
+#                 "updated_at": "2023-10-23T12:43:31.542660Z"
+#             },
+#             "available_features": [],
+#             "created_at": "2023-10-23T12:43:31.542660Z",
+#             "updated_at": "2023-10-23T12:43:31.542660Z"
+#         }
+#     ]
+# }
+
+class State(BaseModel):
+    ad_account_id: str
+    state: str
+    state_case: str
+    state_updated_at: str
+    updated_at: str
+
+class Account(BaseModel):
+    id: str
+    title: str
+    timezone: str
+    state_info: State
+    # available_features: []
+    created_at: str
+    updated_at: str
+
+class AccountListWrapper(BaseModel):
+    ad_accounts: list[Account]

mcmcli/data/account_user.py

@@ -0,0 +1,50 @@
+# 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
+
+#
+# Ad account users response example is as below:f
+#
+# {
+#     "users": [
+#         {
+#             "ad_account_id": "1234",
+#             "id": "CEdyiC4f1yyyySGEOGj7",
+#             "email": "user@example.com",
+#             "name": "John Doe",
+#             "role": "AD_ACCOUNT_OWNER",
+#             "status": "NOT_REGISTERED",
+#             "created_at": "2024-06-06T14:29:42Z",
+#             "updated_at": "2024-06-06T14:29:42Z"
+#         }
+#     ]
+# }
+
+class User(BaseModel):
+    ad_account_id: str
+    id: str
+    email: str
+    name: str
+    role: str
+    status: str
+    created_at: str
+    updated_at: str
+
+class UserListWrapper(BaseModel):
+    users: list[User]
+
+class UserWrapper(BaseModel):
+    user: User
+

mcmcli/data/decision.py

@@ -0,0 +1,104 @@
+# 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 dataclasses
+#
+# Item decision API's response example:
+#
+# {
+#     "request_id": "request-1",
+#     "decided_items": [
+#         {
+#             "item_id": "1111833",
+#             "auction_result": {
+#                 "ad_account_id": "2444",
+#                 "campaign_id": "zWHhpyNbzYcy5FAy",
+#                 "win_price": {
+#                     "currency": "USD",
+#                     "amount_micro": "500000000"
+#                 },
+#                 "campaign_text_entry": ""
+#             },
+#             "imp_trackers": [
+#                 "https://myplatform-evt.rmp-api.moloco.com/t/i/MYPLATFORM_TEST?source=2X0op"
+#             ],
+#             "click_trackers": [
+#                 "https://myplatform-evt.rmp-api.moloco.com/t/c/MYPLATFORM_TEST?source=2X0opp"
+#             ],
+#             "track_id": "2X0op"
+#         }
+#     ]
+# }
+
+class MicroPrice(BaseModel):
+    currency: str
+    amount_micro: str
+
+class AuctionResult(BaseModel):
+    ad_account_id: str
+    campaign_id: str
+    win_price: Optional[MicroPrice]
+    campaign_text_entry: Optional[str]
+
+class DecidedItem(BaseModel):
+    item_id: str
+    auction_result: Optional[AuctionResult]
+    imp_trackers: list[str]
+    click_trackers: list[str]
+    track_id: Optional[str]
+
+class DecidedItemList(BaseModel):
+    request_id: str
+    decided_items: list[DecidedItem]
+
+class CreativeBanner(BaseModel):
+    creative_id: str
+    image_url: str
+    imp_trackers: list[str]
+    click_trackers: list[str]
+
+class CreativeItem(BaseModel):
+    item_id: str
+    imp_trackers: list[str]
+    click_trackers: list[str] 
+
+class LandingUrl(BaseModel):
+    id: str
+    url: str
+
+class DecidedCreative(BaseModel):
+    request_id: str
+    auction_result: Optional[AuctionResult]
+    banner: Optional[CreativeBanner]
+    items: list[CreativeItem]
+    landing_url:Optional[LandingUrl]
+
+class CreativeBannerWrapper(BaseModel):
+    banner: CreativeBanner
+
+class DecidedCreativeBulk(BaseModel):
+    inventory_id: str
+    auction_result: Optional[AuctionResult]
+    creatives: list[CreativeBannerWrapper]
+    items: list[DecidedItem]
+    landing_url: Optional[LandingUrl]
+
+class DecidedCreativeBulkList(BaseModel):
+    request_id: str
+    results: list[DecidedCreativeBulk]
+

mcmcli/data/seller.py

@@ -0,0 +1,38 @@
+# 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
+
+#
+# API error response dataclasses
+#
+# list-accounts command's example response is as below:
+#
+# {
+#     "sellers": [
+#         {
+#             "id": "4450",
+#             "title": "1 All Good",
+#             "is_registered": false
+#         }
+#     ]
+# }
+
+class Seller(BaseModel):
+    id: str
+    title: str
+    is_registered: bool
+
+class SellerListWrapper(BaseModel):
+    sellers: list[Seller]

mcmcli/data/wallet.py

@@ -24,7 +24,7 @@ from pydantic import BaseModel
 #         {
 #             "id": "TjNwMMlONkaMqNyn",
 #             "title": "",
-#             "ad_account_id": "side_bar_1-ME",
+#             "ad_account_id": "1234",
 #             "type": "PRE_PAYMENT",
 #             "accounts": [
 #                 {

mcm_cli-0.45.dist-info/RECORD

@@ -1,17 +0,0 @@
-mcmcli/__init__.py,sha256=-U6lMZ9_99IXAKwnqnYXYr6NcO6TSmG-kxewgvJjU4k,575
-mcmcli/__main__.py,sha256=Mil8isMhqc3nzQyTDIfC8q3bgmM8jDHaIKtDupyj_xw,1267
-mcmcli/logging.py,sha256=xjRS5ey1ONx_d34qB1Fetb_SwPysoh2hzNDuNAaYYWQ,1739
-mcmcli/requests.py,sha256=50N_LiWIWr8-3EPs_yR9f4uEQf8rQ68s_FoMYRhgjzI,2343
-mcmcli/command/auth.py,sha256=QLdr_XFW5BVw9r4a7Kjj5BTBXpSux3AWI9eI03S8aiA,2480
-mcmcli/command/config.py,sha256=sdzge-l_Yi2P_TlTgSLqShcGyPCzpW3QJzctpIvc-g4,4195
-mcmcli/command/wallet.py,sha256=TB3WrmniREsDk0ui20p3ha6OZMwA2wAJaxQ9QDGtKnA,8968
-mcmcli/data/error.py,sha256=d6xa_jTXumlA0EzXy2PJQ86ajBb0Pm90fss9R3LuHUc,1094
-mcmcli/data/token.py,sha256=11wtyLHCAZHu0LVbNDPa-yipcL6lenxoYIKEI58VzFs,1744
-mcmcli/data/wallet.py,sha256=HvFJsRsPNRw-n_lwm6kAKlUxQbtnft97QFkHiS3StjY,1915
-mcm_cli-0.45.dist-info/LICENSE,sha256=RFhQPdSOiMTguUX7JSoIuTxA7HVzCbj_p8WU36HjUQQ,10947
-mcm_cli-0.45.dist-info/METADATA,sha256=4G0mNs2xqIgMeE3GkIoDDNiFxFIrl2hSrrWDFE9zkKA,2755
-mcm_cli-0.45.dist-info/NOTICE,sha256=Ldnl2MjRaXPxcldUdbI2NTybq60XAa2LowRhFrRTuiI,76
-mcm_cli-0.45.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
-mcm_cli-0.45.dist-info/entry_points.txt,sha256=qTHAWZ-ejSiU4t11RYwtAU8ScqhQPDeMVTG9y4wMVLg,60
-mcm_cli-0.45.dist-info/top_level.txt,sha256=sh7oqIaqLQlMtKHlxHHgpV2xGMrBMPFWpSp0C6nvJ_Y,7
-mcm_cli-0.45.dist-info/RECORD,,