sinatra 2.0.0 → 2.2.0

data/README.ja.md

@@ -28,7 +28,10 @@ ruby myapp.rb
 
 [http://localhost:4567](http://localhost:4567) を開きます。
 
-ThinがあればSinatraはこれを利用するので、`gem install thin`することをお薦めします。
+コードを変更しても、サーバを再起動しないと変更が有効になりません。
+コードを変更するたびにサーバを再起動するか、[sinatra/reloader](http://www.sinatrarb.com/contrib/reloader)を使ってください。
+
+PumaがあればSinatraはこれを利用するので、`gem install puma`することをお薦めします。
 
 ## 目次
 
@@ -315,12 +318,12 @@ end
 Rackレスポンス、Rackボディオブジェクト、HTTPステータスコードのいずれかとして妥当なオブジェクトであればどのようなオブジェクトでも返すことができます。
 
 * 3つの要素を含む配列:
-  `[ステータス(Fixnum), ヘッダ(Hash), レスポンスボディ(#eachに応答する)]`
+  `[ステータス(Integer), ヘッダ(Hash), レスポンスボディ(#eachに応答する)]`
 * 2つの要素を含む配列:
-  `[ステータス(Fixnum), レスポンスボディ(#eachに応答する)]`
+  `[ステータス(Integer), レスポンスボディ(#eachに応答する)]`
 * `#each`に応答するオブジェクト。通常はそのまま何も返さないが、
 与えられたブロックに文字列を渡す。
-* ステータスコードを表現する整数(Fixnum)
+* ステータスコードを表現する整数(Integer)
 
 これにより、例えばストリーミングを簡単に実装することができます。
 
@@ -386,7 +389,7 @@ end
 `:public_folder`オプションを指定することで別の場所を指定することができます。
 
 ```ruby
-set :public_folder, File.dirname(__FILE__) + '/static'
+set :public_folder, __dir__ + '/static'
 ```
 
 ノート: この静的ファイル用のディレクトリ名はURL中に含まれません。
@@ -551,13 +554,14 @@ get('/') { markdown :index }
   <tr>
     <td>依存</td>
     <td>
-      <a href="http://www.kuwata-lab.com/erubis/" title="erubis">erubis</a>
+      <a href="https://github.com/jeremyevans/erubi" title="erubi">erubi</a>
+      または <a href="http://www.kuwata-lab.com/erubis/" title="erubis">erubis</a>
       または erb (Rubyに同梱)
     </td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
-    <td><tt>.erb</tt>, <tt>.rhtml</tt> or <tt>.erubis</tt> (Erubisだけ)</td>
+    <td><tt>.erb</tt>, <tt>.rhtml</tt> または <tt>.erubi</tt> (Erubiだけ) または<tt>.erubis</tt> (Erubisだけ)</td>
   </tr>
   <tr>
     <td>例</td>
@@ -610,7 +614,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://sass-lang.com/" title="sass">sass</a></td>
+    <td><a href="https://sass-lang.com/" title="sass">sass</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -627,7 +631,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://sass-lang.com/" title="sass">sass</a></td>
+    <td><a href="https://sass-lang.com/" title="sass">sass</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -661,7 +665,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://liquidmarkup.org/" title="liquid">liquid</a></td>
+    <td><a href="https://shopify.github.io/liquid/" title="liquid">liquid</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -684,8 +688,8 @@ LiquidテンプレートからRubyのメソッド(`yield`を除く)を呼び出
       次の何れか:
         <a href="https://github.com/davidfstr/rdiscount" title="RDiscount">RDiscount</a>,
         <a href="https://github.com/vmg/redcarpet" title="RedCarpet">RedCarpet</a>,
-        <a href="http://deveiate.org/projects/BlueCloth" title="BlueCloth">BlueCloth</a>,
-        <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
+        <a href="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
+        <a href="https://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
         <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>
   </tr>
@@ -746,7 +750,7 @@ erb :overview, :locals => { :text => textile(:introduction) }
 %p= textile(:greetings)
 ```
 
-TexttileからはRubyを呼ぶことができないので、Textileで書かれたレイアウトを使うことはできません。しかしながら、`:layout_engine`オプションを渡すことでテンプレートのものとは異なるレンダリングエンジンをレイアウトのために使うことができます。
+TextileからはRubyを呼ぶことができないので、Textileで書かれたレイアウトを使うことはできません。しかしながら、`:layout_engine`オプションを渡すことでテンプレートのものとは異なるレンダリングエンジンをレイアウトのために使うことができます。
 
 #### RDoc テンプレート
 
@@ -786,7 +790,7 @@ RDocからはRubyを呼ぶことができないので、RDocで書かれたレ
 <table>
  <tr>
    <td>依存</td>
-   <td><a href="http://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a></td>
+   <td><a href="https://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a></td>
  </tr>
  <tr>
    <td>ファイル拡張子</td>
@@ -824,7 +828,7 @@ RadiusテンプレートからRubyのメソッドを直接呼び出すことが
 <table>
   <tr>
     <td>依存</td>
-    <td><a href="http://markaby.github.io/" title="Markaby">Markaby</a></td>
+    <td><a href="https://markaby.github.io/" title="Markaby">Markaby</a></td>
   </tr>
   <tr>
     <td>ファイル拡張子</td>
@@ -1456,7 +1460,7 @@ get '/foo' do
   status 418
   headers \
     "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
-    "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
+    "Refresh" => "Refresh: 20; https://www.ietf.org/rfc/rfc2324.txt"
   body "I'm a tea pot!"
 end
 ```
@@ -1481,37 +1485,55 @@ end
 
 これはストリーミングAPI、[Server Sent Events](https://w3c.github.io/eventsource/)の実装を可能にし、[WebSockets](https://en.wikipedia.org/wiki/WebSocket)の土台に使うことができます。また、一部のコンテンツが遅いリソースに依存しているときに、スループットを上げるために使うこともできます。
 
-ノート: ストリーミングの挙動、特に並行リクエスト(cuncurrent requests)の数は、アプリケーションを提供するのに使われるWebサーバに強く依存します。いくつかのサーバは、ストリーミングを全くサポートしません。サーバがストリーミングをサポートしない場合、ボディは`stream`に渡されたブロックの実行が終了した後、一度に全部送られることになります。ストリーミングは、Shotgunを使った場合は全く動作しません。
+ノート: ストリーミングの挙動、特に並行リクエスト(concurrent requests)の数は、アプリケーションを提供するのに使われるWebサーバに強く依存します。いくつかのサーバは、ストリーミングを全くサポートしません。サーバがストリーミングをサポートしない場合、ボディは`stream`に渡されたブロックの実行が終了した後、一度に全部送られることになります。ストリーミングは、Shotgunを使った場合は全く動作しません。
 
-オプション引数が`keep_open`にセットされている場合、ストリームオブジェクト上で`close`は呼ばれず、実行フローの任意の遅れたタイミングでユーザがこれを閉じることを可能にします。これはThinやRainbowsのようなイベント型サーバ上でしか機能しません。他のサーバでは依然ストリームは閉じられます。
+オプション引数が`keep_open`にセットされている場合、ストリームオブジェクト上で`close`は呼ばれず、実行フローの任意の遅れたタイミングでユーザがこれを閉じることを可能にします。これはRainbowsのようなイベント型サーバ上でしか機能しません。他のサーバでは依然ストリームは閉じられます。
 
 ```ruby
-# ロングポーリング
-
-set :server, :thin
-connections = []
+# config.ru
+require 'sinatra/base'
 
-get '/subscribe' do
-  # サーバイベントにおけるクライアントの関心を登録
-  stream(:keep_open) do |out|
-    connections << out
-    # 死んでいるコネクションを排除
-    connections.reject!(&:closed?)
+class App < Sinatra::Base
+  connections = []
+
+  get '/subscribe' do
+    # register a client's interest in server events
+    # サーバイベントにおけるクライアントの関心を登録
+    stream(:keep_open) do |out|
+      connections << out
+      # 死んでいるコネクションを排除
+      connections.reject!(&:closed?)
+    end
   end
-end
 
-post '/message' do
-  connections.each do |out|
-    # クライアントへ新規メッセージ到着の通知
-    out << params['message'] << "\n"
+  post '/:message' do
+    connections.each do |out|
+      # クライアントへ新規メッセージ到着の通知
+      out << params['message'] << "\n"
 
-    # クライアントへの再接続の指示
-    out.close
+      # クライアントへの再接続の指示
+      out.close
+    end
+
+    # 肯定応答
+    "message received"
   end
+end
+
+run App
+```
 
-  # 肯定応答
-  "message received"
+```ruby
+# rainbows.conf
+Rainbows! do
+  use :EventMachine
 end
+````
+
+次のように起動します。
+
+```shell
+rainbows -c rainbows.conf
 ```
 
 クライアントはソケットに書き込もうとしている接続を閉じることも可能です。そのため、記述しようとする前に`out.closed?`をチェックすることを勧めます。
@@ -1586,7 +1608,7 @@ end
 
 ```ruby
 redirect to('/bar'), 303
-redirect 'http://www.google.com/', 'wrong place, buddy'
+redirect 'https://www.google.com/', 'wrong place, buddy'
 ```
 
 また、`redirect back`を使えば、簡単にユーザが来たページへ戻るリダイレクトを作れます。
@@ -1951,7 +1973,7 @@ end
 
 ### 攻撃防御に対する設定
 
-Sinatraは[Rack::Protection](https://github.com/sinatra/rack-protection#readme)を使用することで、アプリケーションを一般的な日和見的攻撃から守っています。これは簡単に無効化できます（が、アプリケーションに大量の一般的な脆弱性を埋め込むことになってしまいます）。
+Sinatraは[Rack::Protection](https://github.com/sinatra/sinatra/tree/master/rack-protection#readme)を使用することで、アプリケーションを一般的な日和見的攻撃から守っています。これは簡単に無効化できます（が、アプリケーションに大量の一般的な脆弱性を埋め込むことになってしまいます）。
 
 ```ruby
 disable :protection
@@ -2106,7 +2128,7 @@ set :protection, :session => true
 
   <dt>threaded</dt>
   <dd>
-    <tt>true</tt>に設定されているときは、Thinにリクエストを処理するために<tt>EventMachine.defer</tt>を使うことを通知する。
+    <tt>true</tt>に設定されているときは、サーバにリクエストを処理するために<tt>EventMachine.defer</tt>を使うことを通知する。
   </dd>
 
   <dt>views</dt>
@@ -2219,7 +2241,7 @@ Sinatraを開発環境の下で実行している場合は、特別な`not_found
 
 ## Rackミドルウェア(Rack Middleware)
 
-SinatraはRuby製Webフレームワークのミニマルな標準的インタフェースである[Rack](http://rack.github.io/)上に構築されています。アプリケーションデベロッパーにとってRackにおける最も興味深い機能は、「ミドルウェア(middleware)」をサポートしていることであり、これは、サーバとアプリケーションとの間に置かれ、HTTPリクエスト/レスポンスを監視および/または操作することで、各種の汎用的機能を提供するコンポーネントです。
+SinatraはRuby製Webフレームワークのミニマルな標準的インタフェースである[Rack](https://rack.github.io/)上に構築されています。アプリケーションデベロッパーにとってRackにおける最も興味深い機能は、「ミドルウェア(middleware)」をサポートしていることであり、これは、サーバとアプリケーションとの間に置かれ、HTTPリクエスト/レスポンスを監視および/または操作することで、各種の汎用的機能を提供するコンポーネントです。
 
 Sinatraはトップレベルの`use`メソッドを通して、Rackミドルウェアパイプラインの構築を楽にします。
 
@@ -2630,21 +2652,22 @@ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
 -p # ポート指定(デフォルトは4567)
 -o # ホスト指定(デフォルトは0.0.0.0)
 -e # 環境を指定 (デフォルトはdevelopment)
--s # rackserver/handlerを指定 (デフォルトはthin)
+-s # rackserver/handlerを指定 (デフォルトはpuma)
 -x # mutex lockを付ける (デフォルトはoff)
 ```
 
 ### マルチスレッド
 
-_この[StackOverflow][so-answer]でのKonstantinによる回答を言い換えています。_
+_この[StackOverflow](https://stackoverflow.com/a/6282999/5245129)
+のKonstantinによる回答を言い換えています。_
 
-Sinatraでは同時実行モデルを負わせることはできませんが、根本的な部分であるThinやPuma、WebrickのようなRackハンドラ(サーバー)部分に委ねることができます。
+Sinatraでは同時実行モデルを負わせることはできませんが、根本的な部分であるやPuma、WEBrickのようなRackハンドラ(サーバー)部分に委ねることができます。
 Sinatra自身はスレッドセーフであり、もしRackハンドラが同時実行モデルのスレッドを使用していても問題はありません。
 つまり、これはサーバーを起動させる時、特定のRackハンドラに対して正しい起動処理を特定することが出来ます。
-この例はThinサーバーをマルチスレッドで起動する方法のデモです。
+この例はRainbowsサーバーをマルチスレッドで起動する方法のデモです。
 
 ```ruby
-# app.rb
+# config.ru
 
 require 'sinatra/base'
 
@@ -2654,16 +2677,23 @@ class App < Sinatra::Base
   end
 end
 
-App.run!
+run App
 ```
 
-サーバーを開始するコマンドです。
+```ruby
+# rainbows.conf
 
+# RainbowsのコンフィギュレータはUnicornのものをベースにしています。
+Rainbows! do
+  use :ThreadSpawn
+end
 ```
-thin --threaded start
-```
 
-[so-answer]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
+次のようなコマンドでサーバを起動します。
+
+```
+rainbows -c rainbows.conf
+```
 
 ## 必要環境
 
@@ -2734,7 +2764,7 @@ gem install sinatra --pre
 
 ### Bundlerを使う場合
 
-最新のSinatraでアプリケーションを動作させたい場合には、[Bundler](http://bundler.io)を使うのがお薦めのやり方です。
+最新のSinatraでアプリケーションを動作させたい場合には、[Bundler](https://bundler.io)を使うのがお薦めのやり方です。
 
 まず、Bundlerがなければそれをインストールします。
 
@@ -2797,7 +2827,7 @@ sudo rake install
 
 ## バージョニング(Versioning)
 
-Sinatraは、[Semantic Versioning](http://semver.org/)におけるSemVerおよびSemVerTagの両方に準拠しています。
+Sinatraは、[Semantic Versioning](https://semver.org/)におけるSemVerおよびSemVerTagの両方に準拠しています。
 
 ## 参考文献
 
@@ -2805,7 +2835,7 @@ Sinatraは、[Semantic Versioning](http://semver.org/)におけるSemVerおよ
 * [プロジェクトに参加(貢献)する](http://www.sinatrarb.com/contributing.html) - バグレポート パッチの送信、サポートなど
 * [Issue tracker](https://github.com/sinatra/sinatra/issues)
 * [Twitter](https://twitter.com/sinatra)
-* [メーリングリスト](http://groups.google.com/group/sinatrarb/topics)
+* [メーリングリスト](https://groups.google.com/group/sinatrarb/topics)
 * http://freenode.net上のIRC: [#sinatra](irc://chat.freenode.net/#sinatra)
 * [Sinatra Book](https://github.com/sinatra/sinatra-book/) クックブック、チュートリアル
 * [Sinatra Recipes](http://recipes.sinatrarb.com/) コミュニティによるレシピ集

data/README.ko.md

@@ -315,10 +315,10 @@ end
 
 유효한 Rack 응답, Rack 본문 객체 또는 HTTP 상태 코드가 되는 어떠한 객체라도 반환할 수 있습니다.
 
-* 세 요소를 가진 배열: `[상태 (Fixnum), 헤더 (Hash), 응답 본문 (#each에 반응)]`
-* 두 요소를 가진 배열: `[상태 (Fixnum), 응답 본문 (#each에 반응)]`
+* 세 요소를 가진 배열: `[상태 (Integer), 헤더 (Hash), 응답 본문 (#each에 반응)]`
+* 두 요소를 가진 배열: `[상태 (Integer), 응답 본문 (#each에 반응)]`
 * `#each`에 반응하고 주어진 블록으로 문자열만을 전달하는 객체
-* 상태 코드를 의미하는 Fixnum
+* 상태 코드를 의미하는 Integer
 
 이것을 이용한 예를 들자면, 스트리밍(streaming) 예제를 쉽게 구현할 수 있습니다.
 
@@ -385,7 +385,7 @@ end
 변경하려면 `:public_folder` 옵션을 지정하면 됩니다.
 
 ```ruby
-set :public_folder, File.dirname(__FILE__) + '/static'
+set :public_folder, __dir__ + '/static'
 ```
 
 public 디렉터리명은 URL에 포함되지 않는다는 점에 주의하세요.
@@ -653,7 +653,7 @@ get('/') { markdown :index }
 <table>
   <tr>
     <td>의존성</td>
-    <td><a href="http://liquidmarkup.org/">liquid</a></td>
+    <td><a href="https://shopify.github.io/liquid/">liquid</a></td>
   </tr>
   <tr>
     <td>파일 확장자</td>
@@ -676,7 +676,7 @@ Liquid 템플릿에서는 루비 메서드(`yield` 제외)를 호출할 수 없
     <td>
       <a href="https://github.com/davidfstr/rdiscount" title="RDiscount">RDiscount</a>,
       <a href="https://github.com/vmg/redcarpet" title="RedCarpet">RedCarpet</a>,
-      <a href="http://deveiate.org/projects/BlueCloth" title="BlueCloth">BlueCloth</a>,
+      <a href="https://github.com/ged/bluecloth" title="bluecloth">BlueCloth</a>,
       <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
       <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
       중 아무거나
@@ -2023,7 +2023,7 @@ end
 
 ### 공격 방어 설정하기(Configuring attack protection)
 
-Sinatra는 [Rack::Protection](https://github.com/sinatra/rack-protection#readme)을 사용하여
+Sinatra는 [Rack::Protection](https://github.com/sinatra/sinatra/tree/master/rack-protection#readme)을 사용하여
 일반적이고 일어날 수 있는 공격에 대비합니다. 이 모듈은 간단하게 비활성시킬 수 있습니다.
 (하지만 애플리케이션에 엄청나게 많은 취약성을 야기합니다.)