fledge

{fledge} has been designed to streamline the process of versioning R packages on Git, with the functionality to automatically update NEWS.md and DESCRIPTION with relevant information from recent commit messages. For details on usage and implementation, refer the Get Started article.

Demo

Click on the image to show in a separate tab.

Installation

Install from GitHub using

devtools::install_github("krlmlr/fledge")

Usage

Run {fledge} commands from your package directory for versioning as below.

• To configure your package for the first-time with {fledge}, use

  fledge::bump_version()
  fledge::finalize_version()

  From now on, use bullet points (* or -) in your commit or merge messages to indicate the messages that you want to include in NEWS.md

• To assign a new "dev" version number to the R package and update NEWS.md, use

  fledge::bump_version()
  fledge::finalize_version()

• To assign a new version number to the R package before release to CRAN, use

  fledge::bump_version("patch")
  fledge::commit_version()

  Substitute "patch" by "minor" or "major" if applicable.

• To tag a version when the package has been accepted to CRAN, use

  fledge::tag_version()

  Call

  fledge::bump_version()

  to immediately switch to a development version.

• To undo the last version bump, use

  fledge::unbump_version()