super-pro-kit 0.0.1

data/slim-5.2.1/Rakefile

@@ -0,0 +1,80 @@
+begin
+  require 'bundler/setup'
+  Bundler::GemHelper.install_tasks
+rescue Exception
+end
+
+require 'rake/testtask'
+
+task 'test' => %w(test:core test:literate test:logic_less test:translator test:smart test:include)
+
+namespace 'test' do
+  Rake::TestTask.new('core') do |t|
+    t.libs << 'lib' << 'test/core'
+    t.test_files = FileList['test/core/test_*.rb']
+    t.warning = true
+    #t.ruby_opts << '-w' << '-v'
+  end
+
+  Rake::TestTask.new('literate') do |t|
+    t.libs << 'lib' << 'test/literate'
+    t.test_files = FileList['test/literate/run.rb']
+    t.warning = true
+  end
+
+  Rake::TestTask.new('logic_less') do |t|
+    t.libs << 'lib' << 'test/core'
+    t.test_files = FileList['test/logic_less/test_*.rb']
+    t.warning = true
+  end
+
+  Rake::TestTask.new('translator') do |t|
+    t.libs << 'lib' << 'test/core'
+    t.test_files = FileList['test/translator/test_*.rb']
+    t.warning = true
+  end
+
+  Rake::TestTask.new('smart') do |t|
+    t.libs << 'lib' << 'test/core'
+    t.test_files = FileList['test/smart/test_*.rb']
+    t.warning = true
+  end
+
+  Rake::TestTask.new('include') do |t|
+    t.libs << 'lib' << 'test/core'
+    t.test_files = FileList['test/include/test_*.rb']
+    t.warning = true
+  end
+
+  Rake::TestTask.new('rails') do |t|
+    t.libs << 'lib'
+    t.test_files = FileList['test/rails/test/test_*.rb']
+    t.warning = true
+  end
+
+  Rake::TestTask.new('sinatra') do |t|
+    t.libs << 'lib'
+    t.test_files = FileList['test/sinatra/test_*.rb']
+
+    # Copied from test task in Sinatra project to mimic their approach
+    t.ruby_opts = ['-r rubygems'] if defined? Gem
+    t.ruby_opts << '-I.'
+    t.warning = true
+  end
+end
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new do |t|
+    t.files = %w(lib/**/*.rb)
+  end
+rescue LoadError
+  task :yard do
+    abort 'YARD is not available. In order to run yard, you must: gem install yard'
+  end
+end
+
+desc 'Generate Documentation'
+task doc: :yard
+
+task default: 'test'

data/slim-5.2.1/bin/slimrb

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'slim/command'
+
+Slim::Command.new(ARGV).run

data/slim-5.2.1/doc/include.md

@@ -0,0 +1,20 @@
+# Include
+
+The include plugin allows Slim templates to include other files. The .slim extension is appended automatically to the
+filename. If the included file is not a Slim file, it is interpreted as a text file with `#{interpolation}`.
+
+Example:
+
+    include partial.slim
+    include partial
+    include partial.txt
+
+Enable the include plugin with
+
+    require 'slim/include'
+
+# Options
+
+| Type | Name | Default | Purpose |
+| ---- | ---- | ------- | ------- |
+| Array | :include_dirs | [Dir.pwd, '.'] | Directories where to look for the files |

data/slim-5.2.1/doc/jp/include.md

@@ -0,0 +1,20 @@
+# インクルード
+
+インクルードプラグインを使うことで, Slim テンプレートに他の Slim ファイルを読み込むことができます。.slim 拡張子はファイル名に自動的に付加されます。
+読み込まれたファイルが Slim でない場合は `#{文字列展開}` を含んだテキストファイルとして扱われます。
+
+例:
+
+    include partial.slim
+    include partial
+    include partial.txt
+
+インクルードプラグインを有効化
+
+    require 'slim/include'
+
+# オプション
+
+| タイプ | 名前 | デフォルト値 | 目的 |
+| ------ | ---- | ------------ | ---- |
+| Array | :include_dirs | [Dir.pwd, '.'] | ファイルを検索するディレクトリ |

data/slim-5.2.1/doc/jp/logic_less.md

@@ -0,0 +1,137 @@
+# ロジックレスモード
+
+ロジックレスモードは [Mustache](https://github.com/defunkt/mustache) にインスパイアされています。ロジックレスモードは
+例えば動的コンテンツを含む再帰的ハッシュツリーのような辞書オブジェクトを使います。
+
+## 条件付き
+
+オブジェクトが false または empty? ではない場合, コンテンツが表示されます。
+
+    - article
+      h1 = title
+
+## 反転条件付き
+
+オブジェクトが false または empty? の場合, コンテンツが表示されます。
+
+    -! article
+      p Sorry, article not found
+
+## 繰り返し
+
+オブジェクトが配列の場合, この部分は繰り返されます。
+
+    - articles
+      tr: td = title
+
+## ラムダ式
+
+Mustache のように, Slim はラムダ式をサポートします。
+
+    = person
+      = name
+
+ラムダ式は次のように定義できます:
+
+    def lambda_method
+      "<div class='person'>#{yield(name: 'Andrew')}</div>"
+    end
+
+任意に 1 つ以上のハッシュを `yield` に渡すことができます。複数のハッシュを渡した場合, 先述したようにブロックが繰り返されます。
+
+## 辞書アクセス
+
+サンプルコード:
+
+    - article
+      h1 = title
+
+辞書オブジェクトは `:dictionary_access` オプションによって設定された順序でアクセスされます。デフォルトの順序:
+
+1. `シンボル` - `article.respond_to?(:has_key?)` 且つ `article.has_key?(:title)` の場合, Slim は `article[:title]` を実行します。
+2. `文字列` - `article.respond_to?(:has_key?)` 且つ `article.has_key?('title')` の場合, Slim は `article['title']` を実行します。
+3. `メソッド` - `article.respond_to?(:title)` の場合, Slim は `article.send(:title)` を実行します。
+4. `インスタンス変数` - `article.instance_variable_defined?(@title)` の場合, Slim は `article.instance_variable_get @title` を実行します。
+
+すべて失敗した場合, Slim は親オブジェクトに対して同じ順序で title の参照を解決しようとします。この例では, 親オブジェクトはレンダリングしているテンプレートに対する辞書オブジェクトになります。
+
+ご想像のとおり, article への参照は辞書オブジェクトに対して同じ手順で行われます。インスタンス変数はビューのコードでは利用を許されていませんが, Slim はそれを見つけて使います。基本的には, テンプレートの中で @ プレフィックスを落として使っています。パラメータ付きメソッドの呼び出しは許可されません。
+
+
+## 文字列
+
+`self` キーワードは検討中の要素を `.to_s` した値を返します。
+
+辞書オブジェクトを与え,
+
+    {
+      article: [
+        'Article 1',
+        'Article 2'
+      ]
+    }
+
+ビューで次のように
+
+    - article
+      tr: td = self
+
+これは次のようになります。
+
+    <tr>
+      <td>Article 1</td>
+    </>
+    <tr>
+      <td>Article 2</td>
+    </tr>
+
+
+## Rails でロジックレスモード
+
+インストール:
+
+    $ gem install slim
+
+require で指定:
+
+    gem 'slim', require: 'slim/logic_less'
+
+特定のアクションでのみロジックレスモードを有効化したい場合, まず設定でロジックレスモードを global に無効化します。
+
+    Slim::Engine.set_options logic_less: false
+
+さらに, アクションの中でレンダリングする度にロジックレスモードを有効化します。
+
+    class Controller
+      def action
+        Slim::Engine.with_options(logic_less: true) do
+          render
+        end
+      end
+    end
+
+## Sinatra でロジックレスモード
+
+Sinatra には Slim のビルトインサポートがあります。しなければならないのはロジックレス Slim プラグインを require することです。config.ru で require できます:
+
+    require 'slim/logic_less'
+
+これで準備は整いました!
+
+特定のアクションでのみロジックレスモードを有効化したい場合, まず設定でロジックレスモードを global に無効化します。
+
+    Slim::Engine.set_options logic_less: false
+
+さらに, アクションの中でレンダリングする度にロジックレスモードを有効化します。
+
+    get '/page'
+      slim :page, logic_less: true
+    end
+
+## オプション
+
+| 種類 | 名前 | デフォルト | 用途 |
+| ---- | ---- | ------- | ------- |
+| 真偽値 | :logic_less | true | ロジックレスモードを有効化 ('slim/logic_less' の required が必要) |
+| 文字列 | :dictionary | "self" | 変数が検索される辞書への参照 |
+| シンボル/配列&lt;シンボル&gt; | :dictionary_access | [:symbol, :string, :method, :instance_variable] | 辞書のアクセス順序 (:symbol, :string, :method, :instance_variable) |

data/slim-5.2.1/doc/jp/smart.md

@@ -0,0 +1,102 @@
+# スマートテキスト
+
+テキストとマークアップを組み合わせる最も簡単な方法は <a name="smarttext">スマートテキストモード</a> を使うことです。
+
+スマートテキストプラグインを有効化します。
+
+    require 'slim/smart'
+
+自動的に `:implicit_text` オプションが有効になることで,
+次のように簡単にテキストを入力できるようになります:
+
+    p
+      This is text.
+
+小文字のタグ名や暗黙的なテキスト行などの特殊文字で始まっていない行を
+Slim に自動的に処理させることができます。
+テキストが複数行にわたる場合, 単にそれらをインデントします。
+
+    p
+      This is text,
+        and it spans
+        several lines.
+
+`>` を使って明示的にテキストをマークすることもできます。
+例えば, 小文字や特殊文字で始まっている場合,
+テキストが複数行にわたる場合,
+単に見た目の一貫性のために,
+タグ名に大文字を使いたい場合,
+`:implicit_text` オプションを無効にしたままにする必要がある場合です。
+
+    p
+      > 'This is text, too.'
+    p
+      >
+        This is text
+        which spans
+        several lines.
+
+`:smart_text_escaping` が有効化されている限り,
+エスケープされるべきテキストは自動的にエスケープされます。
+しかし, 不便にならないように検出された HTML エンティティはそのまま使われます。
+この方法はいつでも HTML のエスケープを気にすることのない,
+最も理想的な方法です。
+
+    h1 Questions & Answers
+    footer
+      Copyright &copy; #{Time.now.year}
+
+スマートテキストの素晴らしいところの 1 つはマークアップとよくミックスしているところです。
+スマートテキストの行は通常改行を維持するので,
+強調やリンクのような他のタグを簡単に混ぜ合わせて使うことができます:
+
+    p
+      Your credit card
+      strong will not
+      > be charged now.
+    p
+      Check
+      a href=r(:faq) our FAQ
+      > for more info.
+
+(タグから小文字のテキストを区別する場合明示的なテキストを示すインジケーター `>` の使用には注意してください)。
+
+インラインタグのまわりにスペースを入れたくない場合があります。
+幸いなことにスマートテキストはこの一般的なケースを処理できます。
+スマートテキストのブロックが `:smart_text_begin_chars` で指定 (デフォルトは `,.;:!?)]}`)
+された文字で始まる場合には先頭の改行が行われません。
+同様に, スマートテキストのブロックが `:smart_text_begin_chars` で指定 (デフォルトは `,.;:!?)]}`)
+された文字で終わる場合には改行されません。
+これによって通常のテキストとリンクや span タグを混在させることがとても容易になります:
+
+    p
+      Please proceed to
+      a href="/" our homepage
+      .
+    p
+      Status: failed (
+      a href="#1" details
+      ).
+
+スマートテキストはタグのショートカットをも把握しているので,
+次のような場合にも正しく対応します:
+
+    .class
+      #id
+        #{'More'}
+        i text
+        ...
+
+当然のことながら, これは短いテキストのスニペットでより便利に作業できることを意味しています。
+ほとんどがテキストのコンテンツの場合, Markdown や Textile のような
+ビルトインの埋め込みエンジンを使う方が良いでしょう。
+
+## オプション
+
+| 種類 | 名前 | デフォルト | 用途 |
+| ---- | ---- | ---------- | ---- |
+| 真偽値 | :implicit_text | true | 暗黙的テキストの判別を有効化 |
+| 真偽値 | :smart_text | true | スマートテキストによる処理を有効化 |
+| 文字列 | :smart_text_begin_chars | ',.;:!?)]}' | スマートテキストで先頭の改行を抑制する文字 |
+| 文字列 | :smart_text_end_chars | '([{' | スマートテキストで末尾の改行を抑制する文字 |
+| 真偽値 | :smart_text_escaping | true | 設定すると, スマートテキスト中のエスケープが必要な HTML 文字は自動的にエスケープされる |

data/slim-5.2.1/doc/jp/translator.md

@@ -0,0 +1,28 @@
+# 翻訳/I18n
+
+翻訳プラグインは Gettext, Fast-Gettext または Rails I18n を使ったテンプレートの自動翻訳機能を提供します。
+テンプレート内の静的テキストを翻訳版に変換します。
+
+例:
+
+    h1 Welcome to #{url}!
+
+Gettext は文字列を英語からドイツ語に変換し, 文字列が展開される部分は %1, %2, ... の順に変換されます。
+
+    "Welcome to %1!" -> "Willkommen auf %1!"
+
+次のようにレンダリングされます。
+
+    <h1>Willkommen auf github.com/slim-template/slim!</h1>
+
+翻訳プラグインを有効化します。
+
+    require 'slim/translator'
+
+# オプション
+
+| 種類 | 名前 | デフォルト | 用途 |
+| ---- | ---- | ---------- | ---- |
+| 真偽値   | :tr      | true     | 翻訳の有効化 ('slim/translator' の required が必要) |
+| シンボル | :tr_mode | :dynamic | 翻訳を :static = コンパイル時に実施, :dynamic = ランタイムで実施 |
+| 文字列   | :tr_fn   | インストールされた翻訳ライブラリに依存 | 翻訳用ヘルパ, gettext の場合 '_' |

data/slim-5.2.1/doc/logic_less.md

@@ -0,0 +1,137 @@
+# Logic less mode
+
+Logic less mode is inspired by [Mustache](https://github.com/defunkt/mustache). Logic less mode uses a dictionary object
+e.g. a recursive hash tree which contains the dynamic content.
+
+## Conditional
+
+If the object is not false or empty?, the content will show
+
+    - article
+      h1 = title
+
+## Inverted conditional
+
+If the object is false or empty?, the content will show
+
+    -! article
+      p Sorry, article not found
+
+## Iteration
+
+If the object is an array, the section will iterate
+
+    - articles
+      tr: td = title
+
+## Lambdas
+
+Like mustache, Slim supports lambdas.
+
+    = person
+      = name
+
+The lambda method could be defined like this
+
+    def lambda_method
+      "<div class='person'>#{yield(name: 'Andrew')}</div>"
+    end
+
+You can optionally pass one or more hashes to `yield`. If you pass multiple hashes, the block will be iterated as described above.
+
+## Dictionary access
+
+Example code:
+
+    - article
+      h1 = title
+
+The dictionary object is accessed in the order given by the `:dictionary_access`. Default order:
+
+1. `:symbol` - If `article.respond_to?(:has_key?)` and `article.has_key?(:title)`, Slim will execute `article[:title]`
+2. `:string` - If `article.respond_to?(:has_key?)` and `article.has_key?('title')`, Slim will execute `article['title']`
+3. `:method` - If `article.respond_to?(:title)`, Slim will execute `article.send(:title)`
+4. `:instance_variable` - If `article.instance_variable_defined?(@title)`, Slim will execute `article.instance_variable_get @title`
+
+If all the above fails, Slim will try to resolve the title reference in the same order against the parent object. In this example, the parent would be the dictionary object you are rendering the template against.
+
+As you might have guessed, the article reference goes through the same steps against the dictionary. Instance variables are not allowed in the view code, but Slim will find and use them. Essentially, you're just dropping the @ prefix in your template. Parameterized method calls are not allowed.
+
+
+## Strings
+
+The `self` keyword will return the `.to_s` value for the element under consideration.
+
+Given
+
+    {
+      article: [
+        'Article 1',
+        'Article 2'
+      ]
+    }
+
+And
+
+    - article
+      tr: td = self
+
+This will yield
+
+    <tr>
+      <td>Article 1</td>
+    </tr>
+    <tr>
+      <td>Article 2</td>
+    </tr>
+
+
+## Logic less in Rails
+
+Install:
+
+    $ gem install slim
+
+Require:
+
+    gem 'slim', require: 'slim/logic_less'
+
+You might want to activate logic less mode only for a few actions, you should disable logic-less mode globally at first in the configuration
+
+    Slim::Engine.set_options logic_less: false
+
+and activate logic less mode per render call in your action
+
+    class Controller
+      def action
+        Slim::Engine.with_options(logic_less: true) do
+          render
+        end
+      end
+    end
+
+## Logic less in Sinatra
+
+Sinatra has built-in support for Slim. All you have to do is require the logic less Slim plugin. This can be done in your config.ru:
+
+    require 'slim/logic_less'
+
+You are then ready to rock!
+
+You might want to activate logic less mode only for a few actions, you should disable logic-less mode globally at first in the configuration
+
+    Slim::Engine.set_options logic_less: false
+
+and activate logic less mode per render call in your application
+
+    get '/page'
+      slim :page, logic_less: true
+    end
+
+## Options
+
+| Type | Name | Default | Purpose |
+| ---- | ---- | ------- | ------- |
+| Boolean | :logic_less | true | Enable logic less mode (Enabled if 'slim/logic_less' is required) |
+| String | :dictionary | "self" | Dictionary where variables are looked up |
+| Symbol/Array&lt;Symbol&gt; | :dictionary_access | [:symbol, :string, :method, :instance_variable] | Dictionary access order (:symbol, :string, :method, :instance_variable) |

data/slim-5.2.1/doc/smart.md

@@ -0,0 +1,120 @@
+# Smart text
+
+The <a name="smarttext">smart text plugin</a> was created to simplify the typing and combining of text and markup in Slim templates.
+Using the plugin gives you:
+
+* More convenient ways to type text in Slim templates.
+* Smarter and more consistent HTML escaping of typed text.
+* Easier combining of the text with inline HTML tags with smart handling of whitespace on the boundaries.
+
+To get started, enable the smart text plugin with
+
+    require 'slim/smart'
+
+First of all, this automatically enables the `:implicit_text` option.
+When enabled, Slim will treat any line which doesn't start
+with a lowercase tag name or any of the special characters as an implicit text line.
+If the text needs to span several lines, indent them as usual.
+
+This allows you to easily type text like this, without any leading indicator:
+
+    This is an implicit text.
+    This is a text
+      which spans
+      several lines.
+    This is yet another text.
+
+This works in addition to ways already available in stock Slim:
+
+    p This is an inline text.
+    p This is an inline text
+      which spans multiple lines.
+    | This is a verbatim text.
+    | This is a verbatim text
+      which spans multiple lines.
+    <p>This is in fact a verbatim text as well.</p>
+
+You can also mark the text explicitly with a leading `>`.
+This is used for example when the text starts with a lowercase letter or an unusual character,
+or merely for aesthetic consistency when it spans several lines.
+It may be also needed if you want to use uppercase tag names
+and therefore need to keep the `:implicit_text` option disabled.
+
+    > This is an explicit text.
+    > This is an explicit text
+      which spans
+      several lines.
+    > 'This is a text, too.'
+
+    > This is another way
+    > of typing text which spans
+    > several lines, if you prefer that.
+
+BTW, all these examples can be pasted to `slimrb -r slim/smart` to see how the generated output looks like.
+
+The plugin also improves upon Slim's automatic HTML escaping.
+As long as you leave the `:smart_text_escaping` enabled,
+any non-verbatim text (i.e., any implicit, explicit, and inline text) is automatically escaped for you.
+However, for your convenience, any HTML entities detected are still used verbatim.
+This way you are most likely to get what you really wanted,
+without having to worry about HTML escaping all the time.
+
+    h1 Questions & Answers
+    footer
+      Copyright &copy; #{Time.now.year}
+
+Another cool thing about the plugin is that it makes text mix fairly well with markup.
+The text lines are made to preserve newlines as needed,
+so it is easy to mix them with other tags, like emphasis or links:
+
+    p
+      Your credit card
+      strong will not
+      > be charged now.
+    p
+      Check
+      a href='/faq' our FAQ
+      > for more info.
+
+(Note the use of the explicit text indicator `>` to distinguish lowercase text from tags).
+
+However, sometimes you do not want any whitespace around the inline tag at all.
+Fortunately the plugin takes care of the most common cases for you as well.
+The newline before the tag is suppressed if the preceding line ends
+with a character from the `:smart_text_end_chars` set (`([{` by default).
+Similarly, the newline after the tag is suppressed if the following line begins
+with a character from the `:smart_text_begin_chars` set (`,.;:!?)]}` by default).
+This makes it quite easy to naturally mix normal text with links or spans like this:
+
+    p
+      Please proceed to
+      a href="/" our homepage
+      .
+    p
+      Status: failed (
+      a href="#1" see details
+      ).
+
+Note that the plugin is smart enough to know about tag shortcuts, too,
+so it will correctly deal even with cases like this:
+
+    .class
+      #id
+        #{'More'}
+        i text
+        ...
+
+And that's it.
+Of course, all this is meant only to make working with short text snippets more convenient.
+For bulk text content, you are more than welcome to use one of the builtin embedded engines,
+such as Markdown or Textile.
+
+## Options
+
+| Type | Name | Default | Purpose |
+| ---- | ---- | ------- | ------- |
+| Boolean | :implicit_text | true | Enable implicit text recognition |
+| Boolean | :smart_text | true | Enable smart text mode newline processing |
+| String | :smart_text_begin_chars | ',.;:!?)]}' | Characters suppressing leading newline in smart text |
+| String | :smart_text_end_chars | '([{' | Characters suppressing trailing newline in smart text |
+| Boolean | :smart_text_escaping | true | When set, HTML characters which need escaping are automatically escaped in smart text |

data/slim-5.2.1/doc/translator.md

@@ -0,0 +1,28 @@
+# Translator/I18n
+
+The translator plugin provides automatic translation of the templates using Gettext, Fast-Gettext or Rails I18n. Static text
+in the template is replaced by the translated version.
+
+Example:
+
+    h1 Welcome to #{url}!
+
+Gettext translates the string from english to german where interpolations are replaced by %1, %2, ...
+
+    "Welcome to %1!" -> "Willkommen auf %1!"
+
+and renders as
+
+    <h1>Willkommen auf github.com/slim-template/slim!</h1>
+
+Enable the translator plugin with
+
+    require 'slim/translator'
+
+# Options
+
+| Type | Name | Default | Purpose |
+| ---- | ---- | ------- | ------- |
+| Boolean | :tr | true | Enable translator (Enabled if 'slim/translator' is required) |
+| Symbol | :tr_mode | :dynamic | When to translate: :static = at compile time, :dynamic = at runtime |
+| String | :tr_fn | Depending on installed translation library | Translation function, could be '_' for gettext |