https://github.com/jenkinsci/forensics-api-plugin

Jenkins plug-in that defines an API to mine and analyze data from a source control repository
https://github.com/jenkinsci/forensics-api-plugin

api-plugin code-forensics forensics jenkins

Last synced: 24 days ago
JSON representation

Jenkins plug-in that defines an API to mine and analyze data from a source control repository

• Host: GitHub
• URL: https://github.com/jenkinsci/forensics-api-plugin
• Owner: jenkinsci
• License: mit
• Created: 2019-06-12T22:10:38.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2025-04-29T12:04:55.000Z (about 1 month ago)
• Last Synced: 2025-04-29T13:24:35.272Z (about 1 month ago)
• Topics: api-plugin, code-forensics, forensics, jenkins
• Language: Java
• Homepage: https://plugins.jenkins.io/forensics-api/
• Size: 4.52 MB
• Stars: 18
• Watchers: 2
• Forks: 30
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Jenkins Forensics API Plugin

[![Join the chat at https://gitter.im/jenkinsci/warnings-plugin](https://badges.gitter.im/jenkinsci/warnings-plugin.svg)](https://gitter.im/jenkinsci/warnings-plugin?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Jenkins](https://ci.jenkins.io/job/Plugins/job/forensics-api-plugin/job/main/badge/icon?subject=Jenkins%20CI)](https://ci.jenkins.io/job/Plugins/job/forensics-api-plugin/job/main/)

[![GitHub Actions](https://github.com/jenkinsci/forensics-api-plugin/workflows/GitHub%20CI/badge.svg)](https://github.com/jenkinsci/forensics-api-plugin/actions)

[![Codecov](https://codecov.io/gh/jenkinsci/forensics-api-plugin/branch/master/graph/badge.svg)](https://codecov.io/gh/jenkinsci/forensics-api-plugin)

This Forensics API Jenkins plug-in defines an API to mine and analyze data from a source control repository. 

 

This API plugin provides the following services:

- **Blames**: Shows what revision and author last modified a specified set of lines of a file. This information can be 

used to track the original commit that introduced a piece of code. 

- **File statistics**: Incrementally collects global commit statistics for all repository files in the style of 

  [Code as a Crime Scene](https://www.adamtornhill.com/articles/crimescene/codeascrimescene.htm) 

  \[Adam Tornhill, November 2013\]. This includes:

  - commits count

  - different authors count

  - creation time

  - last modification time

  - lines of code (from the commit details)

  - code churn (changed lines since created)

- **Commit tracking**: Tracks all new commits that are part of a build. Using this information plugins can search for 

 builds that contain a specific commit. 

- **Commit statistics**: Collects commit statistics for all new commits in a build or in a series of builds (e.g. for 

all commits of a pull request). This includes: 

  - commits count

  - changed files count

  - added and deleted lines 

- **Reference build**: Several plugins that report build statistics (test results, code coverage, metrics, static 

analysis warnings) typically show their reports in two different ways: either as absolute report 

(e.g., total number of tests or warnings, overall code coverage) or as relative delta report (e.g., additional tests,

increased or decreased coverage, new or fixed warnings). In order to compute a relative delta report a plugin needs 

to carefully select the other build to compare the current results to (a so called *reference build*). 

For simple Jenkins jobs that build the main branch of an SCM the reference build will be selected from one of the 

previous builds of the same job. For more complex branch source projects (i.e., projects that build several branches 

and pull requests in a connected job hierarchy) it makes more sense to select a reference build from a job 

that builds the actual target branch (i.e., the branch the current changes will be merged into). Here one typically is

interested what changed in a branch or pull request with respect to the main branch (or any other 

target branch): e.g., how will the code coverage change if the team merges the changes. Selecting the correct reference

build is not that easy, since the main branch of a project will evolve more frequently than a specific feature or bugfix

branch.    

- **Repository Browser**: Provides a [RepositoryBrowser](https://javadoc.jenkins.io/hudson/scm/RepositoryBrowser.html) 

  for commits. Since the original Jenkins interface has no API to generate links to simple

  commits, this decorator adds such a functionality. Note that this API does not only obtain such links, it also

  renders these links as HTML `a` tags.

## Implementations

[Jenkins Git Forensics Plugin](https://github.com/jenkinsci/git-forensics-plugin) is a plugin that implements the 

corresponding extension points for Git. Other version control systems are not yet supported.  

## User documentation

Currently this API is only implemented by the 

[Jenkins Git Forensics Plugin](https://github.com/jenkinsci/git-forensics-plugin)

so please refer to the [documentation](https://github.com/jenkinsci/git-forensics-plugin/blob/master/README.md)

there on how to use the features.