pics_or_it_didnt_happen 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2a8e935ec65c38271506c2a5bece5d706a660c7386cd100c9282773e7e128b95
+  data.tar.gz: 323232618a4d30ed8f625c976b52380185fda853fa90d21fdb5f0db322a403d2
+SHA512:
+  metadata.gz: c5974894490f3ff424a7a052f8a21dd9ab012d6debc5bba4311c302ce210a1112f75a08aede9859f3185f8d7198de6c691296d59de580c8c78d42f3581f469d6
+  data.tar.gz: 911e9d5a72afb150d2723a20cfeeb8f46459200046525917402ec7f670090192317305971a3f4003458f02804dfed484c2199f0d49e6794ad92b87a3c9fa8572

data/lib/pics_or_it_didnt_happen.rb

@@ -0,0 +1,39 @@
+require 'base64'
+
+module PicsOrItDidntHappen
+  def self.image_to_data_url_image_tag(file_path, alt_text: nil)
+    raise ArgumentError, "No file was found at #{file_path}" unless File.exist?(file_path)
+    file_in_binary = IO.binread(file_path)
+    base64_encoded_image_data = [file_in_binary].pack('m0')
+    src_string = "data:#{mime_type_of(file_path)};base64,#{base64_encoded_image_data}"    
+    if alt_text
+      return "<img src=\"#{src_string}\" alt=\"#{alt_text}\">"
+    else
+      return "<img src=\"#{src_string}\">"
+    end
+  end
+
+  # this method was inspired by a Alain Beauvois's StackOverflow answer: https://stackoverflow.com/a/16635245
+  def self.mime_type_of(file_path)
+    raise ArgumentError, "No file was found at #{file_path}" unless File.exist?(file_path)
+    # define some regular expressions to match the most common image file types
+    png = Regexp.new("\x89PNG".force_encoding("binary"))
+    jpg = Regexp.new("\xff\xd8\xff\xe0\x00\x10JFIF".force_encoding("binary"))
+    jpg2 = Regexp.new("\xff\xd8\xff\xe1(.*){2}Exif".force_encoding("binary"))
+    # Read the first 10 bytes of the file
+    case IO.read(file_path, 10)
+    # MIME types from this list: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
+    when /^GIF8/
+      'image/gif'
+    when /^#{png}/
+      'image/png'
+    when /^#{jpg}/
+      'image/jpeg'
+    when /^#{jpg2}/
+      'image/jpeg'
+    else
+      raise UnprocessableEntity, "File doesn't appear to be a GIF, PNG, or JPEG (based the file's first 10 bytes)"
+    end  
+  end
+end
+

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: pics_or_it_didnt_happen
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Greg Matthew Crossley
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-11-16 00:00:00.000000000 Z
+dependencies: []
+description: |
+  Sometimes, you might want your HTML to include a one-off image file that is just for one person. Making this file public may be undesireable for security reasons, or perhaps simply because it is not worth the overhead of multiple HTTP requests.
+  This gem provides a utility method that takes a locally-saved image file, perhaps within your non-public tmp directory, encodes it as Base64, and returns an HTML <img> element with the correct data URL attributes.
+  It is made possible by the RFC 2397 scheme, which is now fairly well supported in modern browsers.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/pics_or_it_didnt_happen.rb
+homepage: https://github.com/NeomindLabs/pics_or_it_didnt_happen
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/NeomindLabs/pics_or_it_didnt_happen/issues
+  documentation_uri: https://github.com/NeomindLabs/pics_or_it_didnt_happen
+  homepage_uri: https://github.com/NeomindLabs/pics_or_it_didnt_happen
+  source_code_uri: https://github.com/NeomindLabs/pics_or_it_didnt_happen
+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.6
+signing_key:
+specification_version: 4
+summary: A Ruby gem that lets you include images in HTML using data URLs (and avoid
+  serving the image file separatly).
+test_files: []