An Elixir client for Picnic's unofficial supermarket API.

The API is undocumented and changes without notice; this library is built around that fact. It may break at any time and using it may violate Picnic's terms of service — be a good citizen and don't hammer the endpoints.

Usage

client = Picnic.Client.new(country: :nl)
{:ok, client} = Picnic.login(client, "user@example.com", "password")

{:ok, results} = Picnic.search(client, "melk")
{:ok, cart} = Picnic.add_to_cart(client, "s1019822", count: 2)
{:ok, deliveries} = Picnic.deliveries(client)

The client is a plain struct — no process, no global state. Login returns a new client carrying the token; persist client.auth_token and rebuild with Picnic.Client.new(auth_token: token) to skip login next time. For managed auth with automatic re-login, see the optional Picnic.Session.

The escape hatch: request/4

Because the API drifts ahead of any library, the generic passthrough is a first-class part of the public surface, not a debug affordance:

Picnic.request(client, :get, "/user")
Picnic.request(client, :post, "/cart/add_product", json: %{product_id: id, count: 2})

It reaches any endpoint — including ones this library hasn't modelled or ones Picnic adds tomorrow. The named functions below are conveniences layered on top of it; they are never the only way in.

Results, drift, and :raw

Every function returns {:ok, result} | {:error, %Picnic.Error{}}; the bang variants raise the Picnic.Error instead. Results are plain maps by default. Pass as: :struct for loose typed structs — and note that every struct keeps the complete, untouched payload under :raw, which is your lifeline when Picnic ships a field the structs don't know about yet. See Picnic.Decode for the full drift-handling rules.