psu-libraries / ruby_tika_app Goto Github PK

This is a simple frontend to the Java Tika parser command line jar / app.

It is the same as running:

java -server -Djava.awt.headless=true -Dfile.encoding=UTF-8 -jar tika-app-1.24.1.jar FileToParse.pdf

with options like --xml, --text, etc.

To install, add ruby_tika_app to your Gemfile and run bundle install:

gem 'ruby_tika_app'

RubyTikaApp is a pretty big gem since it includes the ruby-tika-app jarfile. It might take a while to install.

First, you need Java installed. And it needs to be in your $PATH.

Then:

require 'ruby_tika_app'

rta = RubyTikaApp.new("sample_file.pdf")

puts rta.to_xml # <xml output>

# You also get to_json, to_text, to_text_main, and to_metadata

Run:

bundle exec rspec spec/

NOTE: Since we are using an underlying java library to connect to external URLs we can't use a standard mocking library. The test suite starts a rack-based web server.

Fork on GitHub and after you've committed tested patches, send a pull request.