Skip to contents

Get commits associated with a text pattern

Usage

get_commits_pattern(
  repo = ".",
  pattern = c(Ticket = "#[[:digit:]]+"),
  pattern.table = NULL,
  ref = "main",
  path = NULL,
  silent = FALSE
)

Arguments

repo

a path to a repository or a git_repository object. Default is '.'

pattern

Named vector with regex pattern to expose commits, like c("Issues" = "#\[\[:digit:\]\]") for issues

pattern.table

data.frame with two columns: pattern and description of the pattern. This is used as correspondence table to add some names to existing patterns.

ref

The name of a reference to list commits from e.g. a tag or a branch. The default is NULL for the current branch.

path

The path to a file. If not NULL, only commits modifying this file will be returned. Note that modifying commits that occurred before the file was given its present name are not returned; that is, the output of git log with --no-follow is reproduced.

silent

Logical. Whether to hide messages.

Value

A tibble with one line for each commit, duplicated if associated with multiple patterns and the following columns:

  • sha: sha of the commit

  • summary: First line of the commit message

  • message: Full content of the commit message

  • author: author of the commit

  • email: email of the author

  • when: commit time

  • order: order of commit messages. 1 is the oldest.

  • tag.name: name of tag associated with all commits since the last tag

  • tag.message: message of the tagged commit

  • pattern.type: name of the pattern found in the commit message

  • pattern.content: pattern found in the commit message

Examples

repo <- fake_repo()
get_commits_pattern(repo = repo, pattern = c("Ticket" = "#[[:digit:]]+"))
#> 4 commits found.
#> # A tibble: 7 × 12
#>   sha            summary message author email when                order tag.name
#>   <chr>          <chr>   <chr>   <chr>  <chr> <dttm>              <int> <chr>   
#> 1 ef944d00d24c6… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#> 2 ef944d00d24c6… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#> 3 ef944d00d24c6… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#> 4 68c293c788ccc… Third … "Third… Alice  alic… 2024-12-11 01:20:10     3 v0.1    
#> 5 68c293c788ccc… Third … "Third… Alice  alic… 2024-12-11 01:20:10     3 v0.1    
#> 6 6c554e149b9e1… exampl… "examp… Alice  alic… 2024-12-11 01:20:10     2 v0.1    
#> 7 8cdb60ff5676c… First … "First… Alice  alic… 2024-12-11 01:20:10     1 v0.1    
#> # ℹ 4 more variables: tag.message <chr>, pattern.type <chr>,
#> #   pattern.content <chr>, pattern.title <chr>
get_commits_pattern(repo = repo,
  pattern = c("Ticket" = "ticket[[:digit:]]+", "Issues" = "#[[:digit:]]+"))
#> 4 commits found.
#> # A tibble: 12 × 12
#>    sha           summary message author email when                order tag.name
#>    <chr>         <chr>   <chr>   <chr>  <chr> <dttm>              <int> <chr>   
#>  1 ef944d00d24c… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#>  2 ef944d00d24c… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#>  3 ef944d00d24c… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#>  4 ef944d00d24c… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#>  5 ef944d00d24c… Add NE… "Add N… Alice  alic… 2024-12-11 01:20:10     4 NA      
#>  6 68c293c788cc… Third … "Third… Alice  alic… 2024-12-11 01:20:10     3 v0.1    
#>  7 68c293c788cc… Third … "Third… Alice  alic… 2024-12-11 01:20:10     3 v0.1    
#>  8 68c293c788cc… Third … "Third… Alice  alic… 2024-12-11 01:20:10     3 v0.1    
#>  9 6c554e149b9e… exampl… "examp… Alice  alic… 2024-12-11 01:20:10     2 v0.1    
#> 10 6c554e149b9e… exampl… "examp… Alice  alic… 2024-12-11 01:20:10     2 v0.1    
#> 11 8cdb60ff5676… First … "First… Alice  alic… 2024-12-11 01:20:10     1 v0.1    
#> 12 8cdb60ff5676… First … "First… Alice  alic… 2024-12-11 01:20:10     1 v0.1    
#> # ℹ 4 more variables: tag.message <chr>, pattern.type <chr>,
#> #   pattern.content <chr>, pattern.title <chr>