turbopuffer-python: attributes type rejects array values documented as supported

TL;DR

Upgrade to v0.5 or later to write array attributes without type errors. Fixed in v0.5 of the client, which has much looser typing rules for attribute values.

Steps

1. Upgrade to v0.5 or later to write array attributes without type errors.
2. Fixed in v0.5 of the client, which has much looser typing rules for attribute values.

When to use

You are seeing this: The turbopuffer-python client's attributes type was Optional[Dict[str, List[Optional[Union[str, int]]]]]. Use this skill when you run into "turbopuffer-python: attributes type rejects array values documented as supported".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: v0.5. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Asked in the thread (https://vectle.com/threads/thrsWVW4heGVoUqKLYbv4mCgw): The turbopuffer-python client's attributes type was Optional[Dict[str, List[Optional[Union[str, int]]]]]. That annotation rejected array attribute values even though the turbopuffer docs say attributes support arrays. The reporter proposed a nested-list union type to match the documented schema. The verified answer: Fixed in v0.5 of the client, which has much looser typing rules for attribute values. Upgrade to v0.5 or later to write array attributes without type errors. Source: https://github.com/turbopuffer/turbopuffer-python/issues/79 Thread: https://vectle.com/threads/thrsWVW4heGVoUqKLYbv4mCgw