dhtml 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d19e6ad8effeadc4ba60d79a1df5cc0a66ca25e7c8f75f513e73faf439abccf
-  data.tar.gz: 42e1449cda9a9874bd36bb0b261537c4f147b2af56b0e26aba742b231297332f
+  metadata.gz: 9fe9a81232d087f78f919f95b27cdffc5ccefd5a4134dad6ed21cce7e3856265
+  data.tar.gz: 4db4671909efeb3a9a149b56f8d8cc72c606fc2babc81a3ace13df126a1a7a29
 SHA512:
-  metadata.gz: f26aaa41af798393b2865477d742bf59c9723dc3714d43e1f2e7c463c8465801c7947c1cc33b45671e05ef68f63bff1f7db5e684cbd50720d6df3f9cf18c286a
-  data.tar.gz: 07c3a590c080c087a543628db94fe171e16f7746f7863110c82b7a9a6aa18a55378d39abb95b64abd96b47251b94e25d3e0f3b4831d2f652431e8637b09d2152
+  metadata.gz: 9a8daa8a23422a54a929ba5350a60795cd8b9b863fc59f71de0e9a57d4f2b299725d632b07d3c8f4d3bd9c1cefa50a6cde73a1a414bad7bf21cc5de7ee050755
+  data.tar.gz: 9943ffda42a1c42f04ee12338fd26fcb9e5725757292646107241457033810cef7383d2336fffff44dc7edbdfeb2fe7c3782b5c8f55f5e72312cd5663bc05914

data/CHANGELOG.md

@@ -5,21 +5,20 @@ The format is based on [Keep a Changelog], and this project adheres to [Semantic
 
 ## [Unreleased]
 
-## [0.1.3] - 2021-05-10
-### Fixed
-- The gemspec no longer uses absolute paths for the sources.
-
-## [0.1.2] - 2021-05-10
+## [0.1.4] - 2021-05-11
 ### Added
-- `reset` method so the document can be generated more than once.
+- `pretty_html` method that formats the document in a way presentable to a human.
 
-## [0.1.0] - 2021-05-10
-- Initial release
+### Fixed
+- `write_html_tag` and `write_html_element` return the number of bytes written.
 
+## [0.1.3] - 2021-05-10
+- Initial release
+- Versions prior to this were yanked. The gems were packaged with absolute paths by mistake.
 
-[Unreleased]: https://github.com/hi5dev/dhtml/compare/v0.1.2...HEAD
-[0.1.2]: https://github.com/hi5dev/dhtml/compare/v0.1.2..v0.1.0
-[0.1.0]: https://github.com/hi5dev/dhtml/releases/tag/v0.1.0
+[Unreleased]: https://github.com/hi5dev/dhtml/compare/v0.1.4...HEAD
+[0.1.4]: https://github.com/hi5dev/dhtml/compare/v0.1.3..v0.1.4
+[0.1.3]: https://github.com/hi5dev/dhtml/releases/tag/v0.1.3
 
 [Keep a Changelog]: https://keepachangelog.com/en/1.0.0/
 [Semantic Versioning]: https://semver.org/spec/v2.0.0.html

data/lib/dhtml/document.rb

@@ -97,6 +97,18 @@ module DHTML
 
     alias_method :h, :html_escape
 
+    # Reads and formats the document in a way presentable to a human.
+    #
+    # @note Not available to Opal.
+    # @param [String] indent string.
+    # @return [String]
+    # @since 0.1.4
+    def pretty_html(indent: ' ' * 2)
+      require 'cgi' unless defined?(CGI)
+
+      CGI.pretty(read_html, indent)
+    end if RUBY_ENGINE != 'opal'
+
     # Reads the entire HTML document.
     #
     # @return [String]
@@ -121,10 +133,14 @@ module DHTML
     # @return [Integer] Number of bytes written to the stream.
     # @since 0.1.0
     def write_html_element(tag, attributes = {})
+      length = document.length
+
       document << '<'
       document << tag
       document << " #{html_attributes(attributes)}" unless attributes.empty?
       document << '>'
+
+      document.length - length
     end
 
     # Write a tag to the HTML document.
@@ -142,6 +158,9 @@ module DHTML
       tag = tag.to_s
       tag = tag[1..-1] if tag[0] == '_'
 
+      # Used to calculate the number of bytes written for the return value.
+      length = document.length
+
       # Opening tag with its HTML attributes - e.g. <div id="main">
       write_html_element(tag, attributes)
 
@@ -153,6 +172,9 @@ module DHTML
 
       # Close the tag when necessary.
       document.write("</#{tag}>") if content.is_a?(String) || block_given? || !void?(tag.to_sym)
+
+      # Total number of bytes written by this method.
+      document.length - length
     end
   end
 end

data/lib/dhtml/version.rb

@@ -5,5 +5,5 @@ module DHTML
   #
   # @see https://semver.org/spec/v2.0.0.html
   # @type [String]
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dhtml
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Travis Haynes