data_uri 0.0.1 → 0.0.2

data/README.rdoc

@@ -5,19 +5,65 @@
 Data URIs allow resources to be embedding inside a URI. The URI::Data class
 provides support for parsing these URIs using the normal URI.parse method.
 
+I wrote it to support embedding binary data inside JSON messages in a
+relatively reasonable way. If you find some other use for it, please drop me
+a line.
+
 == Usage
 
  require 'data_uri'
 
  uri = URI.parse('data:image/gif;base64,...')
- uri.content_type # 'image/gif
+ uri.content_type # image/gif
  uri.data # Base64 decoded data
 
+Data URIs can play nicely with open-uri:
+
+ require 'data_uri/openuri'
+
+ open(uri) do |io|
+   io.content_type # image/gif
+   io.read # decoded data
+ end
+
+There is no support for creating data URI strings, but it would be trivial to
+add if anyone's interested.
+
+== Features & Limitations
+
+It accepts URIs with charset MIME parameters:
+
+ data:text/html;charset=utf-8,...
+
+and if the String object has a force_encoding method, as in ruby-1.9.x, it
+will call it with the value of the charset parameter on the decoded data.
+Other MIME parameters are parsed and stored, but are not exposed.
+
+The base64 pseudo-parameter must appear immediately prior to the data, as per
+the RFC. Google Chrome apparently misbehaves in this regard, so if this
+causes grief to anyone, yell and I'll relax the constraint. If base64 coding
+is not specified, the data are URI decoded.
+
+Some non-authoritative documentation about data URIs state that whitespace
+is allowed and ignored within them. The RFC seems to contradict this
+interpretation, but support seems to be widespread in the browser world.
+URI::Data cannot parse URIs containing whitespace. If
+this causes grief to anyone, yell and I'll either add a class method to
+URI::Data for explicit relaxed parsing, and/or figure out how to convince
+URI::Generic to be more open minded about the kinds of URIs it allows.
+
+Even when using the open-uri support file, Kernel.open will not accept string
+data URIs, only URI::Data objects. Open-uri is opinionated about the
+formats of the URIs it will try to open, and it's ambiguous to me at least if
+data URIs can necessarily be distinguished from filesystem paths on all
+platforms. Again, if this causes undue pain and suffering, we can commit
+minor violence to open-uri to convince it to see reason.
+
 == License:
 
 (The MIT License)
 
-Copyright (c) 2010
+Copyright (c) 2010 Donald Ball <donald.ball@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -2,9 +2,3 @@ desc "Build a gem file"
 task :build do
   system "gem build data_uri.gemspec"
 end
-
-task :default => :test
-
-task :test do
-  system "ruby -Ilib test/test_*.rb"
-end

data/lib/data_uri/open_uri.rb

@@ -0,0 +1,22 @@
+module URI
+
+  class Data
+
+    def open
+      io = StringIO.new(data)
+      OpenURI::Meta.init(io)
+      io.meta_add_field('content-type', content_type)
+      if block_given?
+        begin
+          yield io
+        ensure
+          io.close
+        end
+      else
+        io
+      end
+    end
+
+  end
+
+end

data/lib/data_uri/uri.rb

@@ -0,0 +1,40 @@
+module URI
+
+  class Data < Generic
+
+    COMPONENT = [:scheme, :opaque].freeze
+    MIME_TYPE_RE = %r{^([-\w.+]+/[-\w.+]*)}.freeze
+    MIME_PARAM_RE = /^;([-\w.+]+)=([^;,]+)/.freeze
+
+    attr_reader :content_type, :data
+
+    def initialize(*args)
+      super(*args)
+      @data = @opaque
+      if md = MIME_TYPE_RE.match(@data)
+        @content_type = md[1]
+        @data = @data[@content_type.length .. -1]
+      end
+      @content_type ||= 'text/plain'
+      @mime_params = {}
+      while md = MIME_PARAM_RE.match(@data)
+        @mime_params[md[1]] = md[2]
+        @data = @data[md[0].length .. -1]
+      end
+      if base64 = /^;base64/.match(@data)
+        @data = @data[7 .. -1]
+      end
+      unless /^,/.match(@data)
+        raise 'Invalid data URI'
+      end
+      @data = @data[1 .. -1]
+      @data = base64 ? Base64.decode64(@data) : URI.decode(@data)
+      if @data.respond_to?(:force_encoding) && charset = @mime_params['charset']
+        @data.force_encoding(charset)
+      end
+    end
+  end
+
+  @@schemes['DATA'] = Data
+
+end

data/lib/data_uri.rb

@@ -1,24 +1,5 @@
 require 'uri'
 require 'base64'
+require 'stringio'
 
-module URI
-
-  class Data < Generic
-
-    COMPONENT = [:scheme, :opaque].freeze
-    OPAQUE_REGEXP = /^([^;]+);base64,(.+)$/.freeze
-
-    attr_reader :content_type, :data
-
-    def initialize(*args)
-      super(*args)
-      if OPAQUE_REGEXP.match(@opaque)
-        @content_type = $1
-        @data = Base64.decode64($2)
-      end
-    end
-  end
-
-  @@schemes['DATA'] = Data
-
-end
+require 'data_uri/uri'

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: data_uri
 version: !ruby/object:Gem::Version 
+  hash: 27
   prerelease: false
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Donald Ball
@@ -29,6 +30,8 @@ extra_rdoc_files:
 files: 
 - README.rdoc
 - Rakefile
+- lib/data_uri/open_uri.rb
+- lib/data_uri/uri.rb
 - lib/data_uri.rb
 has_rdoc: true
 homepage: http://github.com/dball/data_uri
@@ -44,6 +47,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
@@ -52,6 +56,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"