Build Status Code Climate Coverage Status Gem Version

This library extends Roo to add support for handling class Excel files, including:

  • .xls files
  • .xml files in the SpreadsheetML format (circa 2003)

There is no support for formulas in Roo for .xls files - you can get the result of a formula but not the formula itself.


While Roo and Roo::Xls are licensed under the MIT / Expat license, please note that the spreadsheet gem is released under the GPLv3 license. Please be aware that the author of the spreadsheet gem claims you need a commercial license to use it as part of a public-facing, closed-source service, an interpretation at odds with the FSF's intent and interpretation of the license.


Add this line to your application's Gemfile:

gem 'roo-xls'

And then execute:

$ bundle

Or install it yourself as:

$ gem install roo-xls


TODO: Write usage instructions here


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request