{ "componentChunkName": "component---src-templates-blog-post-tsx", "path": "/blog/2011-05-12-what-it-take-to-bring-ruby-to-jenkins/", "result": {"data":{"blogPost":{"title":"What it takes to bring Ruby to Jenkins","slug":"/blog/2011-05-12-what-it-take-to-bring-ruby-to-jenkins/","authorNodes":[{"name":"Charles Lowell","slug":"/people/charles-lowell/"}],"markdown":{"html":"

\"Jenkins Ruby Plugins\" are at an important, yet fragile stage of their life. Over the past several months, we have made\ntremendous progress towards making extending Jenkins with nothing but Ruby a blissful reality. However, at this moment,\nthey exist only as a collection of hacks, or, to frame it more kindly, \"proofs of concept\" all buried quite deeply in a\nterribly named repo on github.

\n

To name a few of them, we are now able to

\n\n

This is by no means an exhaustive list, but I want to stress just how far we've come before I talk about where it is that\nwe need to go.

\n

While the work done so far represents some phenomenal accomplishments, in the end, they are only technical accomplishments which do not together create a coherent developer experience. So now, for this endeavor to succeed, we must focus our attention on making that entire experience, from project start to release after release, as frictionless as possible.

\n

To that end, I propose the following high level goal for the Jenkins Ruby Plugins project:

\n
\n

To provide the facility to create, develop and release extensions for Jenkins with nothing but knowledge of the language, tools and best practices of the Ruby community.

\n
\n

This is, I think, the most important ideal to aspire to when claiming to provide a Ruby development experience. Unless it feels like the real McCoy, then you aren't really developing Ruby at all, you're just scripting Java with JRuby. You won't fool anybody, and there will be far less enthusiasm and adoption.

\n

That said, several things follow logically from this thesis, the first of which is:

\n

Absolutely, Positively, No Maven!

\n

This is not an ideological stance on the value of Maven as a wretched pile of toad sick software development tool. Rather, it is an explicit acknowledgement that it is not a Ruby tool, it doesn't fit with the community's style, and if you're using it\nyou might not be doing Java, but you certainly aren't doing Ruby. Instead, we should turn to the Ruby tools that\noccupy this same space: Rake for scripting the build, and Bundler for dependency management.

\n

Ruby-Like Project Structure

\n

If we aren't going to use Maven, then why should we be constrained by the project directory structure that it imposes. src/main/resources/what? Nope. Just one glance at Jenkins Ruby Plugin's layout in an editor or file system browser\nshould put a Rubyist's mind right at ease. You see that? There's your Gemfile just\nwhere you left him. And oh, your pals lib/ and spec/ are there too. Let's get right to work!

\n

Managing The Project Life-Cycle

\n

From inception to release, you should be able to manage all aspects of your Jenkins plugin with Ruby. There must be single\ncommands (or rake tasks) to

\n\n

Testing

\n

The importance of testing in the Ruby community cannot be overstated. The Ruby Tools need to provide a clear path to\ntesting the plugin at both the unit and functional levels.

\n

Documentation

\n

The \"Ruby-like\" API that plugin development provides is similar, but not equivalent to its native Java equivalent.\nIt is critical that this API be well documented, so that developers can understand it, and do not find themselves constantly\nreferring to the JavaDoc, which they may very well not understand (it being Java), and might be misleading given the natural\nasymmetries of the two APIs.

\n

Heed the Call!

\n

There are plenty of people who would love to see this project get done, but don't know where to start. I know this because I was one of them. The upshot is that now, as I've just described, there is plenty of work to be done that doesn't require any knowledge of Java and very little knowledge of Jenkins internals. That means that you can contribute in a meaningful way!

\n

Next week, I'll be publishing some specifications in the form of Cucumber scenarios for some of the features up above that we can discuss and then hopefully start implementing.

\n

But the most important thing that you can do is to join in on the conversation!

\n

irc, and email are just a few of the ways to reach out!

\n
\n

Update. I have posted the first scenario: creating a plugin.\nThe first bounty is officially posted.

\n
","frontmatter":{"date":"May 12, 2011","description":null,"tags":["java","ruby","jenkins"],"img":null}}}},"pageContext":{"id":"cc3ec349-5888-520a-a0b3-c199153ec49e"}}, "staticQueryHashes": ["1241260443"]}