data_uri_revived 0.1.1.beta1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3387185bb9f128eeeded93f7e9ffd3cf2830618cfcd1cba04b8ee5856ba0a400
+  data.tar.gz: 9d54ec7a5bfcf39a0083d8e3243d605fc065c9decbddf7a5b971144aeb822709
+SHA512:
+  metadata.gz: d263b3c9b10a9b47090e9ca27b3732f049fe2e6d7af7431ab9a2abb8a3684e2b7565ce1f4c0b480d706da8e1041380877788e8fd5861a84f1ef1b3feb7dc8547
+  data.tar.gz: 22c227426e43fd6d81b796673e799defca78ae61a3b080bea25f739da65b5692a7daec7f2667ccc2fc698d23a8bfb1f08734c5d0232cf05a2848a1e204e1fc4c

data/README.rdoc

@@ -0,0 +1,92 @@
+= Data URI Revived {<img src="https://img.shields.io/github/actions/workflow/status/data-uri-ruby/data_uri/tests.yaml?branch=master&style=flat-square" alt="Build Status" />}[https://github.com/data-uri-ruby/data_uri/actions/workflows/tests.yaml]
+
+Fork of unmaintained original `data_uri` (No commit for 11 years)
+
+== Introduction
+
+Data URIs allow resources to be embedded 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.
+
+== Installation
+
+ # Replacement of `data_uri`, do not mix with it
+ gem 'data_uri_revived'
+
+== Usage
+
+ require 'data_uri_revived'
+ # Or the old one in case you have old require statements
+ require 'data_uri'
+
+ uri = URI::Data.new('data:image/gif;base64,...')
+ uri.content_type # image/gif
+ uri.data # Base64 decoded data
+
+ # Same as `URI::Data.new`
+ uri = URI.parse('data:image/gif;base64,...')
+
+Data URIs CANNOT play nicely with open-uri (was mentioned to be working in original `data_uri` gem
+
+== Features & Limitations
+
+URI.parse knows about URI::Data, but unfortunately, its regexp for splitting
+URIs into components maxes out at 92 characters for an opaque URI, which is
+far too small to be useful for data URIs.
+
+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 Donald Ball <donald.ball@gmail.com>
+Copyright (c) 2025 PikachuEXE <git@pikachuexe.net>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rake/testtask'
+Rake::TestTask.new
+task :default => :test
+
+desc "Build a gem file"
+task :build do
+  system "gem build data_uri.gemspec"
+end
+

data/lib/data_uri/uri.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'base64'
+
+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)
+      if args.length == 1
+        uri = args.first.to_s
+        unless uri.match(/^data:/)
+          raise URI::InvalidURIError.new('Invalid Data URI: ' + args.first.inspect)
+        end
+        @scheme = 'data'
+        @opaque = uri[5 .. -1]
+      else
+        super(*args)
+      end
+      @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 URI::InvalidURIError.new('Invalid data URI')
+      end
+      @data = @data[1 .. -1]
+      @data = base64 ? Base64.decode64(@data) : URI.decode_www_form_component(@data)
+      if @data.respond_to?(:force_encoding) && (charset = @mime_params['charset'])
+        @data.force_encoding(charset)
+      end
+    end
+
+    def self.build(arg)
+      data = nil
+      content_type = nil
+      case arg
+        when IO
+          data = arg
+        when Hash
+          data = arg[:data]
+          content_type = arg[:content_type]
+      end
+      raise 'Invalid build argument: ' + arg.inspect unless data
+      if !content_type && data.respond_to?(:content_type)
+        content_type = data.content_type
+      end
+      new('data', nil, nil, nil, nil, nil, "#{content_type};base64,#{Base64.encode64(data.read).chop}", nil, nil)
+    end
+  end
+
+  unless methods(false).include?(:register_scheme)
+    def self.register_scheme(scheme, klass)
+      @@schemes[scheme] = klass
+    end
+  end
+  register_scheme('DATA', Data)
+
+end

data/lib/data_uri.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'data_uri/uri'

data/lib/data_uri_revived.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'data_uri/uri'

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: data_uri_revived
+version: !ruby/object:Gem::Version
+  version: 0.1.1.beta1
+platform: ruby
+authors:
+- Donald Ball
+- PikachuEXE
+bindir: bin
+cert_chain: []
+date: 2025-01-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: URI class for parsing data URIs
+email:
+- donald.ball@gmail.com
+- git@pikachuexe.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- README.rdoc
+- Rakefile
+- lib/data_uri.rb
+- lib/data_uri/uri.rb
+- lib/data_uri_revived.rb
+homepage: https://github.com/data-uri-ruby/data_uri
+licenses: []
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: A URI class for parsing data URIs as per RFC2397
+test_files: []