amazon-sp-cli 0.2.3__tar.gz → 0.2.5__tar.gz

{amazon_sp_cli-0.2.3/amazon_sp_cli.egg-info → amazon_sp_cli-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-sp-cli
-Version: 0.2.3
+Version: 0.2.5
 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.2.3 → amazon_sp_cli-0.2.5}/README.md

@@ -120,10 +120,9 @@ python3 -m amazon_sp_cli get-price PAW2603190101-BLU
 
 This repository uses automated releases. To publish a new version:
 
-1. Open a **standalone PR** that only bumps `version` in `setup.py`.
+1. Open a **standalone PR** that only bumps `__version__` in `amazon_sp_cli/__init__.py`.
 2. The PR must not include code, test, or documentation changes — a CI check enforces this.
-3. Once the PR is merged to `main`, the `Auto Release` workflow detects the new version, creates a tag (e.g. `v0.2.1`), and pushes it.
-4. The tag push triggers the `Publish to PyPI` workflow, which runs the full test suite and publishes the package.
+3. Once the PR is merged to `main`, the `Auto Release` workflow runs the full test suite, creates a tag (e.g. `v0.2.1`), creates a GitHub release, and publishes to PyPI.
 
 Do not create tags manually.
 

amazon_sp_cli-0.2.5/amazon_sp_cli/__init__.py

@@ -0,0 +1,2 @@
+# Amazon SP-API CLI
+__version__ = "0.2.5"

{amazon_sp_cli-0.2.3 → amazon_sp_cli-0.2.5}/amazon_sp_cli/models/a_plus.py

@@ -18,14 +18,26 @@ class TextComponent:
 class ImageComponent:
     """Image component for A+ Content modules."""
 
-    def __init__(self, upload_destination_id: str, image_crop: dict = None):
+    def __init__(
+        self,
+        upload_destination_id: str,
+        image_crop: dict = None,
+        alt_text: str = None,
+        image_crop_specification: dict = None,
+    ):
         self.upload_destination_id = upload_destination_id
         self.image_crop = image_crop
+        self.alt_text = alt_text
+        self.image_crop_specification = image_crop_specification
 
     def to_dict(self) -> dict:
         result = {"uploadDestinationId": self.upload_destination_id}
         if self.image_crop:
             result["imageCrop"] = self.image_crop
+        if self.alt_text:
+            result["altText"] = self.alt_text
+        if self.image_crop_specification:
+            result["imageCropSpecification"] = self.image_crop_specification
         return result
 
 
@@ -141,19 +153,23 @@ class StandardTextModule:
 class StandardImageTextOverlayModule:
     """Standard Image with Text Overlay module."""
 
-    def __init__(self, headline=None, image=None, body=None):
+    def __init__(self, headline=None, image=None, body=None, overlay_color_type="DARK"):
         self.headline = headline
         self.image = image
         self.body = body
+        self.overlay_color_type = overlay_color_type
 
     def to_dict(self) -> dict:
-        result = {}
+        result = {"overlayColorType": self.overlay_color_type}
+        block = {}
         if self.headline:
-            result["headline"] = self.headline.to_dict()
+            block["headline"] = self.headline.to_dict()
         if self.image:
-            result["image"] = self.image.to_dict()
+            block["image"] = self.image.to_dict()
         if self.body:
-            result["body"] = self.body.to_dict()
+            block["body"] = self.body.to_dict()
+        if block:
+            result["block"] = block
         return result
 
 
@@ -166,7 +182,7 @@ class StandardCompanyLogoModule:
     def to_dict(self) -> dict:
         result = {}
         if self.company_logo:
-            result["companyLogo"] = {"image": self.company_logo.to_dict()}
+            result["companyLogo"] = self.company_logo.to_dict()
         return result
 
 
@@ -174,7 +190,7 @@ class ContentModule:
     """A+ Content module wrapper."""
 
     MODULE_TYPES = {
-        "STANDARD_IMAGE_TEXT": "standardImageText",
+        "STANDARD_IMAGE_TEXT": "standardImageTextOverlay",
         "STANDARD_SINGLE_IMAGE": "standardSingleImage",
         "STANDARD_MULTIPLE_IMAGE_TEXT": "standardMultipleImageText",
         "STANDARD_FOUR_IMAGE_TEXT": "standardFourImageText",
@@ -210,8 +226,8 @@ class ContentModule:
         result = {"contentModuleType": self.module_type}
         field_name = self.MODULE_TYPES.get(self.module_type)
 
-        if field_name == "standardImageText" and self.standard_image_text:
-            result["standardImageText"] = self.standard_image_text.to_dict()
+        if field_name == "standardImageTextOverlay" and self.standard_image_text_overlay:
+            result["standardImageTextOverlay"] = self.standard_image_text_overlay.to_dict()
         elif field_name == "standardSingleImage" and self.standard_single_image:
             result["standardSingleImage"] = self.standard_single_image.to_dict()
         elif field_name == "standardMultipleImageText" and self.standard_multiple_image_text:
@@ -222,8 +238,6 @@ class ContentModule:
             result["standardComparisonTable"] = self.standard_comparison_table.to_dict()
         elif field_name == "standardText" and self.standard_text:
             result["standardText"] = self.standard_text.to_dict()
-        elif field_name == "standardImageTextOverlay" and self.standard_image_text_overlay:
-            result["standardImageTextOverlay"] = self.standard_image_text_overlay.to_dict()
         elif field_name == "standardCompanyLogo" and self.standard_company_logo:
             result["standardCompanyLogo"] = self.standard_company_logo.to_dict()
 
@@ -308,19 +322,38 @@ def build_module_from_json(data: dict) -> ContentModule:
     module_type = data.get("contentModuleType") or data.get("moduleType", "STANDARD_TEXT")
 
     if module_type == "STANDARD_IMAGE_TEXT":
+        body = None
+        if data.get("body"):
+            body = ParagraphComponent(text_list=[TextComponent(data["body"])])
         return ContentModule(
             module_type=module_type,
-            standard_image_text=StandardImageTextModule(
+            standard_image_text_overlay=StandardImageTextOverlayModule(
                 headline=TextComponent(data["headline"]) if data.get("headline") else None,
-                body=TextComponent(data["body"]) if data.get("body") else None,
-                image=ImageComponent(data["imageId"]) if data.get("imageId") else None,
+                body=body,
+                image=(
+                    ImageComponent(
+                        data["imageId"],
+                        alt_text=data.get("altText"),
+                        image_crop_specification=data.get("imageCropSpecification"),
+                    )
+                    if data.get("imageId")
+                    else None
+                ),
             ),
         )
     elif module_type == "STANDARD_SINGLE_IMAGE":
         return ContentModule(
             module_type=module_type,
             standard_single_image=StandardSingleImageModule(
-                image=ImageComponent(data["imageId"]) if data.get("imageId") else None,
+                image=(
+                    ImageComponent(
+                        data["imageId"],
+                        alt_text=data.get("altText"),
+                        image_crop_specification=data.get("imageCropSpecification"),
+                    )
+                    if data.get("imageId")
+                    else None
+                ),
                 image_caption=TextComponent(data["caption"]) if data.get("caption") else None,
             ),
         )
@@ -360,19 +393,39 @@ def build_module_from_json(data: dict) -> ContentModule:
             ),
         )
     elif module_type == "STANDARD_IMAGE_TEXT_OVERLAY":
+        body = None
+        if data.get("body"):
+            body = ParagraphComponent(text_list=[TextComponent(data["body"])])
         return ContentModule(
             module_type=module_type,
             standard_image_text_overlay=StandardImageTextOverlayModule(
                 headline=TextComponent(data["headline"]) if data.get("headline") else None,
-                body=TextComponent(data["body"]) if data.get("body") else None,
-                image=ImageComponent(data["imageId"]) if data.get("imageId") else None,
+                body=body,
+                image=(
+                    ImageComponent(
+                        data["imageId"],
+                        alt_text=data.get("altText"),
+                        image_crop_specification=data.get("imageCropSpecification"),
+                    )
+                    if data.get("imageId")
+                    else None
+                ),
+                overlay_color_type=data.get("overlayColorType", "DARK"),
             ),
         )
     elif module_type == "STANDARD_COMPANY_LOGO":
         return ContentModule(
             module_type=module_type,
             standard_company_logo=StandardCompanyLogoModule(
-                company_logo=ImageComponent(data["imageId"]) if data.get("imageId") else None,
+                company_logo=(
+                    ImageComponent(
+                        data["imageId"],
+                        alt_text=data.get("altText"),
+                        image_crop_specification=data.get("imageCropSpecification"),
+                    )
+                    if data.get("imageId")
+                    else None
+                ),
             ),
         )
     else:

{amazon_sp_cli-0.2.3 → amazon_sp_cli-0.2.5/amazon_sp_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-sp-cli
-Version: 0.2.3
+Version: 0.2.5
 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.2.3 → amazon_sp_cli-0.2.5}/tests/test_a_plus.py

@@ -75,7 +75,7 @@ class TestDataModels:
         assert "has no content" in doc.validate()[0]
 
     def test_module_validate_empty_content(self):
-        mod = ContentModule("STANDARD_IMAGE_TEXT")
+        mod = ContentModule("STANDARD_TEXT")
         issues = mod.validate(0)
         assert len(issues) == 1
         assert "has no content" in issues[0]
@@ -113,11 +113,24 @@ class TestBuildFromJson:
         data = {
             "contentModuleType": "STANDARD_COMPANY_LOGO",
             "imageId": "logo-123",
+            "altText": "Company Logo",
+            "imageCropSpecification": {
+                "size": {
+                    "width": {"value": 600, "units": "pixels"},
+                    "height": {"value": 180, "units": "pixels"},
+                },
+                "offset": {
+                    "x": {"value": 0, "units": "pixels"},
+                    "y": {"value": 0, "units": "pixels"},
+                },
+            },
         }
         mod = build_module_from_json(data)
         assert mod.module_type == "STANDARD_COMPANY_LOGO"
         result = mod.to_dict()
-        assert result["standardCompanyLogo"]["companyLogo"]["image"]["uploadDestinationId"] == "logo-123"
+        assert result["standardCompanyLogo"]["companyLogo"]["uploadDestinationId"] == "logo-123"
+        assert result["standardCompanyLogo"]["companyLogo"]["altText"] == "Company Logo"
+        assert result["standardCompanyLogo"]["companyLogo"]["imageCropSpecification"]["size"]["width"]["value"] == 600
 
     def test_standard_company_logo_module_to_dict_empty(self):
         mod = StandardCompanyLogoModule()
@@ -133,8 +146,25 @@ class TestBuildFromJson:
         mod = build_module_from_json(data)
         assert mod.module_type == "STANDARD_IMAGE_TEXT"
         result = mod.to_dict()
-        assert result["standardImageText"]["headline"]["value"] == "H"
-        assert result["standardImageText"]["image"]["uploadDestinationId"] == "img-1"
+        assert result["standardImageTextOverlay"]["overlayColorType"] == "DARK"
+        assert result["standardImageTextOverlay"]["block"]["headline"]["value"] == "H"
+        assert result["standardImageTextOverlay"]["block"]["body"]["textList"][0]["value"] == "B"
+        assert result["standardImageTextOverlay"]["block"]["image"]["uploadDestinationId"] == "img-1"
+
+    def test_build_module_image_text_overlay(self):
+        data = {
+            "moduleType": "STANDARD_IMAGE_TEXT_OVERLAY",
+            "headline": "H",
+            "body": "B",
+            "imageId": "img-1",
+            "overlayColorType": "LIGHT",
+        }
+        mod = build_module_from_json(data)
+        assert mod.module_type == "STANDARD_IMAGE_TEXT_OVERLAY"
+        result = mod.to_dict()
+        assert result["standardImageTextOverlay"]["overlayColorType"] == "LIGHT"
+        assert result["standardImageTextOverlay"]["block"]["headline"]["value"] == "H"
+        assert result["standardImageTextOverlay"]["block"]["body"]["textList"][0]["value"] == "B"
 
     def test_build_module_comparison_table(self):
         data = {
@@ -148,6 +178,79 @@ class TestBuildFromJson:
         assert result["standardComparisonTable"]["headline"]["value"] == "Compare"
         assert result["standardComparisonTable"]["comparisonTableRows"][0]["name"] == "Feature"
 
+    def test_integration_full_document_from_json(self):
+        data = {
+            "modules": [
+                {
+                    "moduleType": "STANDARD_COMPANY_LOGO",
+                    "imageId": "aplus-media/sc/76a7fb65-607b-4e96-a3fa-a145d1397725.jpg",
+                    "altText": "Pawified Logo",
+                    "imageCropSpecification": {
+                        "size": {
+                            "width": {"value": 600, "units": "pixels"},
+                            "height": {"value": 180, "units": "pixels"},
+                        },
+                        "offset": {
+                            "x": {"value": 0, "units": "pixels"},
+                            "y": {"value": 0, "units": "pixels"},
+                        },
+                    },
+                },
+                {
+                    "moduleType": "STANDARD_IMAGE_TEXT",
+                    "headline": "Pure Joy in Every Bite",
+                    "body": "Treat your feline friend to the finest premium catnip...",
+                    "imageId": "aplus-media/sc/77967e76-a03c-4514-85e1-371e7f2395d1.jpg",
+                },
+                {
+                    "moduleType": "STANDARD_IMAGE_TEXT",
+                    "headline": "100% Natural & Safe",
+                    "body": "Made in the USA with all-natural...",
+                    "imageId": "aplus-media/sc/215948ec-b306-4a0b-8491-f1342dc83f91.jpg",
+                },
+                {
+                    "moduleType": "STANDARD_IMAGE_TEXT",
+                    "headline": "Perfect for Playtime",
+                    "body": "Each 2-pack includes convenient 5g sachets...",
+                    "imageId": "aplus-media/sc/2e6493d5-e7a4-4c3a-8e47-a78e5f5b4802.jpg",
+                },
+                {
+                    "moduleType": "STANDARD_IMAGE_TEXT",
+                    "headline": "Premium Quality You Can Trust",
+                    "body": "Pawified is committed to delivering premium pet products...",
+                    "imageId": "aplus-media/sc/ef864286-0fec-4472-ad20-8b7dfee4922e.jpg",
+                },
+            ]
+        }
+        doc = build_content_from_json("pawified-catnip", data)
+        assert doc.name == "pawified-catnip"
+        assert len(doc.content_module_list) == 5
+        assert doc.content_module_list[0].module_type == "STANDARD_COMPANY_LOGO"
+        assert doc.content_module_list[1].module_type == "STANDARD_IMAGE_TEXT"
+
+        result = doc.to_dict()
+        modules = result["contentModuleList"]
+        assert len(modules) == 5
+
+        logo_module = modules[0]["standardCompanyLogo"]
+        assert "image" not in logo_module["companyLogo"]
+        assert (
+            logo_module["companyLogo"]["uploadDestinationId"]
+            == "aplus-media/sc/76a7fb65-607b-4e96-a3fa-a145d1397725.jpg"
+        )
+        assert logo_module["companyLogo"]["altText"] == "Pawified Logo"
+        assert logo_module["companyLogo"]["imageCropSpecification"]["size"]["width"]["value"] == 600
+
+        for i in range(1, 5):
+            mod = modules[i]["standardImageTextOverlay"]
+            assert mod["overlayColorType"] == "DARK"
+            assert "block" in mod
+            assert "headline" in mod["block"]
+            assert "body" in mod["block"]
+            assert "textList" in mod["block"]["body"]
+            assert "image" in mod["block"]
+            assert mod["block"]["image"]["uploadDestinationId"].startswith("aplus-media/sc/")
+
 
 class TestAPlusCLI:
     @pytest.fixture

amazon_sp_cli-0.2.3/amazon_sp_cli/__init__.py

@@ -1,2 +0,0 @@
-# Amazon SP-API CLI
-__version__ = "0.2.3"