Maëlle Salmon

Other life-changing tip for today: use pr_fetch() to check out the PR of a collaborator locally. 😌

https://usethis.r-lib.org/reference/pull-requests.html

#RStats

Helpers for GitHub pull requests — pull-requests

The pr_* family of functions is designed to make working with GitHub pull requests (PRs) as painless as possible for both contributors and package maintainers. To use the pr_* functions, your project must be a Git repo and have one of these GitHub remote configurations: "ours": You can push to the GitHub remote configured as origin and it's not a fork. "fork": You can push to the GitHub remote configured as origin, it's a fork, and its parent is configured as upstream. origin points to your personal copy and upstream points to the source repo. "Ours" and "fork" are two of several GitHub remote configurations examined in Common remote setups in Happy Git and GitHub for the useR. The Pull Request Helpers article walks through the process of making a pull request with the pr_* functions. The pr_* functions also use your Git/GitHub credentials to carry out various remote operations; see below for more about auth. The pr_* functions also proactively check for agreement re: the default branch in your local repo and the source repo. See git_default_branch() for more.

Sep 28, 2023 at 11:52amWeb
Show threadJon HarmonSep 28, 2023
@maelle I know you linked to them, but the whole `usethis::pr_*()` family is 🥇
pr_init() (cleanly start)
pr_pause() (work on something else in this repo)
pr_resume() (after pr_pausing)
pr_push() (push your work/create the actual remote PR)
pr_finish() (clean up when you're done)
pr_forget() (clean up something you won't finish)
pr_fetch() (get someone else's work for editing or review)
pr_merge_main() (merge main into what you're working on)
Show threadMaëlle SalmonSep 28, 2023
@jonthegeek yes! although for some (bad?) reason I tend to use {gert} + the GitHub interface + RefinedGitHub for most things. 😅 I need to try them out more.
Show threadJon HarmonSep 28, 2023
@maelle I used to be the same (well, RStudio GitHub interface + GitHub.com interface + some hand-rolled stuff at old job), but once you buy into the full suite everything gets easier 😊
Show threadJon HarmonSep 28, 2023
@maelle An important note on this: since the helpers make sure you're up-to-date with the origin before creating the PR, often the person for whom they make things easier is *whoever is reviewing your PR.*
Show threadEric R. ScottSep 28, 2023
@jonthegeek @maelle I still haven't used pr_pause() or pr_resume(), but the others are now my main way of working with branches!
Show threadJon HarmonSep 28, 2023
@LeafyEricScott @maelle I've used each once or twice, I think, but it's nice to know I can go fix a different thing if I get deep into the weeds on something.
Show threadShannon PileggiSep 28, 2023
@maelle the ONLY way I review pr's!! 🙌