From: ecin@copypastel.com Date: Fri, 5 Mar 2010 18:12:55 +0000 (+0000) Subject: Added JRuby wrapper for fun scripting times. X-Git-Url: http://git.rot13.org/?a=commitdiff_plain;h=19062fa7ebf1c5557dac53e2cb1857d575ef2a46;hp=9e65454f51088f4ce539cdc445182bd6c060369c;p=zxing.git Added JRuby wrapper for fun scripting times. git-svn-id: http://zxing.googlecode.com/svn/trunk@1241 59b500cc-1b3d-0410-9834-0bbf25fbcc57 --- diff --git a/jruby/README.textile b/jruby/README.textile new file mode 100644 index 00000000..77f004c9 --- /dev/null +++ b/jruby/README.textile @@ -0,0 +1,65 @@ +h2. Decode QR Codes + +p. "QR code":http://en.wikipedia.org/wiki/QR_Code generation is well served in the Ruby community, but decoding seems to be stuck in the Java world. This is an attempt to bridge the gap by wrapping the "ZXing":http://code.google.com/p/zxing/ library with JRuby. ZXing conveniently decodes a plethora of barcodes. Their site has a complete list. + +h2. Requirements + + * JRuby (tested with 1.4.0) + * shoulda (for testing) + +h2. Using the ZXing module/singleton. + +
+  
+    require 'zxing'
+
+    # You can decode a URL...
+    ZXing.decode 'http://2d-code.co.uk/images/bbc-logo-in-qr-code.gif'
+
+    # ... or a file path...
+    ZXing.decode '/Users/ecin/qrcode.png'
+
+    # ... or a File object...
+    ZXing.decode File.open('qrcode.png')
+
+    # ... or anything that returns a URL or file path when #path or #to_s 
+    # is called on it.
+    class Image
+      attr_reader :path
+      def initialize(path); @path = path end
+    end
+
+    image = Image.new('qrcode.png')
+    ZXing.decode image
+      
+    # #decode returns nil if it can't decode the image.
+    ZXing.decode 'image_without_a_code.png'
+    # => nil
+
+    # #decode! will raise an error if it can't decode the image.
+    ZXing.decode! 'image_without_a_code.png'
+    # => NativeException
+
+    # Feel free to include ZXing to shorten the call.
+    include ZXing
+
+    decode 'qrcode.png'
+  
+
+ +h2. Including the Decodable module. + +p. A Decodable module is included (pun intended) to ease using the library with objects that return the URL or file path to decode when #path or #to_s is called. + +
+  
+     require 'zxing/decodable'
+
+     class File
+       include Decodable
+     end
+
+     file = File.open('qrcode.png')
+     file.decode
+   
+
\ No newline at end of file diff --git a/jruby/lib/core.jar b/jruby/lib/core.jar new file mode 100644 index 00000000..3f23fbfe Binary files /dev/null and b/jruby/lib/core.jar differ diff --git a/jruby/lib/javase.jar b/jruby/lib/javase.jar new file mode 100644 index 00000000..6b953c91 Binary files /dev/null and b/jruby/lib/javase.jar differ diff --git a/jruby/lib/zxing.rb b/jruby/lib/zxing.rb new file mode 100644 index 00000000..506161da --- /dev/null +++ b/jruby/lib/zxing.rb @@ -0,0 +1,56 @@ +raise "ZXing requires JRuby" unless defined?(JRuby) + +require File.expand_path( File.dirname(__FILE__) + '/core.jar' ) # ZXing core classes +require File.expand_path( File.dirname(__FILE__) + '/javase.jar' ) # ZXing JavaSE classes + +require 'uri' + +# Google ZXing classes +java_import com.google.zxing.MultiFormatReader +java_import com.google.zxing.BinaryBitmap +java_import com.google.zxing.Binarizer +java_import com.google.zxing.common.GlobalHistogramBinarizer +java_import com.google.zxing.LuminanceSource +java_import com.google.zxing.client.j2se.BufferedImageLuminanceSource + +# Standard Java classes +java_import javax.imageio.ImageIO +java_import java.net.URL + +module ZXing + + @@decoder = MultiFormatReader.new + + # Transform the module into a singleton! + extend self + + def decode(descriptor) + begin + decode!(descriptor) + rescue NativeException + return nil + end + end + + def decode!(descriptor) + descriptor = descriptor.path if descriptor.respond_to? :path + descriptor = descriptor.to_s + descriptor = case descriptor + when URI.regexp(['http', 'https']) + URL.new(descriptor) + else + Java::JavaIO::File.new(descriptor) + end + image = ImageIO.read(descriptor) + bitmap = to_bitmap(image) + @@decoder.decode(bitmap).to_s + end + + private + + def to_bitmap(image) + luminance = BufferedImageLuminanceSource.new(image) + binarizer = GlobalHistogramBinarizer.new(luminance) + BinaryBitmap.new(binarizer) + end +end diff --git a/jruby/lib/zxing/decodable.rb b/jruby/lib/zxing/decodable.rb new file mode 100644 index 00000000..97f64371 --- /dev/null +++ b/jruby/lib/zxing/decodable.rb @@ -0,0 +1,11 @@ +require File.expand_path( File.dirname(__FILE__) + '/../zxing') + +module Decodable + def decode + ZXing.decode(self) + end + + def decode! + ZXing.decode!(self) + end +end diff --git a/jruby/test/qrcode.png b/jruby/test/qrcode.png new file mode 100644 index 00000000..65b9cd4c Binary files /dev/null and b/jruby/test/qrcode.png differ diff --git a/jruby/test/test_helper.rb b/jruby/test/test_helper.rb new file mode 100644 index 00000000..e590e0b7 --- /dev/null +++ b/jruby/test/test_helper.rb @@ -0,0 +1,4 @@ +$LOAD_PATH.unshift File.expand_path( File.dirname(__FILE__) + '/../lib') +$LOAD_PATH.unshift File.expand_path( File.dirname(__FILE__) ) + +require 'shoulda' diff --git a/jruby/test/zxing/decodable_test.rb b/jruby/test/zxing/decodable_test.rb new file mode 100755 index 00000000..1770d547 --- /dev/null +++ b/jruby/test/zxing/decodable_test.rb @@ -0,0 +1,40 @@ +#!/usr/bin/env jruby --headless -rubygems + +require File.expand_path( File.dirname(__FILE__) + '/../test_helper') +require 'zxing/decodable' + +class DecodableTest < Test::Unit::TestCase + + class Object::File + include Decodable + end + + class URL + include Decodable + def initialize(path) + @path = path + end + def path; @path end + end + + context "A Decodable module" do + setup do + @file = File.open( File.expand_path( File.dirname(__FILE__) + '/../qrcode.png' )) + @uri = URL.new "http://2d-code.co.uk/images/bbc-logo-in-qr-code.gif" + @bad_uri = URL.new "http://google.com" + end + + should "provide #decode to decode the return value of #path" do + assert_equal @file.decode, ZXing.decode(@file.path) + assert_equal @uri.decode, ZXing.decode(@uri.path) + assert_nil @bad_uri.decode + end + + should "provide #decode! as well" do + assert_equal @file.decode!, ZXing.decode(@file.path) + assert_equal @uri.decode!, ZXing.decode(@uri.path) + assert_raise(NativeException) { @bad_uri.decode! } + end + end + +end diff --git a/jruby/test/zxing_test.rb b/jruby/test/zxing_test.rb new file mode 100755 index 00000000..bb65133c --- /dev/null +++ b/jruby/test/zxing_test.rb @@ -0,0 +1,59 @@ +#!/usr/bin/env jruby --headless -rubygems + +require File.expand_path( File.dirname(__FILE__) + '/test_helper') +require 'zxing' + +class ZXingTest < Test::Unit::TestCase + context "A QR decoder singleton" do + + class Foo < Struct.new(:v); def to_s; self.v; end; end + + setup do + @decoder = ZXing + @uri = "http://2d-code.co.uk/images/bbc-logo-in-qr-code.gif" + @path = File.expand_path( File.dirname(__FILE__) + '/qrcode.png') + @file = File.new(@path) + @google_logo = "http://www.google.com/logos/grandparentsday10.gif" + @uri_result = "http://bbc.co.uk/programmes" + @path_result = "http://rubyflow.com" + end + + should "decode a URL" do + assert_equal @decoder.decode(@uri), @uri_result + end + + should "decode a file path" do + assert_equal @decoder.decode(@path), @path_result + end + + should "return nil if #decode fails" do + assert_nil @decoder.decode(@google_logo) + end + + should "raise an exception if #decode! fails" do + assert_raise(NativeException) { @decoder.decode!(@google_logo) } + end + + should "decode objects that respond to #path" do + assert_equal @decoder.decode(@file), @path_result + end + + should "call #to_s to argument passed in as a last resort" do + assert_equal @decoder.decode(Foo.new(@path)), @path_result + end + end + + context "A QR decoder module" do + + setup do + class SpyRing; include ZXing end + @ring = SpyRing.new + end + + should "include #decode and #decode! into classes" do + assert_equal defined?(@ring.decode), "method" + assert_equal defined?(@ring.decode!), "method" + end + + end +end