Returns the Git tag of the form vx.y, vx.y.z or vx.y.z.w with the latest version.
An older version of this logic is used in get_last_tag(),
which traverses the Git history but does not work with squash-merging of version bumps.
Value
A one-row tibble with columns name, ref and commit.
For annotated tags (as created by fledge), commit may be different
from the SHA of the commit that this tag points to.
Use gert::git_log() to find the actual commit.
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.")
# Switch to branch for bumping version.
gert::git_branch_create("fledge")
# Bump version with fledge.
fledge::bump_version(check_default_branch = FALSE)
fledge::finalize_version()
# Merge the version bump branch into main.
gert::git_branch_checkout("main")
gert::git_merge("fledge", squash = TRUE)
print(get_top_level_commits(since = NULL))
# get_last_tag() doesn't work in this scenario
print(fledge::get_last_tag())
# get_last_version_tag() is better
print(fledge::get_last_version_tag())
})
#> ✔ Setting active project to "/tmp/Rtmpkg8Mba/fledge484d6ce805a3/tea".
#> ☐ Edit R/cool-function.R.
#> → Digesting messages from 3 commits.
#> ✔ Found 1 NEWS-worthy entry.
#>
#> ── Updating NEWS ──
#>
#> → Adding new entries to NEWS.md.
#>
#> ── Updating Version ──
#>
#> ✔ Package version bumped to 0.0.0.9001.
#> → Added header to NEWS.md.
#> → Committing changes.
#>
#> ── Tagging Version ──
#>
#> → Creating tag v0.0.0.9001 with tag message derived from NEWS.md.
#> ! Run `fledge::finalize_version()`.
#> → Resetting to previous commit.
#> → Committing changes.
#>
#> ── Tagging Version ──
#>
#> ℹ Tag v0.0.0.9001 exists and points to the current commit.
#> Performing fast-forward merge, no commit needed
#> # A tibble: 4 × 3
#> commit message merge
#> <chr> <chr> <lgl>
#> 1 7f4e72de01140c6c46824beb00e9262bd5b80cdb "fledge: Bump version to 0.0.0… FALSE
#> 2 32399e37910ac386de62a1fbdbe61f5b23837531 "- 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 61184d8aed22ccc4205348dfb94b5847a6c5f919
#> # A tibble: 1 × 3
#> name ref commit
#> <chr> <chr> <chr>
#> 1 v0.0.0.9001 refs/tags/v0.0.0.9001 61184d8aed22ccc4205348dfb94b5847a6c5f919
#> ✔ Setting active project to "<no active project>".