Goal of this gem is to make working with workbooks (spreadsheets) as programmer friendly as possible. Not reinventing a totally new DSL or all kinds of new methodnames, but just borrowing from known concepts such as hashes and arrays (much like (Faster)CSV does)). Workbook is a gem that mimicks a typical spreadsheet, a bundle of sheets, bundled in a workbook. A sheet may contain one or more tables (which might be the multi table sheets of Apple Numbers or Excel ranges). Basically:
Subsequently a table consists of:
Book, Sheet, Table and Row inherit much of the behaviours from the Array and Hash classes, it tries to walk and quack as such. The row is extended with hashlike lookups (row[:id]) and writers (row[:id]=). Values are converted to ruby native types, and optional parsers can be added to improve recognition.
In addition to offering you this plain structure it allows for importing .xls, .csv, .xlsx, .txt files (more to come), writing .xls, and .csv (more to come) and includes several utilities to easily create an overview of the differences between two tables and output basic cell-styling properties as css.
Simply initialize a simple spreadsheet using:
b = Workbook::Book.new
or
b = Workbook::Book.open filename
Calling
s = b.sheet
t = s.table
will give you the first Sheet and Table (if one doesn't exist it is created on the fly).
You can initialize with simple 2-d array like this:
b = Workbook::Book.new [['a','b'],[1,2],[3,4],[5,6]]
t = s.sheet.table
Subsequently you look up values in the table like this:
t[1][:b]
# returns <Workbook::Cel @value=2>
which is equivalent to
t[1][1]
Of course you'll be able to write a new value back to it. If you just enter a value, formatting of the original cell will be maintained.
t[1][:b] = 5
Alternatively (more spreadsheet like) you can read cells like this (writing to be supported, not implemented yet)
t['A2']
If you want to use an existing file as a template (which you can create in Excel to create nice looking templates), simply clone the row, and add it back:
b = Workbook::Book.open("template.xls")
table = b.sheet.table
template_row = table[1] # can be any, but I typically have a well
# formatted header row + an example template
# row for the data
[1,2,3,4].each do |v|
new_row = template_row.clone
table << new_row # to use the symbol style header references,
# the row first needs to be added back to the
# table
new_row[:a] = v
end
table.delete(template_row) # you don't want the template to show up
# in the endresult
b.write("result.xls") # write it!
Another typical use case is exporting a list of ActiveRecord-objects to xls (it is assumed that the headers of the excel-table correspond
(like "Total order price" and total_order_price match) to the headers of the database-table ):
b = Workbook::Book.open("template.xls")
table = b.sheet.table
template_row = table[1] # see above
Order.where("created_at > ?", Time.now - 1.week).each do |order|
new_row = template_row.clone
new_row.table = table
order.to_hash.each{|k,v| row[k]=v}
end
table.delete(template_row) # you don't want the template to show up
# in the endresult
b.write("recent_orders.xls") # write it!
Sorting leaves the header alone, if it exists, and doesn't complain about comparing strings with dates with floats (Ever found OpenOffice Calc or Excel complainging about its inability to compare integers and strings? We're talking spreadsheet here). When classes are different the following (default) order is used: Numbers, Strings, Dates and Times, Booleans and Nils (empty values).
t.sort
To implement:
To some extent, sort_by works, it doesn't, however, adhere to the header settings...
t.sort_by {|r| r[:b]}
Simply call on a Workbook::Table
t1.diff t2
And a new book with a new table will be returned containing the differences between the two tables.
Alternatively you can run the same command on workbooks, which will compare sheet by sheet and return a new Workbook
Currently writing is limited to the following formats. Templating support is still limited.
b.to_xls # returns a spreadsheet workbook
b.write_to_xls filename # writes to filename
t.(write_)to_csv # returns a csv-string (called on tables)
b.(write_)to_html # returns a clean html-page with all tables; unformatted, format-names are used in the classes
t.(write_)to_json # returns the values of a table in json
t.(write_)to_xlsx # returns/writes using RubyXL to XLS (unstable, work in progress)
In case you want to display a formatted table in HTML, some conversion is offered to convert text/background properties to css-entities. Internally the hash storing style elements tries to map to CSS where possible.
Workbook is automatically tested. Check Travis for Workbook's current build status of the supported ruby versions .
The ruby toolbox lists plenty of alternatives, that just didn't suit my needs.
This code MIT (but see below) © murb / Maarten Brouwers, 2011-2015
Workbook uses the following gems:
FAQs
Unknown package
We found that workbook demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.