From a80464c653f75216ef4cd1b7663218293b1aabbf Mon Sep 17 00:00:00 2001
From: krlmlr <krlmlr@users.noreply.github.com>
Date: Wed, 25 Dec 2024 21:02:32 +0000
Subject: [PATCH] Built site for fledge@0.1.99.9036: 6524d18

---
 dev/articles/auto.html                   |  2 +-
 dev/articles/demo.html                   | 70 ++++++++++++------------
 dev/articles/fledge.html                 |  6 +-
 dev/articles/index.html                  |  2 +-
 dev/articles/internals.html              |  6 +-
 dev/authors.html                         |  6 +-
 dev/index.html                           |  2 +-
 dev/news/index.html                      | 51 ++++++++++++++++-
 dev/pkgdown.yml                          |  4 +-
 dev/reference/bump_version.html          |  4 +-
 dev/reference/commit_version.html        |  4 +-
 dev/reference/create_demo_project.html   |  2 +-
 dev/reference/finalize_version.html      |  4 +-
 dev/reference/get_last_tag.html          | 10 ++--
 dev/reference/get_last_version_tag.html  | 12 ++--
 dev/reference/get_top_level_commits.html | 10 ++--
 dev/reference/index.html                 |  2 +-
 dev/reference/release.html               |  2 +-
 dev/reference/tag_version.html           |  6 +-
 dev/reference/unbump_version.html        |  4 +-
 dev/reference/update_news.html           |  6 +-
 dev/reference/update_version.html        |  6 +-
 dev/reference/with_demo_project.html     |  4 +-
 dev/search.json                          |  2 +-
 24 files changed, 141 insertions(+), 86 deletions(-)

diff --git a/dev/articles/auto.html b/dev/articles/auto.html
index f85debf7..912643e7 100644
--- a/dev/articles/auto.html
+++ b/dev/articles/auto.html
@@ -28,7 +28,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/demo.html b/dev/articles/demo.html
index 9c2b9a03..2fe60e77 100644
--- a/dev/articles/demo.html
+++ b/dev/articles/demo.html
@@ -28,7 +28,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -107,15 +107,17 @@ <h3 id="create-a-package">Create a package<a class="anchor" aria-label="anchor"
 project ready for development.</p>
 <div class="sourceCode" id="cb1"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">pkg</span> <span class="op">&lt;-</span> <span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/create_package.html" class="external-link">create_package</a></span><span class="op">(</span><span class="st">"tea"</span><span class="op">)</span></span></code></pre></div>
+<pre><code><span><span class="co">## Error in get(paste0(generic, ".", class), envir = get_method_env()) : </span></span>
+<span><span class="co">##   object 'type_sum.accel' not found</span></span></code></pre>
 <p>In an interactive RStudio session, a new window opens and you would
 work there. Users of other environments would change the working
 directory manually. For this demo, we manually set the active
 project.</p>
-<div class="sourceCode" id="cb2"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb3"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/proj_utils.html" class="external-link">proj_set</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>
 <p>The infrastructure files and directories that comprise a minimal R
 package are created:</p>
-<div class="sourceCode" id="cb3"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">fs</span><span class="fu">::</span><span class="fu"><a href="https://fs.r-lib.org/reference/dir_ls.html" class="external-link">dir_ls</a></span><span class="op">(</span><span class="op">)</span></span>
 <span><span class="co">## DESCRIPTION NAMESPACE   R           tea.Rproj</span></span></code></pre></div>
 </div>
@@ -126,7 +128,7 @@ <h3 id="create-and-configure-a-git-repository">Create and configure a Git reposi
 repository for the package. We achieved this with gert code.</p>
 <p>You could use <code><a href="https://usethis.r-lib.org/reference/use_git.html" class="external-link">usethis::use_git()</a></code> function that creates
 an initial commit, and the repository is in a clean state.</p>
-<div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="co"># Number of commits until now</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/nrow.html" class="external-link">nrow</a></span><span class="op">(</span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_log</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span>
 <span><span class="co">## [1] 1</span></span>
@@ -136,7 +138,7 @@ <h3 id="create-and-configure-a-git-repository">Create and configure a Git reposi
 <span><span class="co">## # ℹ 3 variables: file &lt;chr&gt;, status &lt;chr&gt;, staged &lt;lgl&gt;</span></span></code></pre></div>
 <p>For working in branches, it is recommended to turn off fast-forward
 merging:</p>
-<div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb6"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_config.html" class="external-link">git_config_set</a></span><span class="op">(</span><span class="st">"merge.ff"</span>, <span class="st">"false"</span><span class="op">)</span></span>
 <span><span class="co"># gert::git_config_global_set("merge.ff", "false") # to set globally</span></span></code></pre></div>
 <p>An alternative is to use squash commits.</p>
@@ -146,7 +148,7 @@ <h3 id="create-and-configure-a-git-repository">Create and configure a Git reposi
 <p>We create two functions to show the contents and tags of the remote.
 In real life, you’d probably simply browse the GitHub interface for
 instance!</p>
-<div class="sourceCode" id="cb6"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb7"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">show_files</span> <span class="op">&lt;-</span> <span class="kw">function</span><span class="op">(</span><span class="va">remote_url</span><span class="op">)</span> <span class="op">{</span></span>
 <span>  <span class="va">tempdir_remote</span> <span class="op">&lt;-</span> <span class="fu">withr</span><span class="fu">::</span><span class="fu"><a href="https://withr.r-lib.org/reference/with_tempfile.html" class="external-link">local_tempdir</a></span><span class="op">(</span>pattern <span class="op">=</span> <span class="st">"remote"</span><span class="op">)</span></span>
 <span>  <span class="fu">withr</span><span class="fu">::</span><span class="fu"><a href="https://withr.r-lib.org/reference/with_dir.html" class="external-link">with_dir</a></span><span class="op">(</span><span class="va">tempdir_remote</span>, <span class="op">{</span></span>
@@ -172,22 +174,22 @@ <h3 id="create-initial-news-md-file">Create initial NEWS.md file<a class="anchor
 </h3>
 <p>An initial NEWS file can be created with
 <code><a href="https://usethis.r-lib.org/reference/use_news_md.html" class="external-link">usethis::use_news_md()</a></code>.</p>
-<div class="sourceCode" id="cb7"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb8"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/use_news_md.html" class="external-link">use_news_md</a></span><span class="op">(</span><span class="op">)</span></span>
 <span><span class="co">## ✔ Writing 'NEWS.md'.</span></span></code></pre></div>
 <p>Let’s take a look at the contents:</p>
-<div class="sourceCode" id="cb8"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb9"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">news</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/readLines.html" class="external-link">readLines</a></span><span class="op">(</span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/proj_utils.html" class="external-link">proj_path</a></span><span class="op">(</span><span class="st">"NEWS.md"</span><span class="op">)</span><span class="op">)</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/cat.html" class="external-link">cat</a></span><span class="op">(</span><span class="va">news</span>, sep <span class="op">=</span> <span class="st">"\n"</span><span class="op">)</span></span>
 <span><span class="co">## # tea (development version)</span></span>
 <span><span class="co">## </span></span>
 <span><span class="co">## * Added a `NEWS.md` file to track changes to the package.</span></span></code></pre></div>
 <p>This file needs to be tracked by Git:</p>
-<div class="sourceCode" id="cb9"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb10"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"NEWS.md"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_commit</a></span><span class="op">(</span><span class="st">"Initial NEWS.md ."</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_fetch.html" class="external-link">git_push</a></span><span class="op">(</span>remote <span class="op">=</span> <span class="st">"origin"</span><span class="op">)</span></span></code></pre></div>
-<div class="sourceCode" id="cb10"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb11"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">show_files</span><span class="op">(</span><span class="va">remote_url</span><span class="op">)</span></span>
 <span><span class="co">## remote/DESCRIPTION remote/NAMESPACE   remote/NEWS.md     remote/tea.Rproj</span></span></code></pre></div>
 <div class="alert alert-info">
@@ -204,7 +206,7 @@ <h3 id="create-an-r-file">Create an R file<a class="anchor" aria-label="anchor"
 <p>Now we start coding in the functionality for the package. We start by
 creating the new R file called <code>cup.R</code> and adding code (well
 only a comment).</p>
-<div class="sourceCode" id="cb11"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb12"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/use_r.html" class="external-link">use_r</a></span><span class="op">(</span><span class="st">"cup"</span><span class="op">)</span></span>
 <span><span class="co">## ☐ Edit 'R/cup.R'.</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/writeLines.html" class="external-link">writeLines</a></span><span class="op">(</span><span class="st">"# cup"</span>, <span class="st">"R/cup.R"</span><span class="op">)</span></span></code></pre></div>
@@ -218,11 +220,11 @@ <h3 id="create-an-r-file">Create an R file<a class="anchor" aria-label="anchor"
 <p>It does not matter how and where you type the commit message (gert in
 R, RStudio Git window, command line, VSCode, etc.). What’s important is
 the content of the commit message.</p>
-<div class="sourceCode" id="cb12"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb13"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"R/cup.R"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_commit</a></span><span class="op">(</span><span class="st">"- New cup_of_tea() function makes it easy to drink a cup of tee."</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_fetch.html" class="external-link">git_push</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>
-<div class="sourceCode" id="cb13"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb14"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">show_files</span><span class="op">(</span><span class="va">remote_url</span><span class="op">)</span></span>
 <span><span class="co">## remote/DESCRIPTION remote/NAMESPACE   remote/NEWS.md     remote/R           </span></span>
 <span><span class="co">## remote/R/cup.R     remote/tea.Rproj</span></span></code></pre></div>
@@ -232,7 +234,7 @@ <h3 id="create-a-test">Create a test<a class="anchor" aria-label="anchor" href="
 </h3>
 <p>The code in <code>cup.R</code> warrants a test (at least it would if
 it were actual code!):</p>
-<div class="sourceCode" id="cb14"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb15"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/use_r.html" class="external-link">use_test</a></span><span class="op">(</span><span class="st">"cup"</span><span class="op">)</span></span>
 <span><span class="co">## ✔ Adding testthat to 'Suggests' field in DESCRIPTION.</span></span>
 <span><span class="co">## ✔ Adding "3" to 'Config/testthat/edition'.</span></span>
@@ -247,13 +249,13 @@ <h3 id="create-a-test">Create a test<a class="anchor" aria-label="anchor" href="
 <p>In a real project we would substitute the testing code from the
 template by real tests. In this demo we commit straight away,
 <strong>again with a bulleted message</strong>.</p>
-<div class="sourceCode" id="cb15"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb16"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"DESCRIPTION"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"tests/testthat.R"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"tests/testthat/test-cup.R"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_commit</a></span><span class="op">(</span><span class="st">"- Add tests for cup of tea."</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_fetch.html" class="external-link">git_push</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>
-<div class="sourceCode" id="cb16"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb17"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">show_files</span><span class="op">(</span><span class="va">remote_url</span><span class="op">)</span></span>
 <span><span class="co">## remote/DESCRIPTION               remote/NAMESPACE                 </span></span>
 <span><span class="co">## remote/NEWS.md                   remote/R                         </span></span>
@@ -266,7 +268,7 @@ <h3 id="update-news-md">Update NEWS.md<a class="anchor" aria-label="anchor" href
 </h3>
 <p>Let us look at the commit history until now. You might use any Git
 tool you want to consult it, we use gert.</p>
-<div class="sourceCode" id="cb17"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb18"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="co"># Only show number of files, messages</span></span>
 <span><span class="fu">knitr</span><span class="fu">::</span><span class="fu"><a href="https://rdrr.io/pkg/knitr/man/kable.html" class="external-link">kable</a></span><span class="op">(</span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_log</a></span><span class="op">(</span><span class="op">)</span><span class="op">[</span><span class="op">-</span><span class="op">(</span><span class="fl">1</span><span class="op">:</span><span class="fl">3</span><span class="op">)</span><span class="op">]</span><span class="op">)</span></span></code></pre></div>
 <table class="table">
@@ -310,7 +312,7 @@ <h3 id="update-news-md">Update NEWS.md<a class="anchor" aria-label="anchor" href
 <p>We use <code><a href="../reference/bump_version.html">fledge::bump_version()</a></code> to assign a new dev
 version number to the package and also update <code>NEWS.md</code>.</p>
 <p>The current version number of our package is 0.0.0.9000.</p>
-<div class="sourceCode" id="cb18"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb19"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="../reference/bump_version.html">bump_version</a></span><span class="op">(</span><span class="op">)</span></span>
 <span><span class="co">## → Digesting messages from 4 commits.</span></span>
 <span><span class="co">## ✔ Found 2 NEWS-worthy entries.</span></span>
@@ -343,7 +345,7 @@ <h3 id="update-news-md">Update NEWS.md<a class="anchor" aria-label="anchor" href
 <h3 id="review-news-md">Review NEWS.md<a class="anchor" aria-label="anchor" href="#review-news-md"></a>
 </h3>
 <p>Let us see what <code>NEWS.md</code> looks like after that bump.</p>
-<div class="sourceCode" id="cb19"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb20"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">news</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/readLines.html" class="external-link">readLines</a></span><span class="op">(</span><span class="st">"NEWS.md"</span><span class="op">)</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/cat.html" class="external-link">cat</a></span><span class="op">(</span><span class="va">news</span>, sep <span class="op">=</span> <span class="st">"\n"</span><span class="op">)</span></span>
 <span><span class="co">## &lt;!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --&gt;</span></span>
@@ -364,7 +366,7 @@ <h3 id="review-news-md">Review NEWS.md<a class="anchor" aria-label="anchor" href
 can… if you do it right! Read on.</p>
 </div>
 <p>Let’s fix the typo, which you’d do by hand.</p>
-<div class="sourceCode" id="cb20"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb21"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">news</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/grep.html" class="external-link">gsub</a></span><span class="op">(</span><span class="st">"tee"</span>, <span class="st">"tea"</span>, <span class="va">news</span><span class="op">)</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/cat.html" class="external-link">cat</a></span><span class="op">(</span><span class="va">news</span>, sep <span class="op">=</span> <span class="st">"\n"</span><span class="op">)</span></span>
 <span><span class="co">## &lt;!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --&gt;</span></span>
@@ -394,7 +396,7 @@ <h3 id="finalize-version">Finalize version<a class="anchor" aria-label="anchor"
 <code>NEWS.md</code> is manually updated. Note that it should be called
 after <code><a href="../reference/bump_version.html">fledge::bump_version()</a></code>, an error is raised if another
 commit has been added after that.</p>
-<div class="sourceCode" id="cb21"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb22"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">show_tags</span><span class="op">(</span><span class="va">remote_url</span><span class="op">)</span></span>
 <span><span class="co">## # A tibble: 0 × 2</span></span>
 <span><span class="co">## # ℹ 2 variables: name &lt;chr&gt;, ref &lt;chr&gt;</span></span>
@@ -414,7 +416,7 @@ <h3 id="finalize-version">Finalize version<a class="anchor" aria-label="anchor"
 <span><span class="co">##   &lt;chr&gt;       &lt;chr&gt;                </span></span>
 <span><span class="co">## 1 v0.0.0.9001 refs/tags/v0.0.0.9001</span></span></code></pre></div>
 <p>Let’s look at NEWS.md now:</p>
-<div class="sourceCode" id="cb22"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb23"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">news</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/readLines.html" class="external-link">readLines</a></span><span class="op">(</span><span class="st">"NEWS.md"</span><span class="op">)</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/cat.html" class="external-link">cat</a></span><span class="op">(</span><span class="va">news</span>, sep <span class="op">=</span> <span class="st">"\n"</span><span class="op">)</span></span>
 <span><span class="co">## &lt;!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --&gt;</span></span>
@@ -438,24 +440,24 @@ <h3 id="change-code-and-commit">Change code and commit<a class="anchor" aria-lab
 requires changes to the code, and perhaps a new test. We create a branch
 (whose name starts with a “f” for “feature”) and switch to this branch
 to implement this.</p>
-<div class="sourceCode" id="cb23"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb24"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_branch.html" class="external-link">git_branch_create</a></span><span class="op">(</span><span class="st">"f-bowl"</span>, checkout <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></code></pre></div>
 <p>On the branch, separate commits are used for the tests and the
 implementation. These commit messages do not need to be formatted
 specially, because {fledge} will ignore them anyway.</p>
 <p>This time we write the tests first, test-driven development.</p>
-<div class="sourceCode" id="cb24"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb25"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/use_r.html" class="external-link">use_test</a></span><span class="op">(</span><span class="st">"bowl"</span><span class="op">)</span></span>
 <span><span class="co">## ✔ Writing 'tests/testthat/test-bowl.R'.</span></span>
 <span><span class="co">## ☐ Edit 'tests/testthat/test-bowl.R'.</span></span></code></pre></div>
-<div class="sourceCode" id="cb25"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb26"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"tests/testthat/test-bowl.R"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_commit</a></span><span class="op">(</span><span class="st">"Add bowl tests."</span><span class="op">)</span></span></code></pre></div>
-<div class="sourceCode" id="cb26"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb27"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">usethis</span><span class="fu">::</span><span class="fu"><a href="https://usethis.r-lib.org/reference/use_r.html" class="external-link">use_r</a></span><span class="op">(</span><span class="st">"bowl"</span><span class="op">)</span></span>
 <span><span class="co">## ☐ Edit 'R/bowl.R'.</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/writeLines.html" class="external-link">writeLines</a></span><span class="op">(</span><span class="st">"# bowl of tea"</span>, <span class="st">"R/bowl.R"</span><span class="op">)</span></span></code></pre></div>
-<div class="sourceCode" id="cb27"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb28"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_add</a></span><span class="op">(</span><span class="st">"R/bowl.R"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_commit.html" class="external-link">git_commit</a></span><span class="op">(</span><span class="st">"Add bowl implementation."</span><span class="op">)</span></span></code></pre></div>
 <p>This branch can be pushed to the remote as usual. Only when merging
@@ -467,7 +469,7 @@ <h3 id="change-code-and-commit">Change code and commit<a class="anchor" aria-lab
 this.&lt;/p&gt;'><sup>1</sup></a>
 You might be used to doing the merges on a remote (e.g. GitHub pull
 requests) but here we demonstrate a local merge commit.</p>
-<div class="sourceCode" id="cb28"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb29"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_branch.html" class="external-link">git_branch_checkout</a></span><span class="op">(</span><span class="st">"main"</span><span class="op">)</span></span>
 <span><span class="fu">gert</span><span class="fu">::</span><span class="fu"><a href="https://docs.ropensci.org/gert/reference/git_merge.html" class="external-link">git_merge</a></span><span class="op">(</span><span class="st">"f-bowl"</span>, commit <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span></span>
 <span><span class="co">## Merge was not committed due to merge conflict(s). Please fix and run git_commit() or git_merge_abort()</span></span>
@@ -477,7 +479,7 @@ <h3 id="change-code-and-commit">Change code and commit<a class="anchor" aria-lab
 indicate the items to include in <code>NEWS.md</code>.</p>
 <p>Now that we have added bowl support to our package, it is time to
 bump the version again.</p>
-<div class="sourceCode" id="cb29"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb30"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="../reference/bump_version.html">bump_version</a></span><span class="op">(</span><span class="op">)</span></span>
 <span><span class="co">## → Digesting messages from 1 commits.</span></span>
 <span><span class="co">## ✔ Found 1 NEWS-worthy entry.</span></span>
@@ -542,7 +544,7 @@ <h3 id="bump-version-for-release">Bump version for release<a class="anchor" aria
 <p>We wish to release this package as a patch and so we use
 <code><a href="../reference/bump_version.html">fledge::bump_version()</a></code> with the “patch” argument. Other
 values for the arguments are “dev” (default), “minor” and “major”.</p>
-<div class="sourceCode" id="cb30"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb31"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="../reference/bump_version.html">bump_version</a></span><span class="op">(</span><span class="st">"patch"</span><span class="op">)</span></span>
 <span><span class="co">## → Digesting messages from 1 commits.</span></span>
 <span><span class="co">## ℹ Same as previous version.</span></span>
@@ -567,7 +569,7 @@ <h3 id="generate-release-notes">Generate release notes<a class="anchor" aria-lab
 </h3>
 <p>We review the <code>NEWS.md</code> that were generated by
 {fledge}:</p>
-<div class="sourceCode" id="cb31"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb32"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">news</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/readLines.html" class="external-link">readLines</a></span><span class="op">(</span><span class="st">"NEWS.md"</span><span class="op">)</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/cat.html" class="external-link">cat</a></span><span class="op">(</span><span class="va">news</span>, sep <span class="op">=</span> <span class="st">"\n"</span><span class="op">)</span></span>
 <span><span class="co">## &lt;!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --&gt;</span></span>
@@ -616,7 +618,7 @@ <h3 id="tag-version">Tag version<a class="anchor" aria-label="anchor" href="#tag
 </h3>
 <p>It is now the time to tag the released version using the
 <code><a href="../reference/tag_version.html">fledge::tag_version()</a></code> function.</p>
-<div class="sourceCode" id="cb32"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb33"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="../reference/tag_version.html">tag_version</a></span><span class="op">(</span><span class="op">)</span></span>
 <span><span class="co">## </span></span>
 <span><span class="co">## ── Tagging Version ──</span></span>
@@ -644,7 +646,7 @@ <h3 id="restart-development">Restart development<a class="anchor" aria-label="an
 </h3>
 <p>We will now make the package ready for future development. The
 <code><a href="../reference/bump_version.html">fledge::bump_version()</a></code> takes care of it.</p>
-<div class="sourceCode" id="cb33"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb34"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="../reference/bump_version.html">bump_version</a></span><span class="op">(</span><span class="op">)</span></span>
 <span><span class="co">## → Digesting messages from 1 commits.</span></span>
 <span><span class="co">## ℹ Same as previous version.</span></span>
@@ -667,7 +669,7 @@ <h3 id="restart-development">Restart development<a class="anchor" aria-label="an
 <p>Push to remote, add features with relevant commits (after mergining a
 branch or not), <code><a href="../reference/bump_version.html">bump_version()</a></code>, etc. Happy development, and
 happy smooth filling of the changelog!</p>
-<div class="sourceCode" id="cb34"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb35"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/base/unlink.html" class="external-link">unlink</a></span><span class="op">(</span><span class="va">parent_dir</span>, recursive <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></code></pre></div>
 </div>
 </div>
diff --git a/dev/articles/fledge.html b/dev/articles/fledge.html
index 223efb01..b05e1f40 100644
--- a/dev/articles/fledge.html
+++ b/dev/articles/fledge.html
@@ -28,7 +28,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -77,7 +77,9 @@ <h1>Get started with fledge</h1>
     
     
 <div class="sourceCode" id="cb1"><pre class="downlit sourceCode r">
-<code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://fledge.cynkra.com/">fledge</a></span><span class="op">)</span></span></code></pre></div>
+<code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://fledge.cynkra.com/">fledge</a></span><span class="op">)</span></span>
+<span><span class="co">#&gt; Error in get(paste0(generic, ".", class), envir = get_method_env()) : </span></span>
+<span><span class="co">#&gt;   object 'type_sum.accel' not found</span></span></code></pre></div>
 <p>Do you want to provide a changelog (<a href="https://blog.r-hub.io/2020/05/08/pkg-news/#why-write-the-changelog-as-newsmd" class="external-link">NEWS.md</a>)
 more informative than “bug fixes and performance improvements”
 (<code>https://twitter.com/EmilyKager/status/1413628436984188933</code>)
diff --git a/dev/articles/index.html b/dev/articles/index.html
index f0d92113..03ae3512 100644
--- a/dev/articles/index.html
+++ b/dev/articles/index.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/internals.html b/dev/articles/internals.html
index 25656d75..0c63fa66 100644
--- a/dev/articles/internals.html
+++ b/dev/articles/internals.html
@@ -28,7 +28,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -77,7 +77,9 @@ <h1>Fledge internals</h1>
     
     
 <div class="sourceCode" id="cb1"><pre class="downlit sourceCode r">
-<code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://fledge.cynkra.com/">fledge</a></span><span class="op">)</span></span></code></pre></div>
+<code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://fledge.cynkra.com/">fledge</a></span><span class="op">)</span></span>
+<span><span class="co">#&gt; Error in get(paste0(generic, ".", class), envir = get_method_env()) : </span></span>
+<span><span class="co">#&gt;   object 'type_sum.accel' not found</span></span></code></pre></div>
 <div class="section level2">
 <h2 id="implementation">Implementation<a class="anchor" aria-label="anchor" href="#implementation"></a>
 </h2>
diff --git a/dev/authors.html b/dev/authors.html
index 46df4ed9..df20f500 100644
--- a/dev/authors.html
+++ b/dev/authors.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -61,14 +61,14 @@ <h2 id="citation">Citation</h2>
 
       <p>Müller K, Schratz P (2024).
 <em>fledge: Smoother Change Tracking and Versioning for R Packages</em>.
-R package version 0.1.99.9035,
+R package version 0.1.99.9036,
 https://github.com/cynkra/fledge, <a href="https://fledge.cynkra.com/">https://fledge.cynkra.com/</a>.
 </p>
       <pre>@Manual{,
   title = {fledge: Smoother Change Tracking and Versioning for R Packages},
   author = {Kirill Müller and Patrick Schratz},
   year = {2024},
-  note = {R package version 0.1.99.9035,
+  note = {R package version 0.1.99.9036,
     https://github.com/cynkra/fledge},
   url = {https://fledge.cynkra.com/},
 }</pre>
diff --git a/dev/index.html b/dev/index.html
index ef398102..4b31741b 100644
--- a/dev/index.html
+++ b/dev/index.html
@@ -30,7 +30,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/news/index.html b/dev/news/index.html
index c972e02f..17b0d305 100644
--- a/dev/news/index.html
+++ b/dev/news/index.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -39,6 +39,55 @@ <h1>Changelog</h1>
       <small>Source: <a href="https://github.com/cynkra/fledge/blob/main/NEWS.md" class="external-link"><code>NEWS.md</code></a></small>
     </div>
 
+    <div class="section level2">
+<h2 class="pkg-version" data-toc-text="0.1.99.9036" id="fledge-01999036-2024-12-12">fledge 0.1.99.9036 (2024-12-12)<a class="anchor" aria-label="anchor" href="#fledge-01999036-2024-12-12"></a></h2>
+<div class="section level3">
+<h3 id="bug-fixes-0-1-99-9036">Bug fixes<a class="anchor" aria-label="anchor" href="#bug-fixes-0-1-99-9036"></a></h3>
+<ul><li><p>Support empty commit messages.</p></li>
+<li><p><code>is_news_consistent()</code> detects releases of the kind x.y.z-w.</p></li>
+<li><p>Work around bug in <code><a href="https://rdrr.io/r/base/order.html" class="external-link">order()</a></code> for package versions.</p></li>
+<li><p>Use correct version for checking GH release.</p></li>
+<li><p>Use correct version for checking GH release.</p></li>
+<li><p><code>release_after_cran_built_binaries()</code> works correctly again (<a href="https://github.com/cynkra/fledge/issues/848" class="external-link">#848</a>).</p></li>
+</ul></div>
+<div class="section level3">
+<h3 id="features-0-1-99-9036">Features<a class="anchor" aria-label="anchor" href="#features-0-1-99-9036"></a></h3>
+<ul><li><p>Better entry if PR info could not be extracted.</p></li>
+<li><p>Support versions of the form x.y.z-w for tagging.</p></li>
+<li><p>Newsworthy commits are searched along the first parents only, picking up all relevant commits (<a href="https://github.com/cynkra/fledge/issues/847" class="external-link">#847</a>).</p></li>
+<li><p>Determining the most recent tag now uses the new <code><a href="../reference/get_last_version_tag.html">get_last_version_tag()</a></code> and works when the version tag is on a diverged branch (e.g., after squash-merging) (<a href="https://github.com/cynkra/fledge/issues/844" class="external-link">#844</a>).</p></li>
+<li><p>Consistent protection of hash tag (<a href="https://github.com/cynkra/fledge/issues/836" class="external-link">#836</a>).</p></li>
+<li><p>Keep empty lines when merging (<a href="https://github.com/cynkra/fledge/issues/834" class="external-link">#834</a>).</p></li>
+<li><p><code><a href="../reference/release.html">plan_release()</a></code> pulls the current branch (<a href="https://github.com/cynkra/fledge/issues/831" class="external-link">#831</a>).</p></li>
+</ul></div>
+<div class="section level3">
+<h3 id="chore-0-1-99-9036">Chore<a class="anchor" aria-label="anchor" href="#chore-0-1-99-9036"></a></h3>
+<ul><li><p>Get tagging information from fledgling.</p></li>
+<li><p>Clear clipboard after successful discovery of CRAN URL.</p></li>
+<li><p>Check token early for automation (<a href="https://github.com/cynkra/fledge/issues/841" class="external-link">#841</a>).</p></li>
+<li><p>Refactor (<a href="https://github.com/cynkra/fledge/issues/835" class="external-link">#835</a>).</p></li>
+</ul></div>
+<div class="section level3">
+<h3 id="continuous-integration-0-1-99-9036">Continuous integration<a class="anchor" aria-label="anchor" href="#continuous-integration-0-1-99-9036"></a></h3>
+<ul><li><p>Install R.</p></li>
+<li><p>Avoid failure in fledge workflow if no changes (<a href="https://github.com/cynkra/fledge/issues/851" class="external-link">#851</a>).</p></li>
+<li><p>Fetch tags for fledge workflow to avoid unnecessary NEWS entries (<a href="https://github.com/cynkra/fledge/issues/850" class="external-link">#850</a>).</p></li>
+<li><p>Use larger retry count for lock-threads workflow (<a href="https://github.com/cynkra/fledge/issues/849" class="external-link">#849</a>).</p></li>
+<li><p>Ignore errors when removing pkg-config on macOS (<a href="https://github.com/cynkra/fledge/issues/840" class="external-link">#840</a>).</p></li>
+<li><p>Explicit permissions (<a href="https://github.com/cynkra/fledge/issues/839" class="external-link">#839</a>).</p></li>
+<li><p>Use styler from main branch (<a href="https://github.com/cynkra/fledge/issues/838" class="external-link">#838</a>).</p></li>
+<li><p>Need to install R on Ubuntu 24.04 (<a href="https://github.com/cynkra/fledge/issues/837" class="external-link">#837</a>).</p></li>
+<li><p>Use Ubuntu 24.04 and styler PR (<a href="https://github.com/cynkra/fledge/issues/829" class="external-link">#829</a>).</p></li>
+</ul></div>
+<div class="section level3">
+<h3 id="testing-0-1-99-9036">Testing<a class="anchor" aria-label="anchor" href="#testing-0-1-99-9036"></a></h3>
+<ul><li>Fix test (<a href="https://github.com/cynkra/fledge/issues/846" class="external-link">#846</a>).</li>
+</ul></div>
+<div class="section level3">
+<h3 id="uncategorized-0-1-99-9036">Uncategorized<a class="anchor" aria-label="anchor" href="#uncategorized-0-1-99-9036"></a></h3>
+<ul><li>Ci: Fix macOS (<a href="https://github.com/cynkra/fledge/issues/16" class="external-link">#16</a>) (<a href="https://github.com/cynkra/fledge/issues/830" class="external-link">#830</a>).</li>
+</ul></div>
+</div>
     <div class="section level2">
 <h2 class="pkg-version" data-toc-text="0.1.99.9035" id="fledge-01999035-2024-11-24">fledge 0.1.99.9035 (2024-11-24)<a class="anchor" aria-label="anchor" href="#fledge-01999035-2024-11-24"></a></h2>
 <div class="section level3">
diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml
index c594ab9b..3338dba2 100644
--- a/dev/pkgdown.yml
+++ b/dev/pkgdown.yml
@@ -1,12 +1,12 @@
 pandoc: 3.1.11
 pkgdown: 2.1.1.9000
-pkgdown_sha: 4ed37469e87c3ab813dc954da388242a873738ab
+pkgdown_sha: 5c03b7444923f7c797b8b283e175f8eed63797a7
 articles:
   auto: auto.html
   demo: demo.html
   fledge: fledge.html
   internals: internals.html
-last_built: 2024-12-11T06:50Z
+last_built: 2024-12-25T21:02Z
 urls:
   reference: https://fledge.cynkra.com/reference
   article: https://fledge.cynkra.com/articles
diff --git a/dev/reference/bump_version.html b/dev/reference/bump_version.html
index 98b17711..0d04858c 100644
--- a/dev/reference/bump_version.html
+++ b/dev/reference/bump_version.html
@@ -29,7 +29,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -152,7 +152,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="co"># Bump version with fledge.</span></span></span>
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu">bump_version</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a66a175ba/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b1b85bf38/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
diff --git a/dev/reference/commit_version.html b/dev/reference/commit_version.html
index e9b25724..296b4cca 100644
--- a/dev/reference/commit_version.html
+++ b/dev/reference/commit_version.html
@@ -9,7 +9,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -76,7 +76,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu">desc</span><span class="fu">::</span><span class="fu"><a href="https://desc.r-lib.org/reference/desc_add_author.html" class="external-link">desc_add_author</a></span><span class="op">(</span>given <span class="op">=</span> <span class="st">"Jane"</span>, family <span class="op">=</span> <span class="st">"Doe"</span>, role <span class="op">=</span> <span class="st">"ctb"</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu">commit_version</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a117383e2/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b78012c28/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
diff --git a/dev/reference/create_demo_project.html b/dev/reference/create_demo_project.html
index 35aeb9d5..8c4ded48 100644
--- a/dev/reference/create_demo_project.html
+++ b/dev/reference/create_demo_project.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/finalize_version.html b/dev/reference/finalize_version.html
index 86d4ce27..f78b7526 100644
--- a/dev/reference/finalize_version.html
+++ b/dev/reference/finalize_version.html
@@ -19,7 +19,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -97,7 +97,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="co"># Once done</span></span></span>
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu">finalize_version</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a31f81768/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483bd43cb5b/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
diff --git a/dev/reference/get_last_tag.html b/dev/reference/get_last_tag.html
index 22eb1006..1ee81e31 100644
--- a/dev/reference/get_last_tag.html
+++ b/dev/reference/get_last_tag.html
@@ -13,7 +13,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -85,7 +85,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu"><a href="get_top_level_commits.html">get_top_level_commits</a></span><span class="op">(</span>since <span class="op">=</span> <span class="cn">NULL</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">fledge</span><span class="fu">::</span><span class="fu">get_last_tag</span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a6c7f8c18/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b73617058/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
@@ -113,14 +113,14 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 4 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   commit                                   message                         merge</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                           <span style="color: #949494; font-style: italic;">&lt;lgl&gt;</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 1373ffc01e45baee31a91c832e235cf7f272d7ce <span style="color: #949494;">"</span>fledge: Bump version to 0.0.0… FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 2db7ecd109826b649c25acc7e971c478c5195f18 <span style="color: #949494;">"</span>- Add cool function.\n<span style="color: #949494;">"</span>        FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 3fca6460b6ff953dc710ee01185726f84cd98c1f <span style="color: #949494;">"</span>fledge: Bump version to 0.0.0… FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> ef7820d3213ca82a9ed02bb4529ff466c24f8ddd <span style="color: #949494;">"</span>- Add cool function.\n<span style="color: #949494;">"</span>        FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> b473d8ea7fe4af7189a3f673e6a9efe36cee5395 <span style="color: #949494;">"</span>Add NEWS.md to track changes.… FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 70e0d17ddfcfe6434e67c983b2c12586816baddc <span style="color: #949494;">"</span>First commit\n<span style="color: #949494;">"</span>                FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name        ref                   commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">*</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 6d1540f4362582b40c8619d0bdce45a0def7338c</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 c6732b4414ae96f74b1ad762224d8e89f5016319</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"&lt;no active project&gt;"</span>.</span>
 </code></pre></div>
     </div>
diff --git a/dev/reference/get_last_version_tag.html b/dev/reference/get_last_version_tag.html
index 18026dd1..c227d420 100644
--- a/dev/reference/get_last_version_tag.html
+++ b/dev/reference/get_last_version_tag.html
@@ -11,7 +11,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -94,7 +94,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="co"># get_last_version_tag() is better</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">fledge</span><span class="fu">::</span><span class="fu">get_last_version_tag</span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a197783f1/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b760f9adc/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
@@ -123,18 +123,18 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 4 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   commit                                   message                         merge</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                           <span style="color: #949494; font-style: italic;">&lt;lgl&gt;</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 5fe706a1a5574a79f27b5b3912b144098bd74f7b <span style="color: #949494;">"</span>fledge: Bump version to 0.0.0… FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 712e1ab994fe55e8fec5c5fd830a132a68cc7746 <span style="color: #949494;">"</span>- Add cool function.\n<span style="color: #949494;">"</span>        FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 5a1fb5ca424db57b6f9738f667ad0ef3846988fd <span style="color: #949494;">"</span>fledge: Bump version to 0.0.0… FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 4f46f5ca93f0cb9f0ac7efbe3baa1d7b103919b9 <span style="color: #949494;">"</span>- Add cool function.\n<span style="color: #949494;">"</span>        FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> b473d8ea7fe4af7189a3f673e6a9efe36cee5395 <span style="color: #949494;">"</span>Add NEWS.md to track changes.… FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 70e0d17ddfcfe6434e67c983b2c12586816baddc <span style="color: #949494;">"</span>First commit\n<span style="color: #949494;">"</span>                FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name        ref                   commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">*</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 13ef60a14ed2464a87cd801b21929ea7bfd9623f</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 1159859ccdf7dc62f1afd47e429fb942df8bc90a</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name        ref                   commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 13ef60a14ed2464a87cd801b21929ea7bfd9623f</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 1159859ccdf7dc62f1afd47e429fb942df8bc90a</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"&lt;no active project&gt;"</span>.</span>
 </code></pre></div>
     </div>
diff --git a/dev/reference/get_top_level_commits.html b/dev/reference/get_top_level_commits.html
index e26582c9..6d89f448 100644
--- a/dev/reference/get_top_level_commits.html
+++ b/dev/reference/get_top_level_commits.html
@@ -9,7 +9,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -87,7 +87,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">get_top_level_commits</span><span class="op">(</span>since <span class="op">=</span> <span class="cn">NULL</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="get_last_tag.html">get_last_tag</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a7c0f6177/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b64eaf4bd/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
@@ -115,14 +115,14 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 4 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   commit                                   message                         merge</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                    <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                           <span style="color: #949494; font-style: italic;">&lt;lgl&gt;</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> d1efd4fb568289c48e29b5bed4704e2b22c4c57b <span style="color: #949494;">"</span>fledge: Bump version to 0.0.0… FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 8c02932060ac293778be95626238f72c01d0df0e <span style="color: #949494;">"</span>- Add cool function.\n<span style="color: #949494;">"</span>        FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> f140e1265c8490124c350a927097abf65fa5466a <span style="color: #949494;">"</span>fledge: Bump version to 0.0.0… FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 3261730f012d0d836c3ca9d33a3d582825a1f0f2 <span style="color: #949494;">"</span>- Add cool function.\n<span style="color: #949494;">"</span>        FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> b473d8ea7fe4af7189a3f673e6a9efe36cee5395 <span style="color: #949494;">"</span>Add NEWS.md to track changes.… FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 70e0d17ddfcfe6434e67c983b2c12586816baddc <span style="color: #949494;">"</span>First commit\n<span style="color: #949494;">"</span>                FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name        ref                   commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">*</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                 <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 a47fd9de147f897b9fc979678e5f173cb4cdcc6a</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.0.9001 refs/tags/v0.0.0.9001 70279f59020f33f3df62c8a42e545e14e1a4c696</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"&lt;no active project&gt;"</span>.</span>
 </code></pre></div>
     </div>
diff --git a/dev/reference/index.html b/dev/reference/index.html
index 551e3bf8..32cf0a3c 100644
--- a/dev/reference/index.html
+++ b/dev/reference/index.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/release.html b/dev/reference/release.html
index 490366f9..a0db8cb8 100644
--- a/dev/reference/release.html
+++ b/dev/reference/release.html
@@ -25,7 +25,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/tag_version.html b/dev/reference/tag_version.html
index e968e1e5..00487ae8 100644
--- a/dev/reference/tag_version.html
+++ b/dev/reference/tag_version.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -85,7 +85,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu">tag_version</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="get_last_version_tag.html">get_last_version_tag</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a3023bf22/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b7b16be54/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
@@ -122,7 +122,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name   ref              commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>            <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.1 refs/tags/v0.0.1 1a4c9ecbd13df6b4cfc71a4b62699c0e59ecc036</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.1 refs/tags/v0.0.1 f08b62035de19e276e13ada8d9c876729d121cdc</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"&lt;no active project&gt;"</span>.</span>
 </code></pre></div>
     </div>
diff --git a/dev/reference/unbump_version.html b/dev/reference/unbump_version.html
index 12bce5a2..33f9ae3b 100644
--- a/dev/reference/unbump_version.html
+++ b/dev/reference/unbump_version.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -87,7 +87,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="bump_version.html">bump_version</a></span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="co">#'</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a63f585cb/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b719cd43b/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
diff --git a/dev/reference/update_news.html b/dev/reference/update_news.html
index 88f005b5..06c6d385 100644
--- a/dev/reference/update_news.html
+++ b/dev/reference/update_news.html
@@ -13,7 +13,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -111,7 +111,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="tag_version.html">tag_version</a></span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="get_last_version_tag.html">get_last_version_tag</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a2d09f1d2/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b26882bed/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
@@ -148,7 +148,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name   ref              commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>            <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.1 refs/tags/v0.0.1 feb6e9150bd882a6e869894efc66b7a760c30997</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.1 refs/tags/v0.0.1 e910aa7073fe0869418785417fa2f05a414abb4c</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"&lt;no active project&gt;"</span>.</span>
 </code></pre></div>
     </div>
diff --git a/dev/reference/update_version.html b/dev/reference/update_version.html
index d0facf32..fa4ebc06 100644
--- a/dev/reference/update_version.html
+++ b/dev/reference/update_version.html
@@ -9,7 +9,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -98,7 +98,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="tag_version.html">tag_version</a></span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="get_last_version_tag.html">get_last_version_tag</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a607f2dc3/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b7a44f6c4/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
@@ -135,7 +135,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 1 × 3</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   name   ref              commit                                  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>            <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>                                   </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.1 refs/tags/v0.0.1 604f0454a09030501370064fc9e15f30a144b244</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> v0.0.1 refs/tags/v0.0.1 47fcb26ecb87639d2523a8ca612249f6bfb212be</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"&lt;no active project&gt;"</span>.</span>
 </code></pre></div>
     </div>
diff --git a/dev/reference/with_demo_project.html b/dev/reference/with_demo_project.html
index 6afd63f5..1d811d7a 100644
--- a/dev/reference/with_demo_project.html
+++ b/dev/reference/with_demo_project.html
@@ -7,7 +7,7 @@
     <a href="https://cynkra.com" class="external-link"><img src="https://cynkra.com/assets/img/logo_small.svg" id="cynkra-logo-nav" alt="cynkra"></a>
     <a class="navbar-brand me-2" href="../index.html">fledge</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9035</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9036</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -99,7 +99,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span>  <span class="co"># Bump version with fledge.</span></span></span>
 <span class="r-in"><span>  <span class="fu">fledge</span><span class="fu">::</span><span class="fu"><a href="bump_version.html">bump_version</a></span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmppQUyR5/fledge482a1a038401/tea"</span>.</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Setting active project to <span style="color: #0000BB;">"/tmp/RtmpTP5Kru/fledge483b235e65ac/tea"</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">☐</span> Edit <span style="color: #0000BB;">R/cool-function.R</span>.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> → Digesting messages from <span style="color: #00BB00;">3</span> commits.</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">✔</span> Found <span style="color: #0000BB;">1</span> NEWS-worthy entry.</span>
diff --git a/dev/search.json b/dev/search.json
index 17b4538b..19c1d8f5 100644
--- a/dev/search.json
+++ b/dev/search.json
@@ -1 +1 @@
-[{"path":"https://fledge.cynkra.com/dev/articles/auto.html","id":"goals-and-how-achieved","dir":"Articles","previous_headings":"","what":"Goals, and how achieved","title":"Automate CRAN releases v2","text":"Bumping CRAN version back dev version atomic, dangling release branch Support subsequent release attempts branch created tag Pre-flight plan_release(\"pre-patch\"), including grooming NEWS.md Caveat: committed release, way back, avoid conflicts GitHub Actions branches start cran- Locally urlchecker::url_update(), devtools::check_win_devel(), rhub::check_for_cran() TODO: Compatibility usethis::use_release_issue() Checks run GitHub Actions branches start cran- TODO: Use background jobs via job::empty() useful GHA workflow Commits/merges made fledge newsworthy can always create tag PR merge triggered user TODO: Composable workflow, grooming can separate release plan_release(\"pre-patch\") TODO: snapshot tests usethis:::release_checklist(), maintain list","code":""},{"path":"https://fledge.cynkra.com/dev/articles/auto.html","id":"non-goals","dir":"Articles","previous_headings":"","what":"Non-goals","title":"Automate CRAN releases v2","text":"Conflicts important goal avoid conflicts, also auto-merge merge queues Release main branch possible cases","code":""},{"path":"https://fledge.cynkra.com/dev/articles/auto.html","id":"workflow","dir":"Articles","previous_headings":"","what":"Workflow","title":"Automate CRAN releases v2","text":"Optional, recommended grooming NEWS often gives hint ’s missing release: fledge::plan_release(\"pre-patch\") (\"pre-minor\" \"pre-major\") Edit NEWS.md needed Perform release-related tasks Merge PR Mandatory: fledge::plan_release(\"next\") (\"minor\" \"major\") Perform work previous step omitted fledge::release() (FIXME: also merging PR) submission rejected: fledge::plan_release(\"last\") (FIXME) Apply hotfixes required submit fledge::release() (FIXME: also merging PR) submission abandoned: action required","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Using fledge","text":"guide demonstrate use {fledge}, using mock R package example. going call package “{tea}”. develop scratch also maintain changelog development progresses. Finally, demonstrate changelog can eventually converted release notes package submitted CRAN. typing demo R Markdown vignette therefore using R tools creating files, editing , interacting git: real life can using e.g. IDE command line. fledge package won’t care!","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"set-up-the-development-environment","dir":"Articles","previous_headings":"","what":"Set up the development environment","title":"Using fledge","text":"start development {tea}, set basic development environment required typical R package.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-a-package","dir":"Articles","previous_headings":"Set up the development environment","what":"Create a package","title":"Using fledge","text":"start creating new package. demo, package created temporary directory. real project live somewhere home directory. usethis::create_package() function sets package project ready development. interactive RStudio session, new window opens work . Users environments change working directory manually. demo, manually set active project. infrastructure files directories comprise minimal R package created:","code":"pkg <- usethis::create_package(\"tea\") usethis::proj_set() fs::dir_ls() ## DESCRIPTION NAMESPACE   R           tea.Rproj"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-and-configure-a-git-repository","dir":"Articles","previous_headings":"Set up the development environment","what":"Create and configure a Git repository","title":"Using fledge","text":"Next, one set package development create Git repository package. achieved gert code. use usethis::use_git() function creates initial commit, repository clean state. working branches, recommended turn fast-forward merging: alternative use squash commits. also set git remote. real life might using function like usethis::use_github(). set local remote using git repo secretly created earlier. create two functions show contents tags remote. real life, ’d probably simply browse GitHub interface instance!","code":"# Number of commits until now nrow(gert::git_log()) ## [1] 1 # Anything staged? gert::git_status() ## # A tibble: 0 × 3 ## # ℹ 3 variables: file <chr>, status <chr>, staged <lgl> gert::git_config_set(\"merge.ff\", \"false\") # gert::git_config_global_set(\"merge.ff\", \"false\") # to set globally show_files <- function(remote_url) {   tempdir_remote <- withr::local_tempdir(pattern = \"remote\")   withr::with_dir(tempdir_remote, {     repo <- gert::git_clone(remote_url)     suppressMessages(gert::git_branch_checkout(\"main\", force = TRUE, repo = \"remote\"))     fs::dir_ls(\"remote\", recurse = TRUE)   }) } show_files(remote_url) ## remote/DESCRIPTION remote/NAMESPACE   remote/tea.Rproj  show_tags <- function(remote_url) {   tempdir_remote <- withr::local_tempdir(pattern = \"remote\")   withr::with_dir(tempdir_remote, {     gert::git_clone(remote_url)     # Only show name and ref     gert::git_tag_list(repo = \"remote\")[, c(\"name\", \"ref\")]   }) }"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-initial-news-md-file","dir":"Articles","previous_headings":"Set up the development environment","what":"Create initial NEWS.md file","title":"Using fledge","text":"initial NEWS file can created usethis::use_news_md(). Let’s take look contents: file needs tracked Git: Note done nothing fledge specific yet.","code":"usethis::use_news_md() ## ✔ Writing 'NEWS.md'. news <- readLines(usethis::proj_path(\"NEWS.md\")) cat(news, sep = \"\\n\") ## # tea (development version) ##  ## * Added a `NEWS.md` file to track changes to the package. gert::git_add(\"NEWS.md\") gert::git_commit(\"Initial NEWS.md .\") gert::git_push(remote = \"origin\") show_files(remote_url) ## remote/DESCRIPTION remote/NAMESPACE   remote/NEWS.md     remote/tea.Rproj"},{"path":[]},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-an-r-file","dir":"Articles","previous_headings":"The development phase","what":"Create an R file","title":"Using fledge","text":"Now start coding functionality package. start creating new R file called cup.R adding code (well comment). commit file Git relevant message. first fledge specific step! Note use bullet (-) beginning commit message. indicates message included NEWS.md updated. matter type commit message (gert R, RStudio Git window, command line, VSCode, etc.). ’s important content commit message.","code":"usethis::use_r(\"cup\") ## ☐ Edit 'R/cup.R'. writeLines(\"# cup\", \"R/cup.R\") gert::git_add(\"R/cup.R\") gert::git_commit(\"- New cup_of_tea() function makes it easy to drink a cup of tee.\") gert::git_push() show_files(remote_url) ## remote/DESCRIPTION remote/NAMESPACE   remote/NEWS.md     remote/R            ## remote/R/cup.R     remote/tea.Rproj"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-a-test","dir":"Articles","previous_headings":"The development phase","what":"Create a test","title":"Using fledge","text":"code cup.R warrants test (least actual code!): real project substitute testing code template real tests. demo commit straight away, bulleted message.","code":"usethis::use_test(\"cup\") ## ✔ Adding testthat to 'Suggests' field in DESCRIPTION. ## ✔ Adding \"3\" to 'Config/testthat/edition'. ## ✔ Creating 'tests/testthat/'. ## ✔ Writing 'tests/testthat.R'. ## ✔ Writing 'tests/testthat/test-cup.R'. ## ☐ Edit 'tests/testthat/test-cup.R'. cat(readLines(\"tests/testthat/test-cup.R\"), sep = \"\\n\") ## test_that(\"multiplication works\", { ##   expect_equal(2 * 2, 4) ## }) gert::git_add(\"DESCRIPTION\") gert::git_add(\"tests/testthat.R\") gert::git_add(\"tests/testthat/test-cup.R\") gert::git_commit(\"- Add tests for cup of tea.\") gert::git_push() show_files(remote_url) ## remote/DESCRIPTION               remote/NAMESPACE                  ## remote/NEWS.md                   remote/R                          ## remote/R/cup.R                   remote/tea.Rproj                  ## remote/tests                     remote/tests/testthat             ## remote/tests/testthat/test-cup.R remote/tests/testthat.R"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"update-news-md","dir":"Articles","previous_headings":"The development phase","what":"Update NEWS.md","title":"Using fledge","text":"Let us look commit history now. might use Git tool want consult , use gert. two “bulletted” messages fledge means two NEWS-worthy messages. Let us update NEWS.md! use fledge::bump_version() assign new dev version number package also update NEWS.md. current version number package 0.0.0.9000. new version number 0.0.0.9001. run fledge::bump_version() early mistake (e.g. wanted one code edit), can run fledge::unbump_version()! happen immediately bumping. pushed edited code meantime, ’s late – just continue assign new version done edits.","code":"# Only show number of files, messages knitr::kable(gert::git_log()[-(1:3)]) fledge::bump_version() ## → Digesting messages from 4 commits. ## ✔ Found 2 NEWS-worthy entries. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.0.9001. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.0.9001 with tag message derived from 'NEWS.md'. ## ! Run `fledge::finalize_version(push = TRUE)`."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"review-news-md","dir":"Articles","previous_headings":"The development phase","what":"Review NEWS.md","title":"Using fledge","text":"Let us see NEWS.md looks like bump. reviewing notice typo one comments (congrats noticed right away typed “tee” instead “tea”!). fledge package adds comment editing NEWS.md hand NEWS.md actually can… right! Read . Let’s fix typo, ’d hand. affect original commit message, NEWS.md. (Editing commit messages something fledge supports).","code":"news <- readLines(\"NEWS.md\") cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tee. ##  ## - Added a `NEWS.md` file to track changes to the package. news <- gsub(\"tee\", \"tea\", news) cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package. writeLines(news, \"NEWS.md\")"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"finalize-version","dir":"Articles","previous_headings":"The development phase","what":"Finalize version","title":"Using fledge","text":"tweaking NEWS.md, important use fledge::finalize_version() commit manually. Using fledge::finalize_version() instead committing manually ensures tag set correct version spite NEWS.md update. called NEWS.md manually updated. Note called fledge::bump_version(), error raised another commit added . Let’s look NEWS.md now: version package 0.0.0.9001. tag created version good practice, crucial using fledge: updating changelog, fledge looks commit messages since latest tag.","code":"show_tags(remote_url) ## # A tibble: 0 × 2 ## # ℹ 2 variables: name <chr>, ref <chr> fledge::finalize_version(push = TRUE) ## → Resetting to previous commit. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Deleting existing tag v0.0.0.9001. ## → Creating tag v0.0.0.9001 with tag message derived from 'NEWS.md'. ## → Pushing main. ## → Force-pushing tag v0.0.0.9001. show_tags(remote_url) ## # A tibble: 1 × 2 ##   name        ref                   ##   <chr>       <chr>                 ## 1 v0.0.0.9001 refs/tags/v0.0.0.9001 news <- readLines(\"NEWS.md\") cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"change-code-and-commit","dir":"Articles","previous_headings":"The development phase","what":"Change code and commit","title":"Using fledge","text":"{tea} cup tested, now want enhance bowl. requires changes code, perhaps new test. create branch (whose name starts “f” “feature”) switch branch implement . branch, separate commits used tests implementation. commit messages need formatted specially, {fledge} ignore anyway. time write tests first, test-driven development. branch can pushed remote usual. merging specify message included changelog, bullet.1 might used merges remote (e.g. GitHub pull requests) demonstrate local merge commit. strategy can used merging pull/merge/… request GitHub, GitLab, …: use bullet points merge commit message indicate items include NEWS.md. Now added bowl support package, time bump version . seems even need amend NEWS.md hand time made typo!","code":"gert::git_branch_create(\"f-bowl\", checkout = TRUE) usethis::use_test(\"bowl\") ## ✔ Writing 'tests/testthat/test-bowl.R'. ## ☐ Edit 'tests/testthat/test-bowl.R'. gert::git_add(\"tests/testthat/test-bowl.R\") gert::git_commit(\"Add bowl tests.\") usethis::use_r(\"bowl\") ## ☐ Edit 'R/bowl.R'. writeLines(\"# bowl of tea\", \"R/bowl.R\") gert::git_add(\"R/bowl.R\") gert::git_commit(\"Add bowl implementation.\") gert::git_branch_checkout(\"main\") gert::git_merge(\"f-bowl\", commit = FALSE) ## Merge was not committed due to merge conflict(s). Please fix and run git_commit() or git_merge_abort() gert::git_commit(\"- New bowl_of_tea() function makes it easy to drink a bowl of tea.\") fledge::bump_version() ## → Digesting messages from 1 commits. ## ✔ Found 1 NEWS-worthy entry. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.0.9002. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.0.9002 with tag message derived from 'NEWS.md'. ## ! Run `fledge::finalize_version(push = TRUE)`. news <- readLines(\"NEWS.md\") writeLines(news) ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9002 ##  ## - New bowl_of_tea() function makes it easy to drink a bowl of tea. ##  ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package. fledge::finalize_version(push = TRUE) ## → Resetting to previous commit. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## ℹ Tag v0.0.0.9002 exists and points to the current commit. ## → Pushing main. ## → Force-pushing tag v0.0.0.9002."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"prepare-for-release","dir":"Articles","previous_headings":"","what":"Prepare for release","title":"Using fledge","text":"multiple cycles development, review testing, decide package ready release CRAN. {fledge} simplifies release process making use commit messages provided earlier. difference publishing CRAN publishing GitHub ’s external system controlling publication CRAN package might need tweaks first release candidate version end publishing CRAN.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"bump-version-for-release","dir":"Articles","previous_headings":"Prepare for release","what":"Bump version for release","title":"Using fledge","text":"wish release package patch use fledge::bump_version() “patch” argument. values arguments “dev” (default), “minor” “major”. updates version package 0.0.1.","code":"fledge::bump_version(\"patch\") ## → Digesting messages from 1 commits. ## ℹ Same as previous version. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.1. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Preparing package for CRAN release ── ##  ## • Convert the change log in 'NEWS.md' to release notes."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"generate-release-notes","dir":"Articles","previous_headings":"Prepare for release","what":"Generate release notes","title":"Using fledge","text":"review NEWS.md generated {fledge}: intermediate commit messages relevant release notes release. need edit NEWS.md convert changelog meaningful release notes. E.g. real life might re-organize bullets. Unlike development versions, commit changes NEWS.md manually, fledge function. package now ready released CRAN. prefer devtools::use_release_issue() create checklist things release, devtools::submit_cran() submit. devtools::release() function verbose alternative.","code":"news <- readLines(\"NEWS.md\") cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.1 ##  ## - Same as previous version. ##  ##  ## # tea 0.0.0.9002 ##  ## - New bowl_of_tea() function makes it easy to drink a bowl of tea. ##  ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"after-release","dir":"Articles","previous_headings":"","what":"After release","title":"Using fledge","text":"time passed {tea} package accepted CRAN. stage, {fledge} can help tag released version create new version development.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"tag-version","dir":"Articles","previous_headings":"After release","what":"Tag version","title":"Using fledge","text":"now time tag released version using fledge::tag_version() function. advised push remote, git push --tags command line, favorite Git client.","code":"fledge::tag_version() ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.1 with tag message derived from 'NEWS.md'. show_tags(remote_url) ## # A tibble: 2 × 2 ##   name        ref                   ##   <chr>       <chr>                 ## 1 v0.0.0.9001 refs/tags/v0.0.0.9001 ## 2 v0.0.0.9002 refs/tags/v0.0.0.9002"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-github-release","dir":"Articles","previous_headings":"After release","what":"Create GitHub release","title":"Using fledge","text":"package hosted GitHub, usethis::use_github_release() creates draft GitHub release contents already NEWS.md. need submit draft release GitHub release page.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"restart-development","dir":"Articles","previous_headings":"After release","what":"Restart development","title":"Using fledge","text":"now make package ready future development. fledge::bump_version() takes care . Push remote, add features relevant commits (mergining branch ), bump_version(), etc. Happy development, happy smooth filling changelog!","code":"fledge::bump_version() ## → Digesting messages from 1 commits. ## ℹ Same as previous version. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.1.9000. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.1.9000 with tag message derived from 'NEWS.md'. ## ! Run `fledge::finalize_version(push = TRUE)`. news <- readLines(\"NEWS.md\") unlink(parent_dir, recursive = TRUE)"},{"path":[]},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"once-per-machine","dir":"Articles","previous_headings":"Installation & setup","what":"Once per machine","title":"Get started with fledge","text":"Install CRAN using: Install cynkra’s R-universe (development version) using: install GitHub (development version well) using: used making workflow packages (e.g. devtools) available interactive work, might enjoy loading fledge .Rprofile.","code":"install.packages(\"fledge\") install.packages(\"fledge\", repos = c(\"https://cynkra.r-universe.dev\", \"https://cloud.r-project.org\")) remotes::install_github(\"cynkra/fledge\")"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"once-per-package","dir":"Articles","previous_headings":"Installation & setup","what":"Once per package","title":"Get started with fledge","text":"package needs remote indicates default branch (e.g. GitHub remote) using default branch name global/project init.defaultbranch. Add mention fledge usage contributing guide, contributors might know . comment added top NEWS.md, tends ignored occasionally.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"for-full-use","dir":"Articles","previous_headings":"Installation & setup > Once per package","what":"For full use","title":"Get started with fledge","text":"package… brand-new, remember run fledge::bump_version() regularly. already undergone development, late jump train! Run fledge::bump_version() fledge::finalize_version().","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"for-light-use","dir":"Articles","previous_headings":"Installation & setup > Once per package","what":"For light use","title":"Get started with fledge","text":"package needs development version header produced usethis::use_development_version().","code":"# mypackage (development version)"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"functions","dir":"Articles","previous_headings":"","what":"Functions","title":"Get started with fledge","text":"{fledge} consists following functions enable versioning different stages package development lifecycle.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"full-fledge-usage","dir":"Articles","previous_headings":"","what":"Full fledge usage","title":"Get started with fledge","text":"following sections show combine functions different stages R package GitHub. {fledge} commands issued package directory target R package.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"initial-configuration","dir":"Articles","previous_headings":"Full fledge usage","what":"Initial Configuration","title":"Get started with fledge","text":"{fledge} assumes target R package version-controlled Git dedicated repository. following steps required set {fledge} first time use, package. Call bump_version() given set package version Edit NEWS.md required (typo fixes, rephrasing, grouping). Call finalize_version() given update NEWS.md set switch development stage now. Ensure use bullet points (* -) commit merge messages indicate messages want include NEWS.md. Use finalize_version(push = TRUE) push remote repository (e.g. GitHub) one swoop.","code":"fledge::bump_version() fledge::finalize_version()"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"development","dir":"Articles","previous_headings":"Full fledge usage","what":"Development","title":"Get started with fledge","text":"{fledge} aims update NEWS.md DESCRIPTION correctly whenever new version assigned. order , following steps need included throughout development workflow. commit messages main branch (typically main master), mark everything go NEWS.md bullet point (- *). applicable single commits, merge commits, squash commits pull requests. edit NEWS.md manually. want assign version number current state R package e.g. end day break, call default argument bump_version “dev”. dev part version number updated. good practice assign new version number switching focus another project. Edit NEWS.md required (typo fixes, rephrasing, grouping). Call finalize_version(): fledge::finalize_version(). achieves following: NEWS.md now composed, based recent commit messages. understand NEWS.md updated fledge, see section NEWS.md implementation. new version number assigned automatically (modeled usethis::use_version()). tag matching version number assigned automatically, recent NEWS.md messages included tag’s message.","code":"fledge::bump_version()"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"releasing-to-cran","dir":"Articles","previous_headings":"Full fledge usage","what":"Releasing to CRAN","title":"Get started with fledge","text":"want release package CRAN, follow steps : Call bump_version() appropriate argument (\"patch\", \"major\", \"minor\"). e.g., Edit NEWS.md, convert “change log” “release notes” – higher-level description features bug fixes (typo fixes, rephrasing, grouping). Call commit_version() Make necessary adjustments releasing CRAN depending results preparatory / incoming checks. release/changes accepted CRAN, use following calls tag released version switch development version immediately. Return development mode!","code":"fledge::bump_version(\"patch\") fledge::commit_version() fledge::tag_version() fledge::bump_version()"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"faq-edge-cases","dir":"Articles","previous_headings":"","what":"FAQ & edge cases","title":"Get started with fledge","text":"least think questions asked. Feel free also ask us questions!","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"but-what-if-i-want-to-edit-news-md-manually","dir":"Articles","previous_headings":"FAQ & edge cases","what":"But what if I want to edit NEWS.md manually?","title":"Get started with fledge","text":"still can! best moment bump_version() finalize_version(push = TRUE). can actually edit time, two calls text changelog captured tag message, better tag history.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"what-if-a-contributor-wants-to-contribute-a-news-item","dir":"Articles","previous_headings":"FAQ & edge cases","what":"What if a contributor wants to contribute a NEWS item?","title":"Get started with fledge","text":"someone opens PR, fledge information changes entered message merge squash commit. Now still advise contributors provide summary change comment PR.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"does-this-mean-fix-42-will-appear-in-news-md","dir":"Articles","previous_headings":"FAQ & edge cases","what":"Does this mean “Fix #42” will appear in NEWS.md?","title":"Get started with fledge","text":"want fix issue commit message can put “Fix #42” separate non-bulleted line line 3 hyphens. PR e.g. GitHub can link issue PR starting first comment “Fix 42” issue closed. merge squash commit hyperlinked PR, commit message won’t phrase. still add acknowledgement actual commit message e.g. “- Adds support coolness (#42, @contributor)”.","code":"- Adds support for coolness (#42, @contributor).  ---  Fix #42"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"edge-cases","dir":"Articles","previous_headings":"FAQ & edge cases","what":"Edge cases","title":"Get started with fledge","text":"rebase creating tag, need call finalize_version() make sure tag moved mainline branch. pushed via finalize_version(push = TRUE) git push, tag may pushed well. case, invoke (x.y.z.9www new version) delete newly created remote tag. reason {fledge} tags \"dev\" releases automatically. releases always must tagged manually tag_version().","code":"git push origin :vx.y.z.9www"},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"implementation","dir":"Articles","previous_headings":"","what":"Implementation","title":"Fledge internals","text":"following sections explain things actually work inside fledge.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"updating-news-md","dir":"Articles","previous_headings":"Implementation","what":"Updating NEWS.md","title":"Fledge internals","text":"New entries added NEWS.md commit messages commits master. top-level commits considered (roughly equivalent git log --first-parent.) messages commits parsed. lines start star * dash - included. line starts three dashes, everything past line excluded. Example: following commit message added NEWS.md: retrieving current NEWS defining tag message, entries first two first-level headers (starting #) returned. can use second third level headers add many empty lines want.","code":"Merge f-fancy-feature to master, closes #5678  - Added fancy feature (#5678).  - Fixed bug as a side effect (#9012).  ---  The fancy feature consists of the components:  - foo - bar - baz - Added fancy feature (#5678). - Fixed bug as a side effect (#9012)."},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"collecting-news","dir":"Articles","previous_headings":"Implementation","what":"Collecting NEWS","title":"Fledge internals","text":"first function call stage always bump_version(). following Calls update_news() collect NEWS entries top-level commits increment version DESCRIPTION add header NEWS.md.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"tagging-for-dev-vs--other-releases","dir":"Articles","previous_headings":"Implementation","what":"Tagging for “dev” vs. other releases","title":"Fledge internals","text":"bump_version() continues depending release type: \"dev\" releases: Calls finalize_version() commit DESCRIPTION NEWS.md. Also creates tag message. can always edit NEWS.md call finalize_version() . commit tag updated. releases: Calls commit_version() commit DESCRIPTION NEWS.md without tagging. stage, can edit NEWS.md commit much like. tag created use tag_version() manually.","code":""},{"path":"https://fledge.cynkra.com/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Kirill Müller. Author, maintainer, copyright holder. Patrick Schratz. Author. Maëlle Salmon. Contributor.","code":""},{"path":"https://fledge.cynkra.com/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Müller K, Schratz P (2024). fledge: Smoother Change Tracking Versioning R Packages. R package version 0.1.99.9035, https://github.com/cynkra/fledge, https://fledge.cynkra.com/.","code":"@Manual{,   title = {fledge: Smoother Change Tracking and Versioning for R Packages},   author = {Kirill Müller and Patrick Schratz},   year = {2024},   note = {R package version 0.1.99.9035,     https://github.com/cynkra/fledge},   url = {https://fledge.cynkra.com/}, }"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"fledge","dir":"","previous_headings":"","what":"Smoother Change Tracking and Versioning for R Packages","title":"Smoother Change Tracking and Versioning for R Packages","text":"Smoother change tracking versioning R packages. want provide changelog (NEWS.md) informative “bug fixes performance improvements” (https://twitter.com/EmilyKager/status/1413628436984188933) users package? Ways achieve : Update NEWS.md right release reading commit messages. necessarily fun! Update changelog every commit e.g. every PR. Now, several feature PRs around update changelog, ’ll clicks make tackle conflicts. Easy enough, potentially annoying. Use fledge fill NEWS.md based informative commit messages, (optionally) increase version number DESCRIPTION (e.g. useful bug reports session information!), (optionally) create git tags (coarse-grained history compared top-level merges see fledge tag list GitHub). Using fledge discipline, habits, worth learning! need practice , matter fledge commitment level: important commit messages want recorded changelog, can Use conventional commits syntax. instance feat: Enhanced support time series. using conventional commits syntax provide automatic grouping changelog items groups (Documentation, Bug Fixes, etc.). Add hyphen - * beginning commit message. Exclude housekeeping parts message typing line ---. Use informative merge commit messages also included default changelog. GitHub can control default commit message merging pull request. (GitHub repositories ) merge commits default self-contained message (“Merge pull request…”), rely fledge’s querying GitHub API get PR title include changelog. informative commit messages refer Tidyverse style guide. , full fledge use = fledge-assisted management NEWS.md, DESCRIPTION version numbers, git tags: Run fledge::bump_version() regularly e.g. every coffee break end day week. forgot merge one PR run fledge::unbump_version(), merge PR informative squash commit message, run fledge::bump_version() go drink coffee! Run fledge::finalize_version() need edit NEWS.md manually e.g. made typo happy phrasing retrospect. Even edit lot, ’s written fledge still good place-holder. Follow recommended steps release (see vignette(\"fledge\") usage section). , light fledge use = filling NEWS.md releases: development version header produced usethis::use_development_version(). Regularly run fledge::update_news(), preferentially main branch avoid merge conflicts. habits worth learning!","code":"- Add support for bla databases. - Add support for bla databases.  ---  Also tweak the CI workflow accordingly. :sweat_smile: # mypackage (development version)"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"demo","dir":"","previous_headings":"","what":"Demo","title":"Smoother Change Tracking and Versioning for R Packages","text":"Click image show separate tab.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/index.html","id":"once-per-machine","dir":"","previous_headings":"Installation & setup","what":"Once per machine","title":"Smoother Change Tracking and Versioning for R Packages","text":"Install CRAN using: Install cynkra’s R-universe (development version) using: install GitHub (development version well) using: used making workflow packages (e.g. devtools) available interactive work, might enjoy loading fledge .Rprofile.","code":"install.packages(\"fledge\") install.packages(\"fledge\", repos = c(\"https://cynkra.r-universe.dev\", \"https://cloud.r-project.org\")) remotes::install_github(\"cynkra/fledge\")"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"once-per-package","dir":"","previous_headings":"Installation & setup","what":"Once per package","title":"Smoother Change Tracking and Versioning for R Packages","text":"package needs remote indicates default branch (e.g. GitHub remote) using default branch name global/project init.defaultbranch. Add mention fledge usage contributing guide, contributors might know . comment added top NEWS.md, tends ignored occasionally.","code":""},{"path":"https://fledge.cynkra.com/dev/index.html","id":"for-full-use","dir":"","previous_headings":"Installation & setup > Once per package","what":"For full use","title":"Smoother Change Tracking and Versioning for R Packages","text":"package… brand-new, remember run fledge::bump_version() regularly. already undergone development, late jump train! Run fledge::bump_version() fledge::finalize_version().","code":""},{"path":"https://fledge.cynkra.com/dev/index.html","id":"for-light-use","dir":"","previous_headings":"Installation & setup > Once per package","what":"For light use","title":"Smoother Change Tracking and Versioning for R Packages","text":"package needs development version header produced usethis::use_development_version().","code":"# mypackage (development version)"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"how-to-get-started","dir":"","previous_headings":"","what":"How to get started?","title":"Smoother Change Tracking and Versioning for R Packages","text":"Check general vignette vignette(\"fledge\"), whole game, demo vignette vignette(\"demo\"). Feel free ask us questions!","code":""},{"path":"https://fledge.cynkra.com/dev/index.html","id":"related-tools","dir":"","previous_headings":"","what":"Related tools","title":"Smoother Change Tracking and Versioning for R Packages","text":"newsmd: manually add updates (version bullet points) NEWS.md file. autonewsmd: Auto-Generate Changelog using Conventional Commits.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Bump package version — bump_version","title":"Bump package version — bump_version","text":"Calls following functions: Verify current branch main branch check_default_branch = TRUE (default). update_news(), using argument. result, check meaningful changes since last version. Depending argument: \"dev\", finalize_version() push = FALSE Otherwise, commit_version().","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Bump package version — bump_version","text":"","code":"bump_version(   which = c(\"dev\", \"pre-patch\", \"patch\", \"pre-minor\", \"minor\", \"pre-major\", \"major\"),   ...,   no_change_behavior = c(\"bump\", \"noop\", \"fail\"),   check_default_branch = TRUE )"},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Bump package version — bump_version","text":"Component version number update. Supported values \"auto\" (default: \"samedev\" \"dev\", depending contents NEWS.md), \"samedev\" (.b.c.900x stable version), \"dev\" (.b.c.9xxx), \"patch\" (.b.x), \"pre-minor\" (.b.99.9000), \"minor\" (.x.0), \"pre-major\" (.99.99.9000), \"major\" (x.0.0). ... dots future extensions must empty. no_change_behavior change since last version: \"bump\" bump version; \"noop\" nothing; \"fail\" erroring. check_default_branch Whether check current branch default branch.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Bump package version — bump_version","text":"TRUE NEWS.md DESCRIPTION updated, FALSE otherwise. rely behavior.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"bumped-too-soon-","dir":"Reference","previous_headings":"","what":"Bumped too soon?","title":"Bump package version — bump_version","text":"just run bump_version(), realized \"oh shoot, forgot merge PR\"? Fear , run unbump_version(), merge PR, run bump_version().","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Bump package version — bump_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version() }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a66a175ba/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Commits NEWS.md and DESCRIPTION to Git — commit_version","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"Commits changes NEWS.md DESCRIPTION, amending previous commit created fledge necessary.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"","code":"commit_version()"},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"Invisibly: TRUE previous commit version amended, FALSE .","code":""},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   desc::desc_add_author(given = \"Jane\", family = \"Doe\", role = \"ctb\")   fledge::commit_version() }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a117383e2/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":null,"dir":"Reference","previous_headings":"","what":"Create example repo for fledge demos — create_demo_project","title":"Create example repo for fledge demos — create_demo_project","text":"Create example repo fledge demos","code":""},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create example repo for fledge demos — create_demo_project","text":"","code":"create_demo_project(   open = rlang::is_interactive(),   name = \"tea\",   maintainer = NULL,   email = NULL,   date = \"2021-09-27\",   dir = file.path(tempdir(), \"fledge\"),   news = FALSE )"},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create example repo for fledge demos — create_demo_project","text":"open Whether open new project. name Package name. maintainer Name DESCRIPTION git. email Email DESCRIPTION git. date String time DESCRIPTION git. dir Directory within create mock package folder. news TRUE, create NEWS.md file.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create example repo for fledge demos — create_demo_project","text":"path newly created mock package.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Finalize package version — finalize_version","title":"Finalize package version — finalize_version","text":"Calls following functions: commit_version() tag_version() force = TRUE Force-pushes created tag \"origin\" remote, push = TRUE.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Finalize package version — finalize_version","text":"","code":"finalize_version(push = FALSE)"},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Finalize package version — finalize_version","text":"push TRUE, push created tag.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Finalize package version — finalize_version","text":"None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Finalize package version — finalize_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   # Edit news by hand   # ...   # Once done   fledge::finalize_version() }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a31f81768/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":null,"dir":"Reference","previous_headings":"","what":"The most recent tag — get_last_tag","title":"The most recent tag — get_last_tag","text":"Returns recent Git tag reachable current branch. accurate version bump tag occurred branch squashed main branch. See get_last_version_tag() version works scenario.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"The most recent tag — get_last_tag","text":"","code":"get_last_tag()"},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"The most recent tag — get_last_tag","text":"one-row tibble columns name, ref commit. annotated tags (created fledge), commit may different SHA commit tag points . Use gert::git_log() find actual commit.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"The most recent tag — get_last_tag","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::finalize_version()   print(get_top_level_commits(since = NULL))   print(fledge::get_last_tag()) }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a6c7f8c18/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> # A tibble: 4 × 3 #>   commit                                   message                         merge #>   <chr>                                    <chr>                           <lgl> #> 1 1373ffc01e45baee31a91c832e235cf7f272d7ce \"fledge: Bump version to 0.0.0… FALSE #> 2 2db7ecd109826b649c25acc7e971c478c5195f18 \"- Add cool function.\\n\"        FALSE #> 3 b473d8ea7fe4af7189a3f673e6a9efe36cee5395 \"Add NEWS.md to track changes.… FALSE #> 4 70e0d17ddfcfe6434e67c983b2c12586816baddc \"First commit\\n\"                FALSE #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #> * <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 6d1540f4362582b40c8619d0bdce45a0def7338c #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":null,"dir":"Reference","previous_headings":"","what":"The most recent versioned tag — get_last_version_tag","title":"The most recent versioned tag — get_last_version_tag","text":"Returns Git tag form vx.y, vx.y.z vx.y.z.w latest version. older version logic used get_last_tag(), traverses Git history work squash-merging version bumps.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"The most recent versioned tag — get_last_version_tag","text":"","code":"get_last_version_tag()"},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"The most recent versioned tag — get_last_version_tag","text":"one-row tibble columns name, ref commit. annotated tags (created fledge), commit may different SHA commit tag points . Use gert::git_log() find actual commit.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"The most recent versioned tag — get_last_version_tag","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Switch to branch for bumping version.   gert::git_branch_create(\"fledge\")   # Bump version with fledge.   fledge::bump_version(check_default_branch = FALSE)   fledge::finalize_version()    # Merge the version bump branch into main.   gert::git_branch_checkout(\"main\")   gert::git_merge(\"fledge\", squash = TRUE)    print(get_top_level_commits(since = NULL))    # get_last_tag() doesn't work in this scenario   print(fledge::get_last_tag())    # get_last_version_tag() is better   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a197783f1/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> Performing fast-forward merge, no commit needed #> # A tibble: 4 × 3 #>   commit                                   message                         merge #>   <chr>                                    <chr>                           <lgl> #> 1 5fe706a1a5574a79f27b5b3912b144098bd74f7b \"fledge: Bump version to 0.0.0… FALSE #> 2 712e1ab994fe55e8fec5c5fd830a132a68cc7746 \"- Add cool function.\\n\"        FALSE #> 3 b473d8ea7fe4af7189a3f673e6a9efe36cee5395 \"Add NEWS.md to track changes.… FALSE #> 4 70e0d17ddfcfe6434e67c983b2c12586816baddc \"First commit\\n\"                FALSE #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #> * <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 13ef60a14ed2464a87cd801b21929ea7bfd9623f #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #>   <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 13ef60a14ed2464a87cd801b21929ea7bfd9623f #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":null,"dir":"Reference","previous_headings":"","what":"All top-level commits — get_top_level_commits","title":"All top-level commits — get_top_level_commits","text":"Return top-level commits since particular version commit objects.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"All top-level commits — get_top_level_commits","text":"","code":"get_top_level_commits(since = NULL)"},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"All top-level commits — get_top_level_commits","text":"since commit SHA, e.g. returned commit component get_last_version_tag(). NULL, entire log retrieved.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"All top-level commits — get_top_level_commits","text":"tibble::tibble least two columns: commit: commit SHA message: commit message","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"All top-level commits — get_top_level_commits","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::finalize_version()   print(get_top_level_commits(since = NULL))   print(fledge::get_last_tag()) }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a7c0f6177/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> # A tibble: 4 × 3 #>   commit                                   message                         merge #>   <chr>                                    <chr>                           <lgl> #> 1 d1efd4fb568289c48e29b5bed4704e2b22c4c57b \"fledge: Bump version to 0.0.0… FALSE #> 2 8c02932060ac293778be95626238f72c01d0df0e \"- Add cool function.\\n\"        FALSE #> 3 b473d8ea7fe4af7189a3f673e6a9efe36cee5395 \"Add NEWS.md to track changes.… FALSE #> 4 70e0d17ddfcfe6434e67c983b2c12586816baddc \"First commit\\n\"                FALSE #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #> * <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 a47fd9de147f897b9fc979678e5f173cb4cdcc6a #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":null,"dir":"Reference","previous_headings":"","what":"Automating CRAN release — plan_release","title":"Automating CRAN release — plan_release","text":"plan_release() run milestone development package reached ready sent CRAN. default, function initiate pre-release, indicated 9900 fourth component version number. Pass = \"patch\", = \"minor\", = \"major\" initiate release corresponding version number. release() sends CRAN performing several checks, offers help accepting submission. post_release() called submission accepted.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Automating CRAN release — plan_release","text":"","code":"plan_release(   which = c(\"pre-patch\", \"pre-minor\", \"pre-major\", \"next\", \"patch\", \"minor\", \"major\"),   force = FALSE )  release()  post_release()"},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Automating CRAN release — plan_release","text":"Component version number update. Supported values \"pre-patch\" (default, x.y.z.9900) \"pre-minor\" (x.y.99.9900), \"pre-major\" (x.99.99.9900), \"next\" (\"major\" current version x.99.99.9yyy, \"minor\" current version x.y.99.9zzz, \"patch\" otherwise), \"patch\" \"minor\", \"major\". force Create branches tags even exist. Useful recover previously failed attempt.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Automating CRAN release — plan_release","text":"plan_release(): Ensures modified files Git index. Creates pre-release release branch bumps version accordingly. Writes/updates cran-comments.md useful information current release process. Runs urlchecker::url_update(), devtools::check_win_devel(), rhub::rhub_check(platforms = rhub::rhub_platforms()$name) background RStudio IDE, prompts user . Opens pull request release branch final checks.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a new version tag — tag_version","title":"Create a new version tag — tag_version","text":"Parses NEWS.md creates/updates tag recent version.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a new version tag — tag_version","text":"","code":"tag_version(force = FALSE)"},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a new version tag — tag_version","text":"force Re-tag even last commit created bump_version().  Useful defining CRAN release.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a new version tag — tag_version","text":"created tag, invisibly. None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a new version tag — tag_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::update_news(c(\"- something I forgot\", \"- blabla\"), which = \"patch\")   gert::git_add(\"NEWS.md\")   gert::git_commit(message = \"release notes tweaking\")   fledge::tag_version()   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a3023bf22/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Digesting messages from 2 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.1. #> → Added header to NEWS.md. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.1 with tag message derived from NEWS.md. #> # A tibble: 1 × 3 #>   name   ref              commit                                   #>   <chr>  <chr>            <chr>                                    #> 1 v0.0.1 refs/tags/v0.0.1 1a4c9ecbd13df6b4cfc71a4b62699c0e59ecc036 #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Undoes bumping the package version — unbump_version","title":"Undoes bumping the package version — unbump_version","text":"undoes effect bump_version() call, safety check.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Undoes bumping the package version — unbump_version","text":"","code":"unbump_version()"},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Undoes bumping the package version — unbump_version","text":"NULL, invisibly. function called side effects. None","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Undoes bumping the package version — unbump_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   # Oh no, we forgot to also add the awesome function for that version!   # UNBUMP   fledge::unbump_version()   # Add a new R file.   usethis::use_r(\"awesome-function\", open = FALSE)   # Pretend we added awesome code inside it.   # Track the new R file with Git.   gert::git_add(\"R/awesome-function.R\")   gert::git_commit(\"- Add awesome function.\")   # Bump version with fledge.   fledge::bump_version()   #' }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a63f585cb/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ℹ Checking if working copy is clean. #> ℹ Checking if last tag points to last commit. #> ℹ Checking if commit messages match. #> ✔ Safety checks complete. #> → Deleting tag v0.0.0.9001. #> ✔ Resetting to parent commit 42. #> ☐ Edit R/awesome-function.R. #> → Digesting messages from 4 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":null,"dir":"Reference","previous_headings":"","what":"Update NEWS.md with messages from top-level commits — update_news","title":"Update NEWS.md with messages from top-level commits — update_news","text":"Lists commits range (default: top-level commits since recent tag determined get_last_version_tag()) adds bullets body NEWS.md. Creates NEWS.md necessary.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update NEWS.md with messages from top-level commits — update_news","text":"","code":"update_news(   messages = NULL,   which = c(\"auto\", \"samedev\", \"dev\", \"pre-patch\", \"patch\", \"pre-minor\", \"minor\",     \"pre-major\", \"major\") )"},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update NEWS.md with messages from top-level commits — update_news","text":"messages character vector commit messages, e.g. message column return value get_top_level_commits(). default uses top level commits since last tag retrieved get_last_version_tag(). Component version number update. Supported values \"auto\" (default: \"samedev\" \"dev\", depending contents NEWS.md), \"samedev\" (.b.c.900x stable version), \"dev\" (.b.c.9xxx), \"patch\" (.b.x), \"pre-minor\" (.b.99.9000), \"minor\" (.x.0), \"pre-major\" (.99.99.9000), \"major\" (x.0.0).","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Update NEWS.md with messages from top-level commits — update_news","text":"None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Update NEWS.md with messages from top-level commits — update_news","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::update_news(c(\"- something I forgot\", \"- blabla\"), which = \"patch\")   gert::git_add(\"NEWS.md\")   gert::git_commit(message = \"release notes tweaking\")   fledge::tag_version()   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a2d09f1d2/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Digesting messages from 2 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.1. #> → Added header to NEWS.md. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.1 with tag message derived from NEWS.md. #> # A tibble: 1 × 3 #>   name   ref              commit                                   #>   <chr>  <chr>            <chr>                                    #> 1 v0.0.1 refs/tags/v0.0.1 feb6e9150bd882a6e869894efc66b7a760c30997 #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Update NEWS.md and DESCRIPTION with a new version — update_version","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"Deprecated, use update_news().","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"","code":"update_version(   which = c(\"auto\", \"samedev\", \"dev\", \"patch\", \"pre-minor\", \"minor\", \"pre-major\",     \"major\") )"},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"Component version number update. Supported values \"auto\" (default: \"samedev\" \"dev\", depending contents NEWS.md), \"samedev\" (.b.c.900x stable version), \"dev\" (.b.c.9xxx), \"patch\" (.b.x), \"pre-minor\" (.b.99.9000), \"minor\" (.x.0), \"pre-major\" (.99.99.9000), \"major\" (x.0.0).","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::update_news(c(\"- something I forgot\", \"- blabla\"), which = \"patch\")   gert::git_add(\"NEWS.md\")   gert::git_commit(message = \"release notes tweaking\")   fledge::tag_version()   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a607f2dc3/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Digesting messages from 2 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.1. #> → Added header to NEWS.md. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.1 with tag message derived from NEWS.md. #> # A tibble: 1 × 3 #>   name   ref              commit                                   #>   <chr>  <chr>            <chr>                                    #> 1 v0.0.1 refs/tags/v0.0.1 604f0454a09030501370064fc9e15f30a144b244 #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":null,"dir":"Reference","previous_headings":"","what":"Run code in temporary project — with_demo_project","title":"Run code in temporary project — with_demo_project","text":"Run code temporary project","code":""},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run code in temporary project — with_demo_project","text":"","code":"with_demo_project(code, dir = NULL, news = TRUE, quiet = FALSE)  local_demo_project(   dir = NULL,   news = TRUE,   quiet = FALSE,   .local_envir = parent.frame() )"},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run code in temporary project — with_demo_project","text":"code Code run temporary active project dir Directory within create mock package folder. news TRUE, create NEWS.md file. quiet Whether show messages usethis .local_envir environment use scoping. Defaults current execution environment.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run code in temporary project — with_demo_project","text":"with_demo_project() returns result evaluating code. local_demo_project() called side effect returns NULL, invisibly.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run code in temporary project — with_demo_project","text":"","code":"with_demo_project({   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version() }) #> ✔ Setting active project to \"/tmp/RtmppQUyR5/fledge482a1a038401/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ✔ Setting active project to \"<no active project>\"."},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9035","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9035 (2024-11-24)","text":"Keep raw NEWS (#827).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9035","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9035 (2024-11-24)","text":"Refactorings new test (#825). Better JSON snapshot (#824). Keep raw component date, use assembling NEWS (#823).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9034","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9034 (2024-11-23)","text":"Distinguish news component news column data frame (#820).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9033 (2024-11-22)","text":"CRAN PRs longer created draft (#810). fledge:::release_after_cran_built_binaries() longer throws error release exists.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9033 (2024-11-22)","text":"finalize_version() unconditionally overwrites existing tags (#819). Pre-releases get different PR title (#818). PR must open main window (#816). plan_release() calls bump_version() (#814). Detect contributors squashed commits (#813). Mention bump_version(check_default_branch = FALSE) error message (#812). New plan_release(), replaces init_release() pre_release() (#803). Support = \"pre-patch\" bump_version() update_version() (#802). bump_version() bump newsworthy messages found (#801). Messages start \"fledge: \" longer considered newsworthy (#800). Include relevant info cran-comments.md (#799). Support pre-patch version, new versioning scheme starting 9900 (#794).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9033 (2024-11-22)","text":"Bump commit messages get fledge prefix. Add fledge prefix CRAN PR (#809).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9033 (2024-11-22)","text":"Remove Aviator (#815). Correctly detect branch protection (#811). Sync fledge workflow.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.99.9033 (2024-11-22)","text":"is_dev_version() related (#805).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9033 (2024-11-22)","text":"Reduce use shut_up_fledge() (#796). Speed tests replacing gert::git_add() system call (#793). Split slow test.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9032","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9032 (2024-11-11)","text":"Trigger run (#792).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9031","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9031 (2024-10-28)","text":"Use pkgdown branch (#791).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9030","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9030 (2024-09-15)","text":"Install via R CMD INSTALL ., pak (#789).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9029","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9029 (2024-08-31)","text":"Add Aviator configuration.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9029","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9029 (2024-08-31)","text":"Install local package pkgdown builds. Improve support protected branches, without fledge.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9029","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9029 (2024-08-31)","text":"Snapshot updates rcc-smoke (null) (#786).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9028","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9028 (2024-08-19)","text":"Try pushing head first. Try pushing head first, fail branch protection.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9028","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9028 (2024-08-19)","text":"bump_version(check_default_branch = TRUE).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9027","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9027 (2024-08-17)","text":"Auto-update GitHub Actions. Run: https://github.com/cynkra/fledge/actions/runs/10425483871","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9027","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9027 (2024-08-17)","text":"Sync latest developments.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9026","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9026 (2024-08-10)","text":"Use v2 instead master.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9025","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9025 (2024-08-06)","text":"Inline action.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9024","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9024 (2024-08-03)","text":"Snapshot updates R-CMD-check-base (null) (#783).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9023","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9023 (2024-08-02)","text":"Use dev roxygen2 decor.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9023","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9023 (2024-08-02)","text":"Accept snapshots knitr update.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9022","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9022 (2024-07-02)","text":"Fix Windows, tweak lock workflow.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9021","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9021 (2024-06-30)","text":"Auto-update GitHub Actions. Run: https://github.com/cynkra/fledge/actions/runs/9727971994","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9020","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9020 (2024-06-28)","text":"Auto-update GitHub Actions. Run: https://github.com/cynkra/fledge/actions/runs/9691617690","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9020","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9020 (2024-06-28)","text":"Avoid checking bashisms Windows. Remove netlify workflow. Remove special branch. Bump versions, better default, consume custom matrix. Recent updates.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9019","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9019 (2024-06-26)","text":"Update bump-version.R - replace length test get_main_branch_config() (#775).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-99-9018","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.99.9018 (2024-04-16)","text":"Set BS version explicitly now. https://github.com/cynkra/cynkratemplate/issues/53","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9017","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9017 (2024-02-19)","text":"Move responsibility writing fledgeling, memoise, add repo argument (#761).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999016-2024-01-24","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9016 (2024-01-24)","title":"fledge 0.1.99.9016 (2024-01-24)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9015","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9015 (2024-01-15)","text":"Work around r-lib/roxygen2#1570.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9014","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9014 (2023-12-22)","text":"Create releases correct body (#756).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9014","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9014 (2023-12-22)","text":"Add Aviator configuration.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9013","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9013 (2023-11-09)","text":"create_github_release() removes header NEWS entry.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9012","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9012 (2023-11-07)","text":"report installation size problems (#755).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9011","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9011 (2023-11-05)","text":"post_release() longer checks release branch (#750).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9011","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9011 (2023-11-05)","text":"Use news_path() (#751).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9010","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9010 (2023-11-03)","text":"Allow bumping straight released version (#747). post_release() independent release branch (#748).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9010","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9010 (2023-11-03)","text":"Add aviator configuration.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9009","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9009 (2023-10-28)","text":"Release package soon ’s available PPM.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9008","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9008 (2023-10-23)","text":"New init_release(), called pre_release() (#686).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9007","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9007 (2023-10-21)","text":"Automatically merge news dev versions release (#744). extensive preflight checks post_release(), reduce output quiet mode (#740).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9007","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9007 (2023-10-21)","text":"Basic testing scripts (#742).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9006","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9006 (2023-10-19)","text":"Extract error first submission step, fix CRAN submission (#738). Check release exists creating (#731).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9006","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9006 (2023-10-19)","text":"Add version ref arguments create_release_branch(), fix create_release_branch(force = TRUE) (#734). no_change() functions gain ref argument (#733). Pretty check_only_modified() (#705). Refactorings #686 (#729).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9006","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9006 (2023-10-19)","text":"handle NoSuggests checks 😅 (#732).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999005-2023-10-09","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9005 (2023-10-09)","title":"fledge 0.1.99.9005 (2023-10-09)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9004","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9004 (2023-10-03)","text":"efficient data frame access (#706).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-99-9004","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.99.9004 (2023-10-03)","text":"Replace httr httr2 (#712).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"tests-0-1-99-9004","dir":"Changelog","previous_headings":"","what":"tests","title":"fledge 0.1.99.9004 (2023-10-03)","text":"Clean , simplify tests (#716). Add function help run tests without losing one’s current dir (#715).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9003","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9003 (2023-09-26)","text":"Add test upper case conventional commit type (#711).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999002-2023-07-11","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9002 (2023-07-11)","title":"fledge 0.1.99.9002 (2023-07-11)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Ask fledgeling version. Bad merge conflict resolution v0.1.1.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Indent multiline NEWS items. skip_if_offline() calls. Type stability fledgeling object.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Avoid useless computation.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Prefer local_options(repos = NULL) skip_if_offline(). Test order.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Merge branch ‘cran-0.1.1’.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999000-2023-06-21","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9000 (2023-06-21)","title":"fledge 0.1.99.9000 (2023-06-21)","text":"Merge branch ‘cran-0.1.1’.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9047","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9047 (2023-06-16)","text":"Guess_next() works expected .99. versions.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9046","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9046 (2023-06-13)","text":"Suppress clipr warnings.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9046","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9046 (2023-06-13)","text":"flexible version extraction release PR title (#678).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9045","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9045 (2023-06-09)","text":"Adapt new behavior usethis::use_news_md() (#680).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9045","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9045 (2023-06-09)","text":"Clean version header parsing (#610).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9044","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9044 (2023-06-06)","text":"Tell merge.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9043","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9043 (2023-06-01)","text":"post_release() works release branch doesn’t change files main branch.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9042","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9042 (2023-05-28)","text":"Better error message duplicate version name (#673).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-0-9042","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.0.9042 (2023-05-28)","text":"Snapshot updates rcc-smoke (null) (#677).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9041","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9041 (2023-04-18)","text":"Slightly simplify pre_release() (#669).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9040","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9040 (2023-04-13)","text":"bump_version() works interactive sessions NEWS.md preamble () (#638).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9039","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9039 (2023-04-04)","text":"Use pkg version open PR, CRAN page (#662).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-0-9039","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.0.9039 (2023-04-04)","text":"Snapshot updates rcc-smoke (null) (#660). Snapshot updates rcc-smoke (null) (#647). Fix snapshots updates upstream dependencies (#657).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109038-2023-03-28","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9038 (2023-03-28)","title":"fledge 0.1.0.9038 (2023-03-28)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9037","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9037 (2023-03-24)","text":"write “previous version” first thing brand-new changelog (#655). New internal release_after_cran_built_binaries() support automated CRAN release GHA (#651).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9037","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9037 (2023-03-24)","text":"Update pitch (#656).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9036","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9036 (2023-03-21)","text":"Add ability parse two-line headers (#654).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9036","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9036 (2023-03-21)","text":"Use full power {cli} (#640).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9035","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9035 (2023-03-15)","text":"Add special CRAN release label release PRs (#649).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"tests-0-1-0-9034","dir":"Changelog","previous_headings":"","what":"tests","title":"fledge 0.1.0.9034 (2023-03-08)","text":"Replace httptest httptest2 gh now uses httr2 instead httr (#646).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109033-2023-02-17","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9033 (2023-02-17)","title":"fledge 0.1.0.9033 (2023-02-17)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9032","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9032 (2023-02-12)","text":"Bump dev version pre_release().","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9031","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9031 (2023-02-09)","text":"Update fledge URL NEWS preamble (#622).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Work around unexplicable behavior demo tests. Remove push trigger fledge.yaml, seems broken. bump_version() keeps updating Date field exists DESCRIPTION.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9030 (2023-02-05)","text":"post_release() pulls main branch merging (#525). Closes #525. New mode operation \"samedev\", #147. update_news() gains argument, deprecate update_version() (#607).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Move packages Imports Suggests. Add extra snapshot. Clean snapshots. usethis::use_lifecycle(). Prepare roundtrip via fledgeling (#606). Move foghorn rversions Suggests (#605). Run fledge workflow main branch (#597).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Add test prefix snapshot updates PR template (#582).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Use write_fledgling() write NEWS.md (#588).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Remove false Markdown link? (#592).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109029-2022-12-30","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9029 (2022-12-30)","title":"fledge 0.1.0.9029 (2022-12-30)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109028-2022-12-22","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9028 (2022-12-22)","title":"fledge 0.1.0.9028 (2022-12-22)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109027-2022-12-09","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9027 (2022-12-09)","title":"fledge 0.1.0.9027 (2022-12-09)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9026","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9026 (2022-12-06)","text":"Support linked issues repositories (#595).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9025","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9025 (2022-11-19)","text":"Typo.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109024-2022-11-12","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9024 (2022-11-12)","title":"fledge 0.1.0.9024 (2022-11-12)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Remove partial matching warning (#579).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Draft fledgeling object, ready internal use (#581). Add full stop messages (#578).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Store downlit info (#580).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Cynkratemplate::use_cynkra_pkgdown() + re-add comment (@krlmlr, @41898282+github-actions-bot, @maelle, #568).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Split news (#584).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9022","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9022 (2022-11-10)","text":"Add full stop entries","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109021-2022-11-09","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9021 (2022-11-09)","title":"fledge 0.1.0.9021 (2022-11-09)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109020-2022-11-03","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9020 (2022-11-03)","title":"fledge 0.1.0.9020 (2022-11-03)","text":"Snapshot updates R-CMD-check-base (null) (#570)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109019-2022-10-28","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9019 (2022-10-28)","title":"fledge 0.1.0.9019 (2022-10-28)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9018","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9018 (2022-10-26)","text":"Fix URL (#573)","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9017","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9017 (2022-10-24)","text":"Relax requirement GitHub PAT scope (#572)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109016-2022-10-20","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9016 (2022-10-20)","title":"fledge 0.1.0.9016 (2022-10-20)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109015-2022-10-19","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9015 (2022-10-19)","title":"fledge 0.1.0.9015 (2022-10-19)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109014-2022-10-18","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9014 (2022-10-18)","title":"fledge 0.1.0.9014 (2022-10-18)","text":"Harmonize yaml formatting Revert changes matrix section","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109013-2022-10-16","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9013 (2022-10-16)","title":"fledge 0.1.0.9013 (2022-10-16)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109012-2022-10-14","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9012 (2022-10-14)","title":"fledge 0.1.0.9012 (2022-10-14)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109011-2022-10-11","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9011 (2022-10-11)","title":"fledge 0.1.0.9011 (2022-10-11)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9010","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9010 (2022-09-20)","text":"bump_version() returns TRUE new version created","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9009","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9009 (2022-09-20)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9009","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9009 (2022-09-20)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9008","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9008 (2022-09-18)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9008","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9008 (2022-09-18)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9007","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9007 (2022-09-16)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9007","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9007 (2022-09-16)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9006","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9006 (2022-09-14)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9006","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9006 (2022-09-14)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109005-2022-09-13","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9005 (2022-09-13)","title":"fledge 0.1.0.9005 (2022-09-13)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109004-2022-09-12","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9004 (2022-09-12)","title":"fledge 0.1.0.9004 (2022-09-12)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Adjust empty lines space update_news() (#357) Add PR number CC messages (#353). Fix conventional commit regex (#329)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9003 (2022-09-12)","text":"New default pre_release(= \"next\") (#521, #524). Add “pre-minor” “pre-major” update_version() (#413, #412). Include reference issue closed PR (#361, #411). Capitalize first letter bullet (#360, #409). Extract contributor name PR merge message (@krlmlr, #358) Harvest PR attribution squash commits (@maelle, #349) Harvest PR title merge commit messages (@krlmlr, @maelle, #343) Improve parsing conventional commit messages (#332). Improve bump_version() (error) messages (@maelle, #328) Improve bump_version() behavior absence changes (@krlmlr, @maelle, #323) New local_test_project() (#318) Extract conventional commit messages changelog (#314).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Turn Netlify builds now (#326). Enable auto-style GitHub Actions (#317). Remove testthat specialization snapshots (#309).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Create fledge.yaml (#520).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Add README section related tools (#527). Update summary fledge uses commit messages (#499, #511). Fix typo README (#501)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Create open draft release directly, without using usethis::use_github_release(). Create tag part release(). Fix post_release(), still need tag released version.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109002-2022-04-02","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9002 (2022-04-02)","title":"fledge 0.1.0.9002 (2022-04-02)","text":"release() longer asks confirmation. Inline devtools::submit_cran() minus confirmation messages.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109001-2022-02-22","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9001 (2022-02-22)","title":"fledge 0.1.0.9001 (2022-02-22)","text":"New pre_release(), release() post_release() semi-automatic CRAN releases (#27, #28). Separate snapshot tests dev version testthat.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109000-2021-12-07","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9000 (2021-12-07)","title":"fledge 0.1.0.9000 (2021-12-07)","text":"previous version.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-011-2023-06-16","dir":"Changelog","previous_headings":"","what":"fledge 0.1.1 (2023-06-16)","title":"fledge 0.1.1 (2023-06-16)","text":"CRAN release: 2023-06-17 Compatibility release usethis 2.2.0.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-010-2021-12-07","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0 (2021-12-07)","title":"fledge 0.1.0 (2021-12-07)","text":"CRAN release: 2021-12-07 Change log management utility, initial release. main entry point bump_version(), following: Checks DESCRIPTION NEWS.md clean bumping, current branch main branch. update_news(): collects NEWS entries top-level commits update_version(): bump version DESCRIPTION, add header NEWS.md “dev”, finalize_version(): commit DESCRIPTION NEWS.md, create tag message Otherwise, commit_version(); user needs call tag_version() manually Suggests push changes upstream repository configured. haven’t committed since updating NEWS.md DESCRIPTION, can also edit NEWS.md call tag_version() . commit tag updated. Bumping can undone unbump_version(). DESCRIPTION \"Date\" field, populated current date update_version(). Likewise, NEWS.md contains dates headers, new versions also get date. empty list changes adds “previous version” bullet. allows bumping dev version immediately CRAN release. Also includes helper functions get_last_tag() get_top_level_commits(). Includes vignettes: “Get started”, “Using fledge”, “Fledge internals”. Examples tests supported demo project, created via with_demo_project(). Thanks Patrick Schratz Maëlle Salmon contributions!","code":""}]
+[{"path":"https://fledge.cynkra.com/dev/articles/auto.html","id":"goals-and-how-achieved","dir":"Articles","previous_headings":"","what":"Goals, and how achieved","title":"Automate CRAN releases v2","text":"Bumping CRAN version back dev version atomic, dangling release branch Support subsequent release attempts branch created tag Pre-flight plan_release(\"pre-patch\"), including grooming NEWS.md Caveat: committed release, way back, avoid conflicts GitHub Actions branches start cran- Locally urlchecker::url_update(), devtools::check_win_devel(), rhub::check_for_cran() TODO: Compatibility usethis::use_release_issue() Checks run GitHub Actions branches start cran- TODO: Use background jobs via job::empty() useful GHA workflow Commits/merges made fledge newsworthy can always create tag PR merge triggered user TODO: Composable workflow, grooming can separate release plan_release(\"pre-patch\") TODO: snapshot tests usethis:::release_checklist(), maintain list","code":""},{"path":"https://fledge.cynkra.com/dev/articles/auto.html","id":"non-goals","dir":"Articles","previous_headings":"","what":"Non-goals","title":"Automate CRAN releases v2","text":"Conflicts important goal avoid conflicts, also auto-merge merge queues Release main branch possible cases","code":""},{"path":"https://fledge.cynkra.com/dev/articles/auto.html","id":"workflow","dir":"Articles","previous_headings":"","what":"Workflow","title":"Automate CRAN releases v2","text":"Optional, recommended grooming NEWS often gives hint ’s missing release: fledge::plan_release(\"pre-patch\") (\"pre-minor\" \"pre-major\") Edit NEWS.md needed Perform release-related tasks Merge PR Mandatory: fledge::plan_release(\"next\") (\"minor\" \"major\") Perform work previous step omitted fledge::release() (FIXME: also merging PR) submission rejected: fledge::plan_release(\"last\") (FIXME) Apply hotfixes required submit fledge::release() (FIXME: also merging PR) submission abandoned: action required","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Using fledge","text":"guide demonstrate use {fledge}, using mock R package example. going call package “{tea}”. develop scratch also maintain changelog development progresses. Finally, demonstrate changelog can eventually converted release notes package submitted CRAN. typing demo R Markdown vignette therefore using R tools creating files, editing , interacting git: real life can using e.g. IDE command line. fledge package won’t care!","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"set-up-the-development-environment","dir":"Articles","previous_headings":"","what":"Set up the development environment","title":"Using fledge","text":"start development {tea}, set basic development environment required typical R package.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-a-package","dir":"Articles","previous_headings":"Set up the development environment","what":"Create a package","title":"Using fledge","text":"start creating new package. demo, package created temporary directory. real project live somewhere home directory. usethis::create_package() function sets package project ready development. interactive RStudio session, new window opens work . Users environments change working directory manually. demo, manually set active project. infrastructure files directories comprise minimal R package created:","code":"pkg <- usethis::create_package(\"tea\") ## Error in get(paste0(generic, \".\", class), envir = get_method_env()) :  ##   object 'type_sum.accel' not found usethis::proj_set() fs::dir_ls() ## DESCRIPTION NAMESPACE   R           tea.Rproj"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-and-configure-a-git-repository","dir":"Articles","previous_headings":"Set up the development environment","what":"Create and configure a Git repository","title":"Using fledge","text":"Next, one set package development create Git repository package. achieved gert code. use usethis::use_git() function creates initial commit, repository clean state. working branches, recommended turn fast-forward merging: alternative use squash commits. also set git remote. real life might using function like usethis::use_github(). set local remote using git repo secretly created earlier. create two functions show contents tags remote. real life, ’d probably simply browse GitHub interface instance!","code":"# Number of commits until now nrow(gert::git_log()) ## [1] 1 # Anything staged? gert::git_status() ## # A tibble: 0 × 3 ## # ℹ 3 variables: file <chr>, status <chr>, staged <lgl> gert::git_config_set(\"merge.ff\", \"false\") # gert::git_config_global_set(\"merge.ff\", \"false\") # to set globally show_files <- function(remote_url) {   tempdir_remote <- withr::local_tempdir(pattern = \"remote\")   withr::with_dir(tempdir_remote, {     repo <- gert::git_clone(remote_url)     suppressMessages(gert::git_branch_checkout(\"main\", force = TRUE, repo = \"remote\"))     fs::dir_ls(\"remote\", recurse = TRUE)   }) } show_files(remote_url) ## remote/DESCRIPTION remote/NAMESPACE   remote/tea.Rproj  show_tags <- function(remote_url) {   tempdir_remote <- withr::local_tempdir(pattern = \"remote\")   withr::with_dir(tempdir_remote, {     gert::git_clone(remote_url)     # Only show name and ref     gert::git_tag_list(repo = \"remote\")[, c(\"name\", \"ref\")]   }) }"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-initial-news-md-file","dir":"Articles","previous_headings":"Set up the development environment","what":"Create initial NEWS.md file","title":"Using fledge","text":"initial NEWS file can created usethis::use_news_md(). Let’s take look contents: file needs tracked Git: Note done nothing fledge specific yet.","code":"usethis::use_news_md() ## ✔ Writing 'NEWS.md'. news <- readLines(usethis::proj_path(\"NEWS.md\")) cat(news, sep = \"\\n\") ## # tea (development version) ##  ## * Added a `NEWS.md` file to track changes to the package. gert::git_add(\"NEWS.md\") gert::git_commit(\"Initial NEWS.md .\") gert::git_push(remote = \"origin\") show_files(remote_url) ## remote/DESCRIPTION remote/NAMESPACE   remote/NEWS.md     remote/tea.Rproj"},{"path":[]},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-an-r-file","dir":"Articles","previous_headings":"The development phase","what":"Create an R file","title":"Using fledge","text":"Now start coding functionality package. start creating new R file called cup.R adding code (well comment). commit file Git relevant message. first fledge specific step! Note use bullet (-) beginning commit message. indicates message included NEWS.md updated. matter type commit message (gert R, RStudio Git window, command line, VSCode, etc.). ’s important content commit message.","code":"usethis::use_r(\"cup\") ## ☐ Edit 'R/cup.R'. writeLines(\"# cup\", \"R/cup.R\") gert::git_add(\"R/cup.R\") gert::git_commit(\"- New cup_of_tea() function makes it easy to drink a cup of tee.\") gert::git_push() show_files(remote_url) ## remote/DESCRIPTION remote/NAMESPACE   remote/NEWS.md     remote/R            ## remote/R/cup.R     remote/tea.Rproj"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-a-test","dir":"Articles","previous_headings":"The development phase","what":"Create a test","title":"Using fledge","text":"code cup.R warrants test (least actual code!): real project substitute testing code template real tests. demo commit straight away, bulleted message.","code":"usethis::use_test(\"cup\") ## ✔ Adding testthat to 'Suggests' field in DESCRIPTION. ## ✔ Adding \"3\" to 'Config/testthat/edition'. ## ✔ Creating 'tests/testthat/'. ## ✔ Writing 'tests/testthat.R'. ## ✔ Writing 'tests/testthat/test-cup.R'. ## ☐ Edit 'tests/testthat/test-cup.R'. cat(readLines(\"tests/testthat/test-cup.R\"), sep = \"\\n\") ## test_that(\"multiplication works\", { ##   expect_equal(2 * 2, 4) ## }) gert::git_add(\"DESCRIPTION\") gert::git_add(\"tests/testthat.R\") gert::git_add(\"tests/testthat/test-cup.R\") gert::git_commit(\"- Add tests for cup of tea.\") gert::git_push() show_files(remote_url) ## remote/DESCRIPTION               remote/NAMESPACE                  ## remote/NEWS.md                   remote/R                          ## remote/R/cup.R                   remote/tea.Rproj                  ## remote/tests                     remote/tests/testthat             ## remote/tests/testthat/test-cup.R remote/tests/testthat.R"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"update-news-md","dir":"Articles","previous_headings":"The development phase","what":"Update NEWS.md","title":"Using fledge","text":"Let us look commit history now. might use Git tool want consult , use gert. two “bulletted” messages fledge means two NEWS-worthy messages. Let us update NEWS.md! use fledge::bump_version() assign new dev version number package also update NEWS.md. current version number package 0.0.0.9000. new version number 0.0.0.9001. run fledge::bump_version() early mistake (e.g. wanted one code edit), can run fledge::unbump_version()! happen immediately bumping. pushed edited code meantime, ’s late – just continue assign new version done edits.","code":"# Only show number of files, messages knitr::kable(gert::git_log()[-(1:3)]) fledge::bump_version() ## → Digesting messages from 4 commits. ## ✔ Found 2 NEWS-worthy entries. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.0.9001. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.0.9001 with tag message derived from 'NEWS.md'. ## ! Run `fledge::finalize_version(push = TRUE)`."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"review-news-md","dir":"Articles","previous_headings":"The development phase","what":"Review NEWS.md","title":"Using fledge","text":"Let us see NEWS.md looks like bump. reviewing notice typo one comments (congrats noticed right away typed “tee” instead “tea”!). fledge package adds comment editing NEWS.md hand NEWS.md actually can… right! Read . Let’s fix typo, ’d hand. affect original commit message, NEWS.md. (Editing commit messages something fledge supports).","code":"news <- readLines(\"NEWS.md\") cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tee. ##  ## - Added a `NEWS.md` file to track changes to the package. news <- gsub(\"tee\", \"tea\", news) cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package. writeLines(news, \"NEWS.md\")"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"finalize-version","dir":"Articles","previous_headings":"The development phase","what":"Finalize version","title":"Using fledge","text":"tweaking NEWS.md, important use fledge::finalize_version() commit manually. Using fledge::finalize_version() instead committing manually ensures tag set correct version spite NEWS.md update. called NEWS.md manually updated. Note called fledge::bump_version(), error raised another commit added . Let’s look NEWS.md now: version package 0.0.0.9001. tag created version good practice, crucial using fledge: updating changelog, fledge looks commit messages since latest tag.","code":"show_tags(remote_url) ## # A tibble: 0 × 2 ## # ℹ 2 variables: name <chr>, ref <chr> fledge::finalize_version(push = TRUE) ## → Resetting to previous commit. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Deleting existing tag v0.0.0.9001. ## → Creating tag v0.0.0.9001 with tag message derived from 'NEWS.md'. ## → Pushing main. ## → Force-pushing tag v0.0.0.9001. show_tags(remote_url) ## # A tibble: 1 × 2 ##   name        ref                   ##   <chr>       <chr>                 ## 1 v0.0.0.9001 refs/tags/v0.0.0.9001 news <- readLines(\"NEWS.md\") cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"change-code-and-commit","dir":"Articles","previous_headings":"The development phase","what":"Change code and commit","title":"Using fledge","text":"{tea} cup tested, now want enhance bowl. requires changes code, perhaps new test. create branch (whose name starts “f” “feature”) switch branch implement . branch, separate commits used tests implementation. commit messages need formatted specially, {fledge} ignore anyway. time write tests first, test-driven development. branch can pushed remote usual. merging specify message included changelog, bullet.1 might used merges remote (e.g. GitHub pull requests) demonstrate local merge commit. strategy can used merging pull/merge/… request GitHub, GitLab, …: use bullet points merge commit message indicate items include NEWS.md. Now added bowl support package, time bump version . seems even need amend NEWS.md hand time made typo!","code":"gert::git_branch_create(\"f-bowl\", checkout = TRUE) usethis::use_test(\"bowl\") ## ✔ Writing 'tests/testthat/test-bowl.R'. ## ☐ Edit 'tests/testthat/test-bowl.R'. gert::git_add(\"tests/testthat/test-bowl.R\") gert::git_commit(\"Add bowl tests.\") usethis::use_r(\"bowl\") ## ☐ Edit 'R/bowl.R'. writeLines(\"# bowl of tea\", \"R/bowl.R\") gert::git_add(\"R/bowl.R\") gert::git_commit(\"Add bowl implementation.\") gert::git_branch_checkout(\"main\") gert::git_merge(\"f-bowl\", commit = FALSE) ## Merge was not committed due to merge conflict(s). Please fix and run git_commit() or git_merge_abort() gert::git_commit(\"- New bowl_of_tea() function makes it easy to drink a bowl of tea.\") fledge::bump_version() ## → Digesting messages from 1 commits. ## ✔ Found 1 NEWS-worthy entry. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.0.9002. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.0.9002 with tag message derived from 'NEWS.md'. ## ! Run `fledge::finalize_version(push = TRUE)`. news <- readLines(\"NEWS.md\") writeLines(news) ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.0.9002 ##  ## - New bowl_of_tea() function makes it easy to drink a bowl of tea. ##  ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package. fledge::finalize_version(push = TRUE) ## → Resetting to previous commit. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## ℹ Tag v0.0.0.9002 exists and points to the current commit. ## → Pushing main. ## → Force-pushing tag v0.0.0.9002."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"prepare-for-release","dir":"Articles","previous_headings":"","what":"Prepare for release","title":"Using fledge","text":"multiple cycles development, review testing, decide package ready release CRAN. {fledge} simplifies release process making use commit messages provided earlier. difference publishing CRAN publishing GitHub ’s external system controlling publication CRAN package might need tweaks first release candidate version end publishing CRAN.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"bump-version-for-release","dir":"Articles","previous_headings":"Prepare for release","what":"Bump version for release","title":"Using fledge","text":"wish release package patch use fledge::bump_version() “patch” argument. values arguments “dev” (default), “minor” “major”. updates version package 0.0.1.","code":"fledge::bump_version(\"patch\") ## → Digesting messages from 1 commits. ## ℹ Same as previous version. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.1. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Preparing package for CRAN release ── ##  ## • Convert the change log in 'NEWS.md' to release notes."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"generate-release-notes","dir":"Articles","previous_headings":"Prepare for release","what":"Generate release notes","title":"Using fledge","text":"review NEWS.md generated {fledge}: intermediate commit messages relevant release notes release. need edit NEWS.md convert changelog meaningful release notes. E.g. real life might re-organize bullets. Unlike development versions, commit changes NEWS.md manually, fledge function. package now ready released CRAN. prefer devtools::use_release_issue() create checklist things release, devtools::submit_cran() submit. devtools::release() function verbose alternative.","code":"news <- readLines(\"NEWS.md\") cat(news, sep = \"\\n\") ## <!-- NEWS.md is maintained by https://fledge.cynkra.com, contributors should not edit this file --> ##  ## # tea 0.0.1 ##  ## - Same as previous version. ##  ##  ## # tea 0.0.0.9002 ##  ## - New bowl_of_tea() function makes it easy to drink a bowl of tea. ##  ##  ## # tea 0.0.0.9001 ##  ## - Add tests for cup of tea. ##  ## - New cup_of_tea() function makes it easy to drink a cup of tea. ##  ## - Added a `NEWS.md` file to track changes to the package."},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"after-release","dir":"Articles","previous_headings":"","what":"After release","title":"Using fledge","text":"time passed {tea} package accepted CRAN. stage, {fledge} can help tag released version create new version development.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"tag-version","dir":"Articles","previous_headings":"After release","what":"Tag version","title":"Using fledge","text":"now time tag released version using fledge::tag_version() function. advised push remote, git push --tags command line, favorite Git client.","code":"fledge::tag_version() ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.1 with tag message derived from 'NEWS.md'. show_tags(remote_url) ## # A tibble: 2 × 2 ##   name        ref                   ##   <chr>       <chr>                 ## 1 v0.0.0.9001 refs/tags/v0.0.0.9001 ## 2 v0.0.0.9002 refs/tags/v0.0.0.9002"},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"create-github-release","dir":"Articles","previous_headings":"After release","what":"Create GitHub release","title":"Using fledge","text":"package hosted GitHub, usethis::use_github_release() creates draft GitHub release contents already NEWS.md. need submit draft release GitHub release page.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/demo.html","id":"restart-development","dir":"Articles","previous_headings":"After release","what":"Restart development","title":"Using fledge","text":"now make package ready future development. fledge::bump_version() takes care . Push remote, add features relevant commits (mergining branch ), bump_version(), etc. Happy development, happy smooth filling changelog!","code":"fledge::bump_version() ## → Digesting messages from 1 commits. ## ℹ Same as previous version. ##  ## ── Updating NEWS ── ##  ## → Adding new entries to 'NEWS.md'. ##  ## ── Updating Version ── ##  ## ✔ Package version bumped to 0.0.1.9000. ## → Added header to 'NEWS.md'. ## → Committing changes. ##  ## ── Tagging Version ── ##  ## → Creating tag v0.0.1.9000 with tag message derived from 'NEWS.md'. ## ! Run `fledge::finalize_version(push = TRUE)`. news <- readLines(\"NEWS.md\") unlink(parent_dir, recursive = TRUE)"},{"path":[]},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"once-per-machine","dir":"Articles","previous_headings":"Installation & setup","what":"Once per machine","title":"Get started with fledge","text":"Install CRAN using: Install cynkra’s R-universe (development version) using: install GitHub (development version well) using: used making workflow packages (e.g. devtools) available interactive work, might enjoy loading fledge .Rprofile.","code":"install.packages(\"fledge\") install.packages(\"fledge\", repos = c(\"https://cynkra.r-universe.dev\", \"https://cloud.r-project.org\")) remotes::install_github(\"cynkra/fledge\")"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"once-per-package","dir":"Articles","previous_headings":"Installation & setup","what":"Once per package","title":"Get started with fledge","text":"package needs remote indicates default branch (e.g. GitHub remote) using default branch name global/project init.defaultbranch. Add mention fledge usage contributing guide, contributors might know . comment added top NEWS.md, tends ignored occasionally.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"for-full-use","dir":"Articles","previous_headings":"Installation & setup > Once per package","what":"For full use","title":"Get started with fledge","text":"package… brand-new, remember run fledge::bump_version() regularly. already undergone development, late jump train! Run fledge::bump_version() fledge::finalize_version().","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"for-light-use","dir":"Articles","previous_headings":"Installation & setup > Once per package","what":"For light use","title":"Get started with fledge","text":"package needs development version header produced usethis::use_development_version().","code":"# mypackage (development version)"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"functions","dir":"Articles","previous_headings":"","what":"Functions","title":"Get started with fledge","text":"{fledge} consists following functions enable versioning different stages package development lifecycle.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"full-fledge-usage","dir":"Articles","previous_headings":"","what":"Full fledge usage","title":"Get started with fledge","text":"following sections show combine functions different stages R package GitHub. {fledge} commands issued package directory target R package.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"initial-configuration","dir":"Articles","previous_headings":"Full fledge usage","what":"Initial Configuration","title":"Get started with fledge","text":"{fledge} assumes target R package version-controlled Git dedicated repository. following steps required set {fledge} first time use, package. Call bump_version() given set package version Edit NEWS.md required (typo fixes, rephrasing, grouping). Call finalize_version() given update NEWS.md set switch development stage now. Ensure use bullet points (* -) commit merge messages indicate messages want include NEWS.md. Use finalize_version(push = TRUE) push remote repository (e.g. GitHub) one swoop.","code":"fledge::bump_version() fledge::finalize_version()"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"development","dir":"Articles","previous_headings":"Full fledge usage","what":"Development","title":"Get started with fledge","text":"{fledge} aims update NEWS.md DESCRIPTION correctly whenever new version assigned. order , following steps need included throughout development workflow. commit messages main branch (typically main master), mark everything go NEWS.md bullet point (- *). applicable single commits, merge commits, squash commits pull requests. edit NEWS.md manually. want assign version number current state R package e.g. end day break, call default argument bump_version “dev”. dev part version number updated. good practice assign new version number switching focus another project. Edit NEWS.md required (typo fixes, rephrasing, grouping). Call finalize_version(): fledge::finalize_version(). achieves following: NEWS.md now composed, based recent commit messages. understand NEWS.md updated fledge, see section NEWS.md implementation. new version number assigned automatically (modeled usethis::use_version()). tag matching version number assigned automatically, recent NEWS.md messages included tag’s message.","code":"fledge::bump_version()"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"releasing-to-cran","dir":"Articles","previous_headings":"Full fledge usage","what":"Releasing to CRAN","title":"Get started with fledge","text":"want release package CRAN, follow steps : Call bump_version() appropriate argument (\"patch\", \"major\", \"minor\"). e.g., Edit NEWS.md, convert “change log” “release notes” – higher-level description features bug fixes (typo fixes, rephrasing, grouping). Call commit_version() Make necessary adjustments releasing CRAN depending results preparatory / incoming checks. release/changes accepted CRAN, use following calls tag released version switch development version immediately. Return development mode!","code":"fledge::bump_version(\"patch\") fledge::commit_version() fledge::tag_version() fledge::bump_version()"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"faq-edge-cases","dir":"Articles","previous_headings":"","what":"FAQ & edge cases","title":"Get started with fledge","text":"least think questions asked. Feel free also ask us questions!","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"but-what-if-i-want-to-edit-news-md-manually","dir":"Articles","previous_headings":"FAQ & edge cases","what":"But what if I want to edit NEWS.md manually?","title":"Get started with fledge","text":"still can! best moment bump_version() finalize_version(push = TRUE). can actually edit time, two calls text changelog captured tag message, better tag history.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"what-if-a-contributor-wants-to-contribute-a-news-item","dir":"Articles","previous_headings":"FAQ & edge cases","what":"What if a contributor wants to contribute a NEWS item?","title":"Get started with fledge","text":"someone opens PR, fledge information changes entered message merge squash commit. Now still advise contributors provide summary change comment PR.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"does-this-mean-fix-42-will-appear-in-news-md","dir":"Articles","previous_headings":"FAQ & edge cases","what":"Does this mean “Fix #42” will appear in NEWS.md?","title":"Get started with fledge","text":"want fix issue commit message can put “Fix #42” separate non-bulleted line line 3 hyphens. PR e.g. GitHub can link issue PR starting first comment “Fix 42” issue closed. merge squash commit hyperlinked PR, commit message won’t phrase. still add acknowledgement actual commit message e.g. “- Adds support coolness (#42, @contributor)”.","code":"- Adds support for coolness (#42, @contributor).  ---  Fix #42"},{"path":"https://fledge.cynkra.com/dev/articles/fledge.html","id":"edge-cases","dir":"Articles","previous_headings":"FAQ & edge cases","what":"Edge cases","title":"Get started with fledge","text":"rebase creating tag, need call finalize_version() make sure tag moved mainline branch. pushed via finalize_version(push = TRUE) git push, tag may pushed well. case, invoke (x.y.z.9www new version) delete newly created remote tag. reason {fledge} tags \"dev\" releases automatically. releases always must tagged manually tag_version().","code":"git push origin :vx.y.z.9www"},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"implementation","dir":"Articles","previous_headings":"","what":"Implementation","title":"Fledge internals","text":"following sections explain things actually work inside fledge.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"updating-news-md","dir":"Articles","previous_headings":"Implementation","what":"Updating NEWS.md","title":"Fledge internals","text":"New entries added NEWS.md commit messages commits master. top-level commits considered (roughly equivalent git log --first-parent.) messages commits parsed. lines start star * dash - included. line starts three dashes, everything past line excluded. Example: following commit message added NEWS.md: retrieving current NEWS defining tag message, entries first two first-level headers (starting #) returned. can use second third level headers add many empty lines want.","code":"Merge f-fancy-feature to master, closes #5678  - Added fancy feature (#5678).  - Fixed bug as a side effect (#9012).  ---  The fancy feature consists of the components:  - foo - bar - baz - Added fancy feature (#5678). - Fixed bug as a side effect (#9012)."},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"collecting-news","dir":"Articles","previous_headings":"Implementation","what":"Collecting NEWS","title":"Fledge internals","text":"first function call stage always bump_version(). following Calls update_news() collect NEWS entries top-level commits increment version DESCRIPTION add header NEWS.md.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/internals.html","id":"tagging-for-dev-vs--other-releases","dir":"Articles","previous_headings":"Implementation","what":"Tagging for “dev” vs. other releases","title":"Fledge internals","text":"bump_version() continues depending release type: \"dev\" releases: Calls finalize_version() commit DESCRIPTION NEWS.md. Also creates tag message. can always edit NEWS.md call finalize_version() . commit tag updated. releases: Calls commit_version() commit DESCRIPTION NEWS.md without tagging. stage, can edit NEWS.md commit much like. tag created use tag_version() manually.","code":""},{"path":"https://fledge.cynkra.com/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Kirill Müller. Author, maintainer, copyright holder. Patrick Schratz. Author. Maëlle Salmon. Contributor.","code":""},{"path":"https://fledge.cynkra.com/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Müller K, Schratz P (2024). fledge: Smoother Change Tracking Versioning R Packages. R package version 0.1.99.9036, https://github.com/cynkra/fledge, https://fledge.cynkra.com/.","code":"@Manual{,   title = {fledge: Smoother Change Tracking and Versioning for R Packages},   author = {Kirill Müller and Patrick Schratz},   year = {2024},   note = {R package version 0.1.99.9036,     https://github.com/cynkra/fledge},   url = {https://fledge.cynkra.com/}, }"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"fledge","dir":"","previous_headings":"","what":"Smoother Change Tracking and Versioning for R Packages","title":"Smoother Change Tracking and Versioning for R Packages","text":"Smoother change tracking versioning R packages. want provide changelog (NEWS.md) informative “bug fixes performance improvements” (https://twitter.com/EmilyKager/status/1413628436984188933) users package? Ways achieve : Update NEWS.md right release reading commit messages. necessarily fun! Update changelog every commit e.g. every PR. Now, several feature PRs around update changelog, ’ll clicks make tackle conflicts. Easy enough, potentially annoying. Use fledge fill NEWS.md based informative commit messages, (optionally) increase version number DESCRIPTION (e.g. useful bug reports session information!), (optionally) create git tags (coarse-grained history compared top-level merges see fledge tag list GitHub). Using fledge discipline, habits, worth learning! need practice , matter fledge commitment level: important commit messages want recorded changelog, can Use conventional commits syntax. instance feat: Enhanced support time series. using conventional commits syntax provide automatic grouping changelog items groups (Documentation, Bug Fixes, etc.). Add hyphen - * beginning commit message. Exclude housekeeping parts message typing line ---. Use informative merge commit messages also included default changelog. GitHub can control default commit message merging pull request. (GitHub repositories ) merge commits default self-contained message (“Merge pull request…”), rely fledge’s querying GitHub API get PR title include changelog. informative commit messages refer Tidyverse style guide. , full fledge use = fledge-assisted management NEWS.md, DESCRIPTION version numbers, git tags: Run fledge::bump_version() regularly e.g. every coffee break end day week. forgot merge one PR run fledge::unbump_version(), merge PR informative squash commit message, run fledge::bump_version() go drink coffee! Run fledge::finalize_version() need edit NEWS.md manually e.g. made typo happy phrasing retrospect. Even edit lot, ’s written fledge still good place-holder. Follow recommended steps release (see vignette(\"fledge\") usage section). , light fledge use = filling NEWS.md releases: development version header produced usethis::use_development_version(). Regularly run fledge::update_news(), preferentially main branch avoid merge conflicts. habits worth learning!","code":"- Add support for bla databases. - Add support for bla databases.  ---  Also tweak the CI workflow accordingly. :sweat_smile: # mypackage (development version)"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"demo","dir":"","previous_headings":"","what":"Demo","title":"Smoother Change Tracking and Versioning for R Packages","text":"Click image show separate tab.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/index.html","id":"once-per-machine","dir":"","previous_headings":"Installation & setup","what":"Once per machine","title":"Smoother Change Tracking and Versioning for R Packages","text":"Install CRAN using: Install cynkra’s R-universe (development version) using: install GitHub (development version well) using: used making workflow packages (e.g. devtools) available interactive work, might enjoy loading fledge .Rprofile.","code":"install.packages(\"fledge\") install.packages(\"fledge\", repos = c(\"https://cynkra.r-universe.dev\", \"https://cloud.r-project.org\")) remotes::install_github(\"cynkra/fledge\")"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"once-per-package","dir":"","previous_headings":"Installation & setup","what":"Once per package","title":"Smoother Change Tracking and Versioning for R Packages","text":"package needs remote indicates default branch (e.g. GitHub remote) using default branch name global/project init.defaultbranch. Add mention fledge usage contributing guide, contributors might know . comment added top NEWS.md, tends ignored occasionally.","code":""},{"path":"https://fledge.cynkra.com/dev/index.html","id":"for-full-use","dir":"","previous_headings":"Installation & setup > Once per package","what":"For full use","title":"Smoother Change Tracking and Versioning for R Packages","text":"package… brand-new, remember run fledge::bump_version() regularly. already undergone development, late jump train! Run fledge::bump_version() fledge::finalize_version().","code":""},{"path":"https://fledge.cynkra.com/dev/index.html","id":"for-light-use","dir":"","previous_headings":"Installation & setup > Once per package","what":"For light use","title":"Smoother Change Tracking and Versioning for R Packages","text":"package needs development version header produced usethis::use_development_version().","code":"# mypackage (development version)"},{"path":"https://fledge.cynkra.com/dev/index.html","id":"how-to-get-started","dir":"","previous_headings":"","what":"How to get started?","title":"Smoother Change Tracking and Versioning for R Packages","text":"Check general vignette vignette(\"fledge\"), whole game, demo vignette vignette(\"demo\"). Feel free ask us questions!","code":""},{"path":"https://fledge.cynkra.com/dev/index.html","id":"related-tools","dir":"","previous_headings":"","what":"Related tools","title":"Smoother Change Tracking and Versioning for R Packages","text":"newsmd: manually add updates (version bullet points) NEWS.md file. autonewsmd: Auto-Generate Changelog using Conventional Commits.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Bump package version — bump_version","title":"Bump package version — bump_version","text":"Calls following functions: Verify current branch main branch check_default_branch = TRUE (default). update_news(), using argument. result, check meaningful changes since last version. Depending argument: \"dev\", finalize_version() push = FALSE Otherwise, commit_version().","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Bump package version — bump_version","text":"","code":"bump_version(   which = c(\"dev\", \"pre-patch\", \"patch\", \"pre-minor\", \"minor\", \"pre-major\", \"major\"),   ...,   no_change_behavior = c(\"bump\", \"noop\", \"fail\"),   check_default_branch = TRUE )"},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Bump package version — bump_version","text":"Component version number update. Supported values \"auto\" (default: \"samedev\" \"dev\", depending contents NEWS.md), \"samedev\" (.b.c.900x stable version), \"dev\" (.b.c.9xxx), \"patch\" (.b.x), \"pre-minor\" (.b.99.9000), \"minor\" (.x.0), \"pre-major\" (.99.99.9000), \"major\" (x.0.0). ... dots future extensions must empty. no_change_behavior change since last version: \"bump\" bump version; \"noop\" nothing; \"fail\" erroring. check_default_branch Whether check current branch default branch.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Bump package version — bump_version","text":"TRUE NEWS.md DESCRIPTION updated, FALSE otherwise. rely behavior.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"bumped-too-soon-","dir":"Reference","previous_headings":"","what":"Bumped too soon?","title":"Bump package version — bump_version","text":"just run bump_version(), realized \"oh shoot, forgot merge PR\"? Fear , run unbump_version(), merge PR, run bump_version().","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/reference/bump_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Bump package version — bump_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version() }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b1b85bf38/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Commits NEWS.md and DESCRIPTION to Git — commit_version","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"Commits changes NEWS.md DESCRIPTION, amending previous commit created fledge necessary.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"","code":"commit_version()"},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"Invisibly: TRUE previous commit version amended, FALSE .","code":""},{"path":"https://fledge.cynkra.com/dev/reference/commit_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Commits NEWS.md and DESCRIPTION to Git — commit_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   desc::desc_add_author(given = \"Jane\", family = \"Doe\", role = \"ctb\")   fledge::commit_version() }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b78012c28/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":null,"dir":"Reference","previous_headings":"","what":"Create example repo for fledge demos — create_demo_project","title":"Create example repo for fledge demos — create_demo_project","text":"Create example repo fledge demos","code":""},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create example repo for fledge demos — create_demo_project","text":"","code":"create_demo_project(   open = rlang::is_interactive(),   name = \"tea\",   maintainer = NULL,   email = NULL,   date = \"2021-09-27\",   dir = file.path(tempdir(), \"fledge\"),   news = FALSE )"},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create example repo for fledge demos — create_demo_project","text":"open Whether open new project. name Package name. maintainer Name DESCRIPTION git. email Email DESCRIPTION git. date String time DESCRIPTION git. dir Directory within create mock package folder. news TRUE, create NEWS.md file.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/create_demo_project.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create example repo for fledge demos — create_demo_project","text":"path newly created mock package.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Finalize package version — finalize_version","title":"Finalize package version — finalize_version","text":"Calls following functions: commit_version() tag_version() force = TRUE Force-pushes created tag \"origin\" remote, push = TRUE.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Finalize package version — finalize_version","text":"","code":"finalize_version(push = FALSE)"},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Finalize package version — finalize_version","text":"push TRUE, push created tag.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Finalize package version — finalize_version","text":"None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/finalize_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Finalize package version — finalize_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   # Edit news by hand   # ...   # Once done   fledge::finalize_version() }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483bd43cb5b/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":null,"dir":"Reference","previous_headings":"","what":"The most recent tag — get_last_tag","title":"The most recent tag — get_last_tag","text":"Returns recent Git tag reachable current branch. accurate version bump tag occurred branch squashed main branch. See get_last_version_tag() version works scenario.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"The most recent tag — get_last_tag","text":"","code":"get_last_tag()"},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"The most recent tag — get_last_tag","text":"one-row tibble columns name, ref commit. annotated tags (created fledge), commit may different SHA commit tag points . Use gert::git_log() find actual commit.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_tag.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"The most recent tag — get_last_tag","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::finalize_version()   print(get_top_level_commits(since = NULL))   print(fledge::get_last_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b73617058/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> # A tibble: 4 × 3 #>   commit                                   message                         merge #>   <chr>                                    <chr>                           <lgl> #> 1 3fca6460b6ff953dc710ee01185726f84cd98c1f \"fledge: Bump version to 0.0.0… FALSE #> 2 ef7820d3213ca82a9ed02bb4529ff466c24f8ddd \"- Add cool function.\\n\"        FALSE #> 3 b473d8ea7fe4af7189a3f673e6a9efe36cee5395 \"Add NEWS.md to track changes.… FALSE #> 4 70e0d17ddfcfe6434e67c983b2c12586816baddc \"First commit\\n\"                FALSE #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #> * <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 c6732b4414ae96f74b1ad762224d8e89f5016319 #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":null,"dir":"Reference","previous_headings":"","what":"The most recent versioned tag — get_last_version_tag","title":"The most recent versioned tag — get_last_version_tag","text":"Returns Git tag form vx.y, vx.y.z vx.y.z.w latest version. older version logic used get_last_tag(), traverses Git history work squash-merging version bumps.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"The most recent versioned tag — get_last_version_tag","text":"","code":"get_last_version_tag()"},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"The most recent versioned tag — get_last_version_tag","text":"one-row tibble columns name, ref commit. annotated tags (created fledge), commit may different SHA commit tag points . Use gert::git_log() find actual commit.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_last_version_tag.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"The most recent versioned tag — get_last_version_tag","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Switch to branch for bumping version.   gert::git_branch_create(\"fledge\")   # Bump version with fledge.   fledge::bump_version(check_default_branch = FALSE)   fledge::finalize_version()    # Merge the version bump branch into main.   gert::git_branch_checkout(\"main\")   gert::git_merge(\"fledge\", squash = TRUE)    print(get_top_level_commits(since = NULL))    # get_last_tag() doesn't work in this scenario   print(fledge::get_last_tag())    # get_last_version_tag() is better   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b760f9adc/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> Performing fast-forward merge, no commit needed #> # A tibble: 4 × 3 #>   commit                                   message                         merge #>   <chr>                                    <chr>                           <lgl> #> 1 5a1fb5ca424db57b6f9738f667ad0ef3846988fd \"fledge: Bump version to 0.0.0… FALSE #> 2 4f46f5ca93f0cb9f0ac7efbe3baa1d7b103919b9 \"- Add cool function.\\n\"        FALSE #> 3 b473d8ea7fe4af7189a3f673e6a9efe36cee5395 \"Add NEWS.md to track changes.… FALSE #> 4 70e0d17ddfcfe6434e67c983b2c12586816baddc \"First commit\\n\"                FALSE #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #> * <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 1159859ccdf7dc62f1afd47e429fb942df8bc90a #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #>   <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 1159859ccdf7dc62f1afd47e429fb942df8bc90a #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":null,"dir":"Reference","previous_headings":"","what":"All top-level commits — get_top_level_commits","title":"All top-level commits — get_top_level_commits","text":"Return top-level commits since particular version commit objects.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"All top-level commits — get_top_level_commits","text":"","code":"get_top_level_commits(since = NULL)"},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"All top-level commits — get_top_level_commits","text":"since commit SHA, e.g. returned commit component get_last_version_tag(). NULL, entire log retrieved.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"All top-level commits — get_top_level_commits","text":"tibble::tibble least two columns: commit: commit SHA message: commit message","code":""},{"path":"https://fledge.cynkra.com/dev/reference/get_top_level_commits.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"All top-level commits — get_top_level_commits","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::finalize_version()   print(get_top_level_commits(since = NULL))   print(fledge::get_last_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b64eaf4bd/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Resetting to previous commit. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> ℹ Tag v0.0.0.9001 exists and points to the current commit. #> # A tibble: 4 × 3 #>   commit                                   message                         merge #>   <chr>                                    <chr>                           <lgl> #> 1 f140e1265c8490124c350a927097abf65fa5466a \"fledge: Bump version to 0.0.0… FALSE #> 2 3261730f012d0d836c3ca9d33a3d582825a1f0f2 \"- Add cool function.\\n\"        FALSE #> 3 b473d8ea7fe4af7189a3f673e6a9efe36cee5395 \"Add NEWS.md to track changes.… FALSE #> 4 70e0d17ddfcfe6434e67c983b2c12586816baddc \"First commit\\n\"                FALSE #> # A tibble: 1 × 3 #>   name        ref                   commit                                   #> * <chr>       <chr>                 <chr>                                    #> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 70279f59020f33f3df62c8a42e545e14e1a4c696 #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":null,"dir":"Reference","previous_headings":"","what":"Automating CRAN release — plan_release","title":"Automating CRAN release — plan_release","text":"plan_release() run milestone development package reached ready sent CRAN. default, function initiate pre-release, indicated 9900 fourth component version number. Pass = \"patch\", = \"minor\", = \"major\" initiate release corresponding version number. release() sends CRAN performing several checks, offers help accepting submission. post_release() called submission accepted.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Automating CRAN release — plan_release","text":"","code":"plan_release(   which = c(\"pre-patch\", \"pre-minor\", \"pre-major\", \"next\", \"patch\", \"minor\", \"major\"),   force = FALSE )  release()  post_release()"},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Automating CRAN release — plan_release","text":"Component version number update. Supported values \"pre-patch\" (default, x.y.z.9900) \"pre-minor\" (x.y.99.9900), \"pre-major\" (x.99.99.9900), \"next\" (\"major\" current version x.99.99.9yyy, \"minor\" current version x.y.99.9zzz, \"patch\" otherwise), \"patch\" \"minor\", \"major\". force Create branches tags even exist. Useful recover previously failed attempt.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/release.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Automating CRAN release — plan_release","text":"plan_release(): Ensures modified files Git index. Creates pre-release release branch bumps version accordingly. Writes/updates cran-comments.md useful information current release process. Runs urlchecker::url_update(), devtools::check_win_devel(), rhub::rhub_check(platforms = rhub::rhub_platforms()$name) background RStudio IDE, prompts user . Opens pull request release branch final checks.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a new version tag — tag_version","title":"Create a new version tag — tag_version","text":"Parses NEWS.md creates/updates tag recent version.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a new version tag — tag_version","text":"","code":"tag_version(force = FALSE)"},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a new version tag — tag_version","text":"force Re-tag even last commit created bump_version().  Useful defining CRAN release.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a new version tag — tag_version","text":"created tag, invisibly. None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/tag_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a new version tag — tag_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::update_news(c(\"- something I forgot\", \"- blabla\"), which = \"patch\")   gert::git_add(\"NEWS.md\")   gert::git_commit(message = \"release notes tweaking\")   fledge::tag_version()   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b7b16be54/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Digesting messages from 2 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.1. #> → Added header to NEWS.md. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.1 with tag message derived from NEWS.md. #> # A tibble: 1 × 3 #>   name   ref              commit                                   #>   <chr>  <chr>            <chr>                                    #> 1 v0.0.1 refs/tags/v0.0.1 f08b62035de19e276e13ada8d9c876729d121cdc #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Undoes bumping the package version — unbump_version","title":"Undoes bumping the package version — unbump_version","text":"undoes effect bump_version() call, safety check.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Undoes bumping the package version — unbump_version","text":"","code":"unbump_version()"},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Undoes bumping the package version — unbump_version","text":"NULL, invisibly. function called side effects. None","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/reference/unbump_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Undoes bumping the package version — unbump_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   # Oh no, we forgot to also add the awesome function for that version!   # UNBUMP   fledge::unbump_version()   # Add a new R file.   usethis::use_r(\"awesome-function\", open = FALSE)   # Pretend we added awesome code inside it.   # Track the new R file with Git.   gert::git_add(\"R/awesome-function.R\")   gert::git_commit(\"- Add awesome function.\")   # Bump version with fledge.   fledge::bump_version()   #' }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b719cd43b/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ℹ Checking if working copy is clean. #> ℹ Checking if last tag points to last commit. #> ℹ Checking if commit messages match. #> ✔ Safety checks complete. #> → Deleting tag v0.0.0.9001. #> ✔ Resetting to parent commit 42. #> ☐ Edit R/awesome-function.R. #> → Digesting messages from 4 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":null,"dir":"Reference","previous_headings":"","what":"Update NEWS.md with messages from top-level commits — update_news","title":"Update NEWS.md with messages from top-level commits — update_news","text":"Lists commits range (default: top-level commits since recent tag determined get_last_version_tag()) adds bullets body NEWS.md. Creates NEWS.md necessary.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update NEWS.md with messages from top-level commits — update_news","text":"","code":"update_news(   messages = NULL,   which = c(\"auto\", \"samedev\", \"dev\", \"pre-patch\", \"patch\", \"pre-minor\", \"minor\",     \"pre-major\", \"major\") )"},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update NEWS.md with messages from top-level commits — update_news","text":"messages character vector commit messages, e.g. message column return value get_top_level_commits(). default uses top level commits since last tag retrieved get_last_version_tag(). Component version number update. Supported values \"auto\" (default: \"samedev\" \"dev\", depending contents NEWS.md), \"samedev\" (.b.c.900x stable version), \"dev\" (.b.c.9xxx), \"patch\" (.b.x), \"pre-minor\" (.b.99.9000), \"minor\" (.x.0), \"pre-major\" (.99.99.9000), \"major\" (x.0.0).","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Update NEWS.md with messages from top-level commits — update_news","text":"None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_news.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Update NEWS.md with messages from top-level commits — update_news","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::update_news(c(\"- something I forgot\", \"- blabla\"), which = \"patch\")   gert::git_add(\"NEWS.md\")   gert::git_commit(message = \"release notes tweaking\")   fledge::tag_version()   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b26882bed/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Digesting messages from 2 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.1. #> → Added header to NEWS.md. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.1 with tag message derived from NEWS.md. #> # A tibble: 1 × 3 #>   name   ref              commit                                   #>   <chr>  <chr>            <chr>                                    #> 1 v0.0.1 refs/tags/v0.0.1 e910aa7073fe0869418785417fa2f05a414abb4c #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":null,"dir":"Reference","previous_headings":"","what":"Update NEWS.md and DESCRIPTION with a new version — update_version","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"Deprecated, use update_news().","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"","code":"update_version(   which = c(\"auto\", \"samedev\", \"dev\", \"patch\", \"pre-minor\", \"minor\", \"pre-major\",     \"major\") )"},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"Component version number update. Supported values \"auto\" (default: \"samedev\" \"dev\", depending contents NEWS.md), \"samedev\" (.b.c.900x stable version), \"dev\" (.b.c.9xxx), \"patch\" (.b.x), \"pre-minor\" (.b.99.9000), \"minor\" (.x.0), \"pre-major\" (.99.99.9000), \"major\" (x.0.0).","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"None","code":""},{"path":"https://fledge.cynkra.com/dev/reference/update_version.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Update NEWS.md and DESCRIPTION with a new version — update_version","text":"","code":"# Create mock package in a temporary directory. # Set open to TRUE if you want to play in the mock package. with_demo_project({   # Use functions as if inside the newly created package project.   # (Or go and actually run code inside the newly created package project!)   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version()   fledge::update_news(c(\"- something I forgot\", \"- blabla\"), which = \"patch\")   gert::git_add(\"NEWS.md\")   gert::git_commit(message = \"release notes tweaking\")   fledge::tag_version()   print(fledge::get_last_version_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b7a44f6c4/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> → Digesting messages from 2 commits. #> ✔ Found 2 NEWS-worthy entries. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.1. #> → Added header to NEWS.md. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.1 with tag message derived from NEWS.md. #> # A tibble: 1 × 3 #>   name   ref              commit                                   #>   <chr>  <chr>            <chr>                                    #> 1 v0.0.1 refs/tags/v0.0.1 47fcb26ecb87639d2523a8ca612249f6bfb212be #> ✔ Setting active project to \"<no active project>\"."},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":null,"dir":"Reference","previous_headings":"","what":"Run code in temporary project — with_demo_project","title":"Run code in temporary project — with_demo_project","text":"Run code temporary project","code":""},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run code in temporary project — with_demo_project","text":"","code":"with_demo_project(code, dir = NULL, news = TRUE, quiet = FALSE)  local_demo_project(   dir = NULL,   news = TRUE,   quiet = FALSE,   .local_envir = parent.frame() )"},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run code in temporary project — with_demo_project","text":"code Code run temporary active project dir Directory within create mock package folder. news TRUE, create NEWS.md file. quiet Whether show messages usethis .local_envir environment use scoping. Defaults current execution environment.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run code in temporary project — with_demo_project","text":"with_demo_project() returns result evaluating code. local_demo_project() called side effect returns NULL, invisibly.","code":""},{"path":"https://fledge.cynkra.com/dev/reference/with_demo_project.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run code in temporary project — with_demo_project","text":"","code":"with_demo_project({   # Add a new R file.   usethis::use_r(\"cool-function\", open = FALSE)   # Pretend we added useful code inside it.   # Track the new R file with Git.   gert::git_add(\"R/cool-function.R\")   gert::git_commit(\"- Add cool function.\")   # Bump version with fledge.   fledge::bump_version() }) #> ✔ Setting active project to \"/tmp/RtmpTP5Kru/fledge483b235e65ac/tea\". #> ☐ Edit R/cool-function.R. #> → Digesting messages from 3 commits. #> ✔ Found 1 NEWS-worthy entry. #>  #> ── Updating NEWS ── #>  #> → Adding new entries to NEWS.md. #>  #> ── Updating Version ── #>  #> ✔ Package version bumped to 0.0.0.9001. #> → Added header to NEWS.md. #> → Committing changes. #>  #> ── Tagging Version ── #>  #> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md. #> ! Run `fledge::finalize_version()`. #> ✔ Setting active project to \"<no active project>\"."},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9036","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9036 (2024-12-12)","text":"Support empty commit messages. is_news_consistent() detects releases kind x.y.z-w. Work around bug order() package versions. Use correct version checking GH release. Use correct version checking GH release. release_after_cran_built_binaries() works correctly (#848).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9036","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9036 (2024-12-12)","text":"Better entry PR info extracted. Support versions form x.y.z-w tagging. Newsworthy commits searched along first parents , picking relevant commits (#847). Determining recent tag now uses new get_last_version_tag() works version tag diverged branch (e.g., squash-merging) (#844). Consistent protection hash tag (#836). Keep empty lines merging (#834). plan_release() pulls current branch (#831).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9036","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9036 (2024-12-12)","text":"Get tagging information fledgling. Clear clipboard successful discovery CRAN URL. Check token early automation (#841). Refactor (#835).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9036","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9036 (2024-12-12)","text":"Install R. Avoid failure fledge workflow changes (#851). Fetch tags fledge workflow avoid unnecessary NEWS entries (#850). Use larger retry count lock-threads workflow (#849). Ignore errors removing pkg-config macOS (#840). Explicit permissions (#839). Use styler main branch (#838). Need install R Ubuntu 24.04 (#837). Use Ubuntu 24.04 styler PR (#829).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9036","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9036 (2024-12-12)","text":"Fix test (#846).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-99-9036","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.99.9036 (2024-12-12)","text":"Ci: Fix macOS (#16) (#830).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9035","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9035 (2024-11-24)","text":"Keep raw NEWS (#827).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9035","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9035 (2024-11-24)","text":"Refactorings new test (#825). Better JSON snapshot (#824). Keep raw component date, use assembling NEWS (#823).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9034","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9034 (2024-11-23)","text":"Distinguish news component news column data frame (#820).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9033 (2024-11-22)","text":"CRAN PRs longer created draft (#810). fledge:::release_after_cran_built_binaries() longer throws error release exists.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9033 (2024-11-22)","text":"finalize_version() unconditionally overwrites existing tags (#819). Pre-releases get different PR title (#818). PR must open main window (#816). plan_release() calls bump_version() (#814). Detect contributors squashed commits (#813). Mention bump_version(check_default_branch = FALSE) error message (#812). New plan_release(), replaces init_release() pre_release() (#803). Support = \"pre-patch\" bump_version() update_version() (#802). bump_version() bump newsworthy messages found (#801). Messages start \"fledge: \" longer considered newsworthy (#800). Include relevant info cran-comments.md (#799). Support pre-patch version, new versioning scheme starting 9900 (#794).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9033 (2024-11-22)","text":"Bump commit messages get fledge prefix. Add fledge prefix CRAN PR (#809).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9033 (2024-11-22)","text":"Remove Aviator (#815). Correctly detect branch protection (#811). Sync fledge workflow.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.99.9033 (2024-11-22)","text":"is_dev_version() related (#805).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9033","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9033 (2024-11-22)","text":"Reduce use shut_up_fledge() (#796). Speed tests replacing gert::git_add() system call (#793). Split slow test.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9032","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9032 (2024-11-11)","text":"Trigger run (#792).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9031","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9031 (2024-10-28)","text":"Use pkgdown branch (#791).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9030","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9030 (2024-09-15)","text":"Install via R CMD INSTALL ., pak (#789).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9029","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9029 (2024-08-31)","text":"Add Aviator configuration.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9029","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9029 (2024-08-31)","text":"Install local package pkgdown builds. Improve support protected branches, without fledge.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9029","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9029 (2024-08-31)","text":"Snapshot updates rcc-smoke (null) (#786).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9028","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9028 (2024-08-19)","text":"Try pushing head first. Try pushing head first, fail branch protection.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9028","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9028 (2024-08-19)","text":"bump_version(check_default_branch = TRUE).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9027","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9027 (2024-08-17)","text":"Auto-update GitHub Actions. Run: https://github.com/cynkra/fledge/actions/runs/10425483871","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9027","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9027 (2024-08-17)","text":"Sync latest developments.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9026","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9026 (2024-08-10)","text":"Use v2 instead master.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9025","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9025 (2024-08-06)","text":"Inline action.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9024","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9024 (2024-08-03)","text":"Snapshot updates R-CMD-check-base (null) (#783).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9023","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9023 (2024-08-02)","text":"Use dev roxygen2 decor.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9023","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9023 (2024-08-02)","text":"Accept snapshots knitr update.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9022","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9022 (2024-07-02)","text":"Fix Windows, tweak lock workflow.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9021","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9021 (2024-06-30)","text":"Auto-update GitHub Actions. Run: https://github.com/cynkra/fledge/actions/runs/9727971994","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9020","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9020 (2024-06-28)","text":"Auto-update GitHub Actions. Run: https://github.com/cynkra/fledge/actions/runs/9691617690","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-99-9020","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.99.9020 (2024-06-28)","text":"Avoid checking bashisms Windows. Remove netlify workflow. Remove special branch. Bump versions, better default, consume custom matrix. Recent updates.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9019","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9019 (2024-06-26)","text":"Update bump-version.R - replace length test get_main_branch_config() (#775).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-99-9018","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.99.9018 (2024-04-16)","text":"Set BS version explicitly now. https://github.com/cynkra/cynkratemplate/issues/53","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9017","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9017 (2024-02-19)","text":"Move responsibility writing fledgeling, memoise, add repo argument (#761).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999016-2024-01-24","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9016 (2024-01-24)","title":"fledge 0.1.99.9016 (2024-01-24)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9015","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9015 (2024-01-15)","text":"Work around r-lib/roxygen2#1570.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9014","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9014 (2023-12-22)","text":"Create releases correct body (#756).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9014","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9014 (2023-12-22)","text":"Add Aviator configuration.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9013","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9013 (2023-11-09)","text":"create_github_release() removes header NEWS entry.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9012","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9012 (2023-11-07)","text":"report installation size problems (#755).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9011","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9011 (2023-11-05)","text":"post_release() longer checks release branch (#750).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9011","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9011 (2023-11-05)","text":"Use news_path() (#751).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9010","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9010 (2023-11-03)","text":"Allow bumping straight released version (#747). post_release() independent release branch (#748).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9010","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9010 (2023-11-03)","text":"Add aviator configuration.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9009","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9009 (2023-10-28)","text":"Release package soon ’s available PPM.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9008","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9008 (2023-10-23)","text":"New init_release(), called pre_release() (#686).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9007","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9007 (2023-10-21)","text":"Automatically merge news dev versions release (#744). extensive preflight checks post_release(), reduce output quiet mode (#740).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9007","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9007 (2023-10-21)","text":"Basic testing scripts (#742).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9006","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9006 (2023-10-19)","text":"Extract error first submission step, fix CRAN submission (#738). Check release exists creating (#731).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9006","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9006 (2023-10-19)","text":"Add version ref arguments create_release_branch(), fix create_release_branch(force = TRUE) (#734). no_change() functions gain ref argument (#733). Pretty check_only_modified() (#705). Refactorings #686 (#729).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9006","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9006 (2023-10-19)","text":"handle NoSuggests checks 😅 (#732).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999005-2023-10-09","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9005 (2023-10-09)","title":"fledge 0.1.99.9005 (2023-10-09)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9004","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9004 (2023-10-03)","text":"efficient data frame access (#706).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-99-9004","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.99.9004 (2023-10-03)","text":"Replace httr httr2 (#712).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"tests-0-1-99-9004","dir":"Changelog","previous_headings":"","what":"tests","title":"fledge 0.1.99.9004 (2023-10-03)","text":"Clean , simplify tests (#716). Add function help run tests without losing one’s current dir (#715).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9003","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9003 (2023-09-26)","text":"Add test upper case conventional commit type (#711).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999002-2023-07-11","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9002 (2023-07-11)","title":"fledge 0.1.99.9002 (2023-07-11)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Ask fledgeling version. Bad merge conflict resolution v0.1.1.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Indent multiline NEWS items. skip_if_offline() calls. Type stability fledgeling object.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Avoid useless computation.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Prefer local_options(repos = NULL) skip_if_offline(). Test order.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-99-9001","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.99.9001 (2023-06-22)","text":"Merge branch ‘cran-0.1.1’.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-01999000-2023-06-21","dir":"Changelog","previous_headings":"","what":"fledge 0.1.99.9000 (2023-06-21)","title":"fledge 0.1.99.9000 (2023-06-21)","text":"Merge branch ‘cran-0.1.1’.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9047","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9047 (2023-06-16)","text":"Guess_next() works expected .99. versions.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9046","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9046 (2023-06-13)","text":"Suppress clipr warnings.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9046","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9046 (2023-06-13)","text":"flexible version extraction release PR title (#678).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9045","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9045 (2023-06-09)","text":"Adapt new behavior usethis::use_news_md() (#680).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9045","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9045 (2023-06-09)","text":"Clean version header parsing (#610).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9044","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9044 (2023-06-06)","text":"Tell merge.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9043","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9043 (2023-06-01)","text":"post_release() works release branch doesn’t change files main branch.","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9042","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9042 (2023-05-28)","text":"Better error message duplicate version name (#673).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-0-9042","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.0.9042 (2023-05-28)","text":"Snapshot updates rcc-smoke (null) (#677).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9041","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9041 (2023-04-18)","text":"Slightly simplify pre_release() (#669).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9040","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9040 (2023-04-13)","text":"bump_version() works interactive sessions NEWS.md preamble () (#638).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9039","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9039 (2023-04-04)","text":"Use pkg version open PR, CRAN page (#662).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"testing-0-1-0-9039","dir":"Changelog","previous_headings":"","what":"Testing","title":"fledge 0.1.0.9039 (2023-04-04)","text":"Snapshot updates rcc-smoke (null) (#660). Snapshot updates rcc-smoke (null) (#647). Fix snapshots updates upstream dependencies (#657).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109038-2023-03-28","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9038 (2023-03-28)","title":"fledge 0.1.0.9038 (2023-03-28)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9037","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9037 (2023-03-24)","text":"write “previous version” first thing brand-new changelog (#655). New internal release_after_cran_built_binaries() support automated CRAN release GHA (#651).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9037","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9037 (2023-03-24)","text":"Update pitch (#656).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9036","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9036 (2023-03-21)","text":"Add ability parse two-line headers (#654).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9036","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9036 (2023-03-21)","text":"Use full power {cli} (#640).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9035","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9035 (2023-03-15)","text":"Add special CRAN release label release PRs (#649).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"tests-0-1-0-9034","dir":"Changelog","previous_headings":"","what":"tests","title":"fledge 0.1.0.9034 (2023-03-08)","text":"Replace httptest httptest2 gh now uses httr2 instead httr (#646).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109033-2023-02-17","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9033 (2023-02-17)","title":"fledge 0.1.0.9033 (2023-02-17)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9032","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9032 (2023-02-12)","text":"Bump dev version pre_release().","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9031","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9031 (2023-02-09)","text":"Update fledge URL NEWS preamble (#622).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Work around unexplicable behavior demo tests. Remove push trigger fledge.yaml, seems broken. bump_version() keeps updating Date field exists DESCRIPTION.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9030 (2023-02-05)","text":"post_release() pulls main branch merging (#525). Closes #525. New mode operation \"samedev\", #147. update_news() gains argument, deprecate update_version() (#607).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Move packages Imports Suggests. Add extra snapshot. Clean snapshots. usethis::use_lifecycle(). Prepare roundtrip via fledgeling (#606). Move foghorn rversions Suggests (#605). Run fledge workflow main branch (#597).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Add test prefix snapshot updates PR template (#582).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"refactoring-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Refactoring","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Use write_fledgling() write NEWS.md (#588).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9030","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9030 (2023-02-05)","text":"Remove false Markdown link? (#592).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109029-2022-12-30","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9029 (2022-12-30)","title":"fledge 0.1.0.9029 (2022-12-30)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109028-2022-12-22","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9028 (2022-12-22)","title":"fledge 0.1.0.9028 (2022-12-22)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109027-2022-12-09","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9027 (2022-12-09)","title":"fledge 0.1.0.9027 (2022-12-09)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9026","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9026 (2022-12-06)","text":"Support linked issues repositories (#595).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9025","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9025 (2022-11-19)","text":"Typo.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109024-2022-11-12","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9024 (2022-11-12)","title":"fledge 0.1.0.9024 (2022-11-12)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Remove partial matching warning (#579).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Draft fledgeling object, ready internal use (#581). Add full stop messages (#578).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Store downlit info (#580).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Cynkratemplate::use_cynkra_pkgdown() + re-add comment (@krlmlr, @41898282+github-actions-bot, @maelle, #568).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9023","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9023 (2022-11-11)","text":"Split news (#584).","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9022","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9022 (2022-11-10)","text":"Add full stop entries","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109021-2022-11-09","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9021 (2022-11-09)","title":"fledge 0.1.0.9021 (2022-11-09)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109020-2022-11-03","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9020 (2022-11-03)","title":"fledge 0.1.0.9020 (2022-11-03)","text":"Snapshot updates R-CMD-check-base (null) (#570)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109019-2022-10-28","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9019 (2022-10-28)","title":"fledge 0.1.0.9019 (2022-10-28)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9018","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9018 (2022-10-26)","text":"Fix URL (#573)","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9017","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9017 (2022-10-24)","text":"Relax requirement GitHub PAT scope (#572)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109016-2022-10-20","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9016 (2022-10-20)","title":"fledge 0.1.0.9016 (2022-10-20)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109015-2022-10-19","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9015 (2022-10-19)","title":"fledge 0.1.0.9015 (2022-10-19)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109014-2022-10-18","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9014 (2022-10-18)","title":"fledge 0.1.0.9014 (2022-10-18)","text":"Harmonize yaml formatting Revert changes matrix section","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109013-2022-10-16","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9013 (2022-10-16)","title":"fledge 0.1.0.9013 (2022-10-16)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109012-2022-10-14","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9012 (2022-10-14)","title":"fledge 0.1.0.9012 (2022-10-14)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109011-2022-10-11","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9011 (2022-10-11)","title":"fledge 0.1.0.9011 (2022-10-11)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9010","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9010 (2022-09-20)","text":"bump_version() returns TRUE new version created","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9009","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9009 (2022-09-20)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9009","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9009 (2022-09-20)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9008","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9008 (2022-09-18)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9008","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9008 (2022-09-18)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9007","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9007 (2022-09-16)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9007","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9007 (2022-09-16)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9006","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9006 (2022-09-14)","text":"Better support merge commits kinds (@maelle, #512)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9006","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9006 (2022-09-14)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109005-2022-09-13","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9005 (2022-09-13)","title":"fledge 0.1.0.9005 (2022-09-13)","text":"Internal changes .","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109004-2022-09-12","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9004 (2022-09-12)","title":"fledge 0.1.0.9004 (2022-09-12)","text":"Internal changes .","code":""},{"path":[]},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"bug-fixes-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Bug fixes","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Adjust empty lines space update_news() (#357) Add PR number CC messages (#353). Fix conventional commit regex (#329)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"features-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Features","title":"fledge 0.1.0.9003 (2022-09-12)","text":"New default pre_release(= \"next\") (#521, #524). Add “pre-minor” “pre-major” update_version() (#413, #412). Include reference issue closed PR (#361, #411). Capitalize first letter bullet (#360, #409). Extract contributor name PR merge message (@krlmlr, #358) Harvest PR attribution squash commits (@maelle, #349) Harvest PR title merge commit messages (@krlmlr, @maelle, #343) Improve parsing conventional commit messages (#332). Improve bump_version() (error) messages (@maelle, #328) Improve bump_version() behavior absence changes (@krlmlr, @maelle, #323) New local_test_project() (#318) Extract conventional commit messages changelog (#314).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"chore-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Chore","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Turn Netlify builds now (#326). Enable auto-style GitHub Actions (#317). Remove testthat specialization snapshots (#309).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"continuous-integration-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Continuous integration","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Create fledge.yaml (#520).","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"documentation-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Documentation","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Add README section related tools (#527). Update summary fledge uses commit messages (#499, #511). Fix typo README (#501)","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"uncategorized-0-1-0-9003","dir":"Changelog","previous_headings":"","what":"Uncategorized","title":"fledge 0.1.0.9003 (2022-09-12)","text":"Create open draft release directly, without using usethis::use_github_release(). Create tag part release(). Fix post_release(), still need tag released version.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109002-2022-04-02","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9002 (2022-04-02)","title":"fledge 0.1.0.9002 (2022-04-02)","text":"release() longer asks confirmation. Inline devtools::submit_cran() minus confirmation messages.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109001-2022-02-22","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9001 (2022-02-22)","title":"fledge 0.1.0.9001 (2022-02-22)","text":"New pre_release(), release() post_release() semi-automatic CRAN releases (#27, #28). Separate snapshot tests dev version testthat.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-0109000-2021-12-07","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0.9000 (2021-12-07)","title":"fledge 0.1.0.9000 (2021-12-07)","text":"previous version.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-011-2023-06-16","dir":"Changelog","previous_headings":"","what":"fledge 0.1.1 (2023-06-16)","title":"fledge 0.1.1 (2023-06-16)","text":"CRAN release: 2023-06-17 Compatibility release usethis 2.2.0.","code":""},{"path":"https://fledge.cynkra.com/dev/news/index.html","id":"fledge-010-2021-12-07","dir":"Changelog","previous_headings":"","what":"fledge 0.1.0 (2021-12-07)","title":"fledge 0.1.0 (2021-12-07)","text":"CRAN release: 2021-12-07 Change log management utility, initial release. main entry point bump_version(), following: Checks DESCRIPTION NEWS.md clean bumping, current branch main branch. update_news(): collects NEWS entries top-level commits update_version(): bump version DESCRIPTION, add header NEWS.md “dev”, finalize_version(): commit DESCRIPTION NEWS.md, create tag message Otherwise, commit_version(); user needs call tag_version() manually Suggests push changes upstream repository configured. haven’t committed since updating NEWS.md DESCRIPTION, can also edit NEWS.md call tag_version() . commit tag updated. Bumping can undone unbump_version(). DESCRIPTION \"Date\" field, populated current date update_version(). Likewise, NEWS.md contains dates headers, new versions also get date. empty list changes adds “previous version” bullet. allows bumping dev version immediately CRAN release. Also includes helper functions get_last_tag() get_top_level_commits(). Includes vignettes: “Get started”, “Using fledge”, “Fledge internals”. Examples tests supported demo project, created via with_demo_project(). Thanks Patrick Schratz Maëlle Salmon contributions!","code":""}]