I've been thinking a lot about this general idea the past couple weeks, and had even considered writing a plugin last weekend before I got sick

I think a more generic "require" syntax would be ideal for example:

require 'junit' /* plugin artifactId */
require 'parallel-text-executor'

Which could be expanded upon with the keyword arguments in groovy to support additional requirement statements in the future, e.g.

/* Naturally all of these could be squished into one require statement */
require plugin: 'junit'
require core: '1.642.4'
require tool: ['Maven' : '3.3.3']

I'm curious what hrmpw and abayer think of this syntax.

The simplest approach would simply be a step which fails if some of the requested plugins are missing or too old:

Mostly agreed, i suggest that the pipeline should abort because of missing dependencies with console outputs stating this Jenkins instance is lacking the required dependencies to execute this pipeline. I generally interpret failures to mean the Pipeline is broken (user error) rather than something requiring a user/administrator cooperation to rectify. I don't have much better reasoning than that, but an abort would catch my gaze a lot sooner than a failure, unfortunately

As far as version restricting goes, in my mind I was thinking on punting on that for now until some more users using any require syntax.

Based on your example above I don't know if you intended that you could specify a version for plugins like you did for Tools

require 'junit'  /* simply checks for any version */

or

require ['junit' : '1.11']  /* checks for that version */

or

require ['junit' : '>1.11'] /* 1.11 or above */

This might be too much like gemspec notation it would be clear what is needed.

hrmpw with tools, there is no "version range" in the Tool installers right now, so in my head it was a fairly direct mapping selecting a version from a dropdown in a Freestyle job configuration page. If we were to support "just use Maven, any maven" i think that would be venturing too far from what Jenkins currently does.

The reason for avoiding the version ranges right now, in my opinion, is that I'm not confident the right thing that would meet users' needs would be specifying a singular version (could be too restrictive), specify a base version (could be too relaxed) and don't want to introduce the full maven version range syntax into this

jglick I don't see how my proposal and JENKINS-28718 are mutually exclusive, unless you're referring to automatically installing tools (which I think is a fun feature but I would immediately disable it in any production environment).

I view a generic require step as a useful way to allow a script to safely declare runtime dependencies and nothing more. Every scripting environment, even JavaScript these days, has a similar syntax.

I'm +1 overall - tools will need a fair amount of work to support a real version concept, but I'm actually beginning to kick around ideas for that anyway.

Also, this would be handy, particularly with regards to tools, with Plumber - I was planning to put in some try/catch logic once tool management actually becomes a thing (which itself still depends on a consistent way to do version discovery), but if we can just use "require" that'd be smoother.

Again -1 on a general require. Particular things that might be needed are better handled with dedicated steps or system.

So, we're disagreeing about whether to have a generic require or a plugin specific one?

What about implementing the generic syntax, but with only plugin name for now?

require plugin: 'junit-plugin' 

Then we have the concept and can consider expanding it (or not) later?

Proposal in https://github.com/jenkinsci/workflow-basic-steps-plugin/pull/31

Just a quick status update as I've been unable to push this forward in the last few months: I'm leaving myself assigned so that this shows up on my JIRA board for now, because I hope to be able to get back to it some day.

BUT, I'm posting this so that anyone feeling an itch to push this to completion just feel free to take over. Then either just reassign to you, or ping me privately for any question (related to taking over the development of this, I don't mean any usage question. Because then it'd be the users ML instead).

Thank you!

Unassigned myself to clarify I'm not working on this currently.

While commenting on JENKINS-49651 I had an idea that could make this almost automatic:
Extend plugin metadata with (RPM style) Provides for pipeline symbols (& extensions,... ) they implement. With that metadata available in the Update Center a build that tries to use say the junit step could instead of failing the build be paused and the user could be prompted if they want to install the plugin that provides that step of if they want to abort the build:

• Pipeline execution detects unknown step / use of a global / unknown type referenced.
• Pipeline execution paused (like with an input step?)
• Query Update Center metadata if there are plugins that provide the missing references
• Prompt the user to install those plugins or fail the build (possibly saving ignored dependencies)
• User selects to install the missing plugins -> continue the pipeline execution
• maximum user satisfaction