Changelog¶

All notable changes to pypresscart are recorded here. This project follows Semantic Versioning.

Unreleased ¶

client.orders.get(order_id, include_outlets_data=True) — new keyword-only parameter that requests a fully-populated outlet block (id, name, logo, website_url) on each line item instead of the lean shape. Defaults to None, in which case the parameter is omitted from the URL and existing call sites are byte-for-byte unchanged on the wire.

Order.name and Order.email — top-level fields returned by GET /orders/{order_id} (the list endpoint nests these as team.name / team.contact_email; both shapes are now modelled in parallel).
LineItem.includes: list[IncludeItem] | None — channel/placement array surfaced on GET /orders/{order_id} line items.

LineItem.id and LineItem.order_id are now optional. The Presscart API doesn’t populate them on the lean POST /orders/checkout response (line items are only persisted with an id once the order is paid, exposed via GET /order-items), which previously caused checkout responses to fail Pydantic validation.

Removed the strict-xfail trip-wire on the tests/integration/test_articles.py::test_get_article live test. Presscart fixed the GET /articles/{article_id} 403 for full_access API tokens (issue #8), and the live test now passes. Documentation under docs/testing-status.md and docs/resource-articles.md updated accordingly.

OutletChannel.do_follow_links_allowed now accepts string values (e.g. "Unlimited") in addition to bool/null. The Presscart API returns a capacity string here on some outlet channels even though the docs type it as a boolean, which was causing GET /outlets/{id} to raise a Pydantic ValidationError whenever one of those channels appeared in the response.

serialize_filters now emits list-valued filters in the indexed-bracket form (filters[key][0]=v1&filters[key][1]=v2) that the Presscart API actually parses. The previous bare-bracket form (filters[key][]=v1) was silently ignored by the server, causing any query using disclaimer_ids, placement_types, channel_types, tags, or product_ids to return the full unfiltered result set instead of the expected subset.

Housekeeping release. No runtime behavior changes.

Project URLs in pyproject.toml (and therefore the Project links sidebar on PyPI) now point at the new owner pypresscart/py-presscart. 0.1.0 still shipped with the original annjawn/py-presscart URLs baked into its metadata; GitHub redirects preserve them, but 0.1.1 is the first release published under the canonical URLs.
Docs site moved from www.anjanbiswas.dev/py-presscart/ to https://pypresscart.github.io/py-presscart/ as a side-effect of the repo transfer to the new pypresscart GitHub org.
README now documents the full release procedure end-to-end and notes that main is protected (CI must pass, no direct pushes, force-pushes and deletions denied).

Initial public release.

PresscartClient with composable resource services: auth, outlets, products, orders, order_items, profiles, campaigns, articles, files, folders.
Full coverage of the Presscart API as of release date (40+ endpoints).
Pydantic models for every request and response shape.
Dual-mode I/O: accept and return either Pydantic models or dicts, controllable per-call (as_json=) or at the client level (response_mode=).
Typed exception hierarchy with BadRequestError, ValidationError, AuthenticationError, PermissionError, NotFoundError, RateLimitError, ServerError, and PresscartTransportError.
Automatic exponential-backoff retry on 429/5xx/network errors, honoring Retry-After.
Context-manager lifecycle.
Typed throughout (py.typed shipped; mypy-strict clean).