himg 0.0.9 → 0.0.11

data/gemfiles/rails_7_1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    himg (0.0.6)
+    himg (0.0.10)
       rb_sys (~> 0.9)
 
 GEM
@@ -84,10 +84,6 @@ GEM
       mutex_m
       securerandom (>= 0.3)
       tzinfo (~> 2.0)
-    appraisal (2.5.0)
-      bundler
-      rake
-      thor (>= 0.14.0)
     ast (2.4.3)
     base64 (0.2.0)
     benchmark (0.4.0)
@@ -97,7 +93,6 @@ GEM
     concurrent-ruby (1.3.5)
     connection_pool (2.5.1)
     crass (1.0.6)
-    csv (3.3.4)
     date (3.4.1)
     debug (1.10.0)
       irb (~> 1.10)
@@ -105,15 +100,6 @@ GEM
     diff-lcs (1.6.1)
     drb (2.2.1)
     erubi (1.13.1)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    fileutils (1.7.3)
     globalid (1.2.1)
       activesupport (>= 6.1)
     i18n (1.14.7)
@@ -126,9 +112,6 @@ GEM
     json (2.10.2)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
-    listen (3.9.0)
-      rb-fsevent (~> 0.10, >= 0.10.3)
-      rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
     loofah (2.24.0)
       crass (~> 1.0.2)
@@ -222,13 +205,8 @@ GEM
     rake-compiler (1.3.0)
       rake
     rake-compiler-dock (1.9.1)
-    rb-fsevent (0.11.2)
-    rb-inotify (0.11.1)
-      ffi (~> 1.0)
     rb_sys (0.9.111)
       rake-compiler-dock (= 1.9.1)
-    rbs (3.9.2)
-      logger
     rdoc (6.13.1)
       psych (>= 4.0.0)
     regexp_parser (2.10.0)
@@ -271,27 +249,7 @@ GEM
       prism (~> 1.4)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    steep (1.10.0)
-      activesupport (>= 5.1)
-      concurrent-ruby (>= 1.1.10)
-      csv (>= 3.0.9)
-      fileutils (>= 1.1.0)
-      json (>= 2.1.0)
-      language_server-protocol (>= 3.17.0.4, < 4.0)
-      listen (~> 3.0)
-      logger (>= 1.3.0)
-      mutex_m (>= 0.3.0)
-      parser (>= 3.1)
-      rainbow (>= 2.2.2, < 4.0)
-      rbs (~> 3.9)
-      securerandom (>= 0.1)
-      strscan (>= 1.0.0)
-      terminal-table (>= 2, < 5)
-      uri (>= 0.12.0)
     stringio (3.1.7)
-    strscan (3.1.3)
-    terminal-table (4.0.0)
-      unicode-display_width (>= 1.1.1, < 4)
     thor (1.3.2)
     timeout (0.4.3)
     tzinfo (2.0.6)
@@ -299,7 +257,6 @@ GEM
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
-    uri (1.0.3)
     websocket-driver (0.7.7)
       base64
       websocket-extensions (>= 0.1.0)
@@ -317,7 +274,6 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
-  appraisal
   bump
   debug
   himg!
@@ -328,7 +284,7 @@ DEPENDENCIES
   rspec
   rspec-rails (~> 7.0)
   rubocop
-  steep
+  thor
 
 BUNDLED WITH
    2.6.7

data/gemfiles/rails_7_2.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    himg (0.0.6)
+    himg (0.0.10)
       rb_sys (~> 0.9)
 
 GEM
@@ -78,10 +78,6 @@ GEM
       minitest (>= 5.1)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
-    appraisal (2.5.0)
-      bundler
-      rake
-      thor (>= 0.14.0)
     ast (2.4.3)
     base64 (0.2.0)
     benchmark (0.4.0)
@@ -91,7 +87,6 @@ GEM
     concurrent-ruby (1.3.5)
     connection_pool (2.5.1)
     crass (1.0.6)
-    csv (3.3.4)
     date (3.4.1)
     debug (1.10.0)
       irb (~> 1.10)
@@ -99,15 +94,6 @@ GEM
     diff-lcs (1.6.1)
     drb (2.2.1)
     erubi (1.13.1)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    fileutils (1.7.3)
     globalid (1.2.1)
       activesupport (>= 6.1)
     i18n (1.14.7)
@@ -120,9 +106,6 @@ GEM
     json (2.10.2)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
-    listen (3.9.0)
-      rb-fsevent (~> 0.10, >= 0.10.3)
-      rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
     loofah (2.24.0)
       crass (~> 1.0.2)
@@ -135,7 +118,6 @@ GEM
     marcel (1.0.4)
     mini_mime (1.1.5)
     minitest (5.25.5)
-    mutex_m (0.3.0)
     net-imap (0.5.6)
       date
       net-protocol
@@ -216,13 +198,8 @@ GEM
     rake-compiler (1.3.0)
       rake
     rake-compiler-dock (1.9.1)
-    rb-fsevent (0.11.2)
-    rb-inotify (0.11.1)
-      ffi (~> 1.0)
     rb_sys (0.9.111)
       rake-compiler-dock (= 1.9.1)
-    rbs (3.9.2)
-      logger
     rdoc (6.13.1)
       psych (>= 4.0.0)
     regexp_parser (2.10.0)
@@ -265,27 +242,7 @@ GEM
       prism (~> 1.4)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    steep (1.10.0)
-      activesupport (>= 5.1)
-      concurrent-ruby (>= 1.1.10)
-      csv (>= 3.0.9)
-      fileutils (>= 1.1.0)
-      json (>= 2.1.0)
-      language_server-protocol (>= 3.17.0.4, < 4.0)
-      listen (~> 3.0)
-      logger (>= 1.3.0)
-      mutex_m (>= 0.3.0)
-      parser (>= 3.1)
-      rainbow (>= 2.2.2, < 4.0)
-      rbs (~> 3.9)
-      securerandom (>= 0.1)
-      strscan (>= 1.0.0)
-      terminal-table (>= 2, < 5)
-      uri (>= 0.12.0)
     stringio (3.1.7)
-    strscan (3.1.3)
-    terminal-table (4.0.0)
-      unicode-display_width (>= 1.1.1, < 4)
     thor (1.3.2)
     timeout (0.4.3)
     tzinfo (2.0.6)
@@ -293,7 +250,6 @@ GEM
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
-    uri (1.0.3)
     useragent (0.16.11)
     websocket-driver (0.7.7)
       base64
@@ -312,7 +268,6 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
-  appraisal
   bump
   debug
   himg!
@@ -323,7 +278,7 @@ DEPENDENCIES
   rspec
   rspec-rails (~> 7.0)
   rubocop
-  steep
+  thor
 
 BUNDLED WITH
    2.6.7

data/gemfiles/rails_8.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    himg (0.0.6)
+    himg (0.0.10)
       rb_sys (~> 0.9)
 
 GEM
@@ -78,10 +78,6 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    appraisal (2.5.0)
-      bundler
-      rake
-      thor (>= 0.14.0)
     ast (2.4.3)
     base64 (0.2.0)
     benchmark (0.4.0)
@@ -91,7 +87,6 @@ GEM
     concurrent-ruby (1.3.5)
     connection_pool (2.5.1)
     crass (1.0.6)
-    csv (3.3.4)
     date (3.4.1)
     debug (1.10.0)
       irb (~> 1.10)
@@ -99,15 +94,6 @@ GEM
     diff-lcs (1.6.1)
     drb (2.2.1)
     erubi (1.13.1)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    fileutils (1.7.3)
     globalid (1.2.1)
       activesupport (>= 6.1)
     i18n (1.14.7)
@@ -120,9 +106,6 @@ GEM
     json (2.10.2)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
-    listen (3.9.0)
-      rb-fsevent (~> 0.10, >= 0.10.3)
-      rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
     loofah (2.24.0)
       crass (~> 1.0.2)
@@ -135,7 +118,6 @@ GEM
     marcel (1.0.4)
     mini_mime (1.1.5)
     minitest (5.25.5)
-    mutex_m (0.3.0)
     net-imap (0.5.6)
       date
       net-protocol
@@ -216,13 +198,8 @@ GEM
     rake-compiler (1.3.0)
       rake
     rake-compiler-dock (1.9.1)
-    rb-fsevent (0.11.2)
-    rb-inotify (0.11.1)
-      ffi (~> 1.0)
     rb_sys (0.9.111)
       rake-compiler-dock (= 1.9.1)
-    rbs (3.9.2)
-      logger
     rdoc (6.13.1)
       psych (>= 4.0.0)
     regexp_parser (2.10.0)
@@ -265,27 +242,7 @@ GEM
       prism (~> 1.4)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    steep (1.10.0)
-      activesupport (>= 5.1)
-      concurrent-ruby (>= 1.1.10)
-      csv (>= 3.0.9)
-      fileutils (>= 1.1.0)
-      json (>= 2.1.0)
-      language_server-protocol (>= 3.17.0.4, < 4.0)
-      listen (~> 3.0)
-      logger (>= 1.3.0)
-      mutex_m (>= 0.3.0)
-      parser (>= 3.1)
-      rainbow (>= 2.2.2, < 4.0)
-      rbs (~> 3.9)
-      securerandom (>= 0.1)
-      strscan (>= 1.0.0)
-      terminal-table (>= 2, < 5)
-      uri (>= 0.12.0)
     stringio (3.1.7)
-    strscan (3.1.3)
-    terminal-table (4.0.0)
-      unicode-display_width (>= 1.1.1, < 4)
     thor (1.3.2)
     timeout (0.4.3)
     tzinfo (2.0.6)
@@ -312,7 +269,6 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
-  appraisal
   bump
   debug
   himg!
@@ -323,7 +279,7 @@ DEPENDENCIES
   rspec
   rspec-rails (~> 7.0)
   rubocop
-  steep
+  thor
 
 BUNDLED WITH
    2.6.7

data/lib/himg/cli.rb

@@ -1,9 +1,22 @@
 require "thor"
 require "himg"
 require "open-uri"
+require "uri"
 
 module Himg
   class CLI < Thor
+    default_command :usage
+
+    desc "usage", "Show usage for screenshot command", hide: true
+    def usage
+      puts "himg v#{VERSION}"
+      puts
+      puts "Converts HTML to PNG images using a lightweight, minimal renderer."
+      puts "Ideal for generating OpenGraph images from purpose-built HTML."
+      puts
+      CLI.command_help(Thor::Base.shell.new, 'screenshot')
+    end
+
     desc "screenshot SOURCE_HTML DESTINATION_PNG [OPTIONS]", "Render HTML to a png screenshot"
 
     option :width, type: :numeric, desc: "Sets the width of the rendered content.", default: 720
@@ -13,7 +26,7 @@ module Himg
     option :disable_fetch, type: :boolean, desc: "Skip fetching file/http resources (stylesheets, images, fonts, etc)", default: false
     option :fetch_timeout, type: :numeric, desc: "Timeout in seconds for fetching resources", default: 10
     option :gpu, type: :boolean, desc: "Use GPU renderer instead of CPU renderer", default: false
-    option :http_headers, desc: "HTTP Headers to use when fetching remote resource"
+    option :http_headers, type: :hash, desc: "HTTP headers sent when fetching the SOURCE_HTML (e.g. --http-headers \"Authorization: Bearer token\" \"Content-Type: application/json\")"
     option :base_url, desc: "Base URL used to resolve relative URLs"
 
     long_desc <<-LONGDESC
@@ -27,8 +40,13 @@ module Himg
       Additionally it does not use a JavaScript engine, so will screenshot the page as-is and would not work for all webpages.
     LONGDESC
     def screenshot(url, destination)
+      options[:http_headers]&.transform_values!(&:strip)
+
       Document.new(url, options).load do |content|
-        png = Himg.render(content, **options.transform_keys(&:to_sym))
+        render_options = options.transform_keys(&:to_sym)
+        render_options[:base_url] ||= base_directory_url(url) if Document.http_url?(url)
+
+        png = Himg.render(content, **render_options)
 
         File.open(destination, "wb") { |f| f.write(png) }
       end
@@ -36,6 +54,10 @@ module Himg
 
     private
 
+    def base_directory_url(url)
+      URI.join(url, ".").to_s
+    end
+
     def self.exit_on_failure?
       true
     end
@@ -44,15 +66,19 @@ module Himg
       def initialize(source, options)
         @source = source
         @options = options
+        @http_headers = options[:http_headers]
       end
 
-      def http_url?
-        @source =~ %r{\Ahttps?\://}
+      def self.http_url?(url)
+        url =~ %r{\Ahttps?\://}
       end
 
       def load(&block)
-        if http_url?
-          URI.send(:open, @source) do |input|
+        if self.class.http_url?(@source)
+          args = [@source]
+          args << @http_headers if @http_headers
+
+          URI.open(*args) do |input|
             yield(input.binmode.read)
           end
         else

data/lib/himg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Himg
-  VERSION = "0.0.9"
+  VERSION = "0.0.11"
 end

data/lib/himg.rb

@@ -8,7 +8,7 @@ require "himg/railtie" if defined?(Rails::Railtie)
 # Fall back to loading the non-versioned extension if version-specific loading fails.
 begin
   RUBY_VERSION =~ /(\d+\.\d+)/
-  require "#{Regexp.last_match(1)}/himg/himg"
+  require "himg/#{Regexp.last_match(1)}/himg"
 rescue LoadError
   require "himg/himg"
 end
@@ -19,6 +19,7 @@ end
 module Himg
   RENDER_OPTIONS = %i[width height truncate verbose base_url disable_fetch fetch_timeout gpu].freeze
   class Error < StandardError; end
+  class GpuNotFound < Error; end
 
   def self.render(html, width: 720, height: 405, truncate: true, verbose: false, base_url: nil, disable_fetch: false, fetch_timeout: 10, gpu: false)
     render_to_string(html, "width" => width.to_i, "height" => height.to_i, "truncate" => truncate, "verbose" => verbose, "base_url" => BaseUrl.new(base_url).to_s, "disable_fetch" => disable_fetch, "fetch_timeout" => fetch_timeout.to_f, "gpu" => gpu)

data/logo.svg

@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg width="220" height="80" viewBox="0 0 220 80" version="1.1" id="svg32" xmlns="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg">
+  <defs id="defs14">
+    <linearGradient id="waveGradient" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#FF006E" id="stop2" />
+      <stop offset="50%" stop-color="#8338EC" id="stop4" />
+      <stop offset="100%" stop-color="#3A86FF" id="stop6" />
+    </linearGradient>
+    <linearGradient id="borderGradient" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#8338EC" id="stop9" />
+      <stop offset="100%" stop-color="#3A86FF" id="stop11" />
+    </linearGradient>
+  </defs>
+
+  <!-- H letter  -->
+  <g aria-label="H" id="text16" style="font-weight:800;font-size:72px;font-family:'Noto Sans';fill:#ff006e">
+    <path
+       d="M 48.6,60 H 37.728 V 37.824 H 17.352 V 60 H 6.48 V 8.592 h 10.872 v 20.16 H 37.728 V 8.592 H 48.6 Z"
+       id="path36" />
+  </g>
+
+  <!-- Flowing wave connector centered on H -->
+  <g transform="translate(60,5)" id="g22">
+    <svg width="120" height="60" viewBox="0 0 120 60" version="1.1" id="svg20">
+      <path d="m 0,30 q 30,-20 60,0 30,20 60,0" stroke="url(#waveGradient)" stroke-width="4" fill="none" id="path18">
+        <animate
+           attributeName="d"
+           values="M 0 30 Q 30 10, 60 30 T 120 30; M 0 30 Q 30 50, 60 30 T 120 30; M 0 30 Q 30 10, 60 30 T 120 30"
+           dur="3s"
+           repeatCount="indefinite" />
+      </path>
+    </svg>
+  </g>
+  <g transform="translate(160,35)" id="g30">
+
+    <!-- Background for gradient border -->
+    <path id="rect24" style="fill:url(#borderGradient)"
+       d="m -10,-20 h 40 c 11.08,0 20,8.92 20,20 0,11.08 -8.92,20 -20,20 h -40 c -11.08,0 -20,-8.92 -20,-20 0,-11.08 8.92,-20 20,-20 z" />
+
+    <!-- White fill on top with 2px border -->
+    <path id="rect26" style="fill:#ffffff"
+       d="m -10,-18 h 40 c 9.972,0 18,8.028 18,18 0,9.972 -8.028,18 -18,18 h -40 c -9.972,0 -18,-8.028 -18,-18 0,-9.972 8.028,-18 18,-18 z" />
+
+    <!-- "img" text -->
+    <g aria-label="img" id="text28" style="font-weight:700;font-size:24px;font-family:'Noto Sans';text-anchor:middle;fill:#333333">
+      <path
+         d="m -9.3680009,-10.24 q 0.792,0 1.368,0.384 0.576,0.36 0.576,1.368 0,0.984 -0.576,1.368 -0.576,0.384 -1.368,0.384 -0.8160001,0 -1.3920001,-0.384 -0.552,-0.384 -0.552,-1.368 0,-1.008 0.552,-1.368 0.576,-0.384 1.3920001,-0.384 z m 1.776,5.136 V 8 H -11.168001 V -5.104 Z"
+         id="path41" />
+      <path
+         d="m 11.536006,-5.344 q 2.232,0 3.36,1.152 1.152,1.128 1.152,3.648 V 8 h -3.576 V 0.344 q 0,-2.832 -1.968,-2.832 -1.4159996,0 -2.0159996,1.008 -0.6,1.008 -0.6,2.904 V 8 h -3.576 V 0.344 q 0,-2.832 -1.968,-2.832 -1.48799999,0 -2.06399999,1.128 -0.552,1.104 -0.552,3.192 V 8 H -3.8479936 V -5.104 h 2.736 l 0.48000001,1.68 h 0.192 q 0.6,-1.008 1.63199999,-1.464 1.056,-0.456 2.184,-0.456 1.44,0 2.448,0.48 1.008,0.456 1.536,1.44 h 0.312 q 0.6,-1.008 1.656,-1.464 1.0799996,-0.456 2.2079996,-0.456 z"
+         id="path43" />
+      <path
+         d="m 23.968015,-5.344 q 2.424,0 3.792,1.92 h 0.096 l 0.288,-1.68 h 3.024 V 8.024 q 0,2.808 -1.656,4.272 -1.656,1.464 -4.896,1.464 -1.392,0 -2.592,-0.168 -1.176,-0.168 -2.304,-0.6 v -2.856 q 2.424,1.008 5.112,1.008 2.76,0 2.76,-2.976 V 7.904 q 0,-0.408 0.024,-0.84 0.048,-0.432 0.072,-0.768 h -0.096 q -0.672,1.032 -1.608,1.488 -0.936,0.456 -2.112,0.456 -2.328,0 -3.648,-1.776 -1.296,-1.8 -1.296,-4.992 0,-3.216 1.344,-5.016 1.344,-1.8 3.696,-1.8 z m 1.128,2.904 q -2.52,0 -2.52,3.96 0,3.912 2.568,3.912 1.368,0 2.016,-0.768 0.672,-0.792 0.672,-2.736 V 1.496 q 0,-2.112 -0.648,-3.024 -0.648,-0.912 -2.088,-0.912 z"
+         id="path45" />
+    </g>
+  </g>
+</svg>