RubyGems - papercraft - Versions diffs - 0.29 → 1.0 - Mend

papercraft 0.29 → 1.0

Files changed (6) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ca707074311c909d6e2b4aa86748f1ffbd5b614d73fb78e85985d174b69e263
-  data.tar.gz: f53dc4fa5088472ccc805f50938f25539950446fe14e97facb2cc346722d13fe
+  metadata.gz: d769e6ec71d8c6d60ebb0aa727037b691562a31ec1fc1a05ccb0f25f29858b7a
+  data.tar.gz: 97b15299e8b4ca3d801aec881bd0ea4cee245650225f9c6e41972333ab9f8011
 SHA512:
-  metadata.gz: 0d216f2c8db4beed8c7fe184d3b8e0a13ba8af4684d4e46f5506f0b1eb6c3bfaa0ad76b7a5b1b6e28a8ba37a730545ca00139fd0bf35b74628d117c504fc1e9c
-  data.tar.gz: 27ac04cf8b75b5d6abda511513618fb6ef20417365ac7b45855d909323db3c536204f85d719a44e2374b095d955f4eb0c25901290990dab861c908fa4d73142e
+  metadata.gz: ff74adc23fc616b579f9729cecc595e2eebe92d2b96b6edcceff4eae043c7ca8048e3baea14f275533667809183cd7961e14c74a6afb71b04fe7902806c8678c
+  data.tar.gz: 8fcecbac3baa12296ae3386ecb31eb0db0d7e001f4f38dd1c055ab497a3113471338d26cca8812582091e10c17ab5413c1e37cdf172d07ca1eac011206935d90

data/CHANGELOG.md CHANGED Viewed

@@ -1,3 +1,7 @@
+## 1.0 2023-03-30
+- Add support for Array attribute values
 ## 0.29 2023-03-11
 - Add Tilt integration (#15)

data/README.md CHANGED Viewed

@@ -84,6 +84,7 @@ hello.render('world')
 - [Emitting Markdown](#emitting-markdown)
 - [Working with MIME Types](#working-with-mime-types)
 - [Deferred Evaluation](#deferred-evaluation)
+- [HTML Templates](#html-templates)
 - [XML Templates](#xml-templates)
 - [JSON Templates](#json-templates)
 - [Papercraft Extensions](#papercraft-extensions)
@@ -198,14 +199,28 @@ Papercraft.html { hr() }.render #=> "<hr/>"
 Tag methods also accept tag attributes, given as a hash:
 ```ruby
-Papercraft.html { img src: '/my.gif' }.render #=> "<img src="/my.gif"/>
+Papercraft.html { img src: '/my.gif' }.render #=> "<img src=\"/my.gif\"/>"
 Papercraft.html { p "foobar", class: 'important' }.render #=> "<p class=\"important\">foobar</p>"
 ```
+A `true` attribute value will emit a valueless attribute. A `nil` or `false`
+attribute value will emit nothing:
+```ruby
+Papercraft.html { button disabled: nil }.render #=> "<button></button>"
+Papercraft.html { button disabled: true }.render #=> "<button disabled></button>"
+```
+An attribute value given as an array will be joined by space characters:
+```ruby
+Papercraft.html { div class: [:foo, :bar] }.render #=> "<div class=\"foo bar\"></div>"
+```
 ## Tag and Attribute Formatting
-Papercraft does not make any presumption about what tags and attributes you can
+Papercraft does not make any assumption about what tags and attributes you can
 use. You can mix upper and lower case letters, and you can include arbitrary
 characters in tag and attribute names. However, in order to best adhere to the
 HTML and XML specs and common practices, tag names and attributes will be
@@ -276,7 +291,7 @@ greeting.render(name: 'world') #=> "<h1>Hello, world!</h1>"
 ## Template Logic
-Since Papercraft templates are just a bunch of Ruby, you can easily write your
+Since Papercraft templates are just a bunch of Ruby, you can easily embed your
 view logic right in the template:
 ```ruby
@@ -585,6 +600,24 @@ page = default_layout.apply {
 }
 ```
+## HTML Templates
+HTML templates include a few HTML-specific methods to facilitate writing modern
+HTML:
+- `html5 { ... }` - emits an HTML 5 DOCTYPE (`<!DOCTYPE html>`)
+- `import_map(root_path, root_url)` - emits an import map including all files
+  matching `<root_path>/*.js`, based on the given `root_url`
+- `js_module(js)` - emits a `<script type="module">` element
+- `link_stylesheet(href, **attributes)` - emits a `<link rel="stylesheet" ...>`
+  element
+- `script(js, **attributes)` - emits an inline `<script>` element
+- `style(css, **attributes)` - emits an inline `<style>` element
+- `versioned_file_href(href, root_path, root_url)` - calculates a versioned href
+  for the given file
+[HTML docs](https://www.rubydoc.info/gems/papercraft/Papercraft/HTML)
 ## XML Templates
 XML templates behave largely the same as HTML templates, with a few minor
@@ -620,6 +653,8 @@ rss = Papercraft.xml(mime_type: 'text/xml; charset=utf-8') { |resource:, **props
 }
 ```
+[XML docs](https://www.rubydoc.info/gems/papercraft/Papercraft/XML)
 ## JSON Templates
 JSON templates behave largely the same as HTML and XML templates. The only major
@@ -651,6 +686,8 @@ Papercraft.json {
 Papercraft uses the [JSON gem](https://rubyapi.org/3.1/o/json) under the hood in
 order to generate actual JSON.
+[JSON docs](https://www.rubydoc.info/gems/papercraft/Papercraft/JSON)
 ## Papercraft Extensions
 Papercraft extensions are modules that contain one or more methods that can be
@@ -857,6 +894,8 @@ xml = Papercraft.xml {
 }
 ```
+[SOAP docs](https://www.rubydoc.info/gems/papercraft/Papercraft/Extensions/Soap)
 ## API Reference
 The API reference for this library can be found

data/lib/papercraft/tags.rb CHANGED Viewed

@@ -387,6 +387,10 @@ module Papercraft
             @buffer << S_SPACE << att_repr(k)
           when false, nil
             # emit nothing
+          when Array
+            v = v.join(' ')
+            @buffer << S_SPACE << att_repr(k) <<
+              S_EQUAL_QUOTE << escape_text(v) << S_QUOTE
           else
             @buffer << S_SPACE << att_repr(k) <<
               S_EQUAL_QUOTE << escape_text(v) << S_QUOTE

data/lib/papercraft/version.rb CHANGED Viewed

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

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: papercraft
 version: !ruby/object:Gem::Version
-  version: '0.29'
+  version: '1.0'
 platform: ruby
 authors:
 - Sharon Rosner
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-11 00:00:00.000000000 Z
+date: 2023-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: escape_utils