workwire 0.3.0__tar.gz → 0.4.0__tar.gz

{workwire-0.3.0 → workwire-0.4.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.4.0](https://github.com/workwire/workwire-python/compare/v0.3.0...v0.4.0) (2026-10-18)
+
+
+### Features
+
+* **WOR-471:** party jobs carry location_name, location_kind and location_path (backend v1.54.0) ([#20](https://github.com/workwire/workwire-python/issues/20)) ([14f1c08](https://github.com/workwire/workwire-python/commit/14f1c083a600747521087a3b4b572d44c69934ef))
+
 ## [0.3.0](https://github.com/workwire/workwire-python/compare/v0.2.0...v0.3.0) (2026-10-16)
 
 

{workwire-0.3.0 → workwire-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: workwire
-Version: 0.3.0
+Version: 0.4.0
 Summary: Official Python SDK for the Workwire API
 Project-URL: Homepage, https://github.com/workwire/workwire-python
 Project-URL: Changelog, https://github.com/workwire/workwire-python/blob/main/CHANGELOG.md
@@ -120,6 +120,11 @@ page = client.jobs.list(project=project.id)  # page.quantity_unit is your org's
 client.jobs.update(page.data[0].id, your_reference="PO-4471-A", quantity="12.5", checked=True)
 ```
 
+A party Job — each of `client.wires.retrieve(...).parties[i].jobs`, and the
+one `client.jobs.update` returns — carries `location_name`, `location_kind` and
+`location_path` (the ancestors, root first), so a sub reads its scope without
+the GC's tree; `client.jobs.list` rows had them already.
+
 Leave `scope_location_ids` out to scope a party to the whole project.
 `client.jobs.update` sends only the fields you pass: leave one out to keep
 it, pass `None` to clear it. Add to a tree later with

{workwire-0.3.0 → workwire-0.4.0}/README.md

@@ -97,6 +97,11 @@ page = client.jobs.list(project=project.id)  # page.quantity_unit is your org's
 client.jobs.update(page.data[0].id, your_reference="PO-4471-A", quantity="12.5", checked=True)
 ```
 
+A party Job — each of `client.wires.retrieve(...).parties[i].jobs`, and the
+one `client.jobs.update` returns — carries `location_name`, `location_kind` and
+`location_path` (the ancestors, root first), so a sub reads its scope without
+the GC's tree; `client.jobs.list` rows had them already.
+
 Leave `scope_location_ids` out to scope a party to the whole project.
 `client.jobs.update` sends only the fields you pass: leave one out to keep
 it, pass `None` to clear it. Add to a tree later with

{workwire-0.3.0 → workwire-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "workwire"
-version = "0.3.0"
+version = "0.4.0"
 description = "Official Python SDK for the Workwire API"
 readme = "README.md"
 license = "MIT"

{workwire-0.3.0 → workwire-0.4.0}/src/workwire/_models.py

@@ -171,14 +171,31 @@ class PO(WorkwireObject):
     created_at: str
 
 
+class JobPathLocation(WorkwireObject):
+    """One ancestor on a Job's ``location_path`` (a :class:`PartyJob`'s or a
+    :class:`JobRow`'s)."""
+
+    id: str
+    name: str
+    kind: str
+
+
 class PartyJob(WorkwireObject):
     """One Job on a wire party (``JOB-…``) — the party's work at one location
-    of its scope. ``your_reference``, ``quantity`` and ``checked_at`` are
-    **your org's own** fields, never the other side's."""
+    of its scope. ``location_name``, ``location_kind`` and ``location_path``
+    (the ancestors, root first; empty at the site root) are the server's
+    description of where the Job sits in the GC's tree; ``your_reference``,
+    ``quantity`` and ``checked_at`` are **your org's own** fields, never the
+    other side's."""
+
+    _nested = {"location_path": JobPathLocation}
 
     id: str
     display_id: str
     location_id: str
+    location_name: str
+    location_kind: str
+    location_path: list[JobPathLocation]
     your_reference: str | None
     quantity: str | None
     checked_at: str | None
@@ -334,14 +351,6 @@ class LocationBatch(list[Location]):
         return copy.deepcopy(self._data)
 
 
-class JobPathLocation(WorkwireObject):
-    """One ancestor on a Job row's ``location_path``."""
-
-    id: str
-    name: str
-    kind: str
-
-
 class JobMilestones(WorkwireObject):
     """A Job row's party milestone counts (repeated across the party's Jobs)."""