html_to 0.7.2 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8dfe49b4c49b244fbaf07b43bad721e8c3fd589d1a72a34d0679fd5c598f04a2
-  data.tar.gz: 70dc266086e67d001cda4976ba4d29bef8078823fb835b47e2b6b33aaa34a7dd
+  metadata.gz: cc490495133d2799e907b246a839a9645e81d0097a10006a851cbb8af8343a61
+  data.tar.gz: 46f2beb5850fe8975354763abdce67ea53b0f06bc65a6ed19d9c179cb329f547
 SHA512:
-  metadata.gz: 943cc79185807aeea0482a83c053e4d414d02dd6cb79ae87fdf6c857455bd067056cf6b77cedd6c65a0c2ed66537b241dfe3f7e49b87636355f2d683138ed5a4
-  data.tar.gz: 918beae4db7054acb2393dea07d9b1038d849c8d705751b4db31911ea2e33bf15bc1789bda65b4f87f0a5b90a1a5587c3bc7bd29ff062b4b7acbe3befe2dae8e
+  metadata.gz: daeaa75cc74b90d4ff4883c5475559d7b886fb81dcbdea084ae96d1b5fd159e962e1dcf442ad95dabdc3d0298f4f82b2f2bc2d2ac8e10bb70094f2cd0f40abbc
+  data.tar.gz: 9ab97a704bcc78d2274948916e8b382e7cb97a64775a37747ce7abe866564b5126e06cd09f1e56db53c9996c471ddfb1d1b82fead1a8ecf8d3583596b01fe3ba

data/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project author at vchekryzhov@ya.ru. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/.github/CONTRIBUTING.md

@@ -0,0 +1,14 @@
+# Contributing
+
+1. [Fork the repository.][fork]
+2. [Create a topic branch.][branch]
+3. Implement your feature or bug fix.
+4. Don't forget to add specs and make sure they pass by running `rspec .`.
+5. Make sure your code complies with the style guide by running `rubocop`. `rubocop -a` can automatically fix most issues for you.
+6. If necessary, add documentation for your feature or bug fix.
+7. Commit and push your changes.
+8. [Submit a pull request.][pr]
+
+[fork]: http://help.github.com/fork-a-repo/
+[branch]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-branches
+[pr]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests

data/.github/pull_request_template.md

@@ -0,0 +1,11 @@
+### Summary
+
+Provide a general description of the code changes in your pull
+request. Were there any bugs you had fixed? If so, mention them. If
+these bugs have open GitHub issues, be sure to tag them here as well,
+to keep the conversation linked together.
+
+### Other Information
+
+If there's anything else that's important and relevant to your pull
+request, mention that information here. 

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+## 1.1.1
+Added templates, added generators, updated Readme, updated dependencies
+## 1.0.1
+Bug fixes. test refactor. Added integration tests
+## 1.0.0 (5-Sep-2023)
+Added configuration via DSL. Added ability to generate few images on one model. Replaced carrierwave uploader to active storage. Added rspec.
+## 0.7.2 (12-May-2021)
+* Fixing Issues
+## 0.7.0 (07-Apr-2021)
+* Some Improves
+## 0.0.2 (05-Apr-2021)
+* Fixing Issues
+## 0.0.1 (05-Apr-2021)
+* Initial release

data/Gemfile

@@ -0,0 +1,23 @@
+source 'http://rubygems.org'
+gemspec
+
+group :test do
+  gem 'database_cleaner-active_record'
+  gem 'image_processing'
+  gem 'tzinfo-data', platforms: %i[mingw mswin x64_mingw jruby]
+
+  gem 'database_cleaner'
+  gem 'dotenv', '~> 2.5'
+  gem 'rails', '~> 7'
+  gem 'rake', '~> 13.0'
+  gem 'rspec', '~> 3.6'
+  gem 'rspec-rails', '~> 4.0'
+  gem 'sqlite3'
+  # rubocop dependencies...
+  gem 'rubocop', '~> 1.55'
+  gem 'rubocop-performance', '~> 1.18'
+  gem 'rubocop-rspec', '~> 2.22'
+  gem 'simplecov', '~> 0.16'
+  gem 'simplecov-cobertura'
+  gem 'vcr', '~> 6.0'
+end

data/README.md

@@ -1,77 +1,75 @@
-# html-to
-# install
-``` ruby
-gem 'html_to'
-```
-And also you need headless browser chrome
+[![codecov](https://codecov.io/gh/Vchekryzhov/html-to/graph/badge.svg?token=27NK3S64MS)](https://codecov.io/gh/Vchekryzhov/html-to)
+[![build](https://github.com/vchekryzhov/html-to/actions/workflows/ruby.yml/badge.svg)](https://github.com/vchekryzhov/html-to/actions/workflows/ruby.yml/badge.svg)
+[![Gem Version](https://img.shields.io/gem/v/html_to.svg)](https://rubygems.org/gems/html_to)
+
+# HtmlTo 🔥
+
+HtmlTo is a gem for Rails that allows you to generate images from an HTML file.💡
+
+## 📋 Table of Contents
+
+- [Installation](#Installation)🚀
+- [Usage](#basic-usage) 📖
+- [Advanced usage](#advanced-usage) 🧰
+
+
+## Installation
+
+You need to have Chrome or Chromium installed 🛠️
+
 
 Ubuntu:
 ``` bash
 sudo apt install -y chromium-browser
 ```
-
 Debian:
 ```bash
 apt-get install chromium chromium-l10n
 ```
-
-# Get Started
-### Prepare your model
-1) do migrate string field for uploader
-
-and add start to your model, what you want use
-``` ruby
-@@share_uploader = "share_image"
-@@share_template = 'share/post'
-include HtmlTo
+add gem to your gemfile
+```ruby
+gem 'html_to'
+```
+copy example serializer with
+```bash
+ rails generate html_to:install
 ```
 
-### creating template file
-
-you need create, on path ```@@share_template``` how example share/post will be ```app/views/share/post.html.erb```
-
-######template file example:
-``` html
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <title>Title</title>
-	<style>
-
-		body {
-			margin: 0;
-		}
-		.image {
-			background-size: cover;
-			position: absolute;
-      float: left;
-      top: 0px;
-      width: 1200px;
-      height: 630px;
-      object-fit: y-repeat;
+### optional
+for set path to chromium executable 
+```ruby
+#confg/initializers/html_to.rb
+HtmlTo::Configuration.config do |config|
+  config.chromium_path = './path-to-executable'
+end
+```
 
-    }
-    .description{
-      position: absolute;
-      font-size: 48px;
-      z-index: 1;
-    }
+## Basic usage
+Add to your model 📖
 
-	</style>
-</head>
-<body>
-	<div class="root">
-    <img class='image' src="https://images.unsplash.com/photo-1593642702821-c8da6771f0c6?ixid=MXwxMjA3fDF8MHxwaG90by1wYWdlfHx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&fit=crop&w=1489&q=80">
-    <p class="description">
-      <%=obj.attributes%>
-      </p>
-	</div>
-</body>
-</html>
+```ruby
+  include HtmlTo
+  html_to HtmlToSerializer
+```
+Now after save your model new image will generated and attached to ```meta_image``` in your model
 
+## Advanced usage
+available options for customizations 🧰
+```ruby
+  html_to HtmlTo::DummySerializer, image_name: :my_image, template: :image
 ```
-In your template file you has access to your object via @obj
+| option             | descriotions                               | default    |
+|--------------------|--------------------------------------------|------------|
+| `image_name`       | name of attachment                         | meta_image |
+| `template`         | HTML template                              | circle     |
+| `synchronous`      | Run image generation job not in background | false      |
+| `skip_auto_update` | skip auto update after save                | false      |
+| `width`            | width of image                             | 1200       |
+| `height`           | height of image                            | 630        |
 
-###### Assets, font, etc
-Headless browser will be start from Rails public path, all local assets should be access in the public folder.
+### template customization
+there are two templates available `circle` and `image` for copy to your project:
+```bash
+rails generate html_to:copy_template
+```
+you can add your own template to `app/views/html_to/*`

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rake'
+begin
+  require 'bundler/setup'
+  Bundler::GemHelper.install_tasks
+rescue LoadError
+  puts 'although not required, bundler is recommended for running the tests'
+end
+task default: :spec
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new do |task|
+  task.requires << 'rubocop-performance'
+  task.requires << 'rubocop-rspec'
+end

data/html_to.gemspec

@@ -1,16 +1,31 @@
-$:.push File.expand_path("../lib", __FILE__)
+require File.expand_path('lib/html_to/version', __dir__)
 
 Gem::Specification.new do |s|
-  s.name        = 'html_to'
-  s.version     = '0.7.2'
-  s.date        = '2021-04-07'
-  s.summary     = 'Html-To transforms html to other format'
-  s.description = 'Simple gem for transforms html page through chromium headless.'
-  s.author      = 'Chekryzhov Viktor'
-  s.email       = 'chekryzhov@charmerstudio.com'
-  s.homepage    = 'https://github.com/Vchekryzhov/html-to'
-  s.license     = 'MIT'
-  s.files       = `git ls-files`.split("\n")
-  s.add_dependency 'sidekiq'
-  s.add_dependency 'carrierwave'
+  s.name = 'html_to'
+  s.required_ruby_version = '>= 2.7'
+  s.version = HtmlTo::VERSION
+  s.summary = 'Html-To transforms html to image'
+  s.description = 'Simple gem for transforms html page through chromium headless to image.'
+  s.author = 'Chekryzhov Viktor'
+  s.email = 'vchekryzhov@ya.ru'
+  s.homepage = 'https://github.com/Vchekryzhov/html-to'
+  s.license = 'MIT'
+  s.files = Dir['README.md', 'LICENSE',
+                'CHANGELOG.md', 'lib/**/*.rb',
+                'lib/**/*.html.erb',
+                'html_to.gemspec', '.github/*.md',
+                'Gemfile', 'Rakefile']
+  s.extra_rdoc_files = ['README.md']
+
+  s.add_dependency 'activejob', '>= 5'
+  s.add_dependency 'activestorage', '>= 5'
+  s.add_dependency 'english'
+  s.add_dependency 'erb'
+
+  if ENV['TEST_RAILS_VERSION'].nil?
+    s.add_development_dependency 'rails', '~> 7.0.6'
+  else
+    s.add_development_dependency 'rails', ENV['TEST_RAILS_VERSION'].to_s
+  end
+  s.metadata['rubygems_mfa_required'] = 'false'
 end

data/lib/generators/html_to/copy_template_generator.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module HtmlTo
+  module Generators
+    class CopyTemplateGenerator < Rails::Generators::Base
+      source_root File.expand_path('../../views/html_to', __dir__)
+
+      desc 'Copy templates'
+
+      def copy_initializer
+        copy_file 'image.html.erb', 'app/views/html_to/image.html.erb'
+        copy_file 'circle.html.erb', 'app/views/html_to/circle.html.erb'
+      end
+    end
+  end
+end

data/lib/generators/html_to/install_generator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module HtmlTo
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('./templates', __dir__)
+
+      desc 'Copy example of serializer to your app'
+
+      def copy_initializer
+        copy_file 'html_to_serializer.rb', 'app/serializers/html_to_serializer.rb'
+      end
+    end
+  end
+end

data/lib/generators/html_to/templates/html_to_serializer.rb

@@ -0,0 +1,11 @@
+class HtmlToSerializer < HtmlTo::Serializer
+  # you can have access to serialized record via object
+
+  def title
+    'object.title'
+  end
+
+  def background_image
+    'https://images.unsplash.com/photo-1593642702821-c8da6771f0c6?ixid=MXwxMjA3fDF8MHxwaG90by1wYWdlfHx8fGVufDB8fHw%3D&ixlib=rb-1.2.1&auto=format&q=80'
+  end
+end

data/lib/html_to/chromium.rb

@@ -0,0 +1,37 @@
+require 'English'
+module HtmlTo
+  module Chromium
+    def self.execute_path
+      if Configuration.chromium_path.present?
+        raise ArgumentError, "html_to error: not found chromium by path #{Configuration.chromium_path}" unless File.exist? Configuration.chromium_path
+
+        return Configuration.chromium_path
+      end
+
+      path = if /darwin/.match?(RbConfig::CONFIG['host_os'])
+               "/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome"
+             elsif /linux/.match?(RbConfig::CONFIG['host_os'])
+               release = %x(lsb_release -i -s)
+               %x(which chromium-browser)
+               if release == "Debian\n"
+                 which_path = %x(which chromium)
+                 raise StandardError, "html_to error: You don't have chromium, please do apt install chromium" unless $CHILD_STATUS.success?
+
+               else
+                 which_path = %x(which chromium-browser)
+                 raise StandardError, "html_to error: You don't have chromium, please do apt install chromium-browser" unless $CHILD_STATUS.success?
+               end
+               which_path
+             else
+               raise StandardError, "html_to error host os don't detected"
+             end
+      raise StandardError, 'html_to error: chromium executable path not found' if path.blank?
+
+      path.delete("\n")
+    end
+
+    def self.version
+      %x(#{execute_path} --version)
+    end
+  end
+end

data/lib/html_to/configuration.rb

@@ -0,0 +1,11 @@
+module HtmlTo
+  module Configuration
+    class << self
+      attr_accessor :chromium_path
+
+      def config
+        yield self
+      end
+    end
+  end
+end

data/lib/html_to/image_generate.rb

@@ -0,0 +1,86 @@
+require 'fileutils'
+require_relative 'chromium'
+require 'erb'
+
+class HtmlTo::ImageGenerate
+  include HtmlTo::Chromium
+  def call(record, serializer, options)
+    generate_template(record, serializer, options[:template], options[:width], options[:height])
+    take_screenshot(options[:width], options[:height])
+    attach_image(record, options[:image_name])
+  rescue StandardError
+    raise
+  ensure
+    FileUtils.rm_f(html_file_path)
+    FileUtils.rm_f(optimize_screenshot) if optimize_screenshot
+    FileUtils.rm_f(screenshot_file_path)
+  end
+
+  def generate_template(record, serializer, template, width, height)
+    object = serializer.constantize.new(record)
+    html = File.open(template) do |f|
+      ERB.new(f.read).result(binding)
+    end
+    File.write(html_file_path, html)
+  end
+
+  def take_screenshot(width, height)
+    cmd = <<~BASH.chomp
+      #{HtmlTo::Chromium.execute_path} \
+      --headless \
+      --screenshot=#{screenshot_file_path} \
+      --window-size=#{width},#{height} \
+      --disable-gpu \
+      --disable-features=NetworkService #{html_file_path}
+    BASH
+
+    %x(#{cmd})
+    raise StandardError, "html_to error result = #{$CHILD_STATUS}; command = #{cmd}" unless chromium_run_success?
+  end
+
+  def attach_image(record, image_name)
+    record.html_to_skip_meta_image_generate = true
+    record.send(image_name).purge
+    record.send(image_name).attach(io: optimize_screenshot, filename: optimize_screenshot, content_type: 'image/png')
+    return unless optimize_screenshot
+
+    optimize_screenshot.close
+  end
+
+  def html_file_path
+    @html_file_path ||= Rails.root.join('tmp').join("#{SecureRandom.urlsafe_base64.downcase}.html")
+  end
+
+  def screenshot_file_path
+    @screenshot_file_path ||= Rails.root.join('tmp').join("#{SecureRandom.urlsafe_base64.downcase}.png")
+  end
+
+  def optimize_screenshot
+    return nil unless File.exist?(screenshot_file_path)
+
+    @optimize_screenshot ||= if image_processing_installed?
+                               ImageProcessing::MiniMagick
+                                 .source(screenshot_file_path)
+                                 .convert('jpg')
+                                 .saver(quality: 85)
+                                 .call
+                             else
+                               File.open(screenshot_file_path)
+                             end
+  end
+
+  private
+
+  def chromium_run_success?
+    $CHILD_STATUS.success?
+  end
+
+  def image_processing_installed?
+    Gem::Specification.find_by_name('image_processing')
+  rescue Gem::LoadError
+    puts '[html-to] image will not processing because gem image_processing is not installed'
+    false
+  else
+    true
+  end
+end

data/lib/html_to/meta_image_generate_job.rb

@@ -0,0 +1,13 @@
+module HtmlTo
+  class MetaImageGenerateJob < ::ActiveJob::Base
+    queue_as :default
+    def perform(id, class_name, serializer, options)
+      record = class_name.constantize.find(id)
+      generator.call(record, serializer, options)
+    end
+
+    def generator
+      HtmlTo::ImageGenerate.new
+    end
+  end
+end

data/lib/html_to/serializer.rb

@@ -0,0 +1,7 @@
+class HtmlTo::Serializer
+  attr_reader :object
+
+  def initialize(object)
+    @object = object
+  end
+end

data/lib/html_to/version.rb

@@ -0,0 +1,4 @@
+module HtmlTo
+  VERSION = '1.1.1'.freeze
+  public_constant :VERSION
+end

data/lib/html_to.rb

@@ -1,22 +1,143 @@
 module HtmlTo
-  extend ActiveSupport::Concern
-  require 'carrierwave'
-  require 'html_to/html_headless.rb'
-  require 'html_to/sharing_image_generate.rb'
-  require 'html_to/share_uploader.rb'
-  included do
-    after_commit :share_image_generate, unless: :skip_share_image_generate
-    attr_accessor :skip_share_image_generate
-
-
-    raise 'Message from html_to: @@share_uploader not present' if class_variable_get(:@@share_uploader).nil?
-    raise 'Message from html_to: @@share_template not present' if class_variable_get(:@@share_template).nil?
-    raise "Message from html_to: share template file #{Rails.root.join('app/views').join(class_variable_get(:@@share_template)+'.html.erb')} not exist" if !File.exist?(Rails.root.join('app/views').join(class_variable_get(:@@share_template)+".html.erb"))
-    mount_uploader class_variable_get(:@@share_uploader), -> { class_variable_get(:@@override_uploader) rescue HtmlTo::ShareUploader }.call
+  require_relative 'html_to/image_generate'
+  require_relative 'html_to/meta_image_generate_job'
+  require_relative 'html_to/configuration'
+  require_relative 'html_to/chromium'
+  require_relative 'html_to/serializer'
+  class HtmlToImageSettings
+    OPTIONS = %i[
+      template width height image_name
+    ].freeze
+    DEFAULT_OPTIONS = {
+      template: :circle,
+      width: 1200,
+      height: 630,
+      image_name: :meta_image
+    }.freeze
+    attr_reader(*OPTIONS, :serializer)
+
+    def initialize(klass, serializer, options, &block)
+      @klass = klass
+      @options = options
+      validate_options
+      @serializer = serializer.to_s
+      setup_options
+      instance_exec(&block) if block_given?
+    end
+
+    def validate_options
+      @options.each_key { |opt| raise ArgumentError, "html_to error #{opt} is unknown option" unless OPTIONS.include? opt }
+    end
+
+    def setup_options
+      OPTIONS.each do |k|
+        instance_variable_set("@#{k}", @options[k] || DEFAULT_OPTIONS[k])
+      end
+      find_template_path!
+    end
+
+    def additional_images
+      @additional_images || {}
+    end
+
+    def add_image(image_name, serializer, options = {})
+      @additional_images ||= {}
+      options[:image_name] = image_name
+      @klass.class_eval do
+        has_one_attached image_name
+      end
+      @additional_images[image_name] = HtmlToImageSettings.new(@klass, serializer, options)
+    end
+
+    def find_template_path!
+      user_template = Rails.root.join('app/views/html_to').join("#{template}.html.erb")
+      return user_template.to_s if File.file? user_template
+
+      gem_template = File.expand_path("views/html_to/#{template}.html.erb", __dir__)
+
+      return gem_template.to_s if File.file? gem_template
+
+      raise ArgumentError, "html_to error Template file not found #{user_template} #{gem_template} "
+    end
   end
+  class << self
+    attr_reader :included_in
 
-  def share_image_generate
-    SharingImageGenerate.perform_async(id, self.class.to_s)
+    def included(klass)
+      @included_in ||= []
+      @included_in << klass
+      @included_in.uniq!
+
+      klass.class_eval do
+        extend ClassMethods
+        include InstanceMethods
+      end
+    end
   end
 
+  module ClassMethods
+    def self.extended(base)
+      class << base
+        alias_method :create_meta_images!, :html_to_create_meta_images! unless method_defined? :create_meta_images!
+      end
+      base.cattr_accessor :html_to_image_settings
+    end
+
+    def html_to_create_meta_images!
+      all.each(&:html_to_create_meta_image!)
+    end
+
+    def html_to(serializer, options = {}, &block)
+      after_validation :html_to_mark_synchronous if options.delete(:synchronous) == true && respond_to?(:after_validation)
+      after_validation :html_to_mark_skip_meta_image_generate if options.delete(:skip_auto_update) == true && respond_to?(:after_validation)
+
+      self.html_to_image_settings = HtmlToImageSettings.new(self, serializer, options, &block)
+      class_eval do
+        has_one_attached options[:image_name] || html_to_image_settings.image_name
+      end
+    end
+  end
+
+  module InstanceMethods
+    def self.included(base)
+      base.attr_accessor :html_to_skip_meta_image_generate
+      base.instance_eval do
+        alias_method :create_meta_image!, :html_to_create_meta_image! unless method_defined? :create_meta_images!
+      end
+      base.after_commit :html_to_create_meta_image!, unless: :html_to_skip_meta_image_generate
+    end
+
+    def html_to_create_meta_image!
+      share_images_settings = [self.class.html_to_image_settings, *self.class.html_to_image_settings.additional_images.values].flatten
+      share_images_settings.each do |image_settings|
+        generator_args = [
+          id, self.class.name, image_settings.serializer, {
+            image_name: image_settings.image_name,
+            width: image_settings.width,
+            height: image_settings.height,
+            template: image_settings.find_template_path!
+          }
+        ]
+        if html_to_synchronous?
+          MetaImageGenerateJob.perform_now(*generator_args)
+        else
+          MetaImageGenerateJob.perform_later(*generator_args)
+        end
+      end
+    end
+
+    private
+
+    def html_to_mark_synchronous
+      @html_to_synchronous = true
+    end
+
+    def html_to_mark_skip_meta_image_generate
+      @html_to_skip_meta_image_generate = true
+    end
+
+    def html_to_synchronous?
+      @html_to_synchronous
+    end
+  end
 end

data/lib/views/html_to/circle.html.erb

@@ -0,0 +1,46 @@
+
+<html>
+<body>
+<div class="container">
+  <div>
+    <svg viewBox="0 0 100 100">
+      <defs>
+        <path id="circle"
+              d="
+                M 50, 50
+                m -37, 0
+                a 37,37 0 1,1 74,0
+                a 37,37 0 1,1 -74,0"/>
+      </defs>
+      <text font-size="18">
+        <textPath xlink:href="#circle">
+          <%= object.title %>
+        </textPath>
+      </text>
+    </svg>
+  </div>
+</div>
+</body>
+<style>
+    svg {
+        fill: currentColor;
+        height: auto;
+        max-width: 66vmin;
+        transform-origin: center;
+        width: 100%;
+    }
+    .container {
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        width: 1200px;
+        height: 630px;
+    }
+    body {
+        margin: 0;
+    }
+
+
+</style>
+</html>
+

data/lib/views/html_to/image.html.erb

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<head>
+  <meta charset="UTF-8">
+  <title>Title</title>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Martian Mono">
+  <style>
+
+      body {
+          margin: 0;
+          font-family: "Martian Mono", sans-serif;
+      }
+      .image {
+          width: <%=width%>px;
+          height: <%=height%>px;
+          position: absolute;
+          float: left;
+          object-fit: cover;
+      }
+      .description{
+          position: absolute;
+          color: white;
+          z-index: 1;
+          font-size: 72px;
+          margin-top: 10%;
+          margin-left: 5%;
+      }
+      .root{
+          background-color: black;
+          width: <%=width%>px;
+          height: <%=height%>px;
+      }
+      .image {
+          opacity: 0.5;
+      }
+
+  </style>
+</head>
+  <body>
+    <div class="root">
+      <img class='image' src="<%=object.background_image %>" alt="img">
+      <p class="description">
+        <%=object.title%>
+      </p>
+    </div>
+  </body>
+</html>

metadata

@@ -1,17 +1,45 @@
 --- !ruby/object:Gem::Specification
 name: html_to
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 1.1.1
 platform: ruby
 authors:
 - Chekryzhov Viktor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-07 00:00:00.000000000 Z
+date: 2023-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: sidekiq
+  name: activejob
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: activestorage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: english
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -25,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: carrierwave
+  name: erb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -38,26 +66,53 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Simple gem for transforms html page through chromium headless.
-email: chekryzhov@charmerstudio.com
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 7.0.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 7.0.6
+description: Simple gem for transforms html page through chromium headless to image.
+email: vchekryzhov@ya.ru
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
-- ".gitignore"
+- ".github/CODE_OF_CONDUCT.md"
+- ".github/CONTRIBUTING.md"
+- ".github/pull_request_template.md"
+- CHANGELOG.md
+- Gemfile
 - LICENSE
 - README.md
-- gemfile
+- Rakefile
 - html_to.gemspec
+- lib/generators/html_to/copy_template_generator.rb
+- lib/generators/html_to/install_generator.rb
+- lib/generators/html_to/templates/html_to_serializer.rb
 - lib/html_to.rb
-- lib/html_to/chromium_controll.rb
-- lib/html_to/html_headless.rb
-- lib/html_to/share_uploader.rb
-- lib/html_to/sharing_image_generate.rb
+- lib/html_to/chromium.rb
+- lib/html_to/configuration.rb
+- lib/html_to/image_generate.rb
+- lib/html_to/meta_image_generate_job.rb
+- lib/html_to/serializer.rb
+- lib/html_to/version.rb
+- lib/views/html_to/circle.html.erb
+- lib/views/html_to/image.html.erb
 homepage: https://github.com/Vchekryzhov/html-to
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'false'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -66,15 +121,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
-summary: Html-To transforms html to other format
+summary: Html-To transforms html to image
 test_files: []

data/.gitignore

@@ -1,49 +0,0 @@
-*.rbc
-capybara-*.html
-.rspec
-/log
-/tmp
-/db/*.sqlite3
-/db/*.sqlite3-journal
-/public/system
-/coverage/
-/spec/tmp
-*.orig
-rerun.txt
-pickle-email-*.html
-
-# TODO Comment out this rule if you are OK with secrets being uploaded to the repo
-config/initializers/secret_token.rb
-config/master.key
-
-# Only include if you have production secrets in this file, which is no longer a Rails default
-# config/secrets.yml
-
-# dotenv
-# TODO Comment out this rule if environment variables can be committed
-.env
-
-## Environment normalization:
-/.bundle
-/vendor/bundle
-
-# these should all be checked in to normalize the environment:
-# Gemfile.lock, .ruby-version, .ruby-gemset
-
-# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
-.rvmrc
-
-# if using bower-rails ignore default bower_components path bower.json files
-/vendor/assets/bower_components
-*.bowerrc
-bower.json
-
-# Ignore pow environment settings
-.powenv
-
-# Ignore Byebug command history file.
-.byebug_history
-
-# Ignore node_modules
-node_modules/
-

data/gemfile

@@ -1,3 +0,0 @@
-# Gemfile
-source 'https://rubygems.org'
-ruby '2.3.3'

data/lib/html_to/chromium_controll.rb

@@ -1,20 +0,0 @@
-module HtmlTo::ChromiumControll
-  def chrome
-    if RbConfig::CONFIG['host_os'] =~ /darwin/
-      "/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome"
-    elsif RbConfig::CONFIG['host_os'] =~ /linux/
-      release = IO.popen("lsb_release -i -s").read
-      if release == "Debian\n"
-        `dpkg -s chromium`
-        raise "html_to message: You don't have chromium, please do apt install chromium"if !$?.success?
-        'chromium'
-      else
-        `dpkg -s chromium-browser`
-        raise "html_to message: You don't have chromium, please do apt install chromium"if !$?.success?
-        'chromium-browser'
-      end
-    else
-      raise StandardError.new "host os don't detected"
-    end
-  end
-end

data/lib/html_to/html_headless.rb

@@ -1,41 +0,0 @@
-class HtmlTo::HtmlHeadless
-  require 'fileutils'
-  require 'html_to/chromium_controll.rb'
-  include HtmlTo::ChromiumControll
-
-  def to_image(obj, width=1200, height=630)
-
-    width = obj.class.class_variable_get(:@@html_to_width) if obj.class.class_variable_defined?(:@@html_to_width)
-    height = obj.class.class_variable_get(:@@html_to_height) if obj.class.class_variable_defined?(:@@html_to_height)
-
-    @template = File.read(Rails.root.join('app/views').join(obj.class.class_variable_get(:@@share_template)+".html.erb"))
-    html = ERB.new(@template.html_safe).result(binding)
-    File.open(html_file_path, 'w+') {|f| f.write(html) }
-    begin
-      cmd = "'#{chrome}'
-        --headless
-        --screenshot=#{screenshot_file_path}
-        --window-size=#{width},#{height}
-        --disable-gpu
-        --disable-features=NetworkService #{html_file_path}".gsub("\n",' ')
-      `#{cmd}`
-      if $?.success?
-        obj.skip_share_image_generate = true
-        obj.send("#{obj.class.class_variable_get(:@@share_uploader)}=", File.open(screenshot_file_path))
-        obj.save
-      else
-        raise "result = #{$?}; command = #{cmd}"
-      end
-    ensure
-       FileUtils.rm(html_file_path)
-       FileUtils.rm(screenshot_file_path)
-    end
-  end
-
-  def html_file_path
-    @path ||= Rails.public_path.join(SecureRandom.urlsafe_base64.downcase + ".html")
-  end
-  def screenshot_file_path
-    @screenshot_file_path ||= Rails.public_path.join(SecureRandom.urlsafe_base64.downcase + ".png")
-  end
-end

data/lib/html_to/share_uploader.rb

@@ -1,14 +0,0 @@
-class HtmlTo::ShareUploader < CarrierWave::Uploader::Base
-  include CarrierWave::MiniMagick
-
-  # raise 'Message from html_to: Rails.application.config.asset_host not present' if Rails.application.config.asset_host.nil?
-
-  def store_dir
-    "storage/#{model.class.base_class.name.underscore}/#{model.id}/share"
-  end
-
-  def url
-    "#{Rails.application.config.asset_host}#{super}"
-  end
-  process resize_to_limit: [1200, 630]
-end

data/lib/html_to/sharing_image_generate.rb

@@ -1,11 +0,0 @@
-class HtmlTo::SharingImageGenerate
-  require 'erb'
-  require 'sidekiq'
-  include Sidekiq::Worker
-  sidekiq_options queue: 'default'
-  
-  def perform(id, class_name)
-    @obj = class_name.constantize.find(id)
-    HtmlTo::HtmlHeadless.new.to_image(@obj)
-  end
-end