mirror of
https://seed.radicle.dev/rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5.git
synced 2026-11-21 18:40:39 +08:00
Similar to the `Fetcher` sans-IO approach, an `Announcer` sans-IO approach is introduced. The previous `Handler::announce` was already quite close to using a sans-IO approach, but using internally held state. This change makes the business logic more reusable – and testable. Similarly to the `Fetcher`, the `Announcer` is configured and then driven by telling it when nodes have been synchronized with. It will continuously check if it has reached its target, yielding to the caller to decide whether to keep going. In contrast, it also provides a way to mark the process as timed out, since announcing relies on waiting for events to come back in a timely manner.
96 lines
3.2 KiB
Markdown
96 lines
3.2 KiB
Markdown
A common workflow is to use `rad patch checkout` to view a
|
|
collaborator's changes. So, first off, we create a patch:
|
|
|
|
``` ~alice
|
|
$ git checkout -b flux-capacitor-power
|
|
$ touch REQUIREMENTS
|
|
$ git add REQUIREMENTS
|
|
$ git commit -v -m "Define power requirements"
|
|
[flux-capacitor-power 3e674d1] Define power requirements
|
|
1 file changed, 0 insertions(+), 0 deletions(-)
|
|
create mode 100644 REQUIREMENTS
|
|
```
|
|
|
|
``` ~alice (stderr)
|
|
$ git push rad -o patch.message="Define power requirements" -o patch.message="See details." HEAD:refs/patches
|
|
✓ Patch aa45913e757cacd46972733bddee5472c78fa32a opened
|
|
✓ Synced with 1 seed(s)
|
|
To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
|
|
* [new reference] HEAD -> refs/patches
|
|
```
|
|
|
|
On the other end, Bob uses `rad patch checkout` to view the patch:
|
|
|
|
``` ~bob
|
|
$ cd heartwood
|
|
$ rad sync -f
|
|
Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from the network, found 1 potential seed(s).
|
|
✓ Target met: 1 seed(s)
|
|
🌱 Fetched from z6MknSL…StBU8Vi
|
|
$ rad patch checkout aa45913 --name alice-init
|
|
✓ Switched to branch alice-init at revision aa45913
|
|
✓ Branch alice-init setup to track rad/patches/aa45913e757cacd46972733bddee5472c78fa32a
|
|
```
|
|
|
|
Meanwhile, we may see some more changes that we need to make, so we
|
|
add a `README.md`:
|
|
|
|
``` ~alice
|
|
$ touch README.md
|
|
$ git add README.md
|
|
$ git commit --message "Add README, just for the fun"
|
|
[flux-capacitor-power 27857ec] Add README, just for the fun
|
|
1 file changed, 0 insertions(+), 0 deletions(-)
|
|
create mode 100644 README.md
|
|
```
|
|
|
|
``` ~alice (stderr)
|
|
$ git push rad -o patch.message="Add README, just for the fun"
|
|
✓ Patch aa45913 updated to revision 3156bed9d64d4675d6cf56612d217fc5f4e8a53a
|
|
To compare against your previous revision aa45913, run:
|
|
|
|
git range-diff f2de534[..] 3e674d1[..] 27857ec[..]
|
|
|
|
✓ Synced with 1 seed(s)
|
|
To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
|
|
3e674d1..27857ec flux-capacitor-power -> patches/aa45913e757cacd46972733bddee5472c78fa32a
|
|
```
|
|
|
|
Bob fetches these new changes and can see their branch is now behind:
|
|
|
|
``` ~bob (stderr)
|
|
$ git fetch rad
|
|
From rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji
|
|
3e674d1..27857ec patches/aa45913e757cacd46972733bddee5472c78fa32a -> rad/patches/aa45913e757cacd46972733bddee5472c78fa32a
|
|
```
|
|
|
|
``` ~bob
|
|
$ git status
|
|
On branch alice-init
|
|
Your branch is behind 'rad/patches/aa45913e757cacd46972733bddee5472c78fa32a' by 1 commit, and can be fast-forwarded.
|
|
(use "git pull" to update your local branch)
|
|
|
|
nothing to commit, working tree clean
|
|
```
|
|
|
|
If Bob was to run `rad patch checkout` again, it would error.
|
|
This is because the branch already exists and `rad` does not want to
|
|
overwrite any changes. Bob can choose to use the `--force` (`-f`) flag to
|
|
ensure that they are looking at the latest changes:
|
|
|
|
``` ~bob (fail)
|
|
$ rad patch checkout aa45913 --name alice-init
|
|
✗ Performing checkout... <canceled>
|
|
✗ Error: branch 'alice-init' already exists (use `--force` to overwrite)
|
|
```
|
|
|
|
``` ~bob
|
|
$ rad patch checkout aa45913 -f --name alice-init
|
|
✓ Switched to branch alice-init at revision 3156bed
|
|
$ git status
|
|
On branch alice-init
|
|
Your branch is up to date with 'rad/patches/aa45913e757cacd46972733bddee5472c78fa32a'.
|
|
|
|
nothing to commit, working tree clean
|
|
```
|