Parses NEWS.md and creates/updates the tag for the most recent version.

tag_version(force = FALSE)

Arguments

force

Re-tag even if the last commit wasn't created by bump_version(). Useful when defining a CRAN release.

Value

The created tag, invisibly. None

Examples

# 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"))
  fledge::update_version()
  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/Rtmp8nQpx7/fledge37f45d52ec4a/tea'
#>  Edit 'R/cool-function.R'
#>  Call `use_test()` to create a matching test file
#> → Scraping 3 commit messages.
#>  Found 1 NEWS-worthy entries.
#> 
#> ── Updating NEWS ──
#> 
#> → Adding new entries to NEWS.md.
#> Warning: 'Date' must be an ISO date: yyyy-mm-dd, but it is actually better to leave       this field out completely. It is not required.
#> 
#> ── Update Version ──
#> 
#>  Package version bumped to 0.0.0.9001.
#> → Adding header to NEWS.md.
#> → Committing changes.
#> 
#> ── Tagging Version ──
#> 
#> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md.
#>  Edit 'NEWS.md'
#> ! Call `fledge::finalize_version()`.
#> → Scraping 2 commit messages.
#>  Found 2 NEWS-worthy entries.
#> 
#> ── Updating NEWS ──
#> 
#> → Adding new entries to NEWS.md.
#> 
#> ── Update Version ──
#> 
#>  Package version bumped to 0.0.0.9002.
#> → Adding header to NEWS.md.
#> 
#> ── Tagging Version ──
#> 
#> → Creating tag v0.0.0.9002 with tag message derived from NEWS.md.
#> # A tibble: 1 × 3
#>   name        ref                   commit                                  
#> * <chr>       <chr>                 <chr>                                   
#> 1 v0.0.0.9002 refs/tags/v0.0.0.9002 11cb756e93596d0ee1f9a6cafb9a759f95313942
#>  Setting active project to '<no active project>'