An plugin for Pentaho kettle (PDI) allowing to include ruby scripts as transformation steps.
The elegance of the ruby language is paired with ultimate row processing flexibility. The step allows scripts to read, write, aggregate, consume and redirect rows to accomplish the most complex of data processing tasks in one place.
The implementation is based on JRuby. Thanks to JRuby's great Java interop, the scripting step also enables easy Java scripting in kettle.
Supported versions of pentaho-kettle
The plugin is built and tested against the most recent versions of Kettle 5.x, 6.x and 7.x.
How to get it?
How to install?
Decompress the release zip to
<kettle-dir>/plugins and restart Spoon. The "Ruby Script" step will appear in the "Scripting" section of a transformation.
How do I write ruby scripts in kettle?
Features at a glance
- rows are represented as hashes, indexed by field name
- automatic conversion between all kettle data types and ruby types
- steps with no input can be used as row generators
- can redirect rows to an error handling stream
- can read from specific info steps
- can write to specific target steps
- can call your favorite Java libraries
- can use ruby gems
- kettle's step
$transobjects are available in ruby scope for advanced scripting
Where do I report bugs and issues?
Just open issues on github.
What about ruby gems?
You can use gems, see the Ruby gems article on the project wiki. As long as JRuby likes the gem, which usually means that the gem has no unsupported native bindings, you may use gems as with any other ruby program.
How do I build the project?
mvn clean package
It creates the plugin zip in
How do I run the test suite?
Create a package, then run the tests. The packaging process unzips the plugin into
enables kettle to find the plugin when running integration tests.
mvn clean package mvn -DskipTests=false test
How can I contribute?
If you'd like to contribute please fork the project, add the feature or bugfix and send a pull request. If your change majorly alters the way the plugin works, we should discuss it via an open issue first.
The ruby-for-pentaho-kettle plugin uses the LGPL 2.1 license.
Open source does not mean you're on your own. The ruby-for-pentaho-kettle plugin is developed by Twineworks GmbH. Twineworks offers commercial support and consulting services. Contact us if you'd like us to help with a project.