https://github.com/jenkinsci/scm-filter-aged-refs-plugin

Additional filtering traits for SCM Jenkins plugins
https://github.com/jenkinsci/scm-filter-aged-refs-plugin

bitbucket filtering-references github hacktoberfest jenkins-pipeline trait

Last synced: 10 months ago
JSON representation

Additional filtering traits for SCM Jenkins plugins

• Host: GitHub
• URL: https://github.com/jenkinsci/scm-filter-aged-refs-plugin
• Owner: jenkinsci
• License: mit
• Created: 2017-09-15T15:08:09.000Z (almost 9 years ago)
• Default Branch: main
• Last Pushed: 2025-01-15T23:59:05.000Z (over 1 year ago)
• Last Synced: 2025-03-19T02:11:25.214Z (over 1 year ago)
• Topics: bitbucket, filtering-references, github, hacktoberfest, jenkins-pipeline, trait
• Language: Java
• Homepage:
• Size: 150 KB
• Stars: 4
• Watchers: 4
• Forks: 14
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Branch source Aged Refs

[![GitHub release](https://img.shields.io/github/v/release/jenkinsci/scm-filter-aged-refs-plugin)](https://github.com/jenkinsci/scm-filter-aged-refs-plugin/releases/latest)

[![Build Status](https://ci.jenkins.io/buildStatus/icon?job=Plugins%2Fscm-filter-aged-refs-plugin%2Fmain)](https://ci.jenkins.io/job/Plugins/job/scm-filter-aged-refs-plugin/job/main/)

[![GitHub license](https://img.shields.io/github/license/jenkinsci/scm-filter-aged-refs-plugin)](https://github.com/jenkinsci/scm-filter-aged-refs-plugin/blob/main/LICENSE)

[![Maintenance](https://img.shields.io/maintenance/yes/2024)]()

This is a collection of extensions for several branch source Jenkins plugins.

It provides filters for

- [Bitbucket]: ![BitBucket Plugin installs](https://img.shields.io/jenkins/plugin/i/bitbucket-scm-filter-aged-refs?color=blue)

  Filtering references (branches, tags and pull requests)

- [GitHub]: ![GitHub Plugin installs](https://img.shields.io/jenkins/plugin/i/github-scm-filter-aged-refs?color=blue)

  Filtering references (branches, tags and pull requests)

This filter will ignore references (branches, tags and/or pull requests) where its last

commit creation date is older than the defined threshold (in days). Ignored

references won't be added as sources or will be disabled and tagged for

deletion on the next full repository scan.

[Bitbucket]: https://plugins.jenkins.io/cloudbees-bitbucket-branch-source/

[GitHub]: https://plugins.jenkins.io/github-branch-source/

## Usage

There are four different behaviours available:

- **Filter by ref age**: Applies the days filter to branches, tags and pull requests.

- **Filter branches by age**: Applies the days filter only to branches.

- **Filter pull requests by age**: Applies the days filter only to pull requests.

- **Filter tags by age**: Applies the days filter only to tags.

![Dropdown Screenshot](.github/images/dropdown.png)

When defining a new job (or Organization folder), include any of the behaviours. They are placed under the additional

separator.

All behaviour are configurable, being mandatory to specify the

acceptable threshold (positive days) for each reference:

![Config Screenshot](.github/images/config.png)

In case of an invalid positive threshold, the form won't validate:

![Error Screenshot](.github/images/config-invalid.png)