it 0.0.1.planned → 0.2.0

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+
+group :development, :test do
+  gem 'actionpack'
+  gem 'rspec-rails'
+end

data/README.textile

@@ -1,12 +1,69 @@
-h1. What is @it@ going to be?
+h1. What is *it*?
 
-@it@ will be the rewrite of my gem "i18n_link":https://github.com/iGEL/i18n_link, but it will support all kinds of HTML tags. It will have a cleaner DSL.
+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.
 
-Here an example, how I think it'll work:
+<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: "Did you read the %{guide:Rails I18n guide}? It has %{strong:more than %{advises} useful advises}.</code></pre>
+  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>
+
+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.
 
-<pre><code><%=it "copy", guide: It.link("http://guides.rubyonrails.org/i18n.html", target: "_blank"), strong: It.tag(:strong), advices: 100 %></code></pre>
+h2. Like it?
 
-Interpolations named @link@, starting with @link_@ or ending with @_link@ will be converted to links, if the argument is a link or Hash.
+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/Rakefile

@@ -0,0 +1,5 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/it.rb

@@ -0,0 +1,28 @@
+require 'it/tag'
+require 'it/link'
+require 'it/helper'
+
+ActiveSupport.on_load(:action_view) do
+  include It::Helper
+end
+
+# Namespace of the gem.
+module It
+  # 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.
+  # * +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)
+  end
+  
+  # Creates a new tag to be used in +it+.
+  # 
+  # * +tag_name+: The name of the tag as a Symbol or String.
+  # * +options+: The options will become attributes on the tag. <em>(optional)</em>
+  def self.tag(tag_name, options = {})
+    It::Tag.new(tag_name, options)
+  end
+end

data/lib/it/helper.rb

@@ -0,0 +1,83 @@
+# encoding: UTF-8
+
+module It
+  # The helper will be available in the views.
+  module Helper
+    # This helper method works just like +t+ (or +translate+ for long), but it allows to insert tags like links 
+    # or spans in the result. The content of these tags can be written in line with the rest of the translation.
+    # Unless you need this functionality, use the normal +t+ method, which is faster.
+    # 
+    # Like for normal translations, you specify interpolations with <code>%{</code> at the beginning and with
+    # <code>}</code> at the end. The new element is the <code>:</code>, which separates the name from the argument
+    # of this interpolation.
+    # 
+    #   # translation: "Already signed up? %{login_link:Sign in}!"
+    #   
+    #   <%=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.
+    # 
+    #   # translation: "Already signed up? %{login_link:Sign in}!"
+    #   
+    #   <%=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.
+    # 
+    #   # translation: "The top contributor of %{wiki_link:our wiki} is currently %{user_link:%{b:%{name}}}. Thanks a lot, %{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"))
+    # 
+    # 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. Also, it's not possible by default to use this helper from inside your controllers. Eighter
+    # you google how to use helpers inside your controllers or you push only the arguments for +it+ into the flash and parse
+    # it once you parse the flash in the view:
+    # 
+    #   # Controller:
+    #   flash[:message] = ["articles.update.success", {:article_link => It.link(article_path(article))}]
+    # 
+    #   # View (or layout)
+    #   <% if flash[:message].is_a?(Array) %>
+    #     <%= it(flash[:message].first, flash[:message].last) %>
+    #   <% else %>
+    #     <%= flash[:message] %>
+    #   <% end %>
+    # 
+    def it(identifier, options = {})
+      options.stringify_keys!
+      # We want the escaped String, not an ActiveSupport::SafeBuffer
+      translation = String.new(h(t(identifier)))
+      
+      # For deep nesting, we repeat the process until we have not 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(raw label)
+          elsif options[token].is_a?(It::Tag) # Empty tag
+            options[token].process
+          else # Normal interpolations, as I18n.t would do it.
+            h(options[token])
+          end
+        end
+      end
+      
+      raw translation
+    end
+  end
+end

data/lib/it/link.rb

@@ -0,0 +1,18 @@
+module It
+  # A class for links
+  class Link < Tag
+    include ActionView::Helpers::UrlHelper
+    
+    # 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)
+      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)
+    end
+  end
+end

data/lib/it/tag.rb

@@ -0,0 +1,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)
+      @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
+        content_tag(@tag_name, content, @options)
+      end
+    end
+  end
+end

data/spec/it/helper_spec.rb

@@ -0,0 +1,104 @@
+# 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 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
+end

data/spec/it/link_spec.rb

@@ -0,0 +1,42 @@
+# 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/tag_spec.rb

@@ -0,0 +1,68 @@
+# 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

@@ -0,0 +1,40 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+require 'it'
+
+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.new("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

data/spec/spec_helper.rb

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

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification 
 name: it
 version: !ruby/object:Gem::Version 
-  prerelease: 6
-  version: 0.0.1.planned
+  prerelease: 
+  version: 0.2.0
 platform: ruby
 authors: 
 - Johannes Barre
@@ -10,9 +10,30 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-19 00:00:00 Z
-dependencies: []
-
+date: 2011-07-23 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: actionpack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 3.0.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.6.0
+  type: :development
+  version_requirements: *id002
 description: 
 email: igel@igels.net
 executables: []
@@ -24,7 +45,18 @@ extra_rdoc_files:
 files: 
 - MIT-LICENSE
 - README.textile
-homepage: http://github.com/igel/it
+- Rakefile
+- Gemfile
+- lib/it.rb
+- lib/it/helper.rb
+- lib/it/tag.rb
+- lib/it/link.rb
+- spec/it/helper_spec.rb
+- spec/it/link_spec.rb
+- spec/it/tag_spec.rb
+- spec/it_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/igel/it
 licenses: []
 
 post_install_message: 
@@ -43,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: "0"
+      version: 1.3.6
 requirements: []
 
 rubyforge_project: 
@@ -51,5 +83,9 @@ rubygems_version: 1.8.5
 signing_key: 
 specification_version: 3
 summary: A helper for links and other html tags in your translations
-test_files: []
-
+test_files: 
+- spec/it/helper_spec.rb
+- spec/it/link_spec.rb
+- spec/it/tag_spec.rb
+- spec/it_spec.rb
+- spec/spec_helper.rb