heartwood/radicle-cli/examples/rad-patch.md at a6d59b3c0eeafe2d6fdff4b58e067c087c552a71

mirror of https://seed.radicle.dev/rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5.git synced 2026-11-13 15:00:46 +08:00

Files

T

Slack Coder a6d59b3c0e cli: alter use subcommands for patch

Make `rad patch` accept subcommands for specifying its operation in
place of the '--command' notation.

For instance `rad patch update` versus `rad patch --update`.  Also make
the default operation list active patches, replacing patch creation.
Patch creation is now done via `rad patch open`.

Make these changes in a way consistent with other commands like `rad
delegate`.

Add '--no-confirm' to patch to support this subcommand's documentation
test.

Signed-off-by: Slack Coder <slackcoder@server.ky>

2023-01-17 10:08:44 +01:00

1.7 KiB

Raw Blame History

When contributing to another's project, it is common for the contribution to be of many commits and involve a discussion with the project's maintainer. This is supported via Radicle's patches.

Here we give a brief overview for using patches in our hypothetical car scenario. It turns out instructions containing the power requirements were missing from the project.

$ git checkout -b flux-capacitor-power
$ touch README.md

Here the instructions are added to the project's README for 1.21 gigawatts and commit the changes to git.

$ git add README.md
$ git commit -m "Define power requirements"
[flux-capacitor-power 7939a9e] Define power requirements
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 README.md

Once the code is ready, we open (or create) a patch with our changes for the project.

$ rad patch open --message "define power requirements" --no-confirm

🌱 Creating patch for heartwood

ok Pushing HEAD to storage...
ok Analyzing remotes...

z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi/master (cdf76ce) <- z6MknSL…StBU8Vi/flux-capacitor-power (7939a9e)
1 commit(s) ahead, 0 commit(s) behind

7939a9e Define power requirements


╭─ define power requirements ───────

No description provided.

╰───────────────────────────────────


ok Patch 3b1f58414e51266d7621203554a63eaee242b744 created 🌱

It will now be listed as one of the project's open patches.

$ rad patch

 YOU PROPOSED

define power requirements 3b1f58414e5 R0 7939a9e (flux-capacitor-power) ahead 1, behind 0
└─ * opened by z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi (you) [..]

 OTHERS PROPOSED

Nothing to show.

1.7 KiB Raw Blame History

1.7 KiB

Raw Blame History