erb 2.2.2 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f3996670474a52bba08a0a8cdeba934a01d09fb7a45047ad14de049823cea90
-  data.tar.gz: e23035811fc69fb375930eb155ecbf47b67e7991ba7c96fd3c95d6f823e58b6b
+  metadata.gz: e39ac89a663f9ec9c2dd46af732f74e814b95167967f5efcf1aa35dbe640ea63
+  data.tar.gz: cfceb3434204b17b65d00a0eab2f73e7abca7c1c67bfa7baefeea151346dae5b
 SHA512:
-  metadata.gz: '09a2991c267e42f6b46f9c629db1596c3238a711e409099c1b50874ded8752d1dd64a9828b6eaec79796b06dab92d402d408c97b24a06eda3e4b12bb8c9e49ac'
-  data.tar.gz: 4341ca9b16e9e646121dd7e2da710156c6ce71a15983b6c12daaad6fc43fec918b4c57b15b933ff7e6a94a32894e8a458f580f3371300253cb36aaf955b2e07c
+  metadata.gz: d71d4bdcf0f0a027f1897a2c74aa56c728658d96f2f88c5e1e4e3e33d5d5707c514a3ed39946335cf9f94ccd4734ee33ad21a1a8f57b547339ef1b49a81681b4
+  data.tar.gz: b85fd09d707a9e92adfd1e8d827cf4c172106cce3f3207495944f8e4fa5b966fb9af2b52053af02e39bd2b1f1db06d9bb00ebe31bc4409b9ff5339a976cee938

data/NEWS.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## 2.2.2
+
+- `ERB.version` returns just a version number
+- `ERB::Revision` is deprecated
+
 ## 2.2.1
 
 - `ERB#initialize` warns `safe_level` and later arguments even without -w

data/README.md

@@ -2,31 +2,253 @@
 
 An easy to use but powerful templating system for Ruby.
 
-## Installation
+## Introduction
 
-Add this line to your application's Gemfile:
+ERB provides an easy to use but powerful templating system for Ruby.  Using
+ERB, actual Ruby code can be added to any plain text document for the
+purposes of generating document information details and/or flow control.
 
-```ruby
-gem 'erb'
+A very simple example is this:
+
+```rb
+require 'erb'
+
+x = 42
+template = ERB.new <<-EOF
+  The value of x is: <%= x %>
+EOF
+puts template.result(binding)
+```
+
+Prints: `The value of x is: 42`
+
+More complex examples are given below.
+
+## Recognized Tags
+
+ERB recognizes certain tags in the provided template and converts them based
+on the rules below:
+
+```erb
+<% Ruby code -- inline with output %>
+<%= Ruby expression -- replace with result %>
+<%# comment -- ignored -- useful in testing %>
+% a line of Ruby code -- treated as <% line %> (optional -- see ERB.new)
+%% replaced with % if first thing on a line and % processing is used
+<%% or %%> -- replace with <% or %> respectively
 ```
 
-And then execute:
+All other text is passed through ERB filtering unchanged.
+
+## Options
+
+There are several settings you can change when you use ERB:
+* the nature of the tags that are recognized;
+* the binding used to resolve local variables in the template.
+
+See the ERB.new and ERB#result methods for more detail.
+
+## Character encodings
+
+ERB (or Ruby code generated by ERB) returns a string in the same
+character encoding as the input string.  When the input string has
+a magic comment, however, it returns a string in the encoding specified
+by the magic comment.
+
+```rb
+# -*- coding: utf-8 -*-
+require 'erb'
+
+template = ERB.new <<EOF
+<%#-*- coding: Big5 -*-%>
+  __ENCODING__ is <%= __ENCODING__ %>.
+EOF
+puts template.result
+```
 
-    $ bundle install
+Prints: `__ENCODING__ is Big5.`
 
-Or install it yourself as:
+## Examples
 
-    $ gem install erb
+### Plain Text
 
-## Development
+ERB is useful for any generic templating situation.  Note that in this example, we use the
+convenient "% at start of line" tag, and we quote the template literally with
+`%q{...}` to avoid trouble with the backslash.
+
+```rb
+require "erb"
+
+# Create template.
+template = %q{
+  From:  James Edward Gray II <james@grayproductions.net>
+  To:  <%= to %>
+  Subject:  Addressing Needs
+
+  <%= to[/\w+/] %>:
+
+  Just wanted to send a quick note assuring that your needs are being
+  addressed.
+
+  I want you to know that my team will keep working on the issues,
+  especially:
+
+  <%# ignore numerous minor requests -- focus on priorities %>
+  % priorities.each do |priority|
+    * <%= priority %>
+  % end
+
+  Thanks for your patience.
+
+  James Edward Gray II
+}.gsub(/^  /, '')
+
+message = ERB.new(template, trim_mode: "%<>")
+
+# Set up template data.
+to = "Community Spokesman <spokesman@ruby_community.org>"
+priorities = [ "Run Ruby Quiz",
+               "Document Modules",
+               "Answer Questions on Ruby Talk" ]
+
+# Produce result.
+email = message.result
+puts email
+```
+
+Generates:
+
+```
+From:  James Edward Gray II <james@grayproductions.net>
+To:  Community Spokesman <spokesman@ruby_community.org>
+Subject:  Addressing Needs
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Community:
+
+Just wanted to send a quick note assuring that your needs are being addressed.
+
+I want you to know that my team will keep working on the issues, especially:
+
+    * Run Ruby Quiz
+    * Document Modules
+    * Answer Questions on Ruby Talk
+
+Thanks for your patience.
+
+James Edward Gray II
+```
+
+### Ruby in HTML
+
+ERB is often used in .rhtml files (HTML with embedded Ruby).  Notice the need in
+this example to provide a special binding when the template is run, so that the instance
+variables in the Product object can be resolved.
+
+```rb
+require "erb"
+
+# Build template data class.
+class Product
+  def initialize( code, name, desc, cost )
+    @code = code
+    @name = name
+    @desc = desc
+    @cost = cost
+
+    @features = [ ]
+  end
+
+  def add_feature( feature )
+    @features << feature
+  end
+
+  # Support templating of member data.
+  def get_binding
+    binding
+  end
+
+  # ...
+end
+
+# Create template.
+template = %{
+  <html>
+    <head><title>Ruby Toys -- <%= @name %></title></head>
+    <body>
+
+      <h1><%= @name %> (<%= @code %>)</h1>
+      <p><%= @desc %></p>
+
+      <ul>
+        <% @features.each do |f| %>
+          <li><b><%= f %></b></li>
+        <% end %>
+      </ul>
+
+      <p>
+        <% if @cost < 10 %>
+          <b>Only <%= @cost %>!!!</b>
+        <% else %>
+           Call for a price, today!
+        <% end %>
+      </p>
+
+    </body>
+  </html>
+}.gsub(/^  /, '')
+
+rhtml = ERB.new(template)
+
+# Set up template data.
+toy = Product.new( "TZ-1002",
+                   "Rubysapien",
+                   "Geek's Best Friend!  Responds to Ruby commands...",
+                   999.95 )
+toy.add_feature("Listens for verbal commands in the Ruby language!")
+toy.add_feature("Ignores Perl, Java, and all C variants.")
+toy.add_feature("Karate-Chop Action!!!")
+toy.add_feature("Matz signature on left leg.")
+toy.add_feature("Gem studded eyes... Rubies, of course!")
+
+# Produce result.
+rhtml.run(toy.get_binding)
+```
+
+Generates (some blank lines removed):
+
+```html
+<html>
+  <head><title>Ruby Toys -- Rubysapien</title></head>
+  <body>
+
+    <h1>Rubysapien (TZ-1002)</h1>
+    <p>Geek's Best Friend!  Responds to Ruby commands...</p>
+
+    <ul>
+        <li><b>Listens for verbal commands in the Ruby language!</b></li>
+        <li><b>Ignores Perl, Java, and all C variants.</b></li>
+        <li><b>Karate-Chop Action!!!</b></li>
+        <li><b>Matz signature on left leg.</b></li>
+        <li><b>Gem studded eyes... Rubies, of course!</b></li>
+    </ul>
+
+    <p>
+         Call for a price, today!
+    </p>
+
+  </body>
+</html>
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+## Notes
 
-## Contributing
+There are a variety of templating solutions available in various Ruby projects.
+For example, RDoc, distributed with Ruby, uses its own template engine, which
+can be reused elsewhere.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/erb.
+Other popular engines could be found in the corresponding
+[Category](https://www.ruby-toolbox.com/categories/template_engines) of
+The Ruby Toolbox.
 
 ## License
 

data/erb.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |spec|
   spec.summary       = %q{An easy to use but powerful templating system for Ruby.}
   spec.description   = %q{An easy to use but powerful templating system for Ruby.}
   spec.homepage      = 'https://github.com/ruby/erb'
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.5.0')
   spec.licenses      = ['Ruby', 'BSD-2-Clause']
 
   spec.metadata['homepage_uri'] = spec.homepage

data/lib/erb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 class ERB
-  VERSION = '2.2.2'
+  VERSION = '2.2.3'
   private_constant :VERSION
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erb
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 2.2.3
 platform: ruby
 authors:
 - Masatoshi SEKI
 autorequire:
 bindir: libexec
 cert_chain: []
-date: 2021-01-21 00:00:00.000000000 Z
+date: 2021-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -60,14 +60,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.0.dev
+rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
 summary: An easy to use but powerful templating system for Ruby.