amazon-orders 3.2.3__tar.gz → 3.2.5__tar.gz

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/CHANGELOG.md

@@ -4,9 +4,26 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://github.com/alexdlaird/amazon-orders/compare/3.2.2...HEAD)
+## [Unreleased](https://github.com/alexdlaird/amazon-orders/compare/3.2.5...HEAD)
 
-## [3.2.3](https://github.com/alexdlaird/amazon-orders/compare/3.2.1...3.2.2) - 2025-02-06
+## [3.2.5](https://github.com/alexdlaird/amazon-orders/compare/3.2.4...3.2.5) - 2025-02-12
+
+### Fixed
+
+- Parsing errors on gift cards totals and broken item links due to changes in Amazon.com DOM.
+
+## [3.2.4](https://github.com/alexdlaird/amazon-orders/compare/3.2.3...3.2.4) - 2025-02-11
+
+### Added
+
+- `Order.promotion_applied` field, which is now parsed alongside other subtotals.
+
+### Fixed
+
+- Broken parsing of Whole Foods Market orders, these are now skipped.
+- Parsing issue on `Order.order_number` and `Order.order_placed` due to changes in Amazon.com DOM.
+
+## [3.2.3](https://github.com/alexdlaird/amazon-orders/compare/3.2.2...3.2.3) - 2025-02-06
 
 ### Added
 
@@ -263,7 +280,7 @@ Build and stability improvements.
 - [AuthForm](https://amazon-orders.readthedocs.io/api.html#amazonorders.forms.AuthForm) abstract class, and
   migrated all auth flow items to subclasses of this class.
 - [Parsable.simple_parse()](https://amazon-orders.readthedocs.io/api.html#amazonorders.entities.parsable.Parsable.simple_parse),
-  which can handle most basic fields when parised with CSS selectors.
+  which can handle most basic fields when parsed with CSS selectors.
 - Stability improvements.
 - Test improvements.
 

{amazon_orders-3.2.3/amazon_orders.egg-info → amazon_orders-3.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: amazon-orders
-Version: 3.2.3
+Version: 3.2.5
 Summary: A CLI and library for interacting with Amazon order history.
 Maintainer-email: Alex Laird <contact@alexlaird.com>
 License: MIT License
@@ -88,7 +88,7 @@ be used to interact with Amazon.com's consumer-facing website.
 
 This works by parsing website data from Amazon.com. A periodic build validates functionality to ensure its
 stability, but as Amazon provides no official API to use, this package may break at any time. This
-package only officially supports the English version of the website.
+package only officially supports the English, `.com` version of Amazon.
 
 ## Installation
 

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/README.md

@@ -12,7 +12,7 @@ be used to interact with Amazon.com's consumer-facing website.
 
 This works by parsing website data from Amazon.com. A periodic build validates functionality to ensure its
 stability, but as Amazon provides no official API to use, this package may break at any time. This
-package only officially supports the English version of the website.
+package only officially supports the English, `.com` version of Amazon.
 
 ## Installation
 

{amazon_orders-3.2.3 → amazon_orders-3.2.5/amazon_orders.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: amazon-orders
-Version: 3.2.3
+Version: 3.2.5
 Summary: A CLI and library for interacting with Amazon order history.
 Maintainer-email: Alex Laird <contact@alexlaird.com>
 License: MIT License
@@ -88,7 +88,7 @@ be used to interact with Amazon.com's consumer-facing website.
 
 This works by parsing website data from Amazon.com. A periodic build validates functionality to ensure its
 stability, but as Amazon provides no official API to use, this package may break at any time. This
-package only officially supports the English version of the website.
+package only officially supports the English, `.com` version of Amazon.
 
 ## Installation
 

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/amazonorders/__init__.py

@@ -1,3 +1,3 @@
 __copyright__ = "Copyright (c) 2024 Alex Laird"
 __license__ = "MIT"
-__version__ = "3.2.3"
+__version__ = "3.2.5"

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/amazonorders/entity/order.py

@@ -43,7 +43,9 @@ class Order(Parsable):
         #: The Order number.
         self.order_number: str = clone.order_number if clone else self.safe_simple_parse(
             selector=self.config.selectors.FIELD_ORDER_NUMBER_SELECTOR,
-            required=True)
+            required=True,
+            prefix_split="#",
+            prefix_split_fuzzy=True)
         #: The Order details link.
         self.order_details_link: Optional[str] = clone.order_details_link if clone else self.safe_parse(
             self._parse_order_details_link)
@@ -51,7 +53,10 @@ class Order(Parsable):
         self.grand_total: float = clone.grand_total if clone else self.safe_parse(self._parse_grand_total)
         #: The Order placed date.
         self.order_placed_date: date = clone.order_placed_date if clone else self.safe_simple_parse(
-            selector=self.config.selectors.FIELD_ORDER_PLACED_DATE_SELECTOR, parse_date=True)
+            selector=self.config.selectors.FIELD_ORDER_PLACED_DATE_SELECTOR,
+            suffix_split="Order #",
+            suffix_split_fuzzy=True,
+            parse_date=True)
         #: The Order Recipients.
         self.recipient: Recipient = clone.recipient if clone else self.safe_parse(self._parse_recipient)
 
@@ -69,6 +74,8 @@ class Order(Parsable):
         self.subtotal: Optional[float] = self._if_full_details(self._parse_currency("subtotal"))
         #: The Order shipping total. Only populated when ``full_details`` is ``True``.
         self.shipping_total: Optional[float] = self._if_full_details(self._parse_currency("shipping"))
+        #: The Order promotion applied. Only populated when ``full_details`` is ``True``.
+        self.promotion_applied: Optional[float] = self._if_full_details(self._parse_currency("promotion"))
         #: The Order Subscribe & Save discount. Only populated when ``full_details`` is ``True``.
         self.subscription_discount: Optional[float] = self._if_full_details(self._parse_currency("subscribe"))
         #: The Order total before tax. Only populated when ``full_details`` is ``True``.

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/amazonorders/entity/parsable.py

@@ -67,7 +67,10 @@ class Parsable:
                      required: bool = False,
                      prefix_split: Optional[str] = None,
                      wrap_tag: Optional[Type] = None,
-                     parse_date: bool = False) -> Any:
+                     parse_date: bool = False,
+                     prefix_split_fuzzy: bool = False,
+                     suffix_split: Optional[str] = None,
+                     suffix_split_fuzzy: bool = False) -> Any:
         """
         Will attempt to extract the text value of the given CSS selector(s) for a field, and
         is suitable for most basic functionality on a well-formed page.
@@ -86,6 +89,9 @@ class Parsable:
         :param wrap_tag: Wrap the selected tag in this class before returning.
         :param parse_date: ``True`` if the resulting value should be fuzzy parsed in to a date (returning ``None`` if
             parsing fails).
+        :param prefix_split_fuzzy: ``True`` if the value should still be used even if ``prefix_split`` is not found.
+        :param suffix_split: Only select the field with the given suffix, returning the left side of the split if so.
+        :param suffix_split_fuzzy: ``True`` if the value should still be used even if ``suffix_split`` is not found.
         :return: The cleaned up return value from the parsed ``selector``.
         """
         if isinstance(selector, str):
@@ -109,12 +115,24 @@ class Parsable:
 
                         if prefix_split:
                             if prefix_split not in tag.text:
-                                continue
+                                if prefix_split_fuzzy:
+                                    value = tag.text.strip()
+                                else:
+                                    continue
                             else:
                                 value = tag.text.strip().split(prefix_split)[1]
                         else:
                             value = tag.text
 
+                        if suffix_split:
+                            if suffix_split not in value:
+                                if suffix_split_fuzzy:
+                                    value = value.strip()
+                                else:
+                                    continue
+                            else:
+                                value = value.strip().split(suffix_split)[0]
+
                         if wrap_tag:
                             value = wrap_tag(tag, self.config)
                         else:
@@ -142,7 +160,7 @@ class Parsable:
         """
         A helper function that uses :func:`simple_parse` as the ``parse_function()`` passed to :func:`safe_parse`.
 
-        :param selector: The selector to pass to :func:`simple_parse`.
+        :param selector: The CSS selector to pass to :func:`simple_parse`.
         :param kwargs: The ``kwargs`` will be passed to ``parse_function``.
         :return: The return value from :func:`simple_parse`.
         """

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/amazonorders/orders.py

@@ -73,9 +73,8 @@ class AmazonOrders:
             response_parsed = self.amazon_session.last_response_parsed
 
             for order_tag in util.select(response_parsed, self.config.selectors.ORDER_HISTORY_ENTITY_SELECTOR):
-                # If we find a brand logo (for instance, Amazon Fresh), we don't know how to parse this. If we know how
-                # to do this in the future, we can implement it, but right now we have no reliable way, so skipping
-                # these orders.
+                # First check if this Order is known to be of a type that we do not currently have a way to support
+                # parsing, meaning it should be skipped
                 if util.select(order_tag, self.config.selectors.ORDER_HISTORY_BRAND_SELECTOR):
                     continue
 

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/amazonorders/selectors.py

@@ -55,7 +55,14 @@ class Selectors:
     SHIPMENT_ENTITY_SELECTOR = ["[data-component='orderCard'] [data-component='shipments'] .a-box",
                                 "div.shipment",
                                 "div.delivery-box"]
-    ORDER_HISTORY_BRAND_SELECTOR = ".brand-info-box .brand-logo img"
+    # Selectors defined here, if found in an Order, will cause the Order to be skipped, since it means we currently
+    # do not have a way to support fully parsing its details
+    ORDER_HISTORY_BRAND_SELECTOR = [
+        # Amazon Fresh is not supported
+        ".brand-info-box .brand-logo img",
+        # Whole Foods Market is not supported
+        "a.yohtmlc-order-details-link[href^='/wholefoodsmarket']"
+    ]
 
     #####################################
     # CSS selectors for Item fields
@@ -69,7 +76,8 @@ class Selectors:
                                  ".yohtmlc-item a", ".yohtmlc-product-title"]
     FIELD_ITEM_LINK_SELECTOR = ["[data-component='itemTitle'] a",
                                 ".yohtmlc-item a",
-                                "a:has(> .yohtmlc-product-title)"]
+                                "a:has(> .yohtmlc-product-title)",
+                                ".yohtmlc-product-title a"]
     FIELD_ITEM_TAG_ITERATOR_SELECTOR = [".yohtmlc-item div"]
     FIELD_ITEM_PRICE_SELECTOR = ["[data-component='unitPrice'] .a-text-price :not(.a-offscreen)",
                                  ".yohtmlc-item .a-color-price"]
@@ -81,12 +89,15 @@ class Selectors:
     #####################################
 
     FIELD_ORDER_DETAILS_LINK_SELECTOR = "a.yohtmlc-order-details-link"
-    FIELD_ORDER_NUMBER_SELECTOR = [".order-date-invoice-item bdi[dir='ltr']",
+    FIELD_ORDER_NUMBER_SELECTOR = ["[data-component='briefOrderInfo'] div.a-column",
+                                   ".order-date-invoice-item bdi[dir='ltr']",
                                    "bdi[dir='ltr']",
                                    "span[dir='ltr']"]
     FIELD_ORDER_GRAND_TOTAL_SELECTOR = ["div.yohtmlc-order-total span.value",
-                                        "div.order-header div.a-column.a-span2"]
-    FIELD_ORDER_PLACED_DATE_SELECTOR = ["span.order-date-invoice-item",
+                                        "div.order-header div.a-column.a-span2",
+                                        "div.order-header div.a-col-left .a-span9"]
+    FIELD_ORDER_PLACED_DATE_SELECTOR = ["[data-component='briefOrderInfo'] div.a-column",
+                                        "span.order-date-invoice-item",
                                         "div.a-span3"]
     FIELD_ORDER_PAYMENT_METHOD_SELECTOR = "img.pmts-payment-credit-card-instrument-logo"
     FIELD_ORDER_PAYMENT_METHOD_LAST_4_SELECTOR = "span:has(img.pmts-payment-credit-card-instrument-logo):last-child"

{amazon_orders-3.2.3 → amazon_orders-3.2.5}/tests/test_orders.py

@@ -3,6 +3,7 @@ __license__ = "MIT"
 
 import os
 import unittest
+from datetime import date
 
 import responses
 
@@ -77,6 +78,40 @@ class TestOrders(UnitTestCase):
         self.assertEqual(1, resp1.call_count)
         self.assertEqual(1, resp2.call_count)
 
+    @responses.activate
+    def test_get_order_history_2025_gift_card(self):
+        # GIVEN
+        self.amazon_session.is_authenticated = True
+        year = 2024
+        start_index = 0
+        resp1 = self.given_order_history_landing_exists()
+        with open(os.path.join(self.RESOURCES_DIR, "order-history-egift.html"), "r",
+                  encoding="utf-8") as f:
+            resp2 = responses.add(
+                responses.GET,
+                self.test_config.constants.ORDER_HISTORY_URL,
+                body=f.read(),
+                status=200,
+            )
+
+        # WHEN
+        orders = self.amazon_orders.get_order_history(year=year, start_index=start_index)
+
+        # THEN
+        self.assertEqual(9, len(orders))
+        self.assertEqual(1, resp1.call_count)
+        self.assertEqual(1, resp2.call_count)
+        order = orders[5]
+        self.assertEqual("112-8022032-9113020", order.order_number)
+        self.assertEqual(150.00, order.grand_total)
+        self.assertIsNotNone(order.order_details_link)
+        self.assertEqual(date(2024, 10, 28), order.order_placed_date)
+        self.assertEqual(1, len(order.items))
+        self.assertEqual("Amazon eGift Card - Birthday Candles (Animated)",
+                         order.items[0].title)
+        self.assertIsNotNone(order.items[0].link)
+        self.assertIsNotNone(order.items[0].image_link)
+
     @responses.activate
     def test_get_order_history_paginated(self):
         # GIVEN
@@ -127,6 +162,30 @@ class TestOrders(UnitTestCase):
         self.assertEqual(1, resp1.call_count)
         self.assertEqual(1, resp2.call_count)
 
+    @responses.activate
+    def test_get_order_history_skip_wholefoods(self):
+        # GIVEN
+        self.amazon_session.is_authenticated = True
+        year = 2024
+        start_index = 0
+        resp1 = self.given_order_history_landing_exists()
+        with open(os.path.join(self.RESOURCES_DIR, "order-history-wholefoods.html"), "r",
+                  encoding="utf-8") as f:
+            resp2 = responses.add(
+                responses.GET,
+                self.test_config.constants.ORDER_HISTORY_URL,
+                body=f.read(),
+                status=200,
+            )
+
+        # WHEN
+        orders = self.amazon_orders.get_order_history(year=year, start_index=start_index)
+
+        # THEN
+        self.assertEqual(9, len(orders))
+        self.assertEqual(1, resp1.call_count)
+        self.assertEqual(1, resp2.call_count)
+
     @responses.activate
     def test_get_order_history_full_details(self):
         # GIVEN