docs.sheetjs.com/docz/docs/03-demos/12-engines/15_rb.md
2023-07-24 22:31:22 -04:00

2.9 KiB

title pagination_prev pagination_next
Ruby + Bindings demos/bigdata/index solutions/input

import current from '/version.js'; import CodeBlock from '@theme/CodeBlock';

ExecJS is a Ruby abstraction over a number of JS runtimes including V8.

The Standalone scripts can be parsed and evaluated in every supported runtime.

Integration Details

Load SheetJS Scripts

The main library can be loaded and compiled in a new context:

require "execjs"

source = File.open("xlsx.full.min.js").read;
context = ExecJS.compile(source);

To confirm the library is loaded, XLSX.version can be inspected:

puts context.eval("XLSX.version");

Reading and Writing Files

The architecture of ExecJS forces users to combine reading and writing in one function step. Base64 strings should be used for interchange. For example, the following snippet reads data from pres.numbers, generates an XLSB file, and writes to sheetjsw.xlsb:

require "base64"

# read and encode data to Base64
data = Base64.strict_encode64(File.open("pres.numbers").read);

# define function and call with the data
xlsb = context.call(<<EOF, data);
function(data) {
  /* parse data -- the argument is the data from Ruby code */
  var wb = XLSX.read(data, {type: 'base64'});
  /* write XLSB data (encoded as base64) */
  return XLSX.write(wb, {bookType: "xlsb", type: "base64"});
}
EOF
# at this point, `xlsb` is a Base64-encoded string

# decode and write to file
File.write("sheetjsw.xlsb", Base64.strict_decode64(xlsb), mode: "wb");

The strict_ variants ensure that no newlines are added to the strings.

Complete Example

:::note

This demo was tested in the following deployments:

Platform Ruby ExecJS Date
darwin-x64 2.7.6 2.8.1 2023-07-24
darwin-arm 2.6.10 2.8.1 2023-07-24

:::

  1. Install Ruby, gem (RubyGems), and the dependencies:
gem install execjs

:::note

The command may need to be run as an administrator or root user:

sudo gem install execjs

:::

  1. Download the standalone script and test file:

{\ curl -LO https://cdn.sheetjs.com/xlsx-${current}/package/dist/xlsx.full.min.js curl -LO https://sheetjs.com/pres.numbers}

  1. Download ExecSheetJS.rb:
curl -LO https://docs.sheetjs.com/execjs/ExecSheetJS.rb
  1. Run the demo:
ruby ExecSheetJS.rb pres.numbers

If the program succeeded, the CSV contents will be printed to console and the file sheetjsw.xlsb will be created. That file can be opened with Excel.