simple-builder 0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7d2b59531cfd70ca72b3078ce6a844741ff88d88abed85921d3a555529eb378f
+  data.tar.gz: d871021f4dfcd4bba1c12fe8d8e84fb97cac3432fc45176bcb7aca277b690f74
+SHA512:
+  metadata.gz: ca3e79b297e5abf5e8e86a44e00513cb2275e2dbfc28ebb0caa903e2d57e9f726c892e445b952788f73094b8348dec46a904219bb32d8cc1328cf941f02f2f3f
+  data.tar.gz: b53a1e68e0b0ee0b8118c6794533d8f78ece3479a8241cf45e1ce2f44c118dc16ed53fa86cb2aee6d23b24f3a546c34f15e4a5e730c294517c78dc281c1dee68

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.DS_Store
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1 @@
+FIXME

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+Bundler.require
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/*_test.rb']
+end
+
+task :default => :test

data/lib/simple-builder/builders.rb

@@ -0,0 +1,67 @@
+module Simple
+
+  class Builder
+
+    def self.build_html4_document(&block)
+      HTML4Document.new.build_html(&block)
+    end
+
+    def self.build_html5_document(&block)
+      HTML5Document.new.build_html(&block)
+    end
+
+    def self.build_html(&block)
+      HTMLFragment.new.build_html(&block)
+    end
+
+    def build_html(&block)
+      Nokogiri::HTML::Builder.with(@root) do |builder|
+        yield(builder)
+      end
+      @root
+    end
+
+    class HTMLDocument < Builder
+
+      def initialize
+        super
+        @root = Nokogiri::HTML::Document.new
+        @root.encoding = 'UTF-8'
+        @root.internal_subset.remove
+        @root.create_internal_subset(*internal_subset) if internal_subset
+      end
+
+      def internal_subset
+        nil
+      end
+
+    end
+
+    class HTML4Document < HTMLDocument
+
+      def internal_subset
+        ['html', '-//W3C//DTD HTML 4.01 Transitional//EN', 'http://www.w3.org/TR/html4/loose.dtd']
+      end
+
+    end
+
+    class HTML5Document < HTMLDocument
+
+      def internal_subset
+        ['html', nil, nil]
+      end
+
+    end
+
+    class HTMLFragment < Builder
+
+      def initialize
+        super
+        @root = Nokogiri::HTML.fragment('')
+      end
+
+    end
+
+  end
+
+end

data/lib/simple-builder/fragments.rb

@@ -0,0 +1,41 @@
+module Simple
+
+  class Builder
+
+    class << self
+
+      def viewport
+        build_html do |html|
+          html.meta(name: 'viewport', content: 'width=device-width, initial-scale=1')
+        end
+      end
+
+      def style(href=nil, &block)
+        build_html do |html|
+          if href
+            html.link(href: href, rel: 'stylesheet', type: 'text/css')
+          elsif block_given?
+            html.style(type: 'text/css') do
+              html << yield
+            end
+          end
+        end
+      end
+
+      def script(src=nil, &block)
+        build_html do |html|
+          if src
+            html.script(src: src, type: 'text/javascript')
+          elsif block_given?
+            html.script(type: 'text/javascript') do
+              html << yield
+            end
+          end
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/simple-builder/helpers.rb

@@ -0,0 +1,55 @@
+module Simple
+
+  class Builder
+
+    class << self
+
+      def find_link_element_attributes(doc)
+        doc.xpath('//@href | //@src')
+      end
+
+      def find_head_element(doc)
+        doc.at_xpath('/html/head')
+      end
+
+      def find_body_element(doc)
+        doc.at_xpath('/html/body')
+      end
+
+      def find_title_element(doc)
+        find_head_element(doc).at_xpath('title')
+      end
+
+      def find_meta_info(doc)
+        find_head_element(doc).xpath('meta[@name]').map do |meta|
+          [meta['name'], meta['content']]
+        end.to_h
+      end
+
+      def find_p_child_elements(doc)
+        if (p = doc.at_xpath('p'))
+          p.children
+        else
+          doc
+        end
+      end
+
+      def replace_element(doc, xpath, &block)
+        doc.xpath(xpath).each do |elem|
+          elem.replace(yield(elem))
+        end
+      end
+
+      def string_to_html(str)
+        find_p_child_elements(
+          parse_html_fragment(
+            RubyPants.new(str).to_html
+          )
+        ).to_html
+      end
+
+    end
+
+  end
+
+end

data/lib/simple-builder/parsers.rb

@@ -0,0 +1,27 @@
+module Simple
+
+  class Builder
+
+    class ParseError < StandardError; end
+
+    class << self
+
+      def parse_html_document(html)
+        Nokogiri::HTML5::Document.parse(html).tap { |doc| check_html_errors(doc) }
+      end
+
+      def parse_html_fragment(html)
+        Nokogiri::HTML5::DocumentFragment.parse(html).tap { |doc| check_html_errors(doc) }
+      end
+
+      def check_html_errors(doc)
+        doc.errors.each do |error|
+          raise ParseError, "HTML error #{error}"
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/simple-builder/string.rb

@@ -0,0 +1,7 @@
+class String
+
+  def to_html
+    Simple::Builder.string_to_html(self)
+  end
+
+end

data/lib/simple-builder.rb

@@ -0,0 +1,8 @@
+require 'nokogiri'
+require 'rubypants'
+
+require 'simple-builder/builders'
+require 'simple-builder/string'
+require 'simple-builder/fragments'
+require 'simple-builder/helpers'
+require 'simple-builder/parsers'

data/simple-builder.gemspec

@@ -0,0 +1,23 @@
+Gem::Specification.new do |gem|
+  gem.name          = 'simple-builder'
+  gem.version       = '0.3'
+  gem.licenses      = ['MIT']
+  gem.authors       = 'John Labovitz'
+  gem.email         = 'johnl@johnlabovitz.com'
+  gem.summary       = %q{Simple HTML builder}
+  gem.description   = %q{Simple HTML builder.}
+  gem.homepage      = 'https://github.com/jslabovitz/simple-builder.git'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_dependency 'nokogiri', '~> 1.15'
+  gem.add_dependency 'rubypants', '~> 0.7'
+
+  gem.add_development_dependency 'bundler', '~> 2.4'
+  gem.add_development_dependency 'minitest', '~> 5.20'
+  gem.add_development_dependency 'minitest-power_assert', '~> 0.3'
+  gem.add_development_dependency 'rake', '~> 13.1'
+end

data/test/builder_test.rb

@@ -0,0 +1,53 @@
+require 'minitest/autorun'
+require 'minitest/power_assert'
+
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+require 'simple-builder'
+
+module Simple
+
+  class BuilderTest < Minitest::Test
+
+    def test_html4_document
+      html = Simple::Builder.build_html4_document do |b|
+        b.html(lang: 'en') do
+          b.h1('foo')
+        end
+      end.to_html
+      expected_html = <<END
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><h1>foo</h1></html>
+END
+      assert { html == expected_html }
+    end
+
+    def test_html5_document
+      html = Simple::Builder.build_html5_document do |b|
+        b.html(lang: 'en') do
+          b.h1('foo')
+        end
+      end.to_html
+      expected_html = <<END
+<!DOCTYPE html>
+<html lang="en"><h1>foo</h1></html>
+END
+      assert { html == expected_html }
+    end
+
+    def test_fragment
+      html = Simple::Builder.build_html do |b|
+        b.h1('foo')
+      end.to_html
+      expected_html = %q{<h1>foo</h1>}
+      assert { html == expected_html }
+    end
+
+    def test_string_to_html
+      html = %q{'foo' <and> "bar"}.to_html
+      expected_html = %q{‘foo’ &lt;and&gt; “bar”}
+      assert { html == expected_html }
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: simple-builder
+version: !ruby/object:Gem::Version
+  version: '0.3'
+platform: ruby
+authors:
+- John Labovitz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-11-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rubypants
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+- !ruby/object:Gem::Dependency
+  name: minitest-power_assert
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+description: Simple HTML builder.
+email: johnl@johnlabovitz.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- lib/simple-builder.rb
+- lib/simple-builder/builders.rb
+- lib/simple-builder/fragments.rb
+- lib/simple-builder/helpers.rb
+- lib/simple-builder/parsers.rb
+- lib/simple-builder/string.rb
+- simple-builder.gemspec
+- test/builder_test.rb
+homepage: https://github.com/jslabovitz/simple-builder.git
+licenses:
+- MIT
+metadata: {}
+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.4.22
+signing_key:
+specification_version: 4
+summary: Simple HTML builder
+test_files:
+- test/builder_test.rb