Prompt file imported from IFirmani/product_gallery_normalizer (.github/prompts/05-implement-woocommerce-client.prompt.md). Copyright stays with the author.

Implement woocommerce_client.py

Name: 05-implement-woocommerce-client
Author: IFirmani

Create src/product_gallery_normalizer/woocommerce_client.py. This is a core module — no PySide6 imports allowed.

Class: WooCommerceClient

Constructor: __init__(self, credentials: WooCredentials)

Build a requests.Session with HTTP Basic Auth (consumer_key, consumer_secret)
Set default timeout to 15 seconds
Base URL: {credentials.store_url}/wp-json/wc/v3

Methods

get_products

def get_products(
    self,
    page: int = 1,
    per_page: int = 50,
    search: str = "",
    status: str = "any",
    category: int | None = None,
) -> list[WooProduct]

GET /products with query params
Parse response JSON into list[WooProduct] using WooProduct.model_validate
Return empty list on HTTP error, log the error with logging.error

get_product

def get_product(self, product_id: int) -> WooProduct | None

GET /products/{product_id}
Return None on 404 or any error

update_product

def update_product(self, product_id: int, payload: dict) -> WooProduct | None

PUT /products/{product_id} with JSON body
Return updated WooProduct or None on error

create_product

def create_product(self, product: WooProduct) -> WooProduct | None

POST /products with product.model_dump(exclude={"id", "date_modified"}, exclude_none=True)
Return created WooProduct (with server-assigned id) or None on error

delete_product

def delete_product(self, product_id: int, force: bool = False) -> bool

DELETE /products/{product_id}?force={force}
Returns True on 200/success, False otherwise

upload_image

def upload_image(self, image_path: Path) -> WooImage | None

POST to {store_url}/wp-json/wp/v2/media (WordPress Media API, not WC)
Send file as multipart with correct Content-Disposition and Content-Type headers
Infer MIME type from file extension using mimetypes.guess_type
Return WooImage with the new id and src, or None on error

get_categories

def get_categories(self) -> list[WooCategory]

GET /products/categories?per_page=100
Return list of WooCategory or empty list on error

Rules

Add requests to [project.dependencies] in pyproject.toml if not already present
Log all HTTP errors with logging.error, never raise to caller
No threading in this module — threading is the GUI's responsibility
No imports from PySide6 or any GUI module

# Implement woocommerce_client.py Create `src/product_gallery_normalizer/woocommerce_client.py`. This is a **core module** — no PySide6 imports allowed. ## Class: WooCommerceClient Constructor: `__init__(self, credentials: WooCredentials)` - Build a `requests.Session` with HTTP Basic Auth (consumer_key, consumer_secret) - Set default timeout to 15 seconds - Base URL: `{credentials.store_url}/wp-json/wc/v3` ## Methods ### get_products ```python def get_products( self, page: int = 1, per_page: int = 50, search: str = "", status: str = "any", category: int | None = None, ) -> list[WooProduct] ``` - GET `/products` with query params - Parse response JSON into `list[WooProduct]` using `WooProduct.model_validate` - Return empty list on HTTP error, log the error with `logging.error` ### get_product ```python def get_product(self, product_id: int) -> WooProduct | None ``` - GET `/products/{product_id}` - Return None on 404 or any error ### update_product ```python def update_product(self, product_id: int, payload: dict) -> WooProduct | None ``` - PUT `/products/{product_id}` with JSON body - Return updated WooProduct or None on error ### create_product ```python def create_product(self, product: WooProduct) -> WooProduct | None ``` - POST `/products` with `product.model_dump(exclude={"id", "date_modified"}, exclude_none=True)` - Return created WooProduct (with server-assigned id) or None on error ### delete_product ```python def delete_product(self, product_id: int, force: bool = False) -> bool ``` - DELETE `/products/{product_id}?force={force}` - Returns True on 200/success, False otherwise ### upload_image ```python def upload_image(self, image_path: Path) -> WooImage | None ``` - POST to `{store_url}/wp-json/wp/v2/media` (WordPress Media API, not WC) - Send file as multipart with correct `Content-Disposition` and `Content-Type` headers - Infer MIME type from file extension using `mimetypes.guess_type` - Return WooImage with the new `id` and `src`, or None on error ### get_categories ```python def get_categories(self) -> list[WooCategory] ``` - GET `/products/categories?per_page=100` - Return list of WooCategory or empty list on error ## Rules - Add `requests` to `[project.dependencies]` in `pyproject.toml` if not already present - Log all HTTP errors with `logging.error`, never raise to caller - No threading in this module — threading is the GUI's responsibility - No imports from PySide6 or any GUI module

{ "prompt": "# Implement woocommerce_client.py\n\nCreate `src/product_gallery_normalizer/woocommerce_client.py`.\nThis is a **core module** — no PySide6 imports allowed.\n\n## Class: WooCommerceClient\n\nConstructor: `__init__(self, credentials: WooCredentials)`\n- Build a `requests.Session` with HTTP Basic Auth (consumer_key, consumer_secret)\n- Set default timeout to 15 seconds\n- Base URL: `{credentials.store_url}/wp-json/wc/v3`\n\n## Methods\n\n### get_products\n```python\ndef get_products(\n self,\n page: int = 1,\n per_page: int = 50,\n search: str = \"\",\n status: str = \"any\",\n category: int | None = None,\n) -> list[WooProduct]\n```\n- GET `/products` with query params\n- Parse response JSON into `list[WooProduct]` using `WooProduct.model_validate`\n- Return empty list on HTTP error, log the error with `logging.error`\n\n### get_product\n```python\ndef get_product(self, product_id: int) -> WooProduct | None\n```\n- GET `/products/{product_id}`\n- Return None on 404 or any error\n\n### update_product\n```python\ndef update_product(self, product_id: int, payload: dict) -> WooProduct | None\n```\n- PUT `/products/{product_id}` with JSON body\n- Return updated WooProduct or None on error\n\n### create_product\n```python\ndef create_product(self, product: WooProduct) -> WooProduct | None\n```\n- POST `/products` with `product.model_dump(exclude={\"id\", \"date_modified\"}, exclude_none=True)`\n- Return created WooProduct (with server-assigned id) or None on error\n\n### delete_product\n```python\ndef delete_product(self, product_id: int, force: bool = False) -> bool\n```\n- DELETE `/products/{product_id}?force={force}`\n- Returns True on 200/success, False otherwise\n\n### upload_image\n```python\ndef upload_image(self, image_path: Path) -> WooImage | None\n```\n- POST to `{store_url}/wp-json/wp/v2/media` (WordPress Media API, not WC)\n- Send file as multipart with correct `Content-Disposition` and `Content-Type` headers\n- Infer MIME type from file extension using `mimetypes.guess_type`\n- Return WooImage with the new `id` and `src`, or None on error\n\n### get_categories\n```python\ndef get_categories(self) -> list[WooCategory]\n```\n- GET `/products/categories?per_page=100`\n- Return list of WooCategory or empty list on error\n\n## Rules\n- Add `requests` to `[project.dependencies]` in `pyproject.toml` if not already present\n- Log all HTTP errors with `logging.error`, never raise to caller\n- No threading in this module — threading is the GUI's responsibility\n- No imports from PySide6 or any GUI module", "variables": [], "notes": "Implement the WooCommerce REST API v3 HTTP client Mode: agent.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/IFirmani/product_gallery_normalizer", "path": ".github/prompts/05-implement-woocommerce-client.prompt.md", "ref": "6f5f0f1e5f484266b72f74d1061f2f70a6ef6318", "url": "https://github.com/IFirmani/product_gallery_normalizer/blob/6f5f0f1e5f484266b72f74d1061f2f70a6ef6318/.github/prompts/05-implement-woocommerce-client.prompt.md", "key": "IFirmani/product_gallery_normalizer/.github/prompts/05-implement-woocommerce-client.prompt.md" } } }

05-implement-woocommerce-client

About