dataurl 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3d5342e9845645526e98b529e9d3191d1e9bc513bb19f6badae43467ffdb4243
+  data.tar.gz: 8d89250fd1afae5db25431f78efb81f992c4b81e056fbf1039c1c5609e948998
+SHA512:
+  metadata.gz: 3d1ba7fba0417a76e2ca1801ee656d436203376ca3db06e66355610ec6a36538c5815b8229258a3f54cf5c6bc2ea3e4e77f162ddcade4f7eb0fb97485175cd9b
+  data.tar.gz: 790258065ea5118186a4f56c28d0d5cdd4e900055bd345a7dad97d694e8e91ce148ffb955132f2c50a0b85c70b54eb3ed90b03ee858af0957c11cbe7db1523ad

data/README.rdoc

@@ -0,0 +1,42 @@
+= DataURL: Generate data URLs for use in HTML, CSS, etc.
+
+DataURL is an RFC 2397-compliant data URL generator. It consists of both a small
+library and a command-line utility.
+
+== Command-Line Usage
+
+  $ dataurl myfile.txt
+  $ dataurl -m text/plain myfile
+  $ echo Hello | dataurl -m text/plain
+
+== Library Usage
+
+  require 'dataurl'
+
+  # Figure out the mime type based on the file name.
+  mime_type = DataURL.guess_mime(filename)
+
+  # Generate the data URL.
+  DataURL.generate(mime_type: mime_type, content: IO.binread(filename))
+
+== Copyright and License
+
+Copyright (C) 2020 Megan Ruggiero
+
+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/bin/dataurl

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/dataurl'
+require 'optparse'
+
+mime_type = nil
+chomp = false
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{$PROGRAM_NAME} [FILENAME]"
+
+  opts.on('-mMIME', '--mime-type=MIME',
+          'Set the MIME type (default: autodetect)') do |value|
+    mime_type = value
+  end
+
+  opts.on('-c', '--chomp',
+          'Chomp the final newline (default: disabled)') do |value|
+    chomp = value
+  end
+end.parse!
+
+filename = ARGV[0]
+
+if mime_type.nil?
+  begin
+    if filename.nil? || (mime_type = DataURL.guess_mime(filename)).nil?
+      abort('Failed to guess MIME type. Please specify with the -m option.')
+    end
+  rescue Errno::ENOENT
+    abort('/etc/mime.types does not exist. Please specify the type with -m.')
+  end
+end
+
+content = filename.nil? ? $stdin.read : IO.binread(filename)
+content.chomp! if chomp
+
+puts(DataURL.generate(mime_type: mime_type, content: content))

data/lib/dataurl.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Utilities for generating data URLs for use in HTML, CSS, etc.
+module DataURL
+  # Generate a data URL.
+  # @param mime_type [String] media type of the data to encode
+  # @param content [String] content to encode
+  # @return [String] RFC 2397-compliant data URL.
+  def self.generate(mime_type:, content:)
+    "data:#{mime_type};base64,#{[content].pack('m0')}"
+  end
+
+  # Guess the MIME type of a file using mailcap's /etc/mime.types.
+  # @param filename [String] filename to check against mime.types
+  # @return [String] media type or nil if it could not be detected
+  def self.guess_mime(filename)
+    extension = File.extname(filename)[1..-1].downcase
+
+    File.foreach('/etc/mime.types') do |line|
+      match = /\A([^#\s]+)\s+([^#]+)/.match(line)
+      return match[1] if match && match[2].split.include?(extension)
+    end
+
+    nil
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: dataurl
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Megan Ruggiero
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-07-06 00:00:00.000000000 Z
+dependencies: []
+description: |
+  DataURL is an RFC 2397-compliant data URL generator. It consists of both a
+  small library and a command-line utility.
+email:
+executables:
+- dataurl
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- README.rdoc
+- bin/dataurl
+- lib/dataurl.rb
+homepage: https://github.com/decadentsoup/dataurl
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/decadentsoup/dataurl/issues
+  documentation_uri: https://www.rubydoc.info/gems/dataurl
+  homepage_uri: https://github.com/decadentsoup/dataurl
+  source_code_uri: https://github.com/decadentsoup/dataurl
+  wiki_uri: https://github.com/decadentsoup/dataurl/wiki
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.3
+signing_key:
+specification_version: 4
+summary: Generate data URLs for use in HTML, CSS, etc.
+test_files: []