From 47d893f7449c2c34f6c59125b391ea4b5697d123 Mon Sep 17 00:00:00 2001
From: krlmlr <krlmlr@users.noreply.github.com>
Date: Sun, 18 Aug 2024 12:30:21 +0000
Subject: [PATCH] Built site for fledge@0.1.99.9027: 1def532

---
 dev/articles/cran-automation.html        |  2 +-
 dev/articles/demo.html                   |  2 +-
 dev/articles/fledge.html                 |  2 +-
 dev/articles/index.html                  |  2 +-
 dev/articles/internals.html              |  2 +-
 dev/authors.html                         |  6 +++---
 dev/index.html                           |  2 +-
 dev/news/index.html                      | 16 +++++++++++++++-
 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_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 +-
 23 files changed, 59 insertions(+), 45 deletions(-)

diff --git a/dev/articles/cran-automation.html b/dev/articles/cran-automation.html
index f084290d6..e8441f76e 100644
--- a/dev/articles/cran-automation.html
+++ b/dev/articles/cran-automation.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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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 8ca231fe8..28191bada 100644
--- a/dev/articles/demo.html
+++ b/dev/articles/demo.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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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/fledge.html b/dev/articles/fledge.html
index 49dd5eec8..e4ee026ff 100644
--- a/dev/articles/fledge.html
+++ b/dev/articles/fledge.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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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/index.html b/dev/articles/index.html
index 9232524d2..cf062027b 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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 11bfa44df..dc542fb05 100644
--- a/dev/articles/internals.html
+++ b/dev/articles/internals.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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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/authors.html b/dev/authors.html
index 170a123b0..d176bb91f 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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.9026,
+R package version 0.1.99.9027,
 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.9026,
+  note = {R package version 0.1.99.9027,
     https://github.com/cynkra/fledge},
   url = {https://fledge.cynkra.com/},
 }</pre>
diff --git a/dev/index.html b/dev/index.html
index 597f4ebe4..34b89a608 100644
--- a/dev/index.html
+++ b/dev/index.html
@@ -31,7 +31,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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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 8ff89fa60..aabd79cc2 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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,20 @@ <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.9027" id="fledge-01999027-2024-08-17">fledge 0.1.99.9027 (2024-08-17)<a class="anchor" aria-label="anchor" href="#fledge-01999027-2024-08-17"></a></h2>
+<div class="section level3">
+<h3 id="chore-0-1-99-9027">Chore<a class="anchor" aria-label="anchor" href="#chore-0-1-99-9027"></a></h3>
+<ul><li>
+<p>Auto-update from GitHub Actions.</p>
+<p>Run: <a href="https://github.com/cynkra/fledge/actions/runs/10425483871" class="external-link uri">https://github.com/cynkra/fledge/actions/runs/10425483871</a></p>
+</li>
+</ul></div>
+<div class="section level3">
+<h3 id="continuous-integration-0-1-99-9027">Continuous integration<a class="anchor" aria-label="anchor" href="#continuous-integration-0-1-99-9027"></a></h3>
+<ul><li>Sync with latest developments.</li>
+</ul></div>
+</div>
     <div class="section level2">
 <h2 class="pkg-version" data-toc-text="0.1.99.9026" id="fledge-01999026-2024-08-10">fledge 0.1.99.9026 (2024-08-10)<a class="anchor" aria-label="anchor" href="#fledge-01999026-2024-08-10"></a></h2>
 <div class="section level3">
diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml
index a454878ca..d2a10f470 100644
--- a/dev/pkgdown.yml
+++ b/dev/pkgdown.yml
@@ -1,12 +1,12 @@
 pandoc: 3.1.11
 pkgdown: 2.1.0.9000
-pkgdown_sha: 6ecf7666c05a728e6fea07301a07c33a6ffed784
+pkgdown_sha: 515efc4149b88d770f7cb236938b0689eb79a4db
 articles:
   cran-automation: cran-automation.html
   demo: demo.html
   fledge: fledge.html
   internals: internals.html
-last_built: 2024-08-16T19:59Z
+last_built: 2024-08-18T12:29Z
 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 d32f95e18..598314191 100644
--- a/dev/reference/bump_version.html
+++ b/dev/reference/bump_version.html
@@ -27,7 +27,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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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">
@@ -138,7 +138,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/RtmpDjHcyl/fledge13d4488c328f/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/RtmpeFS0f4/fledge13b53aaec880/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 9f81ef2cb..36d40dfd6 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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/RtmpDjHcyl/fledge13d430d6e6e4/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/RtmpeFS0f4/fledge13b56918516/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 b62dc0a27..643de4112 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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 057bf3bad..2185ca7ab 100644
--- a/dev/reference/finalize_version.html
+++ b/dev/reference/finalize_version.html
@@ -21,7 +21,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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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">
@@ -100,7 +100,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/RtmpDjHcyl/fledge13d47df5e39f/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/RtmpeFS0f4/fledge13b57db3b0e4/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 78f242946..f3f3c812d 100644
--- a/dev/reference/get_last_tag.html
+++ b/dev/reference/get_last_tag.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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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"><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/RtmpDjHcyl/fledge13d479422484/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/RtmpeFS0f4/fledge13b52f6aad22/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>
@@ -104,14 +104,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> 1cd056393ba0851065cb0dfb7185c23fee01dee5 <span style="color: #949494;">"</span>Bump version to 0.0.0.9001\n<span style="color: #949494;">"</span>  FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 6a8f3794332ea62f7284a1e04a96cfd09cb55797 <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> ae7b3a7b9e0fc74700724fb7d686ebf9331b4146 <span style="color: #949494;">"</span>Bump version to 0.0.0.9001\n<span style="color: #949494;">"</span>  FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 6bf150c17e8f347a9294786c8472dac87344335b <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 9b17107bd0f40defee547c9d25cb6b342eb8ad88</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 b05d2e993d92dc17197459370251100064934866</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 13c541800..bb35d1ed7 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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">
@@ -86,7 +86,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/RtmpDjHcyl/fledge13d46ce66e22/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/RtmpeFS0f4/fledge13b5666faccf/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>
@@ -114,14 +114,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> bfe212fd038158f6251bdf29d1649a6579b60b37 <span style="color: #949494;">"</span>Bump version to 0.0.0.9001\n<span style="color: #949494;">"</span>  FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 1cec5b44363897f7842de1f2eb90eedebc75112d <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> bfe8322ab61de2482382e0fcaba6e129f20f6411 <span style="color: #949494;">"</span>Bump version to 0.0.0.9001\n<span style="color: #949494;">"</span>  FALSE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 5fc2488226aecfdf16d2b55fbe69b094048baf46 <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 22fe1421d46fcd7daa0a410f602ca36770e1be1c</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 fc2b8c3311e9d8d348da42277e54db30772d829b</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 1016bbaf4..e98944c72 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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 1f73fc019..558ab375a 100644
--- a/dev/reference/release.html
+++ b/dev/reference/release.html
@@ -17,7 +17,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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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 736c9982c..dbd98b6f3 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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_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/RtmpDjHcyl/fledge13d4508d2f40/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/RtmpeFS0f4/fledge13b55f2d2863/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: #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.1 refs/tags/v0.0.1 634a04f0580ea25e6143ad34520d512930b20700</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 9a20653dba184aeab2412b5f34272e10d02be5a2</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 1b3689976..fd7fda6d2 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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/RtmpDjHcyl/fledge13d429e2ee94/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/RtmpeFS0f4/fledge13b532db3321/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 4972a1dac..a5b681065 100644
--- a/dev/reference/update_news.html
+++ b/dev/reference/update_news.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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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">
@@ -108,7 +108,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_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/RtmpDjHcyl/fledge13d45bf0f898/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/RtmpeFS0f4/fledge13b5bdd160a/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>
@@ -145,7 +145,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: #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.1 refs/tags/v0.0.1 77711c83704244f3d9c47fe499f91012c91800ee</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 c8110b7d9268c2bf5908534c12be68cba7315425</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 03612fc60..bb31fa9e6 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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_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/RtmpDjHcyl/fledge13d42d224b12/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/RtmpeFS0f4/fledge13b572b7092/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: #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.1 refs/tags/v0.0.1 8de362b9ec01c435456a37edd0aa0e5016256b51</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 45695475d710d77b4c098ab913df9d873b122574</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 1f27ab7c8..581aaecc6 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.9026</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">0.1.99.9027</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/RtmpDjHcyl/fledge13d44248f88d/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/RtmpeFS0f4/fledge13b5b5ec65d/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 c1aea2157..0d3c4e0ae 100644
--- a/dev/search.json
+++ b/dev/search.json
@@ -1 +1 @@
-[{"path":"https://fledge.cynkra.com/dev/articles/cran-automation.html","id":"workflow","dir":"Articles","previous_headings":"","what":"Workflow","title":"Automate CRAN releases","text":"{fledge} able automate CRAN release, locally via continuous integration (CI). difference local CI approach user call fledge::unleash() (child functions) manually step. following describe workflow via CI approach. CI build triggered tag (.e. release made), specific runner build matrix run calls fledge::unleash(). runner run every 2h (?) branch calls fledge::unleash() every time.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/cran-automation.html","id":"execution-conditions","dir":"Articles","previous_headings":"","what":"Execution Conditions","title":"Automate CRAN releases","text":"following list describes conditions need fulfilled state: CRAN-SUBMISSION file exists. package version number four component scheme. cran-comments.md file. Three component package version. cran-comments.md file exists. local package version smaller one CRAN. local version equal CRAN version. boxes cran-comments.md checked. Possible improvements: - Let user forward specific CRAN mails fledge can check required boxes . Currently users needs check boxes cran-comments.md . - Make strict NEWS checking optional - branch creation optional (TRUE default). unleash() wraps fledge::pre_release() fledge::release() fledge::post_release()","code":""},{"path":"https://fledge.cynkra.com/dev/articles/cran-automation.html","id":"execution-actions","dir":"Articles","previous_headings":"","what":"Execution Actions","title":"Automate CRAN releases","text":"following list describes actions state function: Creates cran-comments.md template. Creates branch named r-release<version>. Check recent changes CRAN policies via eddelbuettel/crp@master. Calls devtools::check_win_devel(). Calls rhub::check_for_cran(). Calls foghorn::cran_details(). Calls devtools::submit_cran(). Calls fledge:::confirm_submission(). Calls fledge::tag_version(). Calls git push --tags. Calls usethis::use_github_release(). Calls fledge::bump_version() switch dev version . post_release(), Pull Request merged branch deleted.","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'. ## → Force-pushing tag v0.0.0.9001. ## → Pushing main. 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 2 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. ## → Force-pushing tag v0.0.0.9002. ## → Pushing main."},{"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.9026, 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.9026,     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 changes since last version. update_news(), using argument 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\", \"patch\", \"pre-minor\", \"minor\", \"pre-major\", \"major\"),   no_change_behavior = c(\"bump\", \"noop\", \"fail\") )"},{"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). no_change_behavior change since last version: \"bump\" bump version; \"noop\" nothing; \"fail\" erroring.","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/RtmpDjHcyl/fledge13d4488c328f/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/RtmpDjHcyl/fledge13d430d6e6e4/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(), setting force = TRUE commit_version() amended commit. 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/RtmpDjHcyl/fledge13d47df5e39f/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.","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/RtmpDjHcyl/fledge13d479422484/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 1cd056393ba0851065cb0dfb7185c23fee01dee5 \"Bump version to 0.0.0.9001\\n\"  FALSE #> 2 6a8f3794332ea62f7284a1e04a96cfd09cb55797 \"- 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 9b17107bd0f40defee547c9d25cb6b342eb8ad88 #> ✔ 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 get_last_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/RtmpDjHcyl/fledge13d46ce66e22/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 bfe212fd038158f6251bdf29d1649a6579b60b37 \"Bump version to 0.0.0.9001\\n\"  FALSE #> 2 1cec5b44363897f7842de1f2eb90eedebc75112d \"- 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 22fe1421d46fcd7daa0a410f602ca36770e1be1c #> ✔ 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 — release","title":"Automating CRAN release — release","text":"init_release() pre_release() run milestone development package reached ready sent CRAN. 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 — release","text":"","code":"init_release(which = \"next\", force = FALSE)  pre_release(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 — release","text":"Component version number update. Supported values \"next\" (\"major\" current version x.99.99.9yz, \"minor\" current version x.y.99.za, \"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 — release","text":"init_release(): Ensures modified files git index. Creates release branch bumps version non-development version sent CRAN. Writes/updates cran-comments.md useful information current release process. Prompts user run urlchecker::url_update(), devtools::check_win_devel(), rhub::check_for_cran(). pre_release(): 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_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpDjHcyl/fledge13d4508d2f40/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 634a04f0580ea25e6143ad34520d512930b20700 #> ✔ 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/RtmpDjHcyl/fledge13d429e2ee94/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) 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\", \"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_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_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpDjHcyl/fledge13d45bf0f898/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 77711c83704244f3d9c47fe499f91012c91800ee #> ✔ 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_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpDjHcyl/fledge13d42d224b12/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 8de362b9ec01c435456a37edd0aa0e5016256b51 #> ✔ 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/RtmpDjHcyl/fledge13d44248f88d/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":"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/cran-automation.html","id":"workflow","dir":"Articles","previous_headings":"","what":"Workflow","title":"Automate CRAN releases","text":"{fledge} able automate CRAN release, locally via continuous integration (CI). difference local CI approach user call fledge::unleash() (child functions) manually step. following describe workflow via CI approach. CI build triggered tag (.e. release made), specific runner build matrix run calls fledge::unleash(). runner run every 2h (?) branch calls fledge::unleash() every time.","code":""},{"path":"https://fledge.cynkra.com/dev/articles/cran-automation.html","id":"execution-conditions","dir":"Articles","previous_headings":"","what":"Execution Conditions","title":"Automate CRAN releases","text":"following list describes conditions need fulfilled state: CRAN-SUBMISSION file exists. package version number four component scheme. cran-comments.md file. Three component package version. cran-comments.md file exists. local package version smaller one CRAN. local version equal CRAN version. boxes cran-comments.md checked. Possible improvements: - Let user forward specific CRAN mails fledge can check required boxes . Currently users needs check boxes cran-comments.md . - Make strict NEWS checking optional - branch creation optional (TRUE default). unleash() wraps fledge::pre_release() fledge::release() fledge::post_release()","code":""},{"path":"https://fledge.cynkra.com/dev/articles/cran-automation.html","id":"execution-actions","dir":"Articles","previous_headings":"","what":"Execution Actions","title":"Automate CRAN releases","text":"following list describes actions state function: Creates cran-comments.md template. Creates branch named r-release<version>. Check recent changes CRAN policies via eddelbuettel/crp@master. Calls devtools::check_win_devel(). Calls rhub::check_for_cran(). Calls foghorn::cran_details(). Calls devtools::submit_cran(). Calls fledge:::confirm_submission(). Calls fledge::tag_version(). Calls git push --tags. Calls usethis::use_github_release(). Calls fledge::bump_version() switch dev version . post_release(), Pull Request merged branch deleted.","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'. ## → Force-pushing tag v0.0.0.9001. ## → Pushing main. 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 2 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. ## → Force-pushing tag v0.0.0.9002. ## → Pushing main."},{"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.9027, 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.9027,     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 changes since last version. update_news(), using argument 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\", \"patch\", \"pre-minor\", \"minor\", \"pre-major\", \"major\"),   no_change_behavior = c(\"bump\", \"noop\", \"fail\") )"},{"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). no_change_behavior change since last version: \"bump\" bump version; \"noop\" nothing; \"fail\" erroring.","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/RtmpeFS0f4/fledge13b53aaec880/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/RtmpeFS0f4/fledge13b56918516/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(), setting force = TRUE commit_version() amended commit. 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/RtmpeFS0f4/fledge13b57db3b0e4/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.","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/RtmpeFS0f4/fledge13b52f6aad22/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 ae7b3a7b9e0fc74700724fb7d686ebf9331b4146 \"Bump version to 0.0.0.9001\\n\"  FALSE #> 2 6bf150c17e8f347a9294786c8472dac87344335b \"- 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 b05d2e993d92dc17197459370251100064934866 #> ✔ 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 get_last_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/RtmpeFS0f4/fledge13b5666faccf/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 bfe8322ab61de2482382e0fcaba6e129f20f6411 \"Bump version to 0.0.0.9001\\n\"  FALSE #> 2 5fc2488226aecfdf16d2b55fbe69b094048baf46 \"- 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 fc2b8c3311e9d8d348da42277e54db30772d829b #> ✔ 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 — release","title":"Automating CRAN release — release","text":"init_release() pre_release() run milestone development package reached ready sent CRAN. 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 — release","text":"","code":"init_release(which = \"next\", force = FALSE)  pre_release(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 — release","text":"Component version number update. Supported values \"next\" (\"major\" current version x.99.99.9yz, \"minor\" current version x.y.99.za, \"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 — release","text":"init_release(): Ensures modified files git index. Creates release branch bumps version non-development version sent CRAN. Writes/updates cran-comments.md useful information current release process. Prompts user run urlchecker::url_update(), devtools::check_win_devel(), rhub::check_for_cran(). pre_release(): 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_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpeFS0f4/fledge13b55f2d2863/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 9a20653dba184aeab2412b5f34272e10d02be5a2 #> ✔ 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/RtmpeFS0f4/fledge13b532db3321/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) 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\", \"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_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_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpeFS0f4/fledge13b5bdd160a/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 c8110b7d9268c2bf5908534c12be68cba7315425 #> ✔ 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_tag()) }) #> ✔ Setting active project to \"/tmp/RtmpeFS0f4/fledge13b572b7092/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 45695475d710d77b4c098ab913df9d873b122574 #> ✔ 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/RtmpeFS0f4/fledge13b5b5ec65d/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":"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":""}]