amazon-orders-de 1.0.0__py3-none-any.whl

amazon_orders_de/__init__.py

@@ -0,0 +1,11 @@
+"""
+An ``amazon-orders`` language package for amazon.de, which requests its pages in English. Enable it with
+``language_package: amazon_orders_de`` and ``domain: amazon.de`` in the config.
+"""
+
+from amazon_orders_de.constants import Constants
+from amazon_orders_de.order import Order
+from amazon_orders_de.selectors import Selectors
+from amazon_orders_de.transactions import TransactionsPage
+
+__all__ = ["Constants", "Order", "Selectors", "TransactionsPage"]

amazon_orders_de/constants.py

@@ -0,0 +1,21 @@
+from amazonorders import constants
+
+
+class Constants(constants.Constants):
+    """
+    Constants for amazon.de, requested in English.
+    """
+
+    # Ask for the English version of the site, so its pages are parsed with the English words of ``amazon-orders``
+    BASE_HEADERS = {**constants.Constants.BASE_HEADERS, "Accept-Language": "en-GB,en;q=0.9"}
+
+    # amazon.de picks its language from this cookie rather than from ``Accept-Language``, and sets it again from the
+    # account's language on every response
+    REQUEST_COOKIES = {"lc-acbde": "en_GB"}
+
+    #: The internal API that loads further pages of Transactions.
+    TRANSACTION_HISTORY_API_ROUTE = "/payments-portal/data/iris/live/v1/data/manage/get-transactions"
+
+    @property
+    def TRANSACTION_HISTORY_API_URL(self) -> str:
+        return f"{self.BASE_URL}{self.TRANSACTION_HISTORY_API_ROUTE}"

amazon_orders_de/order.py

@@ -0,0 +1,46 @@
+import re
+
+from amazonorders import util
+from amazonorders.entity import order, recipient
+
+
+class Recipient(recipient.Recipient):
+    """
+    A Recipient whose address is rendered as an unclassed list, one or more lines per list item.
+    """
+
+    def _parse_address(self) -> str | None:
+        return self._parse_address_lines() or super()._parse_address()
+
+    def _parse_address_lines(self) -> str | None:
+        lines: list[str] = []
+        for tag in util.select(self.parsed, self.config.selectors.FIELD_RECIPIENT_ADDRESS_LINES_SELECTOR):
+            # A list item may hold several lines separated by <br> or, when Amazon renders the address inline,
+            # by commas
+            lines.extend(line.strip() for line in re.split(r"[\n,]", tag.get_text("\n")) if line.strip())
+
+        return "\n".join(lines) or None
+
+
+class Order(order.Order):
+    """
+    An Order on amazon.de.
+    """
+
+    def _parse_payment_method(self) -> str | None:
+        # When a Gift Card was used alongside a card, prefer the card (the instrument with a number), like its last
+        # digits are
+        selectors = self.config.selectors
+        for instrument in util.select(self.parsed, selectors.FIELD_ORDER_PAYMENT_INSTRUMENT_SELECTOR):
+            name_tag = util.select_one(instrument, selectors.FIELD_ORDER_PAYMENT_INSTRUMENT_NAME_SELECTOR)
+            if name_tag and util.select_one(instrument, selectors.FIELD_ORDER_PAYMENT_INSTRUMENT_NUMBER_SELECTOR):
+                return name_tag.text.strip() or None
+
+        return super()._parse_payment_method()
+
+    def _parse_recipient(self) -> recipient.Recipient | None:
+        value = super()._parse_recipient()
+        if value is None:
+            return None
+
+        return Recipient(value.parsed, self.config)

amazon_orders_de/selectors.py

@@ -0,0 +1,30 @@
+from amazonorders import selectors
+from amazonorders.selectors import Selector
+
+
+class Selectors(selectors.Selectors):
+    """
+    Selectors for amazon.de, requested in English, which uses British English labels.
+    """
+
+    # Rendered as "Postage & Packing"
+    FIELD_ORDER_SHIPPING_TOTAL_LABELS = [*selectors.Selectors.FIELD_ORDER_SHIPPING_TOTAL_LABELS, "postage"]
+    # Rendered as "Estimated VAT"
+    FIELD_ORDER_ESTIMATED_TAX_LABELS = [*selectors.Selectors.FIELD_ORDER_ESTIMATED_TAX_LABELS, "estimated vat"]
+
+    ORDER_SKIP_TOTALS = [
+        *selectors.Selectors.ORDER_SKIP_TOTALS,
+        # Identifies an Order of a cancelled service (e.g. a cancelled installation) on the history page
+        Selector("div.yohtmlc-shipment-status-primaryText", "Service cancelled"),
+    ]
+
+    #: The payment instruments an Order was paid with, and each one's name and masked number.
+    FIELD_ORDER_PAYMENT_INSTRUMENT_SELECTOR = "[data-testid='payment-instrument']"
+    FIELD_ORDER_PAYMENT_INSTRUMENT_NAME_SELECTOR = "[data-testid='payment-instrument-name']"
+    FIELD_ORDER_PAYMENT_INSTRUMENT_NUMBER_SELECTOR = "[data-testid='payment-instrument-number']"
+
+    #: The address lines that follow the Recipient's name in an unclassed list.
+    FIELD_RECIPIENT_ADDRESS_LINES_SELECTOR = "ul > li:not(:first-child)"
+
+    #: The Transactions, embedded as JSON in the Next.js page.
+    TRANSACTION_HISTORY_NEXT_DATA_SELECTOR = "script#__NEXT_DATA__"

amazon_orders_de/transactions.py

@@ -0,0 +1,157 @@
+import json
+import logging
+import re
+from typing import Any
+
+from amazonorders import transactions, util
+from amazonorders.entity.transaction import Transaction
+from amazonorders.exception import AmazonOrdersEntityError, AmazonOrdersError
+from amazonorders.session import AmazonSession
+from bs4 import Tag
+
+logger = logging.getLogger(__name__)
+
+#: An Order number within a Transaction's Order description.
+_ORDER_NUMBER_RE = re.compile(r"\b(\d{3}-\d{7}-\d{7}|D\d{2}-\d{7}-\d{7})\b")
+
+_PageResult = tuple[list[Transaction], dict[str, Any] | None]
+
+
+class TransactionsPage(transactions.TransactionsPage):
+    """
+    The Transactions page of amazon.de, a Next.js page that embeds its first page of Transactions as JSON and loads
+    further pages from an internal API.
+    """
+
+    def get_page(
+        self, amazon_session: AmazonSession, url: str, next_page_data: dict[str, Any] | None = None
+    ) -> _PageResult:
+        if not next_page_data or "request" not in next_page_data:
+            return super().get_page(amazon_session, url, next_page_data)
+
+        page_response = amazon_session.post(
+            self.config.constants.TRANSACTION_HISTORY_API_URL,
+            json=next_page_data["request"],
+            headers={"x-amzn-upx-token": next_page_data["token"]},
+        )
+        amazon_session.check_response(page_response, meta=next_page_data)
+
+        try:
+            data = page_response.response.json()
+        except ValueError as e:
+            raise AmazonOrdersError(
+                "Could not parse Transaction history. Check if Amazon changed the API.", meta=next_page_data
+            ) from e
+
+        return self._parse_api_response(data, next_page_data)
+
+    def parse_page(self, parsed: Tag) -> _PageResult:
+        next_data_tag = util.select_one(parsed, self.config.selectors.TRANSACTION_HISTORY_NEXT_DATA_SELECTOR)
+        if next_data_tag:
+            result = self._parse_next_data(next_data_tag)
+            if result is not None:
+                return result
+
+        return super().parse_page(parsed)
+
+    def _parse_next_data(self, next_data_tag: Tag) -> _PageResult | None:
+        try:
+            page_props = json.loads(next_data_tag.text)["props"]["pageProps"]
+            state = page_props["state"]["transactionResponseState"]
+            transaction_list = state["visibleTransactionResponse"]["transactionList"]
+        except (ValueError, KeyError, TypeError):
+            return None
+
+        loaded_transactions = self._parse_transactions_data(transaction_list)
+
+        # Further pages are loaded from an internal API, authorized by the token embedded in the page
+        next_page_data = None
+        if state.get("hasMore") and state.get("lastEvaluatedPageKey"):
+            try:
+                next_page_data = {
+                    "token": page_props["token"],
+                    "request": {
+                        "type": "GetTransactions",
+                        "locale": page_props["request"]["locale"],
+                        "surfaceInfo": page_props["manageWalletRequest"]["requestContext"]["surfaceInfo"],
+                        "transactionsViewRequest": {"filtersControls": {"includeFilters": True}},
+                        "widgetName": "ViewTransactions",
+                        "exclusiveStartKey": state["lastEvaluatedPageKey"],
+                    },
+                }
+            except (KeyError, TypeError):
+                logger.warning(
+                    "Only the first page of Transactions could be loaded, as the data to load further "
+                    "pages was not found."
+                )
+
+        return loaded_transactions, next_page_data
+
+    def _parse_api_response(self, data: dict[str, Any], next_page_data: dict[str, Any]) -> _PageResult:
+        try:
+            display_response = data["displayResponse"]
+            transaction_list = display_response["transactionsList"]
+        except (KeyError, TypeError) as e:
+            raise AmazonOrdersError(
+                "Could not parse Transaction history. Check if Amazon changed the API.", meta=next_page_data
+            ) from e
+
+        loaded_transactions = self._parse_transactions_data(transaction_list)
+
+        last_evaluated_key = display_response.get("lastEvaluatedKey")
+        if not last_evaluated_key:
+            return loaded_transactions, None
+
+        return loaded_transactions, {
+            "token": next_page_data["token"],
+            "request": dict(next_page_data["request"], exclusiveStartKey=last_evaluated_key),
+        }
+
+    def _parse_transactions_data(self, transaction_list: list[dict[str, Any]]) -> list[Transaction]:
+        config = self.config
+        loaded_transactions = []
+        for data in transaction_list:
+            date_str = data.get("formattedDate")
+            completed_date = config.constants.parse_date(date_str)
+            if completed_date is None:
+                err_msg = (
+                    f"Transaction date {date_str!r} could not be parsed, but it's required. Check if "
+                    f"Amazon changed the page"
+                )
+                if not config.warn_on_missing_required_field:
+                    raise AmazonOrdersEntityError(f"{err_msg} or set warn_on_missing_required_field=True in config.")
+
+                logger.warning(f"{err_msg}.")
+                continue
+
+            grand_total = config.constants.parse_currency(data.get("formattedAmount"))
+            if grand_total is None:
+                logger.warning(
+                    f"Transaction amount {data.get('formattedAmount')!r} could not be parsed, so the "
+                    f"Transaction was skipped."
+                )
+                continue
+
+            payment_data = data.get("paymentMethodDisplayStringData") or {}
+            payment_method_name = payment_data.get("paymentMethodName")
+            last_digits = (payment_data.get("paymentMethodNumber") or {}).get("lastDigits")
+            # When a Transaction covers more than one Order, only the first one is used
+            order_data = (data.get("orderData") or [{}])[0]
+            order_number_match = _ORDER_NUMBER_RE.search(order_data.get("orderDisplayString") or "")
+
+            loaded_transactions.append(
+                config.transaction_cls.from_fields(
+                    config,
+                    completed_date,
+                    grand_total,
+                    payment_method=f"{payment_method_name} ****{last_digits}"
+                    if payment_method_name and last_digits
+                    else payment_method_name,
+                    payment_method_last_4=last_digits,
+                    order_number=order_number_match.group(1) if order_number_match else None,
+                    order_details_link=order_data.get("orderDetailsUrl"),
+                    seller=data.get("statementDescriptor"),
+                )
+            )
+
+        return loaded_transactions

amazon_orders_de-1.0.0.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.5
+Name: amazon-orders-de
+Version: 1.0.0
+Summary: An amazon-orders language package for amazon.de, which parses its pages in English
+Project-URL: Source, https://github.com/udondan/amazon-orders-de
+Author: Daniel Schroeder
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: amazon-orders<5,>=4.8.1
+Description-Content-Type: text/markdown
+
+# amazon-orders-de
+
+A [language package](https://amazon-orders.readthedocs.io/language-packages.html) for
+[amazon-orders](https://github.com/alexdlaird/amazon-orders) that adds support for amazon.de.
+
+Rather than translating `amazon-orders` into German, it asks amazon.de for its pages in English and handles what's
+different there:
+
+- British English labels ("Postage & Packing", "Estimated VAT")
+- Orders whose service was cancelled
+- Recipient addresses rendered as a plain list
+- The payment method of an Order paid with a Gift Card and a card
+- The Transactions page, which embeds its first page as JSON and loads further pages from an API
+
+## Installation
+
+```sh
+pip install amazon-orders-de
+```
+
+## Usage
+
+Set `language_package` and `domain` in the `amazon-orders` config (`~/.config/amazonorders/config.yml`):
+
+```yaml
+language_package: amazon_orders_de
+domain: amazon.de
+```
+
+or pass them in Python:
+
+```python
+from amazonorders.conf import AmazonOrdersConfig
+from amazonorders.orders import AmazonOrders
+from amazonorders.session import AmazonSession
+
+config = AmazonOrdersConfig(data={"language_package": "amazon_orders_de", "domain": "amazon.de"})
+amazon_session = AmazonSession(config=config)
+amazon_session.login()
+
+orders = AmazonOrders(amazon_session).get_order_history(year=2026)
+```
+
+Everything else works as described in the [amazon-orders docs](https://amazon-orders.readthedocs.io).
+
+## Development
+
+With [mise](https://mise.jdx.dev/), which installs Python and uv:
+
+```sh
+mise run install    # uv sync
+mise run lint       # ruff and mypy; `mise run lint-fix` fixes what it can
+mise run test
+```
+
+Commits follow [Conventional Commits](https://www.conventionalcommits.org/), from which release-please creates the
+releases and the changelog.
+
+The unit tests parse real amazon.de pages in `tests/resources`. Before a page is added there, it's anonymized with
+`scripts/anonymize-test-resources.py`, which removes personal and product details. The raw pages and the rules file
+with the values to replace must never be committed.
+
+The integration tests in `tests/integration` log in to amazon.de with `AMAZON_USERNAME`, `AMAZON_PASSWORD`, and
+`AMAZON_OTP_SECRET_KEY`, and run weekly in CI.

amazon_orders_de-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+amazon_orders_de/__init__.py,sha256=Rwo3_V20Q7-Db_lqypjMJwSxk4otMBoRO5OwVMCGSNM,459
+amazon_orders_de/constants.py,sha256=AXOdeYhDFXXm_pjLBejVIuuJG-elwEfvy0PwKqmbi8Y,860
+amazon_orders_de/order.py,sha256=Hw70lKVt-S0cjCEm5YZ9VcWHrudi3DxPBhHI_lpmYNI,1766
+amazon_orders_de/selectors.py,sha256=ppMKmlB8KA-stYbNNMTb-J2QUOulUhMzkxDnHcFnDBY,1436
+amazon_orders_de/transactions.py,sha256=kx3uM9M5nERqkegtnEa9x8GyrRo95dDsuAXuDHd4BWw,6881
+amazon_orders_de-1.0.0.dist-info/METADATA,sha256=JqnrvQhsGDAP8NmejpG3X2I2dAB8vYS8JWWc_9SFtEQ,2692
+amazon_orders_de-1.0.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+amazon_orders_de-1.0.0.dist-info/licenses/LICENSE,sha256=vB-LyFzAYUHN758HXTKXGZdIfJe0iiDEUHT_KA7Czh8,1073
+amazon_orders_de-1.0.0.dist-info/RECORD,,

amazon_orders_de-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

amazon_orders_de-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Schroeder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.