Skip to content

Commit d841206

Browse files
timsaucerclaude
andcommitted
docs: scope upstream sync cargo update to datafusion family
Replace `cargo update -p datafusion` with an explicit multi-`-p` invocation listing every `datafusion-*` workspace dependency, so PR 1 of the upstream-sync workflow refreshes only the datafusion family and leaves other transitives for PR 2 to consolidate. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent c88a88a commit d841206

1 file changed

Lines changed: 26 additions & 2 deletions

File tree

dev/release/upstream-sync.md

Lines changed: 26 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,32 @@ build, test, and lint cleanly against it.
3838
1. Update the `datafusion` dependency in the root `Cargo.toml` (workspace
3939
section and dependencies). Any downstream `datafusion-*` crates pinned in
4040
`crates/core/Cargo.toml` should move to the matching version.
41-
2. Run `cargo update -p datafusion` (or `cargo update` for a broader refresh)
42-
so `Cargo.lock` reflects the new pin.
41+
2. Update `Cargo.lock` for the datafusion family only — leave unrelated
42+
transitives at their current pins so PR 2 can address them deliberately.
43+
List every `datafusion-*` workspace dependency with `-p`:
44+
45+
```bash
46+
cargo update \
47+
-p datafusion \
48+
-p datafusion-substrait \
49+
-p datafusion-proto \
50+
-p datafusion-ffi \
51+
-p datafusion-catalog \
52+
-p datafusion-common \
53+
-p datafusion-functions-aggregate \
54+
-p datafusion-functions-window \
55+
-p datafusion-expr
56+
```
57+
58+
Or pin exact versions with `--precise`, one crate at a time:
59+
60+
```bash
61+
cargo update -p datafusion --precise 54.0.0
62+
# repeat for each datafusion-* sibling
63+
```
64+
65+
A bare `cargo update` would refresh every transitive crate and blur the
66+
diff between PR 1 and PR 2.
4367
3. Run the standard build and test commands and address compilation errors,
4468
API renames, signature changes, and behavior changes:
4569
- `cargo build`

0 commit comments

Comments
 (0)