Struct Budget 

pub struct Budget { /* private fields */ }

How many calls an invocation may still make: D1 queries, fetches, KV and R2 operations, as the job counts them.

On the free plan a Worker invocation (a request, a queue batch, a cron run) may run 50 D1 queries and make 50 subrequests; past that the call fails. A job over many rows takes a budget, spends it per call, and stops early with a cursor to continue from (run_steps). Ocre does not count for you: take what each step is about to use.

Examples

use ocre::jobs::Budget;

let budget = Budget::new(Budget::FREE_D1_QUERIES - 5); // 5 for the rest of the job
assert!(budget.take(40));
assert!(!budget.take(10), "not enough left: nothing taken");
assert_eq!(budget.left(), 5);

Implementations

impl Budget

pub const FREE_D1_QUERIES: u32 = 50

D1 queries per invocation on the free plan: 50.

pub const FREE_SUBREQUESTS: u32 = 50

Subrequests (fetch) per invocation on the free plan: 50.

pub fn new(calls: u32) -> Self

A budget of calls.

pub fn take(&self, calls: u32) -> bool

Takes calls from the budget when that many are left; false (and nothing taken) otherwise.

pub fn left(&self) -> u32

The calls not taken yet.

Trait Implementations

impl Debug for Budget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.