squoosh 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6ad9840011bc3d7f13d58596a2b77d545745710bca32def00d78ddc9cc9f1989
+  data.tar.gz: c1a1a225d47047f35c5fbf69a05e4543a2f9368eb2c18a97390175c263b2a8d7
+SHA512:
+  metadata.gz: 9e9bcac78e2efebc699be79cd3eb17cc359d4a228677d0fa8bb552e410fcfcffdaadfe5e5585ba23bb87fbad677adeb4039673c9623c1ba401e0513b367abab7
+  data.tar.gz: '098de2bd1800df542f1f1e998aaf0e1fa5247fbec0214f7b4fbbd39677b697e1adfa15d1a5a8a5f01cf516da17d2deb29fce2a79c8355878278a014dc07a3244'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016, 2018 Stephen Checkoway
+
+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/README.md

@@ -0,0 +1,99 @@
+# Squoosh
+
+Minifies HTML, JavaScript, and CSS, including inline JavaScript and CSS.
+
+CSS minification is handled by [Sass](http://www.rubydoc.info/gems/sass)
+whereas JavaScript minification is handled by
+[Uglifier](http://www.rubydoc.info/gems/uglifier) which requires node.js.
+
+HTML minification is handled as follows. First, an HTML 5 (which really means
+the [WHATWG HTML](https://html.spec.whatwg.org/multipage/) living standard)
+parser constructs a DOM as specified by the standard. Next, semantically
+meaningless [inter-element whitespace
+nodes](https://html.spec.whatwg.org/multipage/dom.html#inter-element-whitespace)
+are removed from the DOM and semantically meaningfull runs of whitespace are
+compressed to single spaces, except in `pre`, `textarea`, and
+[foreign](https://html.spec.whatwg.org/multipage/syntax.html#elements-2) elements.
+Then, inline JavaScript and CSS are compressed using Sass and Uglifier.
+Finally, the DOM is serialized, compressing
+[attributes](https://html.spec.whatwg.org/multipage/syntax.html#attributes-2)
+where possible and omitting [optional start and end
+tags](https://html.spec.whatwg.org/multipage/syntax.html#optional-tags) where
+possible.
+
+Unlike some other HTML minifiers, Squoosh uses neither Java nor [regular
+expressions](http://stackoverflow.com/a/1732454) to parse HTML.
+
+## Limitations
+Squoosh will not minify
+
+- HTML 4 and earlier;
+- XHTML, any version;
+- [MathML](https://www.w3.org/TR/MathML3/) elements; nor
+- [SVG](https://www.w3.org/TR/SVG11/) elements.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'squoosh'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install squoosh
+
+## Usage
+
+The three basic minification functions are
+
+- `Squoosh::minify_html`
+- `Squoosh::minify_js`
+- `Squoosh::minify_css`
+
+The `Squoosher` class caches (in memory) minified JavaScript and CSS which can
+significantly speed up minifying HTML with repeated scripts and style sheets.
+
+### Using with Jekyll
+
+Create a `_plugins/squoosh.rb` file with the contents
+
+```ruby
+require 'squoosh'
+
+Jekyll::Hooks.register [:documents, :pages], :post_render, priority: :high do |doc|
+  case File.extname(doc.destination('./'))
+  when '.html', '.htm'
+    doc.output = Squoosh::minify_html doc.output
+  when '.js'
+    doc.output = Squoosh::minify_js doc.output
+  end
+end
+```
+
+CSS minification could be handled similarly, or `foo.css` files could simply
+be renamed to `foo.scss` and 
+
+```yaml
+sass:
+  style: compressed
+```
+
+added to `_config.yml`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/stevecheckoway/squoosh.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT
+License](http://opensource.org/licenses/MIT).
+

data/lib/squoosh.rb

@@ -0,0 +1,608 @@
+# frozen_string_literal: true
+
+require 'squoosh/version'
+require 'nokogumbo'
+require 'sass'
+require 'set'
+require 'uglifier'
+
+# @author Stephen Checkoway <s@pahtak.org>
+# Minify HTML, JavaScript, and CSS.
+#
+# *Examples*
+#
+#    html = <<-EOF
+#    <!DOCTYPE html>
+#    <html>
+#      <head>
+#        <!-- Set the title -->
+#        <title>My fancy title!</title>
+#      </head>
+#      <body>
+#        <p>Two</p>
+#        <p>paragraphs.</p>
+#      </body>
+#    </html>
+#    EOF
+#    compressed = Squoosh.minify_html(html)
+#    # "<!DOCTYPE html><title>My fancy title!</title><p>Two<p>paragraphs."
+#
+module Squoosh
+  # Minify HTML, JavaScript, and CSS using a single set of options. Minified
+  # versions of the JavaScript and CSS encountered are cached to speed up
+  # minification when the same scripts or inline style sheets appear multiple
+  # times.
+  class Squoosher
+    # Default options for minifying.
+    #
+    # * ++remove_comments++ Remove all comments that aren't "loud"
+    # * ++omit_tags++ Omit unnecessary start and end tags
+    # * ++loud_comments++ Keep all comments matching this regex
+    # * ++minify_javascript++ Minify JavaScript <tt><script></tt> and inline
+    #   JavaScript
+    # * ++minify_css++ Minify CSS <tt><style></tt> and inline CSS
+    # * ++uglifier_options++ Options to pass to
+    #   {https://www.rubydoc.info/gems/uglifier Uglifier}
+    # * ++sass_options++ Options to pass to
+    #   {http://sass-lang.com/documentation/file.SASS_REFERENCE.html#options
+    #   Sass}
+    DEFAULT_OPTIONS = {
+      remove_comments: true,
+      omit_tags: true,
+      compress_spaces: true,
+      loud_comments: /\A\s*!/,
+      minify_javascript: true,
+      minify_css: true,
+      uglifier_options: {
+        output: {
+          ascii_only: false,
+          comments: /\A!/
+        }
+      },
+      sass_options: {
+        style: :compressed
+      }
+    }.freeze
+
+    # Create a new instance of ++Squoosher++.
+    #
+    # @param options [Hash] options to override the default options
+    def initialize(options = {})
+      options.each do |key, _val|
+        unless DEFAULT_OPTIONS.include?(key)
+          raise ArgumentError, "Invalid option `#{key}'"
+        end
+      end
+      @options = DEFAULT_OPTIONS.merge(options)
+      @js_cache = {}
+      @css_cache = {}
+    end
+
+    # Minify HTML and inline JavaScript and CSS.
+    #
+    # If the ++content++ does not start with an HTML document type
+    # <tt><!DOCTYPE html></tt>, then ++content++ is returned unchanged.
+    #
+    # @param content [String] the HTML to minify
+    # @return [String] the minified HTML
+    def minify_html(content)
+      doc = Nokogiri.HTML5(content)
+      return content unless doc&.internal_subset&.html5_dtd?
+
+      remove_comments(doc) if @options[:remove_comments]
+      compress_javascript(doc) if @options[:minify_javascript]
+      compress_css(doc) if @options[:minify_css]
+      doc.children.each { |c| compress_spaces(c) } if @options[:compress_spaces]
+      doc.children.map { |node| stringify_node(node) }.join
+    end
+
+    # Minify CSS using Sass.
+    #
+    # @param content [String] the CSS to minify
+    # @return [String] the minified CSS
+    def minify_css(content)
+      @css_cache[content] ||= begin
+        root = Sass::SCSS::CssParser.new(content, nil, nil).parse
+        root.options = @options[:sass_options]
+        root.render.rstrip
+      end
+    end
+
+    # Minify JavaScript using Uglify.
+    #
+    # @param content [String] the JavaScript to minify
+    # @return [String] the minified JavaScript
+    def minify_js(content)
+      @js_cache[content] ||= \
+        Uglifier.compile(content, @options[:uglifier_options])
+    end
+
+    # Element kinds
+    VOID_ELEMENTS = Set.new(%w[area base br col embed hr img input
+                               keygen link meta param source track wbr]).freeze
+    RAW_TEXT_ELEMENTS = Set.new(%w[script style]).freeze
+    ESCAPABLE_RAW_TEXT_ELEMENTS = Set.new(%w[textarea title]).freeze
+    FOREIGN_ELEMENTS = Set.new(%w[math svg]).freeze
+    private_constant :VOID_ELEMENTS, :RAW_TEXT_ELEMENTS
+    private_constant :ESCAPABLE_RAW_TEXT_ELEMENTS, :FOREIGN_ELEMENTS
+
+    private
+
+    def void_element?(node)
+      VOID_ELEMENTS.include? node.name
+    end
+
+    def raw_text_element?(node)
+      RAW_TEXT_ELEMENTS.include? node.name
+    end
+
+    def escapable_raw_text_element?(node)
+      ESCAPABLE_RAW_TEXT_ELEMENTS.include? node.name
+    end
+
+    def foreign_element?(node)
+      FOREIGN_ELEMENTS.include? node.name
+    end
+
+    def normal_element?(node)
+      !void_element?(node) &&
+        !raw_text_element?(node) &&
+        !escapable_raw_text_element?(node) &&
+        !foreign_element?(node)
+    end
+
+    HTML_WHITESPACE = "\t\n\f\r "
+    private_constant :HTML_WHITESPACE
+
+    def inter_element_whitespace?(node)
+      return false unless node.text?
+
+      node.content.each_char.all? { |c| HTML_WHITESPACE.include? c }
+    end
+
+    PHRASING_CONTENT = Set.new(%w[a abbr area audio b bdi bdo br button canvas
+                                  cite code data datalist del dfn em embed i
+                                  iframe img input ins kbd keygen label link
+                                  map mark math meta meter noscript object
+                                  output picture progress q ruby s samp script
+                                  select slot small span strong sub sup svg
+                                  template textarea time u var video
+                                  wbr]).freeze
+    private_constant :PHRASING_CONTENT
+
+    def phrasing_content?(node)
+      name = node.name
+      PHRASING_CONTENT.include?(name)
+    end
+
+    def remove_comments(doc)
+      doc.xpath('//comment()').each do |node|
+        next if preserve_comment?(node)
+
+        prev_node = node.previous_sibling
+        next_node = node.next_sibling
+        node.unlink
+        if prev_node&.text? && next_node&.text?
+          prev_node.content += next_node.content
+          next_node.unlink
+        end
+      end
+      nil
+    end
+
+    def preserve_comment?(node)
+      content = node.content
+      return true if content.start_with? '[if '
+      return true if /\A\s*!/ =~ content
+
+      # Support other retained comments?
+      false
+    end
+
+    EVENT_HANDLERS_XPATH = (
+      # Select all attribute nodes whose names start with "on";
+      '//@*[starts-with(name(),"on")]' +
+      # and are not descendants of foreign elements
+      '[not(ancestor::math or ancestor::svg)]' +
+      # and
+      '[' +
+        # whose names are any of
+        %w[abort cancel canplay canplaythrough change click close contextmenu
+           cuechange dblclick drag dragend dragenter dragexit dragleave
+           dragover dragstart drop durationchange emptied ended input invalid
+           keydown keypress keyup loadeddata loadedmetadata loadend loadstart
+           mousedown mouseenter mouseleave mousemove mouseout mouseover
+           mouseup wheel pause play playing progress ratechange reset seeked
+           seeking select show stalled submit suspend timeupdate toggle
+           volumechange waiting cut copy paste blur error focus load resize
+           scroll].map { |n| "name()=\"on#{n}\"" }.join(' or ') +
+        # or whose parent is body or frameset
+        ' or (parent::body or parent::frameset)' +
+          # and
+          ' and (' +
+            # whose names are any of
+            %w[afterprint beforeprint beforeunload hashchange languagechange
+               message offline online pagehide pageshow popstate
+               rejectionhandled storage unhandledrejection
+               unload].map { |n| "name()=\"on#{n}\"" }.join(' or ') +
+          ')' \
+      ']'
+    ).freeze
+    private_constant :EVENT_HANDLERS_XPATH
+
+    def compress_javascript(doc)
+      # Compress script elements.
+      doc.xpath('//script[not(ancestor::math or ancestor::svg)]').each do |node|
+        type = node['type']&.downcase
+        next unless type.nil? || type == 'text/javascript'
+
+        node.content = minify_js node.content
+      end
+      # Compress event handlers.
+      doc.xpath(EVENT_HANDLERS_XPATH).each do |attr|
+        attr.content = minify_js(attr.content)
+      end
+    end
+
+    def compress_css(doc)
+      # Compress style elements.
+      doc.xpath('//style[not(ancestor::math or ancestor::svg)]').each do |node|
+        type = node['type']&.downcase
+        next unless type.nil? || type == 'text/css'
+
+        node.content = minify_css node.content
+      end
+      # Compress style attributes
+      doc.xpath('//@style[not(ancestor::math or ancestor::svg)]').each do |node|
+        elm_type = node.parent.name
+        css = "#{elm_type}{#{node.content}}"
+        node.content = minify_css(css)[elm_type.length + 1..-2]
+      end
+      nil
+    end
+
+    def compress_spaces(node)
+      if node.text?
+        if text_node_removable? node
+          node.unlink
+        else
+          content = node.content
+          content.gsub!(/[ \t\n\r\f]+/, ' ')
+          content.lstrip! if trim_left? node
+          content.rstrip! if trim_right? node
+          node.content = content
+        end
+      elsif node.element? &&
+            (node.name == 'pre' || node.name == 'textarea')
+        # Remove leading newline in pre and textarea tags unless there are two
+        # in a row.
+        if node.children[0]&.text?
+          content = node.children[0].content
+          if content.sub!(/\A\r\n?([^\r]|\z)/, '\1') ||
+             content.sub!(/\A\n([^\n]|\z)/, '\1')
+            node.children[0].content = content
+          end
+        end
+      elsif normal_element?(node) || node.name == 'title'
+        # Compress spaces in normal elements and title.
+        node.children.each { |c| compress_spaces c }
+      end
+      nil
+    end
+
+    # Be conservative. If an element can be phrasing content, assume it is.
+    def text_node_removable?(node)
+      return false unless inter_element_whitespace?(node)
+      return false if phrasing_content?(node.parent)
+
+      prev_elm = node.previous_element
+      next_elm = node.next_element
+      prev_elm.nil? || !phrasing_content?(prev_elm) ||
+        next_elm.nil? || !phrasing_content?(next_elm)
+    end
+
+    def trim_left?(node)
+      prev_elm = node.previous_element
+      return !phrasing_content?(node.parent) if prev_elm.nil?
+
+      prev_elm.name == 'br'
+    end
+
+    def trim_right?(node)
+      next_elm = node.next_element
+      return !phrasing_content?(node.parent) if next_elm.nil?
+
+      next_elm.name == 'br'
+    end
+
+    def stringify_node(node)
+      return node.to_html(encoding: 'UTF-8') unless node.element?
+
+      output = StringIO.new
+      # Add start tag. 8.1.2.1
+      unless omit_start_tag? node
+        output << "<#{node.name}"
+
+        # Add attributes. 8.1.2.3
+        last_attr_unquoted = false
+        node.attributes.each do |name, attr|
+          last_attr_unquoted = false
+          # Make sure there are no character references.
+          # XXX: We should be able to compress a bit more by leaving bare & in
+          # some cases.
+          # value = (attr.value || '')
+          # value.gsub!(/&([a-zA-Z0-9]+;|#[0-9]+|#[xX][a-fA-F0-9]+)/, '&amp;\1')
+          value = (attr.value || '').gsub('&', '&amp;')
+          if value.empty?
+            output << ' ' + name
+          elsif /[\t\n\f\r "'`=<>]/ !~ value
+            last_attr_unquoted = true
+            output << " #{name}=#{value}"
+          elsif !value.include?('"')
+            output << " #{name}=\"#{value}\""
+          elsif !value.include?("'")
+            output << " #{name}='#{value}'"
+          else
+            # Contains both ' and ".
+            output << " #{name}=\"#{value.gsub('"', '&#34;')}\""
+          end
+        end
+
+        # Close start tag.
+        if node_is_self_closing? node
+          output << ' ' if last_attr_unquoted
+          output << '/'
+        end
+        output << '>'
+      end
+
+      # Add content.
+      output << node.children.map { |c| stringify_node c }.join
+
+      # Add end tag. 8.1.2.2
+      output << "</#{node.name}>" unless omit_end_tag? node
+      output.string
+    end
+
+    def node_is_self_closing?(node)
+      foreign_element?(node) && node.children.empty?
+    end
+
+    def omit_start_tag?(node)
+      return false unless @options[:omit_tags]
+      return false unless node.attributes.empty?
+
+      case node.name
+      when 'html'
+        # An html element's start tag may be omitted if the first thing inside
+        # the html element is not a comment.
+        return node.children.empty? || !node.children[0].comment?
+
+      when 'head'
+        # A head element's start tag may be omitted if the element is empty,
+        # or if the first thing inside the head element is an element.
+        return node.children.empty? || node.children[0].element?
+
+      when 'body'
+        # A body element's start tag may be omitted if the element is empty,
+        # or if the first thing inside the body element is not a space
+        # character or a comment, except if the first thing inside the body
+        # element is a meta, link, script, style, or template element.
+        return true if node.children.empty?
+
+        c = node.children[0]
+        return !c.content.start_with?(' ') if c.text?
+        return false if c.comment?
+
+        return !c.element? ||
+               !%w[meta link script style template].include?(c.name)
+
+      when 'colgroup'
+        # A colgroup element's start tag may be omitted if the first thing
+        # inside the colgroup element is a col element, and if the element is
+        # not immediately preceded by another colgroup element whose end tag
+        # has been omitted. (It can't be omitted if the element is empty.)
+        return false if node.children.empty?
+        return false unless node.children[0].name == 'col'
+
+        prev_elm = node.previous_element
+        return prev_elm.nil? ||
+               prev_elm.name != 'col' ||
+               !omit_end_tag?(prev_elm)
+
+      when 'tbody'
+        # A tbody element's start tag may be omitted if the first thing inside
+        # the tbody element is a tr element, and if the element is not
+        # immediately preceded by a tbody, thead, or tfoot element whose end
+        # tag has been omitted. (It can't be omitted if the element is empty.)
+        return false if node.children.empty?
+        return false unless node.children[0].name == 'tr'
+
+        prev_elm = node.previous_element
+        return prev_elm.nil? ||
+               !%w[tbody thead tfoot].include?(prev_elm.name) ||
+               !omit_end_tag?(prev_elm)
+      end
+      false
+    end
+
+    def parent_contains_more_content?(node)
+      while (node = node.next_sibling)
+        next if node.comment?
+        next if node.processing_instruction?
+        next if inter_element_whitespace? node
+
+        return true
+      end
+      false
+    end
+
+    def omit_end_tag?(node)
+      return true if void_element? node
+      return false unless @options[:omit_tags]
+      return false if node.parent.name == 'noscript'
+
+      next_node = node.next_sibling
+      next_elm = node.next_element
+      case node.name
+      when 'html'
+        # An html element's end tag may be omitted if the html element is not
+        # immediately followed by a comment.
+        return next_node.nil? || !next_node.comment?
+
+      when 'head'
+        # A head element's end tag may be omitted if the head element is not
+        # immediately followed by a space character or a comment.
+        return next_node.nil? ||
+               (next_node.text? && !next_node.content.start_with?(' ')) ||
+               !next_node.comment?
+
+      when 'body'
+        # A body element's end tag may be omitted if the body element is not
+        # immediately followed by a comment.
+        return next_node.nil? || !next_node.comment?
+
+      when 'li'
+        # An li element's end tag may be omitted if the li element is
+        # immediately followed by another li element or if there is no more
+        # content in the parent element.
+        return next_elm&.name == 'li' || !parent_contains_more_content?(node)
+
+      when 'dt'
+        # A dt element's end tag may be omitted if the dt element is immediately
+        # followed by another dt element or a dd element.
+        return %w[dt dd].include? next_elm&.name
+
+      when 'dd'
+        # A dd element's end tag may be omitted if the dd element is immediately
+        # followed by another dd element or a dt element, or if there is no more
+        # content in the parent element.
+        return %w[dt dd].include?(next_elm&.name) ||
+               !parent_contains_more_content?(node)
+
+      when 'p'
+        # A p element's end tag may be omitted if the p element is immediately
+        # followed by an address, article, aside, blockquote, div, dl,
+        # fieldset, footer, form, h1, h2, h3, h4, h5, h6, header, hgroup, hr,
+        # main, nav, ol, p, pre, section, table, or ul, element, or if there
+        # is no more content in the parent element and the parent element is
+        # not an a element.
+        return true if %w[address article aside blockquote div dl
+                          fieldset footer form h1 h2 h3 h4
+                          h5 h6 header hgroup hr main nav ol
+                          p pre section table ul].include? next_elm&.name
+
+        return node.parent.name != 'a' && !parent_contains_more_content?(node)
+
+      when 'rb', 'rt', 'rp'
+        # An rb element's end tag may be omitted if the rb element is
+        # immediately followed by an rb, rt, rtc or rp element, or if there is
+        # no more content in the parent element.
+        #
+        # An rt element's end tag may be omitted if the rt element is
+        # immediately followed by an rb, rt, rtc, or rp element, or if there
+        # is no more content in the parent element.
+        #
+        # An rp element's end tag may be omitted if the rp element is
+        # immediately followed by an rb, rt, rtc or rp element, or if there is
+        # no more content in the parent element.
+        return %w[rb rt rtc rp].include?(next_elm&.name) ||
+               !parent_contains_more_content?(node)
+      when 'rtc'
+        # An rtc element's end tag may be omitted if the rtc element is
+        # immediately followed by an rb, rtc or rp element, or if there is no
+        # more content in the parent element.
+        return %w[rb rtc rp].include?(next_elm&.name) ||
+               !parent_contains_more_content?(node)
+
+      when 'optgroup'
+        # An optgroup element's end tag may be omitted if the optgroup element
+        # is immediately followed by another optgroup element, or if there is
+        # no more content in the parent element.
+        return next_elm&.name == 'optgroup' ||
+               !parent_contains_more_content?(node)
+
+      when 'option'
+        # An option element's end tag may be omitted if the option element is
+        # immediately followed by another option element, or if it is
+        # immediately followed by an optgroup element, or if there is no more
+        # content in the parent element.
+        return %w[option optgroup].include?(next_elm&.name) ||
+               !parent_contains_more_content?(node)
+
+      when 'colgroup'
+        # A colgroup element's end tag may be omitted if the colgroup element is
+        # not immediately followed by a space character or a comment.
+        return next_node.nil? ||
+               (next_node.text? && !next_node.content.start_with(' ')) ||
+               !next_node.comment?
+
+      when 'thead'
+        # A thead element's end tag may be omitted if the thead element is
+        # immediately followed by a tbody or tfoot element.
+        return %w[tbody tfoot].include? next_elm&.name
+
+      when 'tbody'
+        # A tbody element's end tag may be omitted if the tbody element is
+        # immediately followed by a tbody or tfoot element, or if there is no
+        # more content in the parent element.
+        return %w[tbody tfoot].include?(next_elm&.name) ||
+               !parent_contains_more_content?(node)
+
+      when 'tfoot'
+        # A tfoot element's end tag may be omitted if the tfoot element is
+        # immediately followed by a tbody element, or if there is no more
+        # content in the parent element.
+        return next_elm&.name == 'tbody' ||
+               !parent_contains_more_content?(node)
+
+      when 'tr'
+        # A tr element's end tag may be omitted if the tr element is immediately
+        # followed by another tr element, or if there is no more content in the
+        # parent element.
+        return next_elm&.name == 'tr' ||
+               !parent_contains_more_content?(node)
+
+      when 'td', 'th'
+        # A td element's end tag may be omitted if the td element is immediately
+        # followed by a td or th element, or if there is no more content in the
+        # parent element.
+        #
+        # A th element's end tag may be omitted if the th element is immediately
+        # followed by a td or th element, or if there is no more content in the
+        # parent element.
+        return %w[td th].include?(next_elm&.name) ||
+               !parent_contains_more_content?(node)
+      end
+      false
+    end
+  end
+
+  # Minify HTML convenience method.
+  #
+  # @param content [String] the HTML to minify
+  # @param options [Hash] options to override the ++Squoosher++ default options
+  # @return [String] the minified HTML
+  def self.minify_html(content, options = {})
+    Squoosher.new(options).minify_html content
+  end
+
+  # Minify CSS convenience method.
+  #
+  # @param content [String] the CSS to minify
+  # @param options [Hash] options to override the ++Squoosher++ default options
+  # @return [String] the minified CSS
+  def self.minify_css(content, options = {})
+    Squoosher.new(options).minify_css content
+  end
+
+  # Minify JavaScript convenience method.
+  #
+  # @param content [String] the JavaScript to minify
+  # @param options [Hash] options to override the ++Squoosher++ default options
+  # @return [String] the minified JavaScript
+  def self.minify_js(content, options = {})
+    Squoosher.new(options).minify_js content
+  end
+end
+# vim: set sw=2 sts=2 ts=8 expandtab:

data/lib/squoosh/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Squoosh
+  # The version of squoosh.
+  VERSION = '0.2.0'
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: squoosh
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Stephen Checkoway
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-10-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: 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: rspec
+  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: rubocop
+  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: simplecov
+  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: yard
+  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: nokogumbo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: uglifier
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+description: 
+email:
+- s@pahtak.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/squoosh.rb
+- lib/squoosh/version.rb
+homepage: https://github.com/stevecheckoway/squoosh
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/stevecheckoway/squoosh/issues
+  changelog_uri: https://github.com/stevecheckoway/squoosh/blob/master/CHANGELOG.md
+  homepage_uri: https://github.com/stevecheckoway/squoosh
+  source_code_uri: https://github.com/stevecheckoway/squoosh
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.7
+signing_key: 
+specification_version: 4
+summary: Minify HTML/CSS/JavaScript files.
+test_files: []