sinatra 1.4.5 → 1.4.6

data/README.pt-pt.md

@@ -57,8 +57,8 @@ hash `params`:
 ``` ruby
 get '/ola/:nome' do
   # corresponde a "GET /ola/foo" e "GET /ola/bar"
-  # params[:nome] é 'foo' ou 'bar'
-  "Olá #{params[:nome]}!"
+  # params['nome'] é 'foo' ou 'bar'
+  "Olá #{params['nome']}!"
 end
 ```
 
@@ -71,25 +71,25 @@ end
 ```
 
 Padrões de rota podem também incluir parâmetros splat (asteriscos),
-acessíveis através do array `params[:splat]`.
+acessíveis através do array `params['splat']`.
 
 ``` ruby
 get '/diga/*/ao/*' do
   # corresponde a /diga/ola/ao/mundo
-  params[:splat] # => ["ola", "mundo"]
+  params['splat'] # => ["ola", "mundo"]
 end
 
 get '/download/*.*' do
   # corresponde a /download/pasta/do/arquivo.xml
-  params[:splat] # => ["pasta/do/arquivo", "xml"]
+  params['splat'] # => ["pasta/do/arquivo", "xml"]
 end
 ```
 
 Rotas correspondem-se com expressões regulares:
 
 ``` ruby
-get %r{/ola/([\w]+)} do
-  "Olá, #{params[:captures].first}!"
+get /\A\/ola\/([\w]+)\z/ do
+  "Olá, #{params['captures'].first}!"
 end
 ```
 
@@ -106,7 +106,7 @@ exemplo, o agente usuário:
 
 ``` ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
-  "Você está a utilizar a versão #{params[:agent][0]} do Songbird."
+  "Você está a utilizar a versão #{params['agent'][0]} do Songbird."
 end
 
 get '/foo' do
@@ -282,7 +282,7 @@ directamente acedidas por templates:
 
 ``` ruby
 get '/:id' do
-  @foo = Foo.find(params[:id])
+  @foo = Foo.find(params['id'])
   haml '%h1= @foo.nome'
 end
 ```
@@ -291,7 +291,7 @@ Ou, especifique um hash explícito para variáveis locais:
 
 ``` ruby
 get '/:id' do
-  foo = Foo.find(params[:id])
+  foo = Foo.find(params['id'])
   haml '%h1= foo.nome', :locals => { :foo => foo }
 end
 ```
@@ -367,7 +367,7 @@ helpers do
 end
 
 get '/:nome' do
-  bar(params[:nome])
+  bar(params['nome'])
 end
 ```
 
@@ -386,7 +386,7 @@ end
 
 get '/foo/*' do
   @nota #=> 'Olá!'
-  params[:splat] #=> 'bar/baz'
+  params['splat'] #=> 'bar/baz'
 end
 ```
 
@@ -454,7 +454,7 @@ usando `pass`:
 
 ``` ruby
 get '/adivinhar/:quem' do
-  pass unless params[:quem] == 'Frank'
+  pass unless params['quem'] == 'Frank'
   'Apanhaste-me!'
 end
 
@@ -518,7 +518,7 @@ obtido a partir da variável Rack `sinatra.error`:
 
 ``` ruby
 error do
-  'Peço desculpa, houve um erro desagradável - ' + env['sinatra.error'].name
+  'Peço desculpa, houve um erro desagradável - ' + env['sinatra.error'].message
 end
 ```
 
@@ -586,7 +586,7 @@ content_type :foo
 
 ## Middleware Rack
 
-O Sinatra corre no [Rack](http://rack.rubyforge.org/), uma interface
+O Sinatra corre no [Rack](http://rack.github.io/), uma interface
 padrão mínima para frameworks web em Ruby. Uma das capacidades mais
 interessantes do Rack, para desenvolver aplicações, é o suporte de
 “middleware” – componentes que residem entre o servidor e a aplicação,
@@ -609,7 +609,7 @@ end
 ```
 
 A semântica de `use` é idêntica aquela definida para a DSL
-[Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html)
+[Rack::Builder](http://rubydoc.info/github/rack/rack/master/Rack/Builder)
 (mais frequentemente utilizada para arquivos rackup). Por exemplo, o
 método `use` aceita múltiplos argumentos/variáveis, bem como blocos:
 
@@ -635,7 +635,7 @@ framework de teste baseados no Rack.
 require 'minha_aplicacao_sinatra'
 require 'rack/test'
 
-class MinhaAplicacaoTeste < Test::Unit::TestCase
+class MinhaAplicacaoTeste < Minitest::Test
   include Rack::Test::Methods
 
   def app

data/README.ru.md

@@ -18,13 +18,13 @@ end
 
 Установите gem:
 
-```
+``` shell
 gem install sinatra
 ```
 
 и запустите приложение с помощью:
 
-```
+``` shell
 ruby myapp.rb
 ```
 
@@ -82,8 +82,8 @@ end
 ```ruby
 get '/hello/:name' do
   # соответствует "GET /hello/foo" и "GET /hello/bar",
-  # где params[:name] 'foo' или 'bar'
-  "Hello #{params[:name]}!"
+  # где params['name'] 'foo' или 'bar'
+  "Hello #{params['name']}!"
 end
 ```
 
@@ -96,17 +96,17 @@ end
 ```
 
 Шаблоны маршрутов также могут включать в себя splat (или '*' маску,
-обозначающую любой символ) параметры, доступные в массиве `params[:splat]`:
+обозначающую любой символ) параметры, доступные в массиве `params['splat']`:
 
 ```ruby
 get '/say/*/to/*' do
   # соответствует /say/hello/to/world
-  params[:splat] # => ["hello", "world"]
+  params['splat'] # => ["hello", "world"]
 end
 
 get '/download/*.*' do
   # соответствует /download/path/to/file.xml
-  params[:splat] # => ["path/to/file", "xml"]
+  params['splat'] # => ["path/to/file", "xml"]
 end
 ```
 
@@ -121,14 +121,15 @@ end
 Регулярные выражения в качестве шаблонов маршрутов:
 
 ```ruby
-get %r{/hello/([\w]+)} do
-  "Hello, #{params[:captures].first}!"
+get /\A\/hello\/([\w]+)\z/ do
+  "Hello, #{params['captures'].first}!"
 end
 ```
 
 Или с параметром блока:
 
 ```ruby
+# Находит "GET /meta/hello/world", "GET /hello/world/1234" и так далее
 get %r{/hello/([\w]+)} do |c|
   "Hello, #{c}!"
 end
@@ -153,7 +154,7 @@ traversal, см. ниже), путь запроса может быть изме
 
 ```ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
-  "You're using Songbird version #{params[:agent][0]}"
+  "You're using Songbird version #{params['agent'][0]}"
 end
 
 get '/foo' do
@@ -487,7 +488,7 @@ get('/') { markdown :index }
   <tr>
     <td>Зависимости</td>
     <td>
-      <a href="http://builder.rubyforge.org/" title="builder">builder</a>
+      <a href="https://github.com/jimweirich/builder" title="builder">builder</a>
     </td>
   </tr>
   <tr>
@@ -602,8 +603,8 @@ get('/') { markdown :index }
         <a href="https://github.com/rtomayko/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.rubyforge.org/" title="kramdown">kramdown</a>,
-        <a href="http://maruku.rubyforge.org/" title="maruku">maruku</a>
+        <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
+        <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>
   </tr>
   <tr>
@@ -678,7 +679,7 @@ erb :overview, :locals => { :text => textile(:introduction) }
 <table>
   <tr>
     <td>Зависимости</td>
-    <td><a href="http://rdoc.rubyforge.org/" title="RDoc">RDoc</a></td>
+    <td><a href="http://rdoc.sourceforge.net/" title="RDoc">RDoc</a></td>
   </tr>
   <tr>
     <td>Расширения файлов</td>
@@ -735,7 +736,7 @@ erb :overview, :locals => { :text => rdoc(:introduction) }
 <table>
   <tr>
     <td>Зависимости</td>
-    <td><a href="http://radius.rubyforge.org/" title="Radius">Radius</a></td>
+    <td><a href="https://github.com/jlong/radius" title="Radius">Radius</a></td>
   </tr>
   <tr>
     <td>Расширения файлов</td>
@@ -885,9 +886,9 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
     <td>
       <a href="https://github.com/josh/ruby-coffee-script" title="Ruby CoffeeScript">
         CoffeeScript
-      </a> и способ
+      </a> и
       <a href="https://github.com/sstephenson/execjs/blob/master/README.md#readme" title="ExecJS">
-        запускать JavaScript
+        способ запускать JavaScript
       </a>
     </td>
   </tr>
@@ -901,6 +902,43 @@ erb :overview, :locals => { :text => mediawiki(:introduction) }
   </tr>
 </table>
 
+#### Stylus шаблоны
+
+<table>
+  <tr>
+    <td>Зависимости</td>
+    <td>
+      <a href="https://github.com/lucasmazza/ruby-stylus" title="Ruby Stylus">
+        Stylus
+      </a> и
+      <a href="https://github.com/sstephenson/execjs/blob/master/README.md#readme" title="ExecJS">
+        способ запускать JavaScript
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td>Расширение файла</td>
+    <td><tt>.styl</tt></td>
+  </tr>
+  <tr>
+    <td>Пример</td>
+    <td><tt>stylus :index</tt></td>
+  </tr>
+</table>
+
+Перед тем, как использовать шаблоны стилус, загрузите `stylus` и
+`stylus/tilt`:
+
+``` ruby
+require 'sinatra'
+require 'stylus'
+require 'stylus/tilt'
+
+get '/' do
+  stylus :example
+end
+```
+
 #### Yajl шаблоны
 
 <table>
@@ -969,7 +1007,7 @@ var resource = {"foo":"bar","baz":"qux"}; present(resource);
 
 ```ruby
 get '/:id' do
-  @foo = Foo.find(params[:id])
+  @foo = Foo.find(params['id'])
   haml '%h1= @foo.name'
 end
 ```
@@ -978,7 +1016,7 @@ end
 
 ```ruby
 get '/:id' do
-  foo = Foo.find(params[:id])
+  foo = Foo.find(params['id'])
   haml '%h1= bar.name', :locals => { :bar => foo }
 end
 ```
@@ -1122,7 +1160,7 @@ end
 
 get '/foo/*' do
   @note #=> 'Hi!'
-  params[:splat] #=> 'bar/baz'
+  params['splat'] #=> 'bar/baz'
 end
 ```
 
@@ -1150,7 +1188,7 @@ before '/protected/*' do
 end
 
 after '/create/:slug' do |slug|
-  session[:last_slug] = slug
+  session['last_slug'] = slug
 end
 ```
 
@@ -1179,7 +1217,7 @@ helpers do
 end
 
 get '/:name' do
-  bar(params[:name])
+  bar(params['name'])
 end
 ```
 
@@ -1208,11 +1246,11 @@ helpers FooUtils, BarUtils
 enable :sessions
 
 get '/' do
-  "value = " << session[:value].inspect
+  "value = " << session['value'].inspect
 end
 
 get '/:value' do
-  session[:value] = params[:value]
+  session['value'] = params['value']
 end
 ```
 
@@ -1227,11 +1265,11 @@ end
 use Rack::Session::Pool, :expire_after => 2592000
 
 get '/' do
-  "value = " << session[:value].inspect
+  "value = " << session['value'].inspect
 end
 
 get '/:value' do
-  session[:value] = params[:value]
+  session['value'] = params['value']
 end
 ```
 
@@ -1305,7 +1343,7 @@ halt erb(:error)
 
 ```ruby
 get '/guess/:who' do
-  pass unless params[:who] == 'Frank'
+  pass unless params['who'] == 'Frank'
   'You got me!'
 end
 
@@ -1426,19 +1464,17 @@ connections = []
 
 get '/subscribe' do
   # регистрация клиента
-  stream(:keep_open) { |out| connections << out }
-
-  # удаление "мертвых клиентов"
-  connections.reject!(&:closed?)
-
-  # допуск
-  "subscribed"
+  stream(:keep_open) do |out|
+    connections << out }
+    # удаление "мертвых клиентов"
+    connections.reject!(&:closed?)
+  end
 end
 
 post '/message' do
   connections.each do |out|
     # уведомить клиента о новом сообщении
-    out << params[:message] << "\n"
+    out << params['message'] << "\n"
 
     # указать клиенту на необходимость снова соединиться
     out.close
@@ -1561,12 +1597,12 @@ redirect to('/bar?sum=42')
 enable :sessions
 
 get '/foo' do
-  session[:secret] = 'foo'
+  session['secret'] = 'foo'
   redirect to('/bar')
 end
 
 get '/bar' do
-  session[:secret]
+  session['secret']
 end
 ```
 
@@ -1607,7 +1643,7 @@ end
 
 ```ruby
 get '/article/:id' do
-  @article = Article.find params[:id]
+  @article = Article.find params['id']
   last_modified @article.updated_at
   etag @article.sha1
   erb :article
@@ -1803,7 +1839,7 @@ end
 ```
 
 Этот метод используется внутри Sinatra методами `expires`, `last_modified` и
-им подобными. Поэтому вы легко можете расширить функционал этих методов,
+им подобными. Поэтому вы легко можете изменить и дополнить поведение этих методов,
 переопределив `time_for` в своем приложении:
 
 ```ruby
@@ -1970,11 +2006,11 @@ set :protection, :except => [:path_traversal, :session_hijacking]
   </dd>
   <dd>Отключено по умолчанию.</dd>
 
-  <dt>add_charsets</dt>
+  <dt>add_charset</dt>
   <dd>
     mime-типы, к которым метод <tt>content_type</tt> будет автоматически добавлять
     информацию о кодировке. Вам следует добавлять значения к этой опции
-    вместо ее переопределения: <tt>settings.add_charsets &lt;&lt; "application/foobar"</tt>
+    вместо ее переопределения: <tt>settings.add_charset &lt;&lt; "application/foobar"</tt>
   </dd>
 
   <dt>app_file</dt>
@@ -2158,7 +2194,7 @@ not_found do
 end
 ```
 
-### Ошибки
+### Error
 
 Обработчик ошибок `error` будет вызван, когда исключение выброшено из блока
 маршрута, либо из фильтра. Объект-исключение доступен как переменная
@@ -2166,7 +2202,7 @@ end
 
 ```ruby
 error do
-  'Sorry there was a nasty error - ' + env['sinatra.error'].name
+  'Sorry there was a nasty error - ' + env['sinatra.error'].message
 end
 ```
 
@@ -2217,7 +2253,7 @@ Sinatra устанавливает специальные `not_found` и `error`
 
 ## Rack "прослойки"
 
-Sinatra использует [Rack](http://rack.rubyforge.org/), минимальный стандартный
+Sinatra использует [Rack](http://rack.github.io/), минимальный стандартный
 интерфейс для веб-фреймворков на Ruby. Одной из самых интересных для
 разработчиков возможностей Rack является поддержка "прослоек" ("middleware") —
 компонентов, находящихся "между" сервером и вашим приложением, которые
@@ -2239,7 +2275,7 @@ end
 ```
 
 Семантика `use` идентична той, что определена для
-[Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html) DSL
+[Rack::Builder](http://rubydoc.info/github/rack/rack/master/Rack/Builder) DSL
 (чаще всего используется в rackup файлах). Например, метод `use` принимает как
 множественные переменные, так и блоки:
 
@@ -2269,10 +2305,10 @@ Rack распространяется с различными стандартн
 
 ```ruby
 require 'my_sinatra_app'
-require 'test/unit'
+require 'minitest/autorun'
 require 'rack/test'
 
-class MyAppTest < Test::Unit::TestCase
+class MyAppTest < Minitest::Test
   include Rack::Test::Methods
 
   def app
@@ -2447,8 +2483,8 @@ class LoginScreen < Sinatra::Base
   get('/login') { haml :login }
 
   post('/login') do
-    if params[:name] == 'admin' && params[:password] == 'admin'
-      session['user_name'] = params[:name]
+    if params['name'] == 'admin' && params['password'] == 'admin'
+      session['user_name'] = params['name']
     else
       redirect '/login'
     end
@@ -2574,8 +2610,8 @@ class MyApp < Sinatra::Base
     # Область видимости запроса '/define_route/:name'
     @value = 42
 
-    settings.get("/#{params[:name]}") do
-      # Область видимости запроса "/#{params[:name]}"
+    settings.get("/#{params['name']}") do
+      # Область видимости запроса "/#{params['name']}"
       @value # => nil (другой запрос)
     end
 
@@ -2791,7 +2827,7 @@ SemVerTag.
 * [Twitter](http://twitter.com/sinatra)
 * [Группы рассылки](http://groups.google.com/group/sinatrarb/topics)
 * [#sinatra](irc://chat.freenode.net/#sinatra) на http://freenode.net
-* [Sinatra Book](http://sinatra-book.gittr.com) учебник и сборник рецептов
+* [Sinatra Book](https://github.com/sinatra/sinatra-book/) учебник и сборник рецептов
 * [Sinatra Recipes](http://recipes.sinatrarb.com/) сборник рецептов
 * API документация к [последнему релизу](http://rubydoc.info/gems/sinatra)
   или [текущему HEAD](http://rubydoc.info/github/sinatra/sinatra) на