amazon-sp-cli 0.1.4__tar.gz → 0.2.0__tar.gz

{amazon_sp_cli-0.1.4/amazon_sp_cli.egg-info → amazon_sp_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-sp-cli
-Version: 0.1.4
+Version: 0.2.0
 Summary: CLI tool for Amazon Selling Partner API (SP-API) operations
 Home-page: https://github.com/stellaraether/amazon-sp-cli
 Author: Lunan Li

{amazon_sp_cli-0.1.4 → amazon_sp_cli-0.2.0}/README.md

@@ -9,6 +9,7 @@ Command line interface for Amazon Selling Partner API (SP-API) operations.
 - **Catalog Lookup** — Check competitor ASINs
 - **Inventory Checks** — View FBA inventory levels
 - **Feed Submissions** — Bulk updates via feeds API
+- **A+ Content** — Manage A+ Content documents and image uploads (requires Brand Registry)
 
 ## Installation
 
@@ -75,6 +76,42 @@ amz-sp inventory list
 amz-sp inventory get PAW2603190101-BLU
 ```
 
+### A+ Content
+
+Requires Brand Registry.
+
+```bash
+# Upload an image (returns uploadDestinationId)
+amz-sp a-plus upload-image banner.jpg
+
+# Create content from JSON
+amz-sp a-plus create my-content --data content.json
+
+# Validate without creating
+amz-sp a-plus validate my-content --data content.json
+
+# Get content details (includes approval status)
+amz-sp a-plus get my-content
+
+# List all content documents
+amz-sp a-plus list
+
+# Update content
+amz-sp a-plus update my-content --data content.json
+
+# Delete content
+amz-sp a-plus delete my-content
+
+# Associate ASINs
+amz-sp a-plus asin add my-content B123456789 B987654321
+
+# List associated ASINs
+amz-sp a-plus asin list my-content
+
+# Remove ASIN associations
+amz-sp a-plus asin remove my-content B123456789
+```
+
 ## Development
 
 ```bash

{amazon_sp_cli-0.1.4 → amazon_sp_cli-0.2.0}/amazon_sp_cli/auth.py

@@ -4,6 +4,7 @@ import json
 import os
 import time
 from pathlib import Path
+from typing import Optional
 
 import requests
 import yaml
@@ -20,11 +21,14 @@ class SPAPIAuth:
         self.credentials = self._load_credentials(credentials_path)
         self._ensure_cache_dir()
 
-    def _load_credentials(self, path: str = None) -> dict:
+    def _load_credentials(self, path: str = None) -> Optional[dict]:
         """Load credentials from YAML file."""
         if path is None:
             path = Path.home() / ".config" / "amazon-sp-cli" / "credentials.yml"
 
+        if not Path(path).exists():
+            return None
+
         with open(path, "r") as f:
             config = yaml.safe_load(f)
 

amazon_sp_cli-0.2.0/amazon_sp_cli/cli.py

@@ -0,0 +1,92 @@
+"""Core CLI infrastructure and shared utilities."""
+
+import functools
+import os
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+import click
+
+from .auth import SPAPIAuth
+from .client import SPAPIClient
+
+DEFAULT_CREDENTIALS_PATH = os.path.expanduser("~/.config/amazon-sp-cli/credentials.yml")
+
+
+def _check_path():
+    """Check if the CLI is accessible in PATH and warn once per day."""
+    import shutil
+
+    if shutil.which("amz-sp"):
+        return
+
+    # Only warn once per day
+    flag_file = Path.home() / ".config" / "amazon-sp-cli" / ".path-warned"
+    flag_file.parent.mkdir(parents=True, exist_ok=True)
+
+    now = datetime.now(timezone.utc)
+    today = now.strftime("%Y-%m-%d")
+
+    if flag_file.exists():
+        last_warned = flag_file.read_text().strip()
+        if last_warned == today:
+            return
+
+    flag_file.write_text(today)
+
+    print(
+        "\n⚠️  Note: 'amz-sp' is not in your PATH.",
+        file=sys.stderr,
+    )
+    print(
+        "   You can still use: python3 -m amazon_sp_cli",
+        file=sys.stderr,
+    )
+    print(
+        "   To add to PATH, add this to your shell config:",
+        file=sys.stderr,
+    )
+    print(
+        f'   export PATH="{sys.prefix}/bin:$PATH"',
+        file=sys.stderr,
+    )
+    print("", file=sys.stderr)
+
+
+def _ensure_auth_client(ctx):
+    """Lazily create auth and client if not already present."""
+    if "client" not in ctx.obj:
+        auth = SPAPIAuth(ctx.obj.get("credentials_path"))
+        if auth.credentials is None:
+            click.echo("Error: No credentials found. Run 'amz-sp auth setup' first.", err=True)
+            raise click.Abort()
+        ctx.obj["auth"] = auth
+        ctx.obj["client"] = SPAPIClient(auth)
+    return ctx.obj["auth"], ctx.obj["client"]
+
+
+def handle_errors(f):
+    """Decorator to catch exceptions and emit consistent error messages."""
+
+    @functools.wraps(f)
+    def wrapper(*args, **kwargs):
+        try:
+            return f(*args, **kwargs)
+        except click.ClickException:
+            raise
+        except Exception as e:
+            click.echo(f"Error: {e}", err=True)
+            raise click.Abort()
+
+    return wrapper
+
+
+@click.group()
+@click.option("--credentials", "-c", help="Path to credentials YAML file")
+@click.pass_context
+def cli(ctx, credentials):
+    """Amazon SP-API CLI - Manage listings, pricing, inventory, and more."""
+    _check_path()
+    ctx.ensure_object(dict)
+    ctx.obj["credentials_path"] = credentials

{amazon_sp_cli-0.1.4 → amazon_sp_cli-0.2.0}/amazon_sp_cli/client.py

@@ -101,3 +101,82 @@ class SPAPIClient:
         }
         path += "?" + urlencode(params)
         return self.request("GET", path)
+
+    # --- A+ Content API ---
+
+    def create_a_plus_content(self, content_data: dict) -> dict:
+        """Create A+ Content document."""
+        path = "/aplus/2020-11-01/contentDocuments"
+        data = {"contentDocument": content_data}
+        return self.request("POST", path, data)
+
+    def validate_a_plus_content(self, content_data: dict) -> dict:
+        """Validate A+ Content without creating."""
+        path = "/aplus/2020-11-01/contentDocuments"
+        params = {"mode": "VALIDATION_PREVIEW"}
+        path += "?" + urlencode(params)
+        data = {"contentDocument": content_data}
+        return self.request("POST", path, data)
+
+    def update_a_plus_content(self, content_name: str, content_data: dict) -> dict:
+        """Update existing A+ Content document."""
+        path = f"/aplus/2020-11-01/contentDocuments/{content_name}"
+        data = {"contentDocument": content_data}
+        return self.request("POST", path, data)
+
+    def get_a_plus_content(self, content_name: str) -> dict:
+        """Get A+ Content document by name."""
+        path = f"/aplus/2020-11-01/contentDocuments/{content_name}"
+        return self.request("GET", path)
+
+    def list_a_plus_content(self, **filters) -> dict:
+        """List A+ Content documents."""
+        path = "/aplus/2020-11-01/contentDocuments"
+        if filters:
+            path += "?" + urlencode(filters)
+        return self.request("GET", path)
+
+    def delete_a_plus_content(self, content_name: str) -> dict:
+        """Delete A+ Content document."""
+        path = f"/aplus/2020-11-01/contentDocuments/{content_name}"
+        return self.request("DELETE", path)
+
+    def get_a_plus_content_asin_relations(self, content_name: str) -> dict:
+        """Get ASIN relations for a content document."""
+        path = f"/aplus/2020-11-01/contentDocuments/{content_name}/asins"
+        return self.request("GET", path)
+
+    def post_a_plus_content_asin_relations(self, content_name: str, asin_set: list) -> dict:
+        """Associate ASINs with A+ Content document."""
+        path = "/aplus/2020-11-01/contentAsinRelations"
+        data = {"contentDocumentName": content_name, "asinSet": asin_set}
+        return self.request("POST", path, data)
+
+    def delete_a_plus_content_asin_relations(self, content_name: str, asin_set: list) -> dict:
+        """Remove ASIN associations from A+ Content document."""
+        path = "/aplus/2020-11-01/contentAsinRelations"
+        params = {"contentDocumentName": content_name}
+        path += "?" + urlencode(params)
+        data = {"asinSet": asin_set}
+        return self.request("DELETE", path, data)
+
+    def create_upload_destination(
+        self,
+        marketplace_id: str,
+        content_md5: str,
+        content_type: str,
+        file_name: str = None,
+        resource: str = None,
+    ) -> dict:
+        """Create an upload destination for a file."""
+        path = f"/uploads/2020-11-01/uploadDestinations/{marketplace_id}"
+        params = {
+            "contentMD5": content_md5,
+            "contentType": content_type,
+        }
+        if file_name:
+            params["fileName"] = file_name
+        if resource:
+            params["resource"] = resource
+        path += "?" + urlencode(params)
+        return self.request("POST", path)

amazon_sp_cli-0.2.0/amazon_sp_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""

amazon_sp_cli-0.2.0/amazon_sp_cli/commands/a_plus.py

@@ -0,0 +1,233 @@
+"""A+ Content CLI commands."""
+
+import base64
+import hashlib
+import json
+import os
+
+import click
+import requests
+
+from ..cli import handle_errors
+from ..models.a_plus import build_content_from_json
+
+
+def register_a_plus_commands(cli_group, ensure_auth_client):
+    """Register A+ Content CLI commands."""
+
+    @cli_group.group("a-plus")
+    def a_plus():
+        """A+ Content management (requires Brand Registry)."""
+        pass
+
+    @a_plus.command("create")
+    @click.argument("content-name")
+    @click.option("--data", "-d", type=click.Path(exists=True), required=True, help="JSON file with content data")
+    @click.option("--dry-run", is_flag=True, help="Validate without creating")
+    @click.pass_context
+    @handle_errors
+    def create_content(ctx, content_name, data, dry_run):
+        """Create A+ Content document from JSON file."""
+        _, client = ensure_auth_client(ctx)
+
+        with open(data, "r") as f:
+            content_data = json.load(f)
+
+        content = build_content_from_json(content_name, content_data)
+
+        issues = content.validate()
+        if issues:
+            click.echo("Validation issues:", err=True)
+            for issue in issues:
+                click.echo(f"  - {issue}", err=True)
+            raise click.Abort()
+
+        if dry_run:
+            click.echo("Content is valid (dry run)")
+            click.echo(json.dumps(content.to_dict(), indent=2))
+            return
+
+        response = client.create_a_plus_content(content.to_dict())
+        click.echo(f"A+ Content created: {content_name}")
+        click.echo(f"Modules: {len(content.content_module_list)}")
+        if response:
+            click.echo(json.dumps(response, indent=2))
+
+    @a_plus.command("validate")
+    @click.argument("content-name")
+    @click.option("--data", "-d", type=click.Path(exists=True), required=True, help="JSON file with content data")
+    @click.pass_context
+    @handle_errors
+    def validate_content(ctx, content_name, data):
+        """Validate A+ Content without creating."""
+        _, client = ensure_auth_client(ctx)
+
+        with open(data, "r") as f:
+            content_data = json.load(f)
+
+        content = build_content_from_json(content_name, content_data)
+
+        issues = content.validate()
+        if issues:
+            click.echo("Validation issues:", err=True)
+            for issue in issues:
+                click.echo(f"  - {issue}", err=True)
+            raise click.Abort()
+
+        response = client.validate_a_plus_content(content.to_dict())
+        click.echo("API validation passed")
+        if response:
+            click.echo(json.dumps(response, indent=2))
+
+    @a_plus.command("get")
+    @click.argument("content-name")
+    @click.pass_context
+    @handle_errors
+    def get_content(ctx, content_name):
+        """Get A+ Content document."""
+        _, client = ensure_auth_client(ctx)
+        response = client.get_a_plus_content(content_name)
+        click.echo(json.dumps(response, indent=2))
+
+    @a_plus.command("list")
+    @click.pass_context
+    @handle_errors
+    def list_content(ctx):
+        """List A+ Content documents."""
+        _, client = ensure_auth_client(ctx)
+        response = client.list_a_plus_content(marketplaceId=client.marketplace_id)
+        documents = response.get("contentDocumentList", [])
+        click.echo(f"\nA+ Content Documents ({len(documents)} found):\n")
+        for doc in documents:
+            click.echo(f"  Name: {doc.get('name')}")
+            click.echo(f"  Status: {doc.get('status', 'N/A')}")
+            click.echo(f"  Locale: {doc.get('locale', 'N/A')}")
+            asins = doc.get("asinSet", [])
+            if asins:
+                click.echo(f"  ASINs: {', '.join(asins)}")
+            click.echo()
+
+    @a_plus.command("update")
+    @click.argument("content-name")
+    @click.option("--data", "-d", type=click.Path(exists=True), required=True, help="JSON file with updated content")
+    @click.pass_context
+    @handle_errors
+    def update_content(ctx, content_name, data):
+        """Update existing A+ Content document."""
+        _, client = ensure_auth_client(ctx)
+
+        with open(data, "r") as f:
+            content_data = json.load(f)
+
+        content = build_content_from_json(content_name, content_data)
+
+        issues = content.validate()
+        if issues:
+            click.echo("Validation issues:", err=True)
+            for issue in issues:
+                click.echo(f"  - {issue}", err=True)
+            raise click.Abort()
+
+        response = client.update_a_plus_content(content_name, content.to_dict())
+        click.echo(f"A+ Content updated: {content_name}")
+        if response:
+            click.echo(json.dumps(response, indent=2))
+
+    @a_plus.command("delete")
+    @click.argument("content-name")
+    @click.confirmation_option(prompt="Delete this A+ Content?")
+    @click.pass_context
+    @handle_errors
+    def delete_content(ctx, content_name):
+        """Delete A+ Content document."""
+        _, client = ensure_auth_client(ctx)
+        client.delete_a_plus_content(content_name)
+        click.echo(f"A+ Content deleted: {content_name}")
+
+    @a_plus.command("upload-image")
+    @click.argument("file-path", type=click.Path(exists=True))
+    @click.option("--content-type", default="image/jpeg", help="MIME type of the image")
+    @click.option("--resource", default="aplus", help="Resource type for upload destination")
+    @click.pass_context
+    @handle_errors
+    def upload_image(ctx, file_path, content_type, resource):
+        """Upload an image and return an uploadDestinationId for A+ Content."""
+        _, client = ensure_auth_client(ctx)
+
+        with open(file_path, "rb") as f:
+            file_data = f.read()
+
+        md5_hash = hashlib.md5(file_data).digest()
+        content_md5 = base64.b64encode(md5_hash).decode("ascii")
+        file_name = os.path.basename(file_path)
+
+        response = client.create_upload_destination(
+            marketplace_id=client.marketplace_id,
+            content_md5=content_md5,
+            content_type=content_type,
+            file_name=file_name,
+            resource=resource,
+        )
+
+        payload = response.get("payload", response)
+        upload_destination_id = payload.get("uploadDestinationId")
+        upload_url = payload.get("url")
+        headers = payload.get("headers", [])
+
+        if not upload_url:
+            click.echo("Error: No upload URL returned", err=True)
+            raise click.Abort()
+
+        upload_headers = {h["name"]: h["value"] for h in headers}
+        upload_headers.setdefault("Content-Type", content_type)
+        upload_headers.setdefault("Content-MD5", content_md5)
+
+        put_response = requests.put(upload_url, data=file_data, headers=upload_headers)
+        put_response.raise_for_status()
+
+        click.echo(f"Upload successful: {file_name}")
+        click.echo(f"uploadDestinationId: {upload_destination_id}")
+
+    @a_plus.group("asin")
+    def asin():
+        """ASIN association commands."""
+        pass
+
+    @asin.command("add")
+    @click.argument("content-name")
+    @click.argument("asins", nargs=-1, required=True)
+    @click.pass_context
+    @handle_errors
+    def add_asins(ctx, content_name, asins):
+        """Associate ASINs with A+ Content."""
+        _, client = ensure_auth_client(ctx)
+        response = client.post_a_plus_content_asin_relations(content_name, list(asins))
+        click.echo(f"Associated {len(asins)} ASIN(s) with {content_name}")
+        if response:
+            click.echo(json.dumps(response, indent=2))
+
+    @asin.command("remove")
+    @click.argument("content-name")
+    @click.argument("asins", nargs=-1, required=True)
+    @click.pass_context
+    @handle_errors
+    def remove_asins(ctx, content_name, asins):
+        """Remove ASIN associations from A+ Content."""
+        _, client = ensure_auth_client(ctx)
+        response = client.delete_a_plus_content_asin_relations(content_name, list(asins))
+        click.echo(f"Removed {len(asins)} ASIN(s) from {content_name}")
+        if response:
+            click.echo(json.dumps(response, indent=2))
+
+    @asin.command("list")
+    @click.argument("content-name")
+    @click.pass_context
+    @handle_errors
+    def list_asins(ctx, content_name):
+        """List ASINs associated with A+ Content."""
+        _, client = ensure_auth_client(ctx)
+        response = client.get_a_plus_content_asin_relations(content_name)
+        asins = response.get("asinSet", [])
+        click.echo(f"\nASINs for '{content_name}' ({len(asins)} found):\n")
+        for asin in asins:
+            click.echo(f"  {asin}")

amazon_sp_cli-0.2.0/amazon_sp_cli/commands/auth.py

@@ -0,0 +1,135 @@
+"""Authentication commands."""
+
+import os
+
+import click
+import yaml
+
+from ..cli import DEFAULT_CREDENTIALS_PATH, handle_errors
+
+
+def register_auth_commands(cli_group):
+    """Register authentication CLI commands."""
+
+    @cli_group.group()
+    def auth():
+        """Authentication commands."""
+        pass
+
+    @auth.command("setup")
+    @click.option("--path", default=DEFAULT_CREDENTIALS_PATH, help="Path to save credentials")
+    @click.option("--profile", default="default", help="Credential profile name")
+    @click.option("--refresh-token", help="Refresh token")
+    @click.option("--client-id", help="Client ID")
+    @click.option("--client-secret", help="Client secret")
+    @click.option("--aws-access-key-id", help="AWS Access Key ID")
+    @click.option("--aws-secret-access-key", help="AWS Secret Access Key")
+    @click.option("--seller-id", default="A2GKV2AN9F8YG3", help="Seller ID")
+    @click.option("--marketplace-id", default="ATVPDKIKX0DER", help="Marketplace ID")
+    @click.pass_context
+    def auth_setup(
+        ctx,
+        path,
+        profile,
+        refresh_token,
+        client_id,
+        client_secret,
+        aws_access_key_id,
+        aws_secret_access_key,
+        seller_id,
+        marketplace_id,
+    ):
+        """Set up Amazon SP-API credentials.
+
+        When flags are omitted, falls back to interactive prompts.
+        """
+        click.echo("🔐 Amazon SP-API Credential Setup")
+        click.echo("=" * 50)
+        click.echo()
+
+        interactive = not all([refresh_token, client_id, client_secret, aws_access_key_id, aws_secret_access_key])
+        if interactive:
+            click.echo("You'll need the following from your Amazon Developer account:")
+            click.echo("  1. Refresh Token (from LWA authorization)")
+            click.echo("  2. Client ID (from your app registration)")
+            click.echo("  3. Client Secret (from your app registration)")
+            click.echo("  4. AWS Access Key ID")
+            click.echo("  5. AWS Secret Access Key")
+            click.echo()
+
+        profile = profile or click.prompt("Profile name", default="default")
+        refresh_token = refresh_token or click.prompt("Refresh token", hide_input=True)
+        client_id = client_id or click.prompt("Client ID")
+        client_secret = client_secret or click.prompt("Client secret", hide_input=True)
+        aws_access_key_id = aws_access_key_id or click.prompt("AWS Access Key ID")
+        aws_secret_access_key = aws_secret_access_key or click.prompt("AWS Secret Access Key", hide_input=True)
+
+        credentials = {
+            "version": "1.0",
+            profile: {
+                "refresh_token": refresh_token,
+                "client_id": client_id,
+                "client_secret": client_secret,
+                "aws_access_key_id": aws_access_key_id,
+                "aws_secret_access_key": aws_secret_access_key,
+                "seller_id": seller_id,
+                "marketplace_id": marketplace_id,
+            },
+        }
+
+        # Merge with existing if present
+        if os.path.exists(path):
+            try:
+                with open(path, "r") as f:
+                    existing = yaml.safe_load(f) or {}
+                existing[profile] = credentials[profile]
+                credentials = existing
+                click.echo(f"\n📝 Merged with existing credentials at {path}")
+            except Exception as e:
+                click.echo(f"⚠️  Could not read existing file: {e}")
+
+        os.makedirs(os.path.dirname(path), exist_ok=True)
+        with open(path, "w") as f:
+            yaml.dump(credentials, f, default_flow_style=False, sort_keys=False)
+
+        click.echo(f"✅ Credentials saved to {path}")
+        click.echo(f"   Profile: {profile}")
+        click.echo(f"   Seller ID: {seller_id}")
+        click.echo(f"   Marketplace ID: {marketplace_id}")
+        click.echo()
+        click.echo("You can now use: python -m amazon_sp_cli.main --profile {profile} get-price <sku>")
+
+    @auth.command("show")
+    @click.option("--path", default=DEFAULT_CREDENTIALS_PATH, help="Path to credentials file")
+    @click.pass_context
+    def auth_show(ctx, path):
+        """Show configured profiles (without secrets)."""
+        if not os.path.exists(path):
+            click.echo(f"❌ No credentials file found at {path}")
+            click.echo("Run: python -m amazon_sp_cli.main auth setup")
+            return
+
+        with open(path, "r") as f:
+            creds = yaml.safe_load(f) or {}
+
+        click.echo(f"\n📄 Credentials file: {path}")
+        click.echo("-" * 40)
+
+        for profile, data in creds.items():
+            if profile == "version":
+                continue
+            click.echo(f"Profile: {profile}")
+            click.echo(f"  Client ID: {data.get('client_id', 'N/A')[:20]}...")
+            click.echo(f"  Seller ID: {data.get('seller_id', 'N/A')}")
+            click.echo(f"  Marketplace ID: {data.get('marketplace_id', 'N/A')}")
+            click.echo()
+
+    @cli_group.command()
+    @click.pass_context
+    @handle_errors
+    def invalidate(ctx):
+        """Invalidate cached access token."""
+        from ..cli import _ensure_auth_client
+
+        auth, _ = _ensure_auth_client(ctx)
+        auth.invalidate()