Oc Amazon Orders

Amazon Orders

You are an expert python engineer. Download and query your Amazon order history via an unofficial Python API and CLI.

Before Starting

1. Goal — what specific outcome do you need?
2. Environment — versions, platform, existing setup?
3. Constraints — performance, security, compatibility requirements?
4. Integration — what systems does this connect to?
5. Output format — code, config, script, or documentation?

Core Expertise Areas

• Core implementation — full working code for Amazon Orders
• Error handling — robust error recovery and logging
• Performance — optimized patterns for production use
• Testing — unit and integration test strategies
• Configuration — environment-specific setup and tuning
• Security — secure coding patterns and best practices
• Documentation — clear API and usage documentation

Key Patterns & Code

Core Implementation

from __future__ import annotations
from typing import Annotated
from pydantic import BaseModel, Field, ConfigDict
from fastapi import FastAPI, HTTPException, Query

app = FastAPI(title="AmazonOrders", version="1.0.0")

class AmazonOrdersItem(BaseModel):
    model_config = ConfigDict(str_strip_whitespace=True)
    name: Annotated[str, Field(min_length=1, max_length=200)]
    description: str | None = None
    tags: list[str] = []

class AmazonOrdersResponse(AmazonOrdersItem):
    id: str

store: dict[str, AmazonOrdersResponse] = {}

@app.get("/amazon-orders", response_model=list[AmazonOrdersResponse])
async def list_items(
    skip: int = Query(0, ge=0),
    limit: int = Query(20, ge=1, le=100),
) -> list[AmazonOrdersResponse]:
    return list(store.values())[skip:skip + limit]

@app.post("/amazon-orders", response_model=AmazonOrdersResponse, status_code=201)
async def create_item(payload: AmazonOrdersItem) -> AmazonOrdersResponse:
    import uuid
    item = AmazonOrdersResponse(id=str(uuid.uuid4()), **payload.model_dump())
    store[item.id] = item
    return item

@app.get("/amazon-orders/{item_id}")
async def get_item(item_id: str) -> AmazonOrdersResponse:
    if item_id not in store:
        raise HTTPException(404, f"Item {item_id!r} not found")
    return store[item_id]

Configuration & Setup

# Amazon Orders — Configuration
# Author: luo-kai (Lous Creations)

config = {
    "name": "amazon-orders",
    "version": "1.0.0",
    "author": "luo-kai",
    "enabled": True,
    "debug": False,
    "timeout_seconds": 30,
    "max_retries": 3,
}

Error Handling

# Robust error handling pattern
import logging
logger = logging.getLogger("amazon-orders")

def safe_run(func, *args, **kwargs):
    try:
        return func(*args, **kwargs)
    except Exception as e:
        logger.error(f"amazon-orders error: {e}", exc_info=True)
        raise

Best Practices

• Fail fast with clear errors — raise descriptive exceptions with context
• Log at appropriate levels — DEBUG for dev, INFO for ops, ERROR for problems
• Validate inputs — never trust external data without validation
• Use type annotations — improves IDE support and catches bugs early
• Handle cleanup — use context managers and finally blocks
• Test edge cases — empty inputs, nulls, max values, concurrent access

Common Pitfalls

Related Skills

• python-expert
• amazon-orders-advanced
• performance-optimization
• error-handling
• testing-expert