it 0.2.3 → 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4b79069211ccb670779e106ffa6802ab17feac3d72ca87b4088ce4eab9b928b7
+  data.tar.gz: 61b097f8a810653820c8376c523b56f5a7435c93a966505511688f139f3d7837
+SHA512:
+  metadata.gz: a508fd6bb549cdee9b7dd8a9e1fedf9ef0ede81b739fc7cec3e29fc610119e42528e21696bde282847725633b1f029896194b28a4b7bbb0ba6ae5a364cb84a17
+  data.tar.gz: 912d6c0e1db45ecf52cd5c80be7780f6385400f0e84e3ab88076ba639ce8e25569b9a373fa32f23901e50ffa1f73837302425927300301abff04f66e39570557

data/CHANGELOG.md

@@ -0,0 +1,27 @@
+# 2.0.0 (2020-08-07)
+
+## Breaking changes
+
+* Support dropped for Ruby 2.3, 2.4 and for Rails 4.2, 5.0, and 5.1
+
+## Fixes
+
+* Fix 'TypeError - hash key raise is not a Symbol' when used with Rails 6.0.3 [#28](https://github.com/iGEL/it/pull/28)  
+  *Jason Barnabe* and *wingice*
+* Fix Ruby 2.7 deprecations
+* `It.link` now accepts `ActiveSupport::SafeBuffer`s
+  Reported by *James Balazs*
+
+# 1.0.0 (2017-06-03)
+
+* Allow whitespace after the colon without considering it part of the value [#20](https://github.com/iGEL/it/pull/20)  
+  *Russell Norris*
+* Run specs with warnings enabled
+* 1.0.0 Release to conform with semver 2.0
+
+# 0.8.0 (2015-06-12)
+
+* Make `It.plain` work with empty content [#14](https://github.com/iGEL/it/pull/14)  
+  *Emil Sågfors*
+* Pass though `:scope` & `:default` [#13](https://github.com/iGEL/it/pull/13)  
+  *Emil Sågfors*

data/Gemfile

@@ -1,6 +1,3 @@
-source :rubygems
+source 'https://rubygems.org'
 
-group :development, :test do
-  gem 'actionpack'
-  gem 'rspec-rails'
-end
+gemspec

data/README.md

@@ -0,0 +1,123 @@
+[![Maintainability](https://api.codeclimate.com/v1/badges/6f705ee22d3eb7422d8f/maintainability)](https://codeclimate.com/github/iGEL/it/maintainability)
+[![Build Status](http://img.shields.io/travis/iGEL/it/main.svg?style=flat)](https://travis-ci.org/iGEL/it)
+[![Coverage](http://img.shields.io/coveralls/iGEL/it/main.svg?style=flat)](https://coveralls.io/r/iGEL/it)
+[![Rubygems](http://img.shields.io/gem/v/it.svg?style=flat)](http://rubygems.org/gems/it)
+[![Github Issues](http://img.shields.io/github/issues/iGEL/it.svg?style=flat)](https://github.com/iGEL/it/issues)
+
+Tested against Ruby 2.7, 2.6, and 2.5 and Rails 6.0 and 5.2
+
+What is **it**?
+=============
+
+I18n is baked right into Rails, and it's great. But if you want to place markup or links inside your translated copies, things get a little messy. You need to specify the label of your links separately from the rest of the copy. Writing HTML in your translations is even worse.
+
+```yaml
+en:
+  copy: "If you are already registered, %{login_link}!"
+  copy_login_link: "please sign in"
+```
+
+```erb
+<%=raw t("copy", login: link_to(t("copy_login_link"), login_path)) %>
+```
+
+Wouldn't it be much nicer and easier to understand for your translator to have the whole copy in single label? **it** lets you do that:
+
+```yaml
+en:
+  copy: "If you are already registered, %{login_link:please sign in}!"
+```
+
+```erb
+<%=it "copy", login_link: login_path %>
+```
+
+You may have noticed in the example above, that **it** doesn't require `raw` anymore. Of course, all HTML in the translation gets properly escaped, so you don't have to worry about XSS.
+
+Installation
+------------
+
+Just add the following line to your Gemfile & run `bundle install`:
+
+```ruby
+gem 'it'
+```
+
+Usage
+-----
+
+You may have as many links inside your translations as you like, and normal interpolations are possible as well:
+
+```yaml
+en:
+  copy: "Read the %{guide:Rails I18n guide} for more than %{advises} advises. Fork it at %{repo:github}."
+```
+
+```erb
+<%=it "copy",
+  guide: It.link("http://guides.rubyonrails.org/i18n.html"),
+  advices: 100,
+  repo: It.link("https://github.com/rails/rails") %>
+```
+
+As you see above, unless the interpolation name is `link` or starts with `link_` or ends with `_link`, you need to call `It.link` to create a link. The advantage of `It.link`: You may specify options like you would with `link_to`:
+
+```erb
+<%=it "copy",
+  link: It.link("http://rubyonrails.org", target: '_blank', class: "important") %>
+```
+
+You may pass any kind of object accepted by `link_to` as the link target, so your loved named routes like `article_path(id: article.id)` will all work fine.
+
+Want to introduce some markup into your sentences? **it** will help you:
+
+```yaml
+en:
+  advantages: There are %{b:many advantages} for registered users!
+```
+
+```erb
+<%=it "advantages", b: It.tag(:b, class: "red") %>
+```
+
+Even nested interpolations are possible:
+
+```yaml
+en:
+  copy: "Want to contact %{user}%? %{link:send %{b:%{user} a message}}!"
+```
+
+```erb
+<%=it "copy", link: "mailto:igel@igels.net", user: 'iGEL', b: It.tag(:b) %>
+```
+
+To use **it** outside of the view layer, just use `It.it`:
+
+```ruby
+flash[:notice] = It.it('flash.invitation_accepted_already', link: root_path)
+```
+
+If you would like to use the same translations in your html and plain text mails, you will like the `It.plain` method:
+```yaml
+en:
+  mail_copy: "Do you like %{link:Rails}?"
+```
+
+```erb
+https://github.com/rails/rails
+<%= it "mail_copy", link: It.link("http://www.rubyonrails.org/") %>
+
+Plain mail:
+<%= it "mail_copy", link: It.plain("%s[http://www.rubyonrails.org/]") %>
+```
+
+The `%s` will be replaced with the label, in the example with Rails. You could provide any other string containing `%s`. The default is just `%s`, so it will return only the label itself.
+
+Contribute
+----------
+
+* Fork it
+* Create a feature branch (`git checkout -b my-new-feature`)
+* Create one or more failing specs. If you change code (feature or bug), I won't accept a pull request unless you changed specs.
+* Fix the specs by implementing the feature/bug fix
+* Push and open a pull request

data/Rakefile

@@ -1,5 +1,10 @@
+require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'reek/rake/task'
 
 RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+Reek::Rake::Task.new
 
-task :default => :spec
+task default: %i[spec rubocop reek]

data/it.gemspec

@@ -0,0 +1,28 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'it/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'it'
+  spec.version       = It::VERSION
+  spec.authors       = ['Johannes Barre']
+  spec.email         = ['igel@igels.net']
+
+  spec.summary       = 'A helper for links and other html tags in your translations'
+  spec.homepage      = 'https://github.com/igel/it'
+  spec.license       = 'MIT'
+
+  spec.files         = %w[MIT-LICENSE README.md Rakefile Gemfile CHANGELOG.md it.gemspec] + Dir['lib/**/*.rb']
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.5.0'
+  spec.add_dependency 'actionpack', '>= 3.0.0'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'coveralls'
+  spec.add_development_dependency 'nokogiri'
+  spec.add_development_dependency 'rake', '~> 12'
+  spec.add_development_dependency 'reek'
+  spec.add_development_dependency 'rspec', '~> 3.2'
+  spec.add_development_dependency 'rubocop'
+end

data/lib/it.rb

@@ -1,7 +1,10 @@
+require 'it/parser'
+require 'it/interpolation'
 require 'it/tag'
 require 'it/link'
 require 'it/plain'
 require 'it/helper'
+require 'it/version'
 
 ActiveSupport.on_load(:action_view) do
   include It::Helper
@@ -11,15 +14,17 @@ end
 module It
   # It outside of your views. See documentation at Helper#it
   def self.it(identifier, options = {})
-    options.stringify_keys!
-    process(I18n.t(identifier, :locale => options["locale"]), options)
+    Parser.new(
+      I18n.t(identifier, **Parser.backend_options(options).symbolize_keys),
+      options.stringify_keys
+    ).process
   end
 
   # Creates a new link to be used in +it+.
   #
-  # * +href+: The url for the link. You may specify it as a String or as a named route like +article_path+. It's not possible to specify
-  #   a Hash like <code>{:controller => "articles", :action => "index"}</code> directly. Use the +url_for+ helper, if you would like to specify your
-  #   links like that.
+  # * +href+: The url for the link. You may specify it as a String or as a named route like +article_path+. It's not
+  #   possible to specify a Hash like <code>{controller: "articles", action: "index"}</code> directly. Use the
+  #   +url_for+ helper, if you would like to specify your links like that.
   # * +options+: The options as an Hash. Use them like you would with +link_to+. <em>(optional)</em>
   def self.link(href, options = {})
     It::Link.new(href, options)
@@ -27,9 +32,9 @@ module It
 
   # Creates a new plain replacement to be used in +it+.
   #
-  # * +template+: A string to be used as the template. An example would be <code>"%s[http://www.rubyonrails.org]"</code>. Defaults to
-  #   <code>"%s"</code>. <em>(optional)</em>
-  def self.plain(template = "%s")
+  # * +template+: A string to be used as the template. An example would be
+  #   <code>"%s[http://www.rubyonrails.org]"</code>. Defaults to <code>"%s"</code>. <em>(optional)</em>
+  def self.plain(template = '%s')
     It::Plain.new(template)
   end
 
@@ -40,39 +45,4 @@ module It
   def self.tag(tag_name, options = {})
     It::Tag.new(tag_name, options)
   end
-
-  private
-  def self.process(string, options)
-    # Handle pluralization
-    string = I18n.backend.send(:pluralize, options["locale"] || I18n.locale, string, options["count"]) if string.is_a?(Hash) && options["count"]
-
-    # We want the escaped String, not an ActiveSupport::SafeBuffer
-    translation = String.new(ERB::Util.h(string))
-
-    # For deep nesting, we repeat the process until we have no interpolations anymore
-    while translation =~ /%\{[^{}}]+\}/
-      translation.gsub!(/%\{[^{}}]+\}/) do |interpolation|
-        token, label = interpolation[2..-2].split(":", 2)
-
-        # Convert tokens with String arguments into It::Links, if they are named link, link_* or *_link
-        if (token == "link" || token.ends_with?("_link") || token.starts_with?("link_")) && (options[token].is_a?(String) || options[token].is_a?(Hash))
-          options[token] = It::Link.new(options[token])
-        end
-
-        if !options.has_key?(token)
-          raise KeyError, "key{#{token}} not found"
-        elsif label && !options[token].is_a?(It::Tag)
-          raise ArgumentError, "key{#{token}} has an argument, so it cannot resolved with a #{options[token].class}"
-        elsif label # Normal tags
-          options[token].process(label.html_safe)
-        elsif options[token].is_a?(It::Tag) # Empty tag
-          options[token].process
-        else # Normal interpolations, as I18n.t would do it.
-          ERB::Util.h(options[token])
-        end
-      end
-    end
-
-    translation.html_safe
-  end
 end

data/lib/it/helper.rb

@@ -1,5 +1,3 @@
-# encoding: UTF-8
-
 module It
   # The helper will be available in the views.
   module Helper
@@ -13,34 +11,38 @@ module It
     #
     #   # translation: "Already signed up? %{login_link:Sign in}!"
     #
-    #   <%=it("translation", :login_link => It.link(login_path))
+    #   <%=it("translation", login_link: It.link(login_path))
     #
-    # If your link doesn't require additional attributes and the name is +link+, starts with +link_+ or ends with +_link+,
-    # you may specify the argument as a String or your helper.
+    # If your link doesn't require additional attributes and the name is +link+, starts with +link_+ or ends with
+    # +_link+, you may specify the argument as a String or your helper.
     #
     #   # translation: "Already signed up? %{login_link:Sign in}!"
     #
-    #   <%=it("translation", :login_link => login_path)
+    #   <%=it("translation", login_link: login_path)
     #
-    # You may have as many tags inside of one translation as you like, and you even may nest them into each other. Also you
-    # may specify arguments to links and other tags.
+    # You may have as many tags inside of one translation as you like, and you even may nest them into each other.
+    # Also you may specify arguments to links and other tags.
     #
-    #   # translation: "The top contributor of %{wiki_link:our wiki} is currently %{user_link:%{b:%{name}}}. Thanks a lot, %{name}!"
+    #   # translation: "The top %{wiki_link:our wiki} contributor is %{user_link:%{b:%{name}}}. Thanks %{name}!"
     #
-    #   <%= it("translation", :wiki_link => wiki_path, :name => user.name, :b => It.tag(:b, :class => "user"), :user_link => It.link(user_path(user), :target => "_blank"))
+    #   <%= it("translation", wiki_link: wiki_path, name: user.name, b: It.tag(:b, class: "user"),
+    #       user_link: It.link(user_path(user), target: "_blank"))
     #
-    # I recommend to limit the use of +it+ as much as possible. You could use it for <code><div></code> or <code><br /></code>, but I think,
-    # things seperated over multiple lines should go into different translations. Use it for inline tags like links, <code><span></code>,
-    # <code><b></code>, <code><i></code>, <code><em></code> or <code><strong></code>.
+    # I recommend to limit the use of +it+ as much as possible. You could use it for <code><div></code> or
+    # <code><br /></code>, but I think, things seperated over multiple lines should go into different translations. Use
+    # it for inline tags like links, <code><span></code>, <code><b></code>, <code><i></code>, <code><em></code> or
+    # <code><strong></code>.
     #
-    # It's currently not possible to specify your links as an Hash. Use the +url_for+ helper, if you want to specify your
-    # link target as an Hash.
+    # It's currently not possible to specify your links as an Hash. Use the +url_for+ helper, if you want to specify
+    # your link target as an Hash.
     #
     # If you need to use it outside of your views, use +It.it+.
     #
     def it(identifier, options = {})
-      options.stringify_keys!
-      It.process(t(identifier, :locale => options["locale"]), options)
+      It::Parser.new(
+        t(identifier, **It::Parser.backend_options(options).symbolize_keys),
+        options.stringify_keys
+      ).process
     end
   end
 end

data/lib/it/interpolation.rb

@@ -0,0 +1,65 @@
+module It
+  # Contains one interpolation and will delegate the work to the It::Tag (or subclass) or
+  # ERB::Util.h
+  class Interpolation
+    class << self
+      def call(string, values)
+        key, label = extract_key_and_label_from(string)
+        value = values[key]
+
+        raise KeyError, "key{#{key}} not found" unless values.key?(key)
+
+        new(key, value, label).process
+      end
+
+      private
+
+      # This is a :reek:UtilityFunction, but it's not an instance method
+      def extract_key_and_label_from(string)
+        # eg: %{key:label} or %{key} or %{key: label}
+        string[2..-2].split(/:\s*/, 2)
+      end
+    end
+
+    def initialize(key, value, label)
+      @key = key
+      @value = value
+      @label = label
+    end
+
+    def process
+      convert_link
+
+      validate_value_for_arguments
+
+      if value.is_a?(It::Tag)
+        process_it_tag
+      else # Normal interpolations, as I18n.t would do it.
+        ERB::Util.h(value)
+      end
+    end
+
+    private
+
+    attr_reader :key, :value, :label
+
+    # Convert keys with String arguments into It::Links, if they are named link, link_* or *_link
+    def convert_link
+      @value = It::Link.new(value) if key =~ /(\Alink\z|_link\z|\Alink_)/ && value.is_a?(String)
+    end
+
+    def process_it_tag
+      if label
+        value.process(label.html_safe)
+      else
+        value.process
+      end
+    end
+
+    def validate_value_for_arguments
+      if label && !value.is_a?(It::Tag)
+        raise ArgumentError, "key{#{key}} has an argument, so it cannot resolved with a #{value.class}"
+      end
+    end
+  end
+end

data/lib/it/link.rb

@@ -2,17 +2,20 @@ module It
   # A class for links
   class Link < Tag
     include ActionView::Helpers::UrlHelper
-    
+
+    attr_reader :href
+
     # See It.link for details. You can do everything there and save 6 characters.
     def initialize(href, options = {})
-      raise TypeError, "Invalid href given" unless href.is_a?(Hash) || href.is_a?(String)
+      raise TypeError, 'Invalid href given' unless [Hash, String, ActiveSupport::SafeBuffer].include?(href.class)
+
       super(:a, options)
       @href = href
     end
-    
+
     # Will be called from inside the helper to return the tag with the given content.
     def process(content)
-      link_to(content, @href, @options)
+      link_to(content, href, options)
     end
   end
-end
+end

data/lib/it/parser.rb

@@ -0,0 +1,50 @@
+module It
+  # Parses the string and replaces all interpolations accordingly.
+  class Parser
+    attr_reader :string, :options
+
+    INTERPOLATION_REGEXP = /%\{[^{}]+\}/.freeze
+
+    def self.backend_options(options)
+      options.with_indifferent_access.slice(:default, :locale, :scope)
+    end
+
+    def initialize(string, options)
+      @string = string
+      @options = options
+    end
+
+    def process
+      handle_pluralization
+      escape_string
+
+      # For deep nesting, we repeat the process until we have no interpolations anymore
+      while contains_interpolation?
+        string.gsub!(INTERPOLATION_REGEXP) do |interpolation|
+          Interpolation.call(interpolation, options)
+        end
+      end
+      string.html_safe
+    end
+
+    private
+
+    def contains_interpolation?
+      string =~ INTERPOLATION_REGEXP
+    end
+
+    def handle_pluralization
+      return if !string.is_a?(Hash) || !options.key?('count')
+
+      @string = I18n.backend.send(:pluralize, locale, string, options['count'])
+    end
+
+    def locale
+      options['locale'] || I18n.locale
+    end
+
+    def escape_string
+      @string = String.new(ERB::Util.h(string))
+    end
+  end
+end

data/lib/it/plain.rb

@@ -1,12 +1,14 @@
 module It
+  # Handles replacements in non HTML templates (e.g. mails)
   class Plain < Tag
-    def initialize(template = "%s")
+    def initialize(template = '%s')
       raise TypeError, "expected a String, got #{template.class}" unless template.is_a?(String)
+
       @template = template
     end
-    
-    def process(content)
-      sprintf(@template, content)
+
+    def process(content = '')
+      format(@template, content)
     end
   end
-end
+end

data/lib/it/tag.rb

@@ -2,24 +2,25 @@ module It
   # A generic class for html tags.
   class Tag
     include ActionView::Helpers::TagHelper
-    
+
     attr_reader :tag_name, :options
-    
+
     # See It.tag for details. You can do everything there and save 6 characters.
     def initialize(tag_name, options = {})
-      raise TypeError, "tag_name must be specified as a String or Symbol" unless tag_name.is_a?(String) || tag_name.is_a?(Symbol)
-      raise TypeError, "options must be specified as a Hash" unless options.is_a?(Hash)
+      raise TypeError, 'tag_name must be a String or Symbol' unless [String, Symbol].include?(tag_name.class)
+      raise TypeError, 'options must be a Hash' unless options.is_a?(Hash)
+
       @tag_name = tag_name.to_sym
       @options = options.symbolize_keys
     end
-    
+
     # Will be called from inside the helper to return the tag with the given content.
     def process(content = nil) # :nodoc:
-      if content.nil?
-        tag(@tag_name, @options)
-      else
+      if content
         content_tag(@tag_name, content, @options)
+      else
+        tag(@tag_name, @options)
       end
     end
   end
-end
+end

data/lib/it/version.rb

@@ -0,0 +1,3 @@
+module It
+  VERSION = '2.0.0'.freeze
+end

metadata

@@ -1,117 +1,169 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: it
-version: !ruby/object:Gem::Version 
-  hash: 17
-  prerelease: 
-  segments: 
-  - 0
-  - 2
-  - 3
-  version: 0.2.3
+version: !ruby/object:Gem::Version
+  version: 2.0.0
 platform: ruby
-authors: 
+authors:
 - Johannes Barre
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-12-15 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2020-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: actionpack
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 3
-        - 0
-        - 0
+      - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 23
-        segments: 
-        - 2
-        - 6
-        - 0
-        version: 2.6.0
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id002
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
-email: igel@igels.net
+email:
+- igel@igels.net
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- README.textile
-files: 
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
 - MIT-LICENSE
-- README.textile
+- README.md
 - Rakefile
-- Gemfile
+- it.gemspec
 - lib/it.rb
 - lib/it/helper.rb
-- lib/it/tag.rb
+- lib/it/interpolation.rb
 - lib/it/link.rb
+- lib/it/parser.rb
 - lib/it/plain.rb
-- spec/it/helper_spec.rb
-- spec/it/link_spec.rb
-- spec/it/tag_spec.rb
-- spec/it/plain_spec.rb
-- spec/it_spec.rb
-- spec/spec_helper.rb
+- lib/it/tag.rb
+- lib/it/version.rb
 homepage: https://github.com/igel/it
-licenses: []
-
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 23
-      segments: 
-      - 1
-      - 3
-      - 6
-      version: 1.3.6
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 3.1.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: A helper for links and other html tags in your translations
-test_files: 
-- spec/it/helper_spec.rb
-- spec/it/link_spec.rb
-- spec/it/tag_spec.rb
-- spec/it/plain_spec.rb
-- spec/it_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/README.textile

@@ -1,82 +0,0 @@
-h1. What is *it*?
-
-I18n is baked right into Rails, and it's great. But if you want to place markup or links inside your translated copies, things get a little messy. You need to specify the label of your links separately from the rest of the copy. Writing HTML in your translations is even worse.
-
-<pre><code>en:
-  copy: "If you are already registered, %{login_link}!"
-  copy_login_link: "please sign in"</code></pre>
-
-<pre><code><%=raw t("copy", login: link_to(t("copy_login_link"), login_path)) %></code></pre>
-
-Wouldn't it be much nicer and easier to understand for your translator to have the whole copy in single label? *it* lets you do that:
-
-<pre><code>en:
-  copy: "If you are already registered, %{login_link:please sign in}!"</code></pre>
-
-<pre><code><%=it "copy", login_link: login_path %></code></pre>
-
-You may have noticed in the example above, that *it* doesn't require @raw@ anymore. Of course, all HTML in the translation gets properly escaped, so you don't have to worry about XSS.
-
-h2. Installation
-
-Just add the following line to your Gemfile & run @bundle install@:
-
-<pre><code>gem 'it'</code></pre>
-
-h2. Usage
-
-You may have as many links inside your translations as you like, and normal interpolations are possible as well:
-
-<pre><code>en:
-  copy: "Did you read the %{guide:Rails I18n guide}? It has more than %{advises} useful advises. You may fork the repo at {repo:github}."</code></pre>
-
-<pre><code><%=it "copy", guide: It.link("http://guides.rubyonrails.org/i18n.html"), advices: 100, repo: It.link("https://github.com/lifo/docrails/tree/master/railties/guides") %></code></pre>
-
-As you see above, unless the interpolation name is @link@ or starts with @_link@ or ends with @_link@, you need to call @It.link@ to create a link. The advantage of @It.link@: You may specify options like you would with @link_to@:
-
-<pre><code><%=it "copy", guide: It.link("http://guides.rubyonrails.org/i18n.html", target: '_blank', class: "important") %></code></pre>
-
-You may pass any kind of object accepted by @link_to@ as the link target, so your loved named routes like @article_path(:id => article.id)@ will all work fine.
-
-Want to introduce some markup into your sentences? *it* will help you:
-
-<pre><code>en:
-  advantages: There are %{b:many advantages} for registered users!</code></pre>
-
-<pre><code><%=it "advantages", b: It.tag(:b, class: "red") %></code></pre>
-
-Even nested interpolations are possible:
-
-<pre><code>en:
-  copy: "Want to contact %{user}%? %{link:send %{b:%{user} a message}}!"</code></pre>
-
-<pre><code><%=it "copy", link: "mailto:igel@igels.net", user: 'iGEL', :b => It.tag(:b) %></code></pre>
-
-If you would like to use the same translations in your html and plain text mails, you will like the @It.plain@ method:
-<pre><code>en:
-  mail_copy: "Do you like %{link:Rails}?"</code></pre>
-
-<pre><code>HTML mail:
-<%= it "mail_copy", link: It.link("http://www.rubyonrails.org/") %>
-
-Plain mail:
-<%= it "mail_copy", link: It.plain("%s[http://www.rubyonrails.org/]") %>
-</code></pre>
-
-The @%s@ will be replaced with the label, in the example with Rails. You could provide any other string containing @%s@. The default is just @%s@, so it will return only the label itself.
-
-h2. isit18.com?
-
-Well, the specs pass on 1.8.7, but I never tried it in a real app. Report any issues on "github":https://github.com/iGEL/it/issues
-
-h2. Abandoned & outdated?
-
-Everybody hates old and outdated gems, which don't work on with the latest Rails or Ruby version or haven't been updated for ages. Sadly, rubygems is full of such gems. If you improved *it* send me a pull request. If I have not time to support the lib anymore, I will happily hand the project over to a new maintainer.
-
-h2. Broken English?
-
-I'm not a native speaker, so you'll probably find some spelling errors or clumsy sentences above. If you do, please send me a message.
-
-h2. Like it?
-
-Like it? Flattr it! !http://api.flattr.com/button/flattr-badge-large.png!:http://flattr.com/thing/351483/it-HTML-tags-for-your-translations

data/spec/it/helper_spec.rb

@@ -1,136 +0,0 @@
-# encoding: UTF-8
-
-require 'spec_helper'
-require 'it'
-
-describe It::Helper, "#it" do
-  before do
-    I18n.backend.store_translations(:en, :test1 => "I'm containing a %{link:link to Rails} in the middle.")
-    I18n.backend.store_translations(:de, :test1 => "Ich enthalte einen %{link:Link zu Rails} in der Mitte.")
-
-    @view = ActionView::Base.new
-    @controller = ActionController::Base.new
-    @view.controller = @controller
-  end
-
-  after do
-    I18n.locale = :en
-  end
-
-  it "should insert the link into the string" do
-    @view.it("test1", :link => It.link("http://www.rubyonrails.org")).should == 'I\'m containing a <a href="http://www.rubyonrails.org">link to Rails</a> in the middle.'
-  end
-
-  it "should insert the link into the German translation" do
-    I18n.locale = :de
-    @view.it("test1", :link => It.link("http://www.rubyonrails.org")).should == 'Ich enthalte einen <a href="http://www.rubyonrails.org">Link zu Rails</a> in der Mitte.'
-  end
-
-  it "should allow link options to be set" do
-    @view.it("test1", :link => It.link("http://www.rubyonrails.org", :target => "_blank")).should == 'I\'m containing a <a href="http://www.rubyonrails.org" target="_blank">link to Rails</a> in the middle.'
-  end
-
-  it "should support the plain thing" do
-    @view.it("test1", :link => It.plain("%s[http://www.rubyonrails.org]")).should == 'I\'m containing a link to Rails[http://www.rubyonrails.org] in the middle.'
-  end
-
-  it "should parse other tags as well" do
-    @view.it("test1", :link => It.tag(:b, :class => "classy")).should == 'I\'m containing a <b class="classy">link to Rails</b> in the middle.'
-  end
-
-  it "should mark the result as html safe" do
-    @view.it("test1", :link => It.link("http://www.rubyonrails.org")).html_safe?.should be_true
-  end
-
-  it "should escape all html in the translation" do
-    I18n.backend.store_translations(:en, :test2 => "<a href=\"hax0r\"> & %{link:link -> Rails} in <b>the middle</b>.")
-    @view.it("test2", :link => It.link("http://www.rubyonrails.org")).should == '&lt;a href=&quot;hax0r&quot;&gt; &amp; <a href="http://www.rubyonrails.org">link -&gt; Rails</a> in &lt;b&gt;the middle&lt;/b&gt;.'
-  end
-
-  it "should also work with 2 links" do
-    I18n.backend.store_translations(:en, :test3 => "I like %{link1:rails} and %{link2:github}.")
-    @view.it("test3", :link1 => It.link("http://www.rubyonrails.org"), :link2 => It.link("http://www.github.com")).should == 'I like <a href="http://www.rubyonrails.org">rails</a> and <a href="http://www.github.com">github</a>.'
-  end
-
-  it "should allow normal I18n interpolations" do
-    I18n.backend.store_translations(:en, :test4 => "I'm containing a %{link:link to Rails} in the %{position}.")
-    @view.it("test4", :link => It.link("http://www.rubyonrails.org"), :position => "middle").should == 'I\'m containing a <a href="http://www.rubyonrails.org">link to Rails</a> in the middle.'
-  end
-
-  it "should allow Intergers as normal interpolation" do
-    I18n.backend.store_translations(:en, :test5 => "Hello %{name}.")
-    @view.it("test5", :name => 2).should == 'Hello 2.'
-  end
-
-  it "should escape the HTML in normal interpolations" do
-    I18n.backend.store_translations(:en, :test5 => "Hello %{name}.")
-    @view.it("test5", :name => '<a href="http://evil.haxor.com">victim</a>').should == 'Hello &lt;a href=&quot;http://evil.haxor.com&quot;&gt;victim&lt;/a&gt;.'
-  end
-
-  it "should not escape html_safe interpolations" do
-    I18n.backend.store_translations(:en, :test5 => "Hello %{name}.")
-    @view.it("test5", :name => '<a href="http://www.rubyonrails.org">Rails</a>'.html_safe).should == 'Hello <a href="http://www.rubyonrails.org">Rails</a>.'
-  end
-
-  it "should allow interpolations inside of links" do
-    I18n.backend.store_translations(:en, :test6 => "Did you read our %{link:nice %{article}}?")
-    @view.it("test6", :link => It.link("/article/2"), :article => "article").should == 'Did you read our <a href="/article/2">nice article</a>?'
-  end
-
-  it "should raise a KeyError, if the key was not given" do
-    expect { @view.it("test1", :blubb => true) }.to raise_error(KeyError, "key{link} not found")
-  end
-
-  it "should raise an ArgumentError, if a String was given for an interpolation with argument" do
-    I18n.backend.store_translations(:en, :test7 => "Sign up %{asdf:here}!")
-    expect { @view.it("test7", :asdf => "Heinz") }.to raise_error(ArgumentError, "key{asdf} has an argument, so it cannot resolved with a String")
-  end
-
-  it "should allow Strings, if the interpolation name is link" do
-    I18n.backend.store_translations(:en, :test8 => "Sign up %{link:here}!")
-    @view.it("test8", :link => "/register").should == 'Sign up <a href="/register">here</a>!'
-  end
-
-  it "should allow Strings, if the interpolation name ends with _link" do
-    I18n.backend.store_translations(:en, :test8 => "Sign up %{register_link:here}!")
-    @view.it("test8", :register_link => "/register").should == 'Sign up <a href="/register">here</a>!'
-  end
-
-  it "should allow Strings, if the interpolation name starts with link_" do
-    I18n.backend.store_translations(:en, :test8 => "Sign up %{link_to_register:here}!")
-    @view.it("test8", :link_to_register => "/register").should == 'Sign up <a href="/register">here</a>!'
-  end
-
-  it "should work with tags without arguments" do
-    I18n.backend.store_translations(:en, :test9 => "We can %{br} do line breaks")
-    @view.it("test9", :br => It.tag(:br)).should == 'We can <br /> do line breaks'
-  end
-
-  it 'should support dot-prefixed keys' do
-    I18n.backend.store_translations(:en, :widgets => { :show => { :all_widgets => "See %{widgets_link:all widgets}" } })
-    @view.instance_variable_set(:"@_virtual_path", "widgets/show")
-    @view.it('.all_widgets', :widgets_link => '/widgets').should == 'See <a href="/widgets">all widgets</a>'
-  end
-
-  it 'should support the locale option' do
-    @view.it('test1', :locale => "de", :link => It.link("http://www.rubyonrails.org")).should == 'Ich enthalte einen <a href="http://www.rubyonrails.org">Link zu Rails</a> in der Mitte.'
-  end
-
-  context "With a pluralized translation" do
-    before do
-      I18n.backend.store_translations(:en, :test10 => {:zero => "You have zero messages.", :one => "You have %{link:one message}.", :other => "You have %{link:%{count} messages}."})
-    end
-
-    it 'should work with count = 0' do
-      @view.it("test10", :count => 0, :link => "/messages").should == 'You have zero messages.'
-    end
-
-    it 'should work with count = 1' do
-      @view.it("test10", :count => 1, :link => "/messages").should == 'You have <a href="/messages">one message</a>.'
-    end
-
-    it 'should work with count > 1' do
-      @view.it("test10", :count => 2, :link => "/messages").should == 'You have <a href="/messages">2 messages</a>.'
-    end
-  end
-end

data/spec/it/link_spec.rb

@@ -1,42 +0,0 @@
-# encoding: UTF-8
-
-require 'spec_helper'
-require 'it'
-
-describe It::Link, '.new' do
-  it "should accept a String as frist param" do
-    expect { It::Link.new("http://www.rubyonrails.org/") }.not_to raise_error
-  end
-  
-  it "should accept a Hash as first param" do
-    expect { It::Link.new({:controller => "articles", :action => "index"}) }.not_to raise_error
-  end
-  
-  it "should raise a TypeError if the first param is an Integer" do
-    expect { It::Link.new(1) }.to raise_error(TypeError)
-  end
-  
-  it "should accept options as a Hash" do
-    expect { It::Link.new("http://www.rubyonrails.org/", {:id => "identity", :class => "classy"}) }.not_to raise_error
-  end
-  
-  it "should raise a TypeError, if the options are a String" do
-    expect { It::Link.new("http://www.rubyonrails.org/", "classy") }.to raise_error(TypeError)
-  end
-  
-  it "should raise ArgumentError, if called with three params" do
-    expect { It::Link.new("http://www.rubyonrails.org/", {}, :blubb) }.to raise_error(ArgumentError)
-  end
-end
-
-describe It::Link, '#tag_name' do
-  it "should always return a" do
-    It::Link.new("http://www.rubyonrails.org/").tag_name.should == :a
-  end
-end
-
-describe It::Link, '#process' do
-  it "should return a link with the options set and the content as label" do
-    It::Link.new("http://www.rubyonrails.org", :target => "_blank").process("Rails").should == '<a href="http://www.rubyonrails.org" target="_blank">Rails</a>'
-  end
-end

data/spec/it/plain_spec.rb

@@ -1,30 +0,0 @@
-require 'spec_helper'
-require 'it'
-
-describe It::Plain, '.new' do
-  it "should work with no params" do
-    expect { It::Plain.new }.not_to raise_error
-  end
-  
-  it "should work with a String" do
-    expect { It::Plain.new("%s[http://www.rubyonrails.org]") }.not_to raise_error
-  end
-  
-  it "should raise ArgumentError with 2 params" do
-    expect { It::Plain.new("asdf", "asdf")}.to raise_error(ArgumentError, "wrong number of arguments (2 for 1)")
-  end
-  
-  it "should raise a TypeError, if the first param is not a String" do
-    expect { It::Plain.new(1)}.to raise_error(TypeError)
-  end
-end
-
-describe It::Plain, '#process' do
-  it "should return 'Ruby on Rails', if no param was given" do
-    It::Plain.new.process("Ruby on Rails").should == 'Ruby on Rails'
-  end
-  
-  it "should return 'Ruby on Rails[http://www.rubyonrails.org/]'" do
-    It::Plain.new("%s[http://www.rubyonrails.org/]").process("Ruby on Rails").should == 'Ruby on Rails[http://www.rubyonrails.org/]'
-  end
-end

data/spec/it/tag_spec.rb

@@ -1,68 +0,0 @@
-# encoding: UTF-8
-
-require 'spec_helper'
-require 'it'
-
-describe It::Tag, '.new' do
-  it "should work with a parameter (Symbol)" do
-    expect { It::Tag.new(:b) }.not_to raise_error
-  end
-  
-  it "should work with a paramter (String)" do
-    expect { It::Tag.new("b") }.not_to raise_error
-  end
-  
-  it "should raise TypeError if called with an Integer" do
-    expect { It::Tag.new(1) }.to raise_error(TypeError)
-  end
-  
-  it "should accept an options Hash" do
-    expect { It::Tag.new(:b, :class => "very_bold") }.not_to raise_error
-  end
-  
-  it "should raise a TypeError if called with a String" do
-    expect { It::Tag.new(:b, "very_bold") }.to raise_error(TypeError)
-  end
-  
-  it "should raise an ArgumentError if called with three params" do
-    expect { It::Tag.new(:b, {}, :blubb) }.to raise_error(ArgumentError)
-  end
-end
-
-describe It::Tag, '#tag_name' do
-  it "should return the tag as a Symbol if given as a Symbol" do
-    It::Tag.new(:i).tag_name.should == :i
-  end
-  
-  it "should return the tag_name as a Symbol if given as a String" do
-    It::Tag.new("i").tag_name.should == :i
-  end
-end
-
-describe It::Tag, '#options' do
-  it "should return the options with symbolized keys" do
-    It::Tag.new(:i, "id" => "cool", :class => "classy").options.should == {:id => "cool", :class => "classy"}
-  end
-end
-
-describe It::Tag, '#process' do
-  it "should return a tag with the options as attributes and the param as content" do
-    It::Tag.new(:i, "id" => "cool", "class" => "classy").process("some text").should == '<i class="classy" id="cool">some text</i>'
-  end
-  
-  it "should be marked as html safe" do
-    It::Tag.new(:i).process("some text").html_safe.should be_true
-  end
-  
-  it "should escape HTML" do
-    It::Tag.new(:i).process("some text & <b>html</b>").should == '<i>some text &amp; &lt;b&gt;html&lt;/b&gt;</i>'
-  end
-  
-  it "should not escape strings marked as HTML safe" do
-    It::Tag.new(:i).process("some text & <b>html</b>".html_safe).should == '<i>some text & <b>html</b></i>'
-  end
-  
-  it "should return an empty tag, if no content is provided" do
-    It::Tag.new(:br, "id" => "cool").process.should == '<br id="cool" />'
-  end
-end

data/spec/it_spec.rb

@@ -1,65 +0,0 @@
-# encoding: UTF-8
-
-require 'spec_helper'
-require 'it'
-
-describe It, '.it' do
-  it "should translate inside the controller as well" do
-    I18n.backend.store_translations(:en, :test1 => "I'm containing a %{link:link to Rails} in the middle.")
-    It.it("test1", :link => It.link("http://www.rubyonrails.org")).should == 'I\'m containing a <a href="http://www.rubyonrails.org">link to Rails</a> in the middle.'
-  end
-end
-
-describe It, '.link' do
-  it "should return an It::Link object" do
-    It.link("https://www.github.com").class.should == It::Link
-  end
-
-  it "should accept one param" do
-    expect { It.link("http://www.rubyonrails.org/") }.not_to raise_error
-  end
-
-  it "should accept two params" do
-    expect { It.link("http://www.rubyonrails.org/", {:id => "identity", :class => "classy"}) }.not_to raise_error
-  end
-
-  it "should raise ArgumentError, if called with three params" do
-    expect { It.link("http://www.rubyonrails.org/", {}, :blubb) }.to raise_error(ArgumentError)
-  end
-end
-
-describe It, '.tag' do
-  it "should return an It::Tag object" do
-    It.tag(:b).class.should == It::Tag
-  end
-
-  it "should work with a param" do
-    expect { It.tag(:b) }.not_to raise_error
-  end
-
-  it "should accept two params" do
-    expect { It.tag(:b, :class => "very_bold") }.not_to raise_error
-  end
-
-  it "should raise an ArgumentError if called with three params" do
-    expect { It.tag(:b, {}, :blubb) }.to raise_error(ArgumentError)
-  end
-end
-
-describe It, '.plain' do
-  it "should return an It::Plain object" do
-    It.plain.class.should == It::Plain
-  end
-
-  it "should work without params" do
-    expect { It.plain }.not_to raise_error
-  end
-
-  it "should accept one param" do
-    expect { It.plain("%s[http://www.rubyonrails.org/]") }.not_to raise_error
-  end
-
-  it "should raise ArgumentError, if called with two params" do
-    expect { It.plain("%s[http://www.rubyonrails.org/]", :blubb) }.to raise_error(ArgumentError)
-  end
-end

data/spec/spec_helper.rb

@@ -1,6 +0,0 @@
-require 'rspec'
-require 'action_pack'
-require 'action_controller'
-require 'action_view'
-
-$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib')