boxd 0.2.17.dev870__tar.gz → 0.2.18.dev892__tar.gz

{boxd-0.2.17.dev870/src/boxd.egg-info → boxd-0.2.18.dev892}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.2.17.dev870
+Version: 0.2.18.dev892
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT
@@ -266,6 +266,25 @@ holds are always admitted. Takes effect within a second and is not visible or
 changeable from inside the machine. A fork inherits its source's allowlist; a
 machine restored from a snapshot starts unrestricted.
 
+### Labels
+
+Labels are `key=value` tags for grouping and finding machines:
+
+```python
+m = boxd.machines.create("job-1", labels={"env": "prod", "run": "nightly"})
+m.labels                                                    # {"env": "prod", "run": "nightly"}
+boxd.machines.list(labels={"run": "nightly"})               # every pair must match
+boxd.machines.list(labels=["env=prod", "gpu"])              # "key=value", or "key" = has the key
+boxd.machines.update_labels("job-1", set={"owner": "ana"}, remove=["run"])
+boxd.machines.update_labels("job-1", {"env": "dev"}, replace_all=True)  # set the whole set
+```
+
+Keys are 1-63 characters of lowercase letters, digits, `.`, `_`, `/` and `-`,
+starting and ending with a letter or digit; the `boxd/` prefix is reserved.
+Values are up to 256 characters and may be empty. A machine holds at most 64
+labels. A fork or restore inherits its source's labels, and `labels=` on
+`fork` or `create(from_snapshot=...)` is merged over them.
+
 ### Sizing
 
 There are four sizes: 1 vCPU/4G, 2/8G, 4/16G, 8/32G. Name either dimension and

{boxd-0.2.17.dev870 → boxd-0.2.18.dev892}/README.md

@@ -234,6 +234,25 @@ holds are always admitted. Takes effect within a second and is not visible or
 changeable from inside the machine. A fork inherits its source's allowlist; a
 machine restored from a snapshot starts unrestricted.
 
+### Labels
+
+Labels are `key=value` tags for grouping and finding machines:
+
+```python
+m = boxd.machines.create("job-1", labels={"env": "prod", "run": "nightly"})
+m.labels                                                    # {"env": "prod", "run": "nightly"}
+boxd.machines.list(labels={"run": "nightly"})               # every pair must match
+boxd.machines.list(labels=["env=prod", "gpu"])              # "key=value", or "key" = has the key
+boxd.machines.update_labels("job-1", set={"owner": "ana"}, remove=["run"])
+boxd.machines.update_labels("job-1", {"env": "dev"}, replace_all=True)  # set the whole set
+```
+
+Keys are 1-63 characters of lowercase letters, digits, `.`, `_`, `/` and `-`,
+starting and ending with a letter or digit; the `boxd/` prefix is reserved.
+Values are up to 256 characters and may be empty. A machine holds at most 64
+labels. A fork or restore inherits its source's labels, and `labels=` on
+`fork` or `create(from_snapshot=...)` is merged over them.
+
 ### Sizing
 
 There are four sizes: 1 vCPU/4G, 2/8G, 4/16G, 8/32G. Name either dimension and

{boxd-0.2.17.dev870 → boxd-0.2.18.dev892}/pyproject.toml

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