meterbase 0.4.0__tar.gz → 0.4.1__tar.gz

{meterbase-0.4.0 → meterbase-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: meterbase
-Version: 0.4.0
+Version: 0.4.1
 Summary: Python SDK for the Meterbase engine
 Project-URL: Homepage, https://meterbase.tech
 Project-URL: Documentation, https://meterbase.tech/docs
@@ -328,12 +328,12 @@ identified. `None` means they hold no plan, which is a default deny — a
 customer with no plan and no grant is denied.
 
 **Lists come a page at a time.** `customers.list` answers one page, newest
-first: `limit` customers, 100 unless you set it and at most 1,000. `list_all`
+first: `limit` customers, 100 unless you set it and at most 100. `list_all`
 follows the pages for you, fetching each one as the loop reaches it:
 
 ```python
-page = meterbase.customers.list(plan="pro", limit=1000)
-page.data  #      the newest 1,000 customers on pro
+page = meterbase.customers.list(plan="pro", limit=50)
+page.data  #      the newest 50 customers on pro
 page.has_more  #  True when another page follows the last of them
 
 for customer in meterbase.customers.list_all(has_plan=False):
@@ -926,7 +926,7 @@ except RateLimitError as error:
 | `InvalidIdempotencyKeyError`             | 422 — an `InvalidRequestError`: the key was not a UUIDv7                                                                                  |
 | `TooLateError`                           | 422 — an `InvalidRequestError`: the key is over an hour from the engine's clock, which it carries on `server_time`. Nothing was recorded |
 | `ReservationMismatchError`               | 422 — an `InvalidRequestError`: the reservation was made for a different customer or meter                                                |
-| `RateLimitError`                         | 429                                                                                                                                       |
+| `RateLimitError`                         | 429 — `check` or `reserve` past the workspace's fair-use rate, `code == "rate_limited"`, with `retry_after` in seconds. `reserve` retries it for you; `check` raises at once, so fail open or closed |
 | `ServerError`                            | 5xx                                                                                                                                       |
 | `APIConnectionError` / `APITimeoutError` | the request never got an answer                                                                                                           |
 | `WebhookVerificationError`               | `verify_webhook`: not a delivery Meterbase signed in the last five minutes                                                                |

{meterbase-0.4.0 → meterbase-0.4.1}/README.md

@@ -301,12 +301,12 @@ identified. `None` means they hold no plan, which is a default deny — a
 customer with no plan and no grant is denied.
 
 **Lists come a page at a time.** `customers.list` answers one page, newest
-first: `limit` customers, 100 unless you set it and at most 1,000. `list_all`
+first: `limit` customers, 100 unless you set it and at most 100. `list_all`
 follows the pages for you, fetching each one as the loop reaches it:
 
 ```python
-page = meterbase.customers.list(plan="pro", limit=1000)
-page.data  #      the newest 1,000 customers on pro
+page = meterbase.customers.list(plan="pro", limit=50)
+page.data  #      the newest 50 customers on pro
 page.has_more  #  True when another page follows the last of them
 
 for customer in meterbase.customers.list_all(has_plan=False):
@@ -899,7 +899,7 @@ except RateLimitError as error:
 | `InvalidIdempotencyKeyError`             | 422 — an `InvalidRequestError`: the key was not a UUIDv7                                                                                  |
 | `TooLateError`                           | 422 — an `InvalidRequestError`: the key is over an hour from the engine's clock, which it carries on `server_time`. Nothing was recorded |
 | `ReservationMismatchError`               | 422 — an `InvalidRequestError`: the reservation was made for a different customer or meter                                                |
-| `RateLimitError`                         | 429                                                                                                                                       |
+| `RateLimitError`                         | 429 — `check` or `reserve` past the workspace's fair-use rate, `code == "rate_limited"`, with `retry_after` in seconds. `reserve` retries it for you; `check` raises at once, so fail open or closed |
 | `ServerError`                            | 5xx                                                                                                                                       |
 | `APIConnectionError` / `APITimeoutError` | the request never got an answer                                                                                                           |
 | `WebhookVerificationError`               | `verify_webhook`: not a delivery Meterbase signed in the last five minutes                                                                |

{meterbase-0.4.0 → meterbase-0.4.1}/src/meterbase/_async/client.py

@@ -126,6 +126,10 @@ class AsyncMeterbase:
         is waiting on, and answers in milliseconds when the engine is well.
         Decide what an `APITimeoutError` means here, failing open or closed,
         rather than waiting out the 35 s the writes are given.
+
+        `check` and `reserve` share the workspace's fair-use rate. Past it this
+        raises `RateLimitError` with `retry_after` in seconds and is not
+        retried, for the same reason: fail open or closed as on a timeout.
         """
         return await self._api.request(
             "POST",

{meterbase-0.4.0 → meterbase-0.4.1}/src/meterbase/_async/resources/customers.py

@@ -115,7 +115,7 @@ class AsyncCustomers:
     ) -> Page[Customer]:
         """
         One page, newest first: `limit` customers, 100 unless set and at most
-        1,000. Pass the last `id` as `starting_after` for the next page, while
+        100. Pass the last `id` as `starting_after` for the next page, while
         `has_more` is `True`; `list_all` does that for you.
 
         `plan`, a key or an id, and `has_plan` filter on the plan in force now;

{meterbase-0.4.0 → meterbase-0.4.1}/src/meterbase/_sync/client.py

@@ -130,6 +130,10 @@ class Meterbase:
         is waiting on, and answers in milliseconds when the engine is well.
         Decide what an `APITimeoutError` means here, failing open or closed,
         rather than waiting out the 35 s the writes are given.
+
+        `check` and `reserve` share the workspace's fair-use rate. Past it this
+        raises `RateLimitError` with `retry_after` in seconds and is not
+        retried, for the same reason: fail open or closed as on a timeout.
         """
         return self._api.request(
             "POST",

{meterbase-0.4.0 → meterbase-0.4.1}/src/meterbase/_sync/resources/customers.py

@@ -119,7 +119,7 @@ class Customers:
     ) -> Page[Customer]:
         """
         One page, newest first: `limit` customers, 100 unless set and at most
-        1,000. Pass the last `id` as `starting_after` for the next page, while
+        100. Pass the last `id` as `starting_after` for the next page, while
         `has_more` is `True`; `list_all` does that for you.
 
         `plan`, a key or an id, and `has_plan` filter on the plan in force now;

meterbase-0.4.1/src/meterbase/_version.py

@@ -0,0 +1 @@
+__version__ = "0.4.1"

{meterbase-0.4.0 → meterbase-0.4.1}/src/meterbase/errors.py

@@ -212,8 +212,13 @@ class IdempotencyKeyReusedError(ConflictError):
 
 
 class RateLimitError(APIError):
-    """`429`. A customer's rate limit is not one: `check` and `reserve` report
-    that as `allowed=False`."""
+    """`429 rate_limited`: `check` or `reserve` past the workspace's fair-use
+    rate, 10 a second on Free, 100 on Pro, 500 on Scale and 5 in a sandbox.
+    Nothing was checked or held. `reserve` retries it for you; `check` raises
+    at once, so fail open or closed as you would on a timeout.
+
+    A customer's rate limit is not one: `check` and `reserve` report that as
+    `allowed=False`."""
 
     retry_after: float | None
     """Seconds to wait, from `Retry-After`, when the engine sends one."""

meterbase-0.4.0/src/meterbase/_version.py

@@ -1 +0,0 @@
-__version__ = "0.4.0"