radicle-heartwood-lfs/crates/radicle-cli/examples/rad-patch-draft.md

5.1 KiB

Let's say we have some changes in a branch:

$ git checkout -b cloudhead/draft
$ git commit -a -m "Nothing to see here.." -q --allow-empty

To open a patch in draft mode, we use the --draft option:

$ git push -o patch.draft -o patch.message="Nothing yet" rad HEAD:refs/patches
✓ Patch 97e18f8598237a396a1c0ac1509c89028e666c97 drafted
To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
 * [new reference]   HEAD -> refs/patches

We can confirm it's a draft by running show:

$ rad patch show 97e18f8598237a396a1c0ac1509c89028e666c97
╭──────────────────────────────────────────────────────────╮
│ Title     Nothing yet                                    │
│ Patch     97e18f8598237a396a1c0ac1509c89028e666c97       │
│ Author    alice (you)                                    │
│ Head      2a465832b5a76abe25be44a3a5d224bbd7741ba7       │
│ Base      [..                                    ]       │
│ Branches  cloudhead/draft                                │
│ Commits   ahead 1, behind 0                              │
│ Status    draft                                          │
├──────────────────────────────────────────────────────────┤
│ 2a46583 Nothing to see here..                            │
├──────────────────────────────────────────────────────────┤
│ ● Revision 97e18f8 @ [..   ]..2a46583 by alice (you) now │
╰──────────────────────────────────────────────────────────╯

Once the patch is ready for review, we can use the ready command:

$ rad patch ready 97e18f8598237a396a1c0ac1509c89028e666c97 --no-announce
$ rad patch show 97e18f8598237a396a1c0ac1509c89028e666c97
╭──────────────────────────────────────────────────────────╮
│ Title     Nothing yet                                    │
│ Patch     97e18f8598237a396a1c0ac1509c89028e666c97       │
│ Author    alice (you)                                    │
│ Head      2a465832b5a76abe25be44a3a5d224bbd7741ba7       │
│ Base      [..                                    ]       │
│ Branches  cloudhead/draft                                │
│ Commits   ahead 1, behind 0                              │
│ Status    open                                           │
├──────────────────────────────────────────────────────────┤
│ 2a46583 Nothing to see here..                            │
├──────────────────────────────────────────────────────────┤
│ ● Revision 97e18f8 @ [..   ]..2a46583 by alice (you) now │
╰──────────────────────────────────────────────────────────╯

If for whatever reason, it needed to go back into draft mode, we could use the --undo flag:

$ rad patch ready --undo 97e18f8598237a396a1c0ac1509c89028e666c97 --no-announce
$ rad patch show 97e18f8598237a396a1c0ac1509c89028e666c97
╭──────────────────────────────────────────────────────────╮
│ Title     Nothing yet                                    │
│ Patch     97e18f8598237a396a1c0ac1509c89028e666c97       │
│ Author    alice (you)                                    │
│ Head      2a465832b5a76abe25be44a3a5d224bbd7741ba7       │
│ Base      [..                                    ]       │
│ Branches  cloudhead/draft                                │
│ Commits   ahead 1, behind 0                              │
│ Status    draft                                          │
├──────────────────────────────────────────────────────────┤
│ 2a46583 Nothing to see here..                            │
├──────────────────────────────────────────────────────────┤
│ ● Revision 97e18f8 @ [..   ]..2a46583 by alice (you) now │
╰──────────────────────────────────────────────────────────╯