boxd 0.2.13.dev750__tar.gz → 0.2.13.dev755__tar.gz

{boxd-0.2.13.dev750/src/boxd.egg-info → boxd-0.2.13.dev755}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.2.13.dev750
+Version: 0.2.13.dev755
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT
@@ -766,10 +766,11 @@ and admins only; an API key issued for the org works too.
 from datetime import datetime, timezone
 
 # One machine over its whole life, or pass since=/until= (datetime or unix
-# seconds). A deleted machine is found by its id.
+# seconds). A deleted machine is found by its id or name (org= says where to look).
 u = boxd.machines.usage("my-machine")
 u.seconds.running, u.seconds.standby, u.seconds.hibernated, u.seconds.stopped
 u.cost_micro / 1e6                   # estimated cost, in u.currency ("eur" | "usd")
+u.complete                           # True once all its usage is metered (see below)
 u.period.start, u.period.end
 u.vcpu_hours, u.ram_gib_hours, u.disk_gib_hours   # what the cost is priced on
 u.rates                              # ...at these rates, per unit-hour
@@ -780,19 +781,35 @@ r.total_cost_micro, r.currency
 for m in r.machines:
     print(m.name, m.status, m.cost_micro / 1e6)
 
-# The credit ledger: what was actually charged, newest first.
-for e in boxd.orgs.ledger(since=datetime(2026, 9, 1, tzinfo=timezone.utc)):
+# Billing activity: what was actually charged, newest first.
+for e in boxd.orgs.billing_activity(since=datetime(2026, 9, 1, tzinfo=timezone.utc)):
     print(e.created_at, e.kind, e.amount_micro / 1e6)   # charges are negative
 ```
 
+To record what a machine cost after deleting it, wait for `complete`:
+metering lags by up to ~25 minutes, so the figure read right after `delete()`
+is still growing.
+
+```python
+boxd.machines.delete(machine_id)
+# ...a little later, or from a periodic job:
+u = boxd.machines.usage(machine_id)
+if u.complete:
+    save(machine_id, u.cost_micro, u.currency)   # otherwise try again later
+```
+
+`orgs.usage()` carries the same flag on every machine, so one periodic call can
+settle all of them. A machine that still exists is never complete in a window
+that runs to now.
+
 Money is in micro-units (1e-6) of the org's currency. Usage is metered in
 15-minute buckets and priced at the org's current rates, so it is an estimate
-that tracks the ledger closely; the ledger is what was charged (one
+that tracks billing activity closely; billing activity is what was charged (one
 `usage_charge` per 15 minutes for the whole org, plus top-ups and grants).
 Machines deleted since still show up, with status `"deleted"`. A window spans
-at most 366 days. `orgs.ledger_page()` returns one page with its
+at most 366 days. `orgs.billing_activity_page()` returns one page with its
 `next_page_token` when you want to page by hand. The async client has the
-same methods (`async for e in boxd.orgs.ledger(): ...`).
+same methods (`async for e in boxd.orgs.billing_activity(): ...`).
 
 ## Errors
 

{boxd-0.2.13.dev750 → boxd-0.2.13.dev755}/README.md

@@ -734,10 +734,11 @@ and admins only; an API key issued for the org works too.
 from datetime import datetime, timezone
 
 # One machine over its whole life, or pass since=/until= (datetime or unix
-# seconds). A deleted machine is found by its id.
+# seconds). A deleted machine is found by its id or name (org= says where to look).
 u = boxd.machines.usage("my-machine")
 u.seconds.running, u.seconds.standby, u.seconds.hibernated, u.seconds.stopped
 u.cost_micro / 1e6                   # estimated cost, in u.currency ("eur" | "usd")
+u.complete                           # True once all its usage is metered (see below)
 u.period.start, u.period.end
 u.vcpu_hours, u.ram_gib_hours, u.disk_gib_hours   # what the cost is priced on
 u.rates                              # ...at these rates, per unit-hour
@@ -748,19 +749,35 @@ r.total_cost_micro, r.currency
 for m in r.machines:
     print(m.name, m.status, m.cost_micro / 1e6)
 
-# The credit ledger: what was actually charged, newest first.
-for e in boxd.orgs.ledger(since=datetime(2026, 9, 1, tzinfo=timezone.utc)):
+# Billing activity: what was actually charged, newest first.
+for e in boxd.orgs.billing_activity(since=datetime(2026, 9, 1, tzinfo=timezone.utc)):
     print(e.created_at, e.kind, e.amount_micro / 1e6)   # charges are negative
 ```
 
+To record what a machine cost after deleting it, wait for `complete`:
+metering lags by up to ~25 minutes, so the figure read right after `delete()`
+is still growing.
+
+```python
+boxd.machines.delete(machine_id)
+# ...a little later, or from a periodic job:
+u = boxd.machines.usage(machine_id)
+if u.complete:
+    save(machine_id, u.cost_micro, u.currency)   # otherwise try again later
+```
+
+`orgs.usage()` carries the same flag on every machine, so one periodic call can
+settle all of them. A machine that still exists is never complete in a window
+that runs to now.
+
 Money is in micro-units (1e-6) of the org's currency. Usage is metered in
 15-minute buckets and priced at the org's current rates, so it is an estimate
-that tracks the ledger closely; the ledger is what was charged (one
+that tracks billing activity closely; billing activity is what was charged (one
 `usage_charge` per 15 minutes for the whole org, plus top-ups and grants).
 Machines deleted since still show up, with status `"deleted"`. A window spans
-at most 366 days. `orgs.ledger_page()` returns one page with its
+at most 366 days. `orgs.billing_activity_page()` returns one page with its
 `next_page_token` when you want to page by hand. The async client has the
-same methods (`async for e in boxd.orgs.ledger(): ...`).
+same methods (`async for e in boxd.orgs.billing_activity(): ...`).
 
 ## Errors
 

{boxd-0.2.13.dev750 → boxd-0.2.13.dev755}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "boxd"
-version = "0.2.13.dev750"
+version = "0.2.13.dev755"
 description = "Python SDK for the boxd cloud VM platform"
 readme = "README.md"
 license = "MIT"

{boxd-0.2.13.dev750 → boxd-0.2.13.dev755}/src/boxd/__init__.py

@@ -53,8 +53,8 @@ from .models import (
     EnvVar,
     ExecResult,
     ExposedPort,
-    LedgerEntry,
-    LedgerPage,
+    BillingActivityEntry,
+    BillingActivityPage,
     Machine,
     MachineAccess,
     MachineIdle,
@@ -130,8 +130,8 @@ __all__ = [
     "EnvVar",
     "ExecResult",
     "ExposedPort",
-    "LedgerEntry",
-    "LedgerPage",
+    "BillingActivityEntry",
+    "BillingActivityPage",
     "Machine",
     "MachineAccess",
     "MachineIdle",