papercraft 0.24 → 0.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f90c4ea6ac9d3090ae45d79f7f4a58668ccf7f8ae5d4dfa2a727b44a82699eb9
-  data.tar.gz: 10ff5bc3df10c10b0a968921517d2e0c18a61973dd97b88e95eef38670b9e451
+  metadata.gz: f23902f7431dcbd6c1180e26f612ae5099d4e7f2ba468dd0e0e5e9a76e324ef4
+  data.tar.gz: 5bf38e4faea0ab6c6145d769b24b416e467836b29c6d8856bb96442f86b43bfe
 SHA512:
-  metadata.gz: '02461962ba174678a5b4a6ec550a8faa2f643fe87234e41513f7b49d798e3f3b2ade02adcfb0fa4961124a74484ddddea9437cb02eec98e9e897721729c0ef63'
-  data.tar.gz: f99728bb218382a040f67cbf2fd9652c33b3e0648efefbc695ceee708006758b6ec249748f3e3d41b065bf3b2fb28014b1ae61e02f7d3b01231e928f028e6ebd
+  metadata.gz: 69ed90f079f1db073bbc18b1b631c13cbcd2db5dae9e512781046fb7fa5ab0a164653137b28c201f48671d77e4d08ff1da3818381aca5d3686d61eb185f8a586
+  data.tar.gz: 85681c583e3e145ca27a52638e0d3370fa94462d5baaae8cccb477a1a2938ad56f3040ee4f6cceb2757b49019890bcae505bcdc008e2ff0931987f09ab9eb91a

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.25 2023-01-12
+
+- Implement `#def_tag` for defining custom tags inline
+
 ## 0.24 2022-03-19
 
 - Fix usage of const components (#13)

data/README.md

@@ -86,6 +86,7 @@ hello.render('world')
 - [XML Templates](#xml-templates)
 - [JSON Templates](#json-templates)
 - [Papercraft Extensions](#papercraft-extensions)
+  - [Inline Helper Methods](#inline-helper-methods)
   - [Bundled Extensions](#bundled-extensions)
 - [API Reference](#api-reference)
 
@@ -681,6 +682,57 @@ Papercraft.html {
 }
 ```
 
+## Inline Helper Methods
+
+In addition to proper extensions defined in modules, you can also define
+individual extension methods inline in your Papercraft templates. You can do
+this using any of the following techniques:
+
+1. Define a method in the template body:
+
+```ruby
+Papercraft.html {
+  def label(text)
+    span text, class: 'label'
+  end
+
+  label 'foo'
+  label 'bar'
+}
+```
+
+2. Use `def_tag` to define a custom tag:
+
+```ruby
+Papercraft.html {
+  def_tag(:label) { |text| span text, class: 'label' }
+
+  label 'foo'
+  label 'bar'
+}
+```
+
+Note that using any of the above methods you can also create custom components
+that take a block with inner HTML:
+
+```ruby
+# using def
+def section(title, &inner)
+  div {
+    h1 title
+    emit inner
+  }
+end
+
+# using def_tag
+def_tag(:section) do |title, &inner|
+  div {
+    h1 title
+    emit inner
+  }
+end
+```
+
 ## Bundled Extensions
 
 Papercraft comes bundled with a few extensions that address common use cases.

data/lib/papercraft/tags.rb

@@ -180,6 +180,29 @@ module Papercraft
       @buffer << escape_text(data)
     end
 
+    # Defines a custom tag. This is handy for defining helper or extension
+    # methods inside the template body.
+    #
+    #   Papercraft.html {
+    #     def_tag(:section) { |title, &inner|
+    #       div {
+    #         h1 title
+    #         emit inner
+    #       }
+    #     }
+    #
+    #     section('Foo') {
+    #       p 'Bar'
+    #     }
+    #   }
+    #
+    # @param tag [Symbol, String] tag/method name
+    # @param block [Proc] method body
+    # @return [void]
+    def def_tag(sym, &block)
+      self.class.define_method(sym, &block)
+    end
+
     private
 
     # Defines a method that emits the given tag based on a constant. The

data/lib/papercraft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Papercraft
-  VERSION = '0.24'
+  VERSION = '0.25'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: papercraft
 version: !ruby/object:Gem::Version
-  version: '0.24'
+  version: '0.25'
 platform: ruby
 authors:
 - Sharon Rosner
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-19 00:00:00.000000000 Z
+date: 2023-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: escape_utils
@@ -122,7 +122,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.0.9
-description:
+description: 
 email: sharon@noteflakes.com
 executables: []
 extensions: []
@@ -152,7 +152,7 @@ metadata:
   documentation_uri: https://www.rubydoc.info/gems/papercraft
   homepage_uri: https://github.com/digital-fabric/papercraft
   changelog_uri: https://github.com/digital-fabric/papercraft/blob/master/CHANGELOG.md
-post_install_message:
+post_install_message: 
 rdoc_options:
 - "--title"
 - Papercraft
@@ -171,8 +171,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
-signing_key:
+rubygems_version: 3.4.1
+signing_key: 
 specification_version: 4
 summary: 'Papercraft: component-based HTML templating for Ruby'
 test_files: []