Filesystem List Parameter

About

This is the source repository for the Filesystem List Parameter plugin for Jenkins. This plugin provides a build parameter with a value from objects names in filesystem like folders, symlinks or files.

For more information see the homepage.

Change Log

Version 0.0.16 (December 05, 2024)
  • Bugfix supporting jenkins cli and buildWithParameters POSTs JENKINS-60978
    • buildWithParameters: Note that the & will need to be escaped, or the whole URL quoted, if using a Unix shell script.
  • Activate renovating depandabot
Version 0.0.15 (November 23, 2024)
  • Add allowed base dirs feature:
    • Create a list of base dirs configured in manage/configure page.
    • The path within the plugin's job config will be checked against the allowed base dirs list.
    • Default is userContent directory for built-in or nodes
    • An administrative monitor is activated as reminder to configure allowed base dirs.
Version 0.0.14 (September 19, 2024)
Version 0.0.13 (September 12, 2024)
  • Small bugfix - Node Name parameter not stored in Freestyle jobs JENKINS-73698
Version 0.0.12 (July 23, 2024)
  • Small bugfix - After adding the parameter to a job, other parameters/steps can't be added JENKINS-73159
Version 0.0.11 (March 16, 2024)
  • Generate Declarative Directive now available for plugin JENKINS-66336
Version 0.0.10 (February 29, 2024)
  • Fix IllegalStateException: Refusing to load the Jenkins test harness in production JENKINS-72789
Version 0.0.9 (December 30, 2023)
  • Added includePathInValue option by allancth.
  • Added default value. Pre-select element if it is in the objects list.
  • Update versions, formatting a.s.o.
Version 0.0.8 (July 06, 2022)
Version 0.0.7 (March 18, 2021)
Version 0.0.6 (February 16, 2020)
Version 0.0.5 (March 23, 2019)
  • Add Slave support.
Version 0.0.4 (February 23, 2018)
  • Compatibility changes JENKINS-49649 - Getting issue details... STATUS
Version 0.0.3 (September 5, 2014)
Version 0.0.2 (June 1, 2014)
  • Add regular expression exclude and include filter for filesystem objects
    • Include and exclude pattern - regular expression to filter filesystem objects
      • Regular expression will be checked with "java.util.regex.Pattern.compile(regex)"
Version 0.0.1 (March 31, 2014)
  • Initial release

The filesystem-list-parameter-plugin lists file system object names of a directory. One of the object names can be selected as build parameter. In addition the objects can be filtered: ALL, DIRECTORY, FILE, SYMLINK. The order of the list can be reversed.

  • Name and Description should be clear
  • Path to the directory to select filesystem objects
  • Default value to pre-select an element from objects list
  • Filesystem object type - filter for type of the file system objects that can be selected.
  • Sort by last modified date - If true, the list of the parameter values will be sorted by last modified file attribute. Default order is alphabetic sort by parameter value.
  • Sort in reverse order - If true, the list of the parameter values will be sorted in reverse order.
  • includePathInValue - If true, the path will be prepended to the value(s).

Purpose

The plugin was designed to support the manual choice of delivery or deployment artefacts. E.g. deploy a defined version of a build package to UAT..

Raise Issues

You are welcome if you find any bug or you want to request a change. Please take a look for: Report an issue.

When creating a ticket in the Jenkins JIRA system, select the component filesystem-list-parameter-plugin.

Source

The source code can be found on GitHub. Fork us!

Contributing

Contributions are welcome! Check out the open tickets for this plugin in JIRA.