sinatra 2.0.7 → 2.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4e8de01bf4c996539070ba126783554845768b3c92428813e36b572330b0105
-  data.tar.gz: b5cea6545616d1296290fdbe88357619ff827ce16f6da7b0310a80bac86c657e
+  metadata.gz: 996ffb850e9fba979b72012a00ba18a9baf51dd8ecb4369330bd0a8f3057b599
+  data.tar.gz: cd3ccb02b5348188a5f644b5a208d94dad535703236d85e1402f53f32e13d054
 SHA512:
-  metadata.gz: c197220fab61cfcfc1f4f2a5d4484a9ade9f3daac32f1baf29a0ce3e0104691b723d96149c792b4e5f14e2365cc1136b89b88e7eb0161383467d018349f55f59
-  data.tar.gz: 24187702ce48a9f18566665a457646a163694685c41ac1a1e898525c9a2a38a139c5420eb56ab2cc28cef1baaf55eac2c1c3f8b30e74c0f5accd8a40f60d781c
+  metadata.gz: 6f1f6450b109378735e2018291f54d91be717942d04613df5db578c476c2ad70ec08fe589fb3a917007549957a8e45cc6abf70cee9bbd2fb09b59ff721a69837
+  data.tar.gz: 7aa231036ecad7c7ce280556d7cfbad1000572466c24c36bc47e5a32aa1594e4aac0393f598211c41b1c65e028125b7d45689a3442d824dcddd7a6a5adba23b8

data/CHANGELOG.md

@@ -1,3 +1,19 @@
+## 2.0.8 / 2020-01-01
+
+* Lookup Tilt class for template engine without loading files [#1558](https://github.com/sinatra/sinatra/pull/1558). Fixes [#1172](https://github.com/sinatra/sinatra/issues/1172) by Jordan Owens
+
+* Add request info in NotFound exception [#1566](https://github.com/sinatra/sinatra/pull/1566) by Stefan Sundin
+
+* Add `.yaml` support in `Sinatra::Contrib::ConfigFile` [#1564](https://github.com/sinatra/sinatra/issues/1564). Fixes [#1563](https://github.com/sinatra/sinatra/issues/1563) by Emerson Manabu Araki
+
+* Allow multiple hashes to be passed in `merge` and `merge!` for `Sinatra::IndifferentHash` [#1572](https://github.com/sinatra/sinatra/pull/1572) by Shota Iguchi
+
+* Remove only routing parameters from @params hash [#1569](https://github.com/sinatra/sinatra/pull/1569). Fixes [#1567](https://github.com/sinatra/sinatra/issues/1567) by Jordan Owens, Horacio
+
+* Support `capture` and `content_for` with Hamlit [#1580](https://github.com/sinatra/sinatra/pull/1580) by Takashi Kokubun
+
+* Eliminate warnings of keyword parameter for Ruby 2.7.0 [#1581](https://github.com/sinatra/sinatra/pull/1581) by Osamtimizer
+
 ## 2.0.7 / 2019-08-22
 
 * Fix a regression [#1560](https://github.com/sinatra/sinatra/pull/1560) by Kunpei Sakai

data/Gemfile

@@ -26,6 +26,10 @@ if RUBY_ENGINE == 'jruby'
   gem 'trinidad'
 end
 
+if RUBY_ENGINE == 'jruby' || RUBY_ENGINE == 'ruby'
+  gem "activesupport", "~> 5.1.6"
+end
+
 if RUBY_ENGINE == "ruby"
   gem 'less', '~> 2.0'
   gem 'therubyracer'
@@ -34,7 +38,6 @@ if RUBY_ENGINE == "ruby"
   gem 'bluecloth'
   gem 'rdiscount'
   gem 'RedCloth'
-  gem "activesupport", "~> 5.1.6"
   gem 'puma'
   gem 'yajl-ruby'
   gem 'nokogiri'

data/README.pt-br.md

@@ -3,13 +3,16 @@
 *Atenção: Este documento é apenas uma tradução da versão em inglês e
 pode estar desatualizado.*
 
-Alguns dos trechos de código a seguir utilizam caracteres UTF-8. Então, caso esteja utilizando uma versão de ruby inferior à `2.0.0`, adicione o encoding no início de seus arquivos:
+Alguns dos trechos de código a seguir utilizam caracteres UTF-8. Então, caso
+esteja utilizando uma versão de ruby inferior à `2.0.0`, adicione o encoding
+no início de seus arquivos:
 
 ```ruby
 # encoding: utf-8
 ```
 
-Sinatra é uma [DSL](https://pt.wikipedia.org/wiki/Linguagem_de_domínio_específico) para
+Sinatra é uma
+[DSL](https://pt.wikipedia.org/wiki/Linguagem_de_domínio_específico) para
 criar aplicações web em Ruby com o mínimo de esforço e rapidez:
 
 ```ruby
@@ -33,10 +36,14 @@ Em seguida execute:
 ruby minha_app.rb
 ```
 
-Acesse: [http://localhost:4567](http://localhost:4567)
+Acesse em: [http://localhost:4567](http://localhost:4567)
 
-É recomendado também executar `gem install thin`. Caso esta gem esteja disponível, o
-Sinatra irá utilizá-la.
+Códigos alterados só terão efeito após você reiniciar o servidor.
+Por favor, reinicie o servidor após qualquer mudança ou use
+[sinatra/reloader](http://www.sinatrarb.com/contrib/reloader).
+
+É recomendado também executar `gem install thin`. Caso esta gem esteja
+disponível, o Sinatra irá utilizá-la.
 
 ## Conteúdo
 
@@ -44,7 +51,7 @@ Sinatra irá utilizá-la.
     * [Conteúdo](#conteúdo)
     * [Rotas](#rotas)
     * [Condições](#condições)
-    * [Retorno de valores](#retorno-de-valores)
+    * [Valores Retornados](#valores-retornados)
     * [Validadores de rota personalizados](#validadores-de-rota-personalizados)
     * [Arquivos estáticos](#arquivos-estáticos)
     * [Views / Templates](#views--templates)
@@ -82,19 +89,50 @@ Sinatra irá utilizá-la.
     * [Filtros](#filtros)
     * [Helpers](#helpers)
         * [Utilizando Sessões](#utilizando-sessões)
+          * [Segurança Secreta da Sessão](#segurança-secreta-da-sessão)
+          * [Configuração da Sessão](#configuração-da-sessão)
+          * [Escolhande Seu Próprio Middleware de Sessão](#escolhendo-middleware-de-sessão)
         * [Halting](#halting)
         * [Passing](#passing)
         * [Desencadeando Outra Rota](#desencadeando-outra-rota)
+        * [Definindo Corpo, Código de Status e Cabeçalhos](#definindo-corpo-codigo-de-status-cabeçalhos)
+        * [Transmitindo Respostas](#transmitindo-respostas)
+        * [Usando Logs](#usando-logs)
+        * [Tipos Mime](#tipos-mime)
+        * [Gerando URLS](#gerando-urls)
+        * [Redirecionamento do Navegador](#redirecionamento-do-navagador)
+        * [Controle de Cache](#controle-de-cache)
+        * [Enviando Arquivos](#enviando-arquivos)
+        * [Acessando o Objeto de Requisição](#acessando-o-objeto-de-requisição)
+        * [Anexos](#anexos)
+        * [Trabalhando com Data e Hora](#trabalhando-com-data-e-hora)
+        * [Procurando Arquivos de Modelo](#procurando-arquivos-de-modelo)
     * [Configuração](#configuração)
+        * [Configurando proteção a ataques](#configurando-proteção-a-ataques)
+        * [Configurações Disponíveis](#configurações-disponíveis)
+    * [Ambientes](#ambientes)
     * [Tratamento de Erros](#tratamento-de-erros)
+        * [Não Encontrado](#não-encontrado)
         * [Erro](#erro)
-    * [Mime Types](#mime-types)
     * [Rack Middleware](#rack-middleware)
     * [Testando](#testando)
-    * [Sinatra::Base - Middleware, Bibliotecas e aplicativos modulares](#sinatrabase---middleware-bibliotecas-e-aplicativos-modulares)
+    * [Sinatra::Base - Middleware, Bibliotecas e Aplicações Modulares](#sinatrabase-middleware-bibliotecas-e-aplicações-modulares)
+        * [Modular vs. Estilo Clássico](#modular-vs-estilo-clássico)
+        * [Servindo uma Aplicação Modular](#servindo-uma-aplicação-modular)
+        * [Usando uma Aplicação de Estilo Clássico com um config.ru](#usando-uma-aplicação-de-estilo-clássico-com-um-configru)
+        * [Quando usar um config.ru?](#quando-usar-um-configru)
+        * [Usando Sinatra como Middleware](#usando-sinatra-como-middleware)
+        * [Criação de Aplicações Dinâmicas](#criação-de-aplicações-dinamicas)
+    * [Escopos e Ligação](#escopos-e-ligação)
+        * [Escopo de Aplicação/Classe](#escopo-de-aplicação-classe)
+        * [Escopo de Instância/Requisição](#escopo-de-instância-requisição)
+        * [Escopo de Delegação](#escopo-de-delegação)
     * [Linha de comando](#linha-de-comando)
         * [Multi-threading](#multi-threading)
+    * [Requerimentos](#requerimentos)
     * [A última versão](#a-última-versão)
+        * [Com Bundler](#com-bundler)
+    * [Versionando](#versionando)
     * [Mais](#mais)
 
 ## Rotas
@@ -124,13 +162,29 @@ delete '/' do
 end
 
 options '/' do
-  .. estabelecendo alguma coisa ..pe
+  .. estabelecendo alguma coisa ..
+end
+
+link '/' do
+  .. associando alguma coisa ..
+end
+
+unlink '/' do
+  .. separando alguma coisa ..
 end
 ```
 
 As rotas são interpretadas na ordem em que são definidas. A primeira
 rota encontrada responde a requisição.
 
+Rotas com barras à direita são diferentes das que não contém as barras:
+
+```ruby
+get '/foo' do
+  # Não é o mesmo que "GET /foo/"
+end
+```
+
 Padrões de rota podem conter parâmetros nomeados, acessíveis por meio do
 hash `params`:
 
@@ -214,8 +268,23 @@ end
 ```
 
 A propósito, a menos que você desative a proteção contra ataques (veja
-abaixo), o caminho solicitado pode ser alterado antes de concluir a
-comparação com as suas rotas.
+[abaixo](#configurando-proteção-a-ataques)), o caminho solicitado pode ser
+alterado antes de concluir a comparação com as suas rotas.
+
+Você pode customizar as opções usadas do
+[Mustermann](https://github.com/sinatra/mustermann#readme) para uma
+rota passando `:mustermann_opts` num hash:
+
+```ruby
+get '\A/posts\z', :musterman_opts => { :type => regexp, :check_anchors => false } do
+  # corresponde a /posts exatamente, com ancoragem explícita
+  "Se você combinar um padrão ancorado bata palmas!"
+end
+```
+
+Parece com uma [condição](#condições) mas não é! Essas opções serão
+misturadas no hash global `:mustermann_opts` descrito
+[abaixo](#configurações-disponíveis)
 
 ## Condições
 
@@ -246,7 +315,7 @@ get '/', :provides => ['rss', 'atom', 'xml'] do
   builder :feed
 end
 ```
-`provides` procura pelos Accept header das requisições
+`provides` procura o cabeçalho Accept das requisições
 
 Você pode facilmente definir suas próprias condições:
 
@@ -316,8 +385,9 @@ end
 get('/') { Stream.new }
 ```
 
-Você também pode usar o método auxiliar `stream` (descrito abaixo) para
-incorporar a lógica de streaming na rota.
+Você também pode usar o método auxiliar `stream`
+([descrito abaixo](#respostas-de-streaming)) para reduzir códigos
+boilerplate e para incorporar a lógica de streaming (transmissão) na rota.
 
 ## Validadores de Rota Personalizados
 
@@ -381,9 +451,13 @@ Note que o nome do diretório público não é incluido na URL. Um arquivo
 `./public/css/style.css` é disponibilizado como
 `http://exemplo.com/css/style.css`.
 
+Use a configuração `:static_cache_control` (veja [abaixo](#controle-de-cache))
+para adicionar a informação `Cache-Control` no cabeçalho.
+
 ## Views / Templates
 
-Cada linguagem de template é exposta através de seu próprio método de renderização. Estes metodos simplesmente retornam uma string:
+Cada linguagem de template é exposta através de seu próprio método de
+renderização. Estes métodos simplesmente retornam uma string:
 
 ```ruby
 get '/' do
@@ -393,7 +467,8 @@ end
 
 Isto renderiza `views/index.rb`
 
-Ao invés do nome do template, você também pode passar direto o conteúdo do template:
+Ao invés do nome do template, você também pode passar direto o conteúdo do
+template:
 
 ```ruby
 get '/' do
@@ -402,7 +477,7 @@ get '/' do
 end
 ```
 
-Templates também aceitam um segundo argumento, um hash de opções:
+Templates também aceitam como um segundo argumento, um hash de opções:
 
 ```ruby
 get '/' do
@@ -410,9 +485,11 @@ get '/' do
 end
 ```
 
-Isto irá renderizar a `views/index.erb` inclusa dentro da `views/post.erb` (o padrão é a `views/layout.erb`, se existir).
+Isto irá renderizar a `views/index.erb` inclusa dentro da `views/post.erb`
+(o padrão é a `views/layout.erb`, se existir).
 
-Qualquer opção não reconhecida pelo Sinatra será passada adiante para o engine de template:
+Qualquer opção não reconhecida pelo Sinatra será passada adiante para o engine
+de template:
 
 ```ruby
 get '/' do
@@ -430,7 +507,8 @@ get '/' do
 end
 ```
 
-Opções passadas para o método de renderização sobrescreve as opções definitas através do método `set`.
+Opções passadas para o método de renderização sobrescreve as opções definitas
+através do método `set`.
 
 Opções disponíveis:
 
@@ -443,12 +521,14 @@ Opções disponíveis:
 
   <dt>default_encoding</dt>
   <dd>
-    String encoding para ser utilizada em caso de incerteza. o padrão é <tt>settings.default_encoding</tt>.
+    String encoding para ser utilizada em caso de incerteza. o padrão é
+    <tt>settings.default_encoding</tt>.
   </dd>
 
   <dt>views</dt>
   <dd>
-    Diretório de onde os templates são carregados. O padrão é <tt>settings.views</tt>.
+    Diretório de onde os templates são carregados. O padrão é
+    <tt>settings.views</tt>.
   </dd>
 
   <dt>layout</dt>
@@ -468,8 +548,8 @@ Opções disponíveis:
   <dt>scope</dt>
   <dd>
     Escopo em que o template será renderizado. Padrão é a
-    instancia da aplicação. Se você mudar isto as variáveis
-    de instânciae metodos auxiliares não serão
+    instância da aplicação. Se você mudar isto as variáveis
+    de instância métodos auxiliares não serão
     disponibilizados.
   </dd>
 
@@ -489,7 +569,8 @@ Opções disponíveis:
   </dd>
 </dl>
 
-É pressuposto que os templates estarão localizados direto sob o diretório `./views`. Para usar um diretório diferente:
+É pressuposto que os templates estarão localizados diretamente sob o
+diretório `./views`. Para usar um diretório diferente:
 
 ```ruby
 set :views, settings.root + '/templates'
@@ -511,11 +592,21 @@ get '/' do
 end
 ```
 
-Renderiza um template string.
+Renderiza um template string. Você pode opcionalmente especificar `path`
+e `:line` para um backtrace mais claro se existir um caminho do sistema de
+arquivos ou linha associada com aquela string.
+
+```ruby
+get '/' do
+  haml '%div.title Olá Mundo', :path => 'exemplos/arquivo.haml', :line => 3
+end
+```
 
 ### Linguagens de template disponíveis
 
-Algumas linguagens possuem multiplas implementações. Para especificar qual implementação deverá ser utilizada (e para ser *thread-safe*), você deve simplesmente requere-la primeiro:
+Algumas linguagens possuem multiplas implementações. Para especificar qual
+implementação deverá ser utilizada (e para ser *thread-safe*), você deve
+requere-la primeiro:
 
 ```ruby
 require 'rdiscount' # ou require 'bluecloth'
@@ -526,11 +617,11 @@ get('/') { markdown :index }
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://haml.info/" title="haml">haml</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.haml</tt></td>
   </tr>
   <tr>
@@ -543,14 +634,14 @@ get('/') { markdown :index }
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td>
       <a href="http://www.kuwata-lab.com/erubis/" title="erubis">erubis</a>
       or erb (included in Ruby)
     </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivos</td>
+    <td>Extensão dos Arquivos</td>
     <td><tt>.erb</tt>, <tt>.rhtml</tt> or <tt>.erubis</tt> (Erubis only)</td>
   </tr>
   <tr>
@@ -563,13 +654,15 @@ get('/') { markdown :index }
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependêcia</td>
     <td>
-      <a href="https://github.com/jimweirich/builder" title="builder">builder</a>
+      <a href="https://github.com/jimweirich/builder" title="builder">
+        builder
+      </a>
     </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.builder</tt></td>
   </tr>
   <tr>
@@ -584,11 +677,11 @@ It also takes a block for inline templates (see exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://www.nokogiri.org/" title="nokogiri">nokogiri</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.nokogiri</tt></td>
   </tr>
   <tr>
@@ -603,11 +696,11 @@ It also takes a block for inline templates (see exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://sass-lang.com/" title="sass">sass</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.sass</tt></td>
   </tr>
   <tr>
@@ -620,11 +713,11 @@ It also takes a block for inline templates (see exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://sass-lang.com/" title="sass">sass</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.scss</tt></td>
   </tr>
   <tr>
@@ -637,11 +730,11 @@ It also takes a block for inline templates (see exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://lesscss.org/" title="less">less</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.less</tt></td>
   </tr>
   <tr>
@@ -654,11 +747,13 @@ It also takes a block for inline templates (see exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
-    <td><a href="https://shopify.github.io/liquid/" title="liquid">liquid</a></td>
+    <td>Dependência</td>
+    <td>
+      <a href="https://shopify.github.io/liquid/" title="liquid">liquid</a>
+    </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.liquid</tt></td>
   </tr>
   <tr>
@@ -667,25 +762,35 @@ It also takes a block for inline templates (see exemplo).
   </tr>
 </table>
 
-Já que você não pode chamar o Ruby (exceto pelo método `yield`) pelo template Liquid,
-você quase sempre precisará passar o `locals` para ele.
+Já que você não pode chamar o Ruby (exceto pelo método `yield`) pelo template
+Liquid, você quase sempre precisará passar o `locals` para ele.
 
 #### Markdown Templates
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td>
       Anyone of:
-        <a href="https://github.com/davidfstr/rdiscount" title="RDiscount">RDiscount</a>,
-        <a href="https://github.com/vmg/redcarpet" title="RedCarpet">RedCarpet</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>
+        <a href="https://github.com/davidfstr/rdiscount" title="RDiscount">
+          RDiscount
+        </a>,
+        <a href="https://github.com/vmg/redcarpet" title="RedCarpet">
+          RedCarpet
+        </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>
     </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivos</td>
+    <td>Extensão do Arquivos</td>
     <td><tt>.markdown</tt>, <tt>.mkd</tt> and <tt>.md</tt></td>
   </tr>
   <tr>
@@ -694,7 +799,8 @@ você quase sempre precisará passar o `locals` para ele.
   </tr>
 </table>
 
-Não é possível chamar métodos por este template, nem passar *locals* para o mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
+Não é possível chamar métodos por este template, nem passar *locals* para o
+mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
 
 ```ruby
 erb :overview, :locals => { :text => markdown(:introducao) }
@@ -714,11 +820,11 @@ deve-se passar a `:layout_engine` como opção.
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://redcloth.org/" title="RedCloth">RedCloth</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.textile</tt></td>
   </tr>
   <tr>
@@ -727,7 +833,8 @@ deve-se passar a `:layout_engine` como opção.
   </tr>
 </table>
 
-Não é possível chamar métodos por este template, nem passar *locals* para o mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
+Não é possível chamar métodos por este template, nem passar *locals* para o
+mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
 
 ```ruby
 erb :overview, :locals => { :text => textile(:introducao) }
@@ -749,11 +856,11 @@ deve-se passar a `:layout_engine` como opção.
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://rdoc.sourceforge.net/" title="RDoc">RDoc</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.rdoc</tt></td>
   </tr>
   <tr>
@@ -762,7 +869,8 @@ deve-se passar a `:layout_engine` como opção.
   </tr>
 </table>
 
-Não é possível chamar métodos por este template, nem passar *locals* para o mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
+Não é possível chamar métodos por este template, nem passar *locals* para o
+mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
 
 ```ruby
 erb :overview, :locals => { :text => rdoc(:introducao) }
@@ -784,11 +892,13 @@ deve-se passar a `:layout_engine` como opção.
 
 <table>
   <tr>
-    <td>Dependencia</td>
-    <td><a href="http://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a></td>
+    <td>Dependência</td>
+    <td>
+      <a href="http://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a>
+    </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.asciidoc</tt>, <tt>.adoc</tt> and <tt>.ad</tt></td>
   </tr>
   <tr>
@@ -804,11 +914,11 @@ você quase sempre precisará passar o `locals` para ele.
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="https://github.com/jlong/radius" title="Radius">Radius</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.radius</tt></td>
   </tr>
   <tr>
@@ -824,11 +934,11 @@ você quase sempre precisará passar o `locals` para ele.
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://markaby.github.io/" title="Markaby">Markaby</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.mab</tt></td>
   </tr>
   <tr>
@@ -843,11 +953,11 @@ Este também recebe um bloco para templates (veja o exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="https://github.com/nesquena/rabl" title="Rabl">Rabl</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.rabl</tt></td>
   </tr>
   <tr>
@@ -860,11 +970,11 @@ Este também recebe um bloco para templates (veja o exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="http://slim-lang.com/" title="Slim Lang">Slim Lang</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.slim</tt></td>
   </tr>
   <tr>
@@ -877,11 +987,11 @@ Este também recebe um bloco para templates (veja o exemplo).
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td><a href="https://github.com/minad/creole" title="Creole">Creole</a></td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.creole</tt></td>
   </tr>
   <tr>
@@ -890,13 +1000,14 @@ Este também recebe um bloco para templates (veja o exemplo).
   </tr>
 </table>
 
-Não é possível chamar métodos por este template, nem passar *locals* para o mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
+Não é possível chamar métodos por este template, nem passar *locals* para o
+mesmo. Portanto normalmente é utilizado junto a outra engine de renderização:
 
 ```ruby
 erb :overview, :locals => { :text => creole(:introduction) }
 ```
 
-Note que vcoê também pode chamar o método `creole` dentro de outros templates:
+Note que você também pode chamar o método `creole` dentro de outros templates:
 
 ```ruby
 %h1 Olá do Haml!
@@ -912,11 +1023,15 @@ deve-se passar a `:layout_engine` como opção.
 
 <table>
   <tr>
-    <td>Dependencia</td>
-    <td><a href="https://github.com/nricciar/wikicloth" title="WikiCloth">WikiCloth</a></td>
+    <td>Dependência</td>
+    <td>
+      <a href="https://github.com/nricciar/wikicloth" title="WikiCloth">
+        WikiCloth
+      </a>
+      </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.mediawiki</tt> and <tt>.mw</tt></td>
   </tr>
   <tr>
@@ -949,7 +1064,7 @@ deve-se passar a `:layout_engine` como opção.
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td>
       <a href="https://github.com/josh/ruby-coffee-script" title="Ruby CoffeeScript">
         CoffeeScript
@@ -960,7 +1075,7 @@ deve-se passar a `:layout_engine` como opção.
     </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.coffee</tt></td>
   </tr>
   <tr>
@@ -973,7 +1088,7 @@ deve-se passar a `:layout_engine` como opção.
 
 <table>
   <tr>
-    <td>Dependencia</td>
+    <td>Dependência</td>
     <td>
       <a href="https://github.com/forgecrafted/ruby-stylus" title="Ruby Stylus">
         Stylus
@@ -984,7 +1099,7 @@ deve-se passar a `:layout_engine` como opção.
     </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.styl</tt></td>
   </tr>
   <tr>
@@ -993,7 +1108,8 @@ deve-se passar a `:layout_engine` como opção.
   </tr>
 </table>
 
-Antes que vcoê possa utilizar o template Stylus primeiro você deve carregar `stylus` e `stylus/tilt`:
+Antes que vcoê possa utilizar o template Stylus primeiro você deve carregar
+`stylus` e `stylus/tilt`:
 
 ```ruby
 require 'sinatra'
@@ -1009,11 +1125,15 @@ end
 
 <table>
   <tr>
-    <td>Dependencia</td>
-    <td><a href="https://github.com/brianmario/yajl-ruby" title="yajl-ruby">yajl-ruby</a></td>
+    <td>Dependência</td>
+    <td>
+      <a href="https://github.com/brianmario/yajl-ruby" title="yajl-ruby">
+        yajl-ruby
+      </a>
+    </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.yajl</tt></td>
   </tr>
   <tr>
@@ -1029,14 +1149,16 @@ end
   </tr>
 </table>
 
-O código-fonte do template é executado como uma string Ruby e a variável resultante em json é convertida utilizando `#to_json`:
+O código-fonte do template é executado como uma string Ruby e a variável
+resultante em json é convertida utilizando `#to_json`:
 
 ```ruby
 json = { :foo => 'bar' }
 json[:baz] = key
 ```
 
-O `:callback` e `:variable` são opções que podem ser utilizadas para o objeto de renderização:
+O `:callback` e `:variable` são opções que podem ser utilizadas para o objeto
+de renderização:
 
 ```javascript
 var resource = {"foo":"bar","baz":"qux"};
@@ -1047,11 +1169,13 @@ present(resource);
 
 <table>
   <tr>
-    <td>Dependencia</td>
-    <td><a href="https://github.com/blambeau/wlang/" title="WLang">WLang</a></td>
+    <td>Dependência</td>
+    <td>
+      <a href="https://github.com/blambeau/wlang/" title="WLang">WLang</a>
+    </td>
   </tr>
   <tr>
-    <td>Extencao do Arquivo</td>
+    <td>Extensão do Arquivo</td>
     <td><tt>.wlang</tt></td>
   </tr>
   <tr>
@@ -1067,7 +1191,7 @@ você quase sempre precisará passar o `locals` para ele.
 ## Acessando Variáveis nos Templates
 
 Templates são avaliados dentro do mesmo contexto como manipuladores de
-rota. Variáveis de instância setadas em rotas manipuladas são
+rota. Variáveis de instância definidas em manipuladores de rota são
 diretamente acessadas por templates:
 
 ```ruby
@@ -1077,7 +1201,7 @@ get '/:id' do
 end
 ```
 
-Ou, especifique um hash explícito para variáveis locais:
+Ou, especifique um hash explícito de variáveis locais:
 
 ```ruby
 get '/:id' do
@@ -1091,8 +1215,9 @@ partials dentro de outros templates.
 
 ### Templates com `yield` e layouts aninhados
 
-O layout geralmente é apenas um template que executa `yield`.
-Tal template pode ser utilizado pela opção `:template` descrita acima ou pode ser renderizado através de um bloco, como a seguir:
+Um layout geralmente é apenas um template que executa `yield`.
+Tal template pode ser utilizado pela opção `:template` descrita acima ou pode
+ser renderizado através de um bloco, como a seguir:
 
 ```ruby
 erb :post, :layout => false do
@@ -1102,7 +1227,8 @@ end
 
 Este código é quase equivalente a `erb :index, :layout => :post`
 
-Passando blocos para os métodos de renderização é útil para criar layouts aninhados:
+Passando blocos para os métodos de renderização é útil para criar layouts
+aninhados:
 
 ```ruby
 erb :main_layout, :layout => false do
@@ -1121,11 +1247,11 @@ end
 ```
 
 Atualmente os métodos listados aceitam blocos: `erb`, `haml`,
-`liquid`, `slim `, `wlang`. E também o método `render`.
+`liquid`, `slim `, `wlang`. E o método geral `render` também aceita blocos.
 
 ### Templates Inline
 
-Templates podem ser definidos no final do arquivo fonte(.rb):
+Templates podem ser definidos no final do arquivo fonte:
 
 ```ruby
 require 'sinatra'
@@ -1145,10 +1271,10 @@ __END__
 ```
 
 NOTA: Templates inline definidos no arquivo fonte são automaticamente
-carregados pelo sinatra. Digite \`enable :inline\_templates\` se você
-tem templates inline no outro arquivo fonte.
+carregados pelo Sinatra. Digite `enable :inline_templates` explicitamente se
+você tem templates inline em outros arquivos fonte.
 
-### Templates nomeados
+### Templates Nomeados
 
 Templates também podem ser definidos utilizando o método top-level
 `template`:
@@ -1169,7 +1295,8 @@ end
 
 Se existir um template com nome “layout”, ele será utilizado toda vez
 que um template for renderizado. Você pode desabilitar layouts passando
-`:layout => false`.
+`:layout => false` ou desabilita-los por padrão
+via `set :haml, :layout => false`
 
 ```ruby
 get '/' do
@@ -1177,9 +1304,11 @@ get '/' do
 end
 ```
 
-### Associando extensões de arquivos
+### Associando Extensões de Arquivos
 
-Para associar uma extensão de arquivo com um engine de template use o método `Tilt.register`. Por exemplo, se você quiser usar a extensão `tt` para os templates Textile você pode fazer o seguinte:
+Para associar uma extensão de arquivo com um engine de template use o método
+`Tilt.register`. Por exemplo, se você quiser usar a extensão `tt` para os
+templates Textile você pode fazer o seguinte:
 
 ```ruby
 Tilt.register :tt, Tilt[:textile]
@@ -1187,7 +1316,8 @@ Tilt.register :tt, Tilt[:textile]
 
 ### Adicionando seu Próprio Engine de Template
 
-Primeiro registre seu engine utilizando o Tilt, e então crie um método de renderização:
+Primeiro registre seu engine utilizando o Tilt, e então crie um método de
+renderização:
 
 ```ruby
 Tilt.register :myat, MyAwesomeTemplateEngine
@@ -1201,12 +1331,13 @@ get '/' do
 end
 ```
 
-Renderize `./views/index.myat`. Veja
-https://github.com/rtomayko/tilt para saber mais sobre Tilt.
+Renderize `./views/index.myat`. Aprenda mais sobre o
+Tilt [aqui](https://github.com/rtomayko/tilt#readme).
 
-### Customizando lógica para encontrar templates
+### Customizando Lógica para Encontrar Templates
 
-Para implementar sua própria lógica para busca de templates você pode escrever seu próprio método `#find_template`
+Para implementar sua própria lógica para busca de templates você pode escrever
+seu próprio método `#find_template`
 
 ```ruby
 configure do
@@ -1224,7 +1355,7 @@ end
 
 Filtros Before são avaliados antes de cada requisição dentro do contexto
 da requisição e podem modificar a requisição e a reposta. Variáveis de
-instância setadas nos filtros são acessadas através de rotas e
+instância definidas nos filtros são acessadas através de rotas e
 templates:
 
 ```ruby
@@ -1239,9 +1370,9 @@ get '/foo/*' do
 end
 ```
 
-Filtros After são avaliados após cada requisição dentro do contexto da
+Filtros After são avaliados após cada requisição dentro do mesmo contexto da
 requisição e também podem modificar a requisição e a resposta. Variáveis de
-instância e rotas definidas nos filtros before são acessadas através dos
+instância definidas nos filtros before e rotas são acessadas através dos
 filtros after:
 
 ```ruby
@@ -1250,6 +1381,10 @@ after do
 end
 ```
 
+Nota: A não ser que você use o metódo `body` ao invés de apenas retornar uma
+String das rotas, o corpo ainda não estará disponível no filtro after, uma vez
+que é gerado depois.
+
 Filtros opcionalmente têm um padrão, fazendo com que sejam avaliados
 somente se o caminho do pedido coincidir com esse padrão:
 
@@ -1263,6 +1398,18 @@ after '/create/:slug' do |slug|
 end
 ```
 
+Como rotas, filtros também aceitam condições:
+
+```ruby
+before :agent => /Songbird/ do
+  #...
+end
+
+after '/blog/*', :host_name => 'exemplo.com' do
+  #...
+end
+```
+
 ## Helpers
 
 Use o método de alto nível `helpers` para definir métodos auxiliares
@@ -1280,9 +1427,27 @@ get '/:nome' do
 end
 ```
 
+Alternativamente, métodos auxiliares podem ser definidos separadamente em
+módulos:
+
+```ruby
+module FooUtils
+  def foo(nome) "#{nome}foo" end
+end
+
+module BarUtils
+  def bar(nome) "#{nome}bar" end
+end
+
+helpers FooUtils, BarUtils
+```
+
+O efeito é o mesmo que incluir os módulos na classe da aplicação.
+
 ### Utilizando Sessões
 
-Sessões são usadas para manter um estado durante uma requisição. Se ativa, você terá disponível um hash de sessão para cada sessão de usuário:
+ Uma sessão é usada para manter o estado durante requisições. Se ativada, você
+ terá disponível um hash de sessão para cada sessão de usuário:
 
 ```ruby
 enable :sessions
@@ -1295,40 +1460,134 @@ get '/:value' do
   session['value'] = params['value']
 end
 ```
+#### Segredo Seguro da Sessão
 
-Note que `enable :sessions` utilizará um cookie para guardar todos os dados da sessão. Isso nem sempre pode ser o que você quer (guardar muitos dados irá aumentar o seu tráfego, por exemplo). Você pode utilizar qualquer Rack middleware de sessão: para fazer isso **não** utilize o método `enable :sessions`, ao invés disso utilize seu middleware de sessão como utilizaria qualquer outro:
+Para melhorar a segurança, os dados da sessão no cookie são assinado com uma
+segredo de sessão usando `HMAC-SHA1`. Esse segredo de sessão deve ser, de
+preferência, um valor criptograficamente randômico, seguro, de um comprimento
+apropriado no qual `HMAC-SHA1` é maior ou igual a 64 bytes (512 bits, 128
+carecteres hexadecimais). Você será avisado para não usar uma chave secreta
+menor que 32 bytes de randomicidade (256 bits, 64 caracteres hexadecimais).
+Portanto, é **muito importante** que você não invente o segredo, mas use um
+gerador de números aleatórios seguro para cria-lo. Humanos são extremamente
+ruins em gerar números aleatórios.
 
-```ruby
-use Rack::Session::Pool, :expire_after => 2592000
+Por padrão, um segredo de sessão aleatório seguro de 32 bytes é gerada para
+você pelo Sinatra, mas ele mudará toda vez que você reiniciar sua aplicação. Se
+você tiver múltiplas instâncias da sua aplicação e você deixar que o Sinatra
+gere a chave, cada instância teria uma chave de sessão diferente, o que
+certamente não é o que você quer.
 
-get '/' do
-  "value = " << session[:value].inspect
-end
+Para melhor segurança e usabilidade é
+[recomendado](https://12factor.net/config) que você gere um segredo randômico
+secreto e salve-o em uma variável de ambiente em cada host rodando sua
+aplicação, assim todas as instâncias da sua aplicação irão compartilhar o mesmo
+segredo. Você deve, periodicamente, mudar esse segredo de sessão para um novo
+valor. Abaixo, são mostrados alguns exemplos de como você pode criar um segredo
+de 64 bytes e usa-lo:
 
-get '/:value' do
-  session['value'] = params['value']
-end
+**Gerando Segredo de Sessão**
+
+```text
+$ ruby -e "require 'securerandom'; puts SecureRandom.hex(64)"
+99ae8af...snip...ec0f262ac
+```
+
+**Gerando Segredo de Sessão (Pontos adicionais)**
+
+Use preferencialmente a
+[gem sysrandom](https://github.com/cryptosphere/sysrandom#readme) para utilizar
+as facilidades do sistema RNG para gerar valores aleatórios ao invés
+do `OpenSSL` no qual o MRI Ruby padroniza para:
+
+```text
+$ gem install sysrandom
+Building native extensions. This could take a while...
+Sucessfully installed sysrandom-1.x
+1 gem installed
+
+$ ruby -e "require 'sysrandom/securerandom'; puts SecureRandom.hex(64)"
+99ae8af...snip...ec0f262ac
+```
+
+**Segredo de Sessão numa Variável de Ambiente**
+
+Defina uma variável de ambiente `SESSION_SECRET` para o Sinatra com o valor que
+você gerou. Salve esse valor entre as reinicializações do seu host. Já que a
+forma de fazer isso irá variar entre os sistemas operacionais, o exemplo abaixo
+serve apenas para fins ilustrativos:
+
+```bash
+# echo "export SESSION_SECRET = 99ae8af...snip...ec0f262ac" >> ~/.bashrc
 ```
 
-Para melhorar a segurança, os dados da sessão guardados no cookie é assinado com uma chave secreta da sessão. Uma chave aleatória é gerada para você pelo Sinatra. Contudo, já que a chave mudará cada vez que você inicia sua aplicação, você talvez queira defini-la você mesmo para que todas as instâncias da aplicação compartilhe-a:
+**Configurando o Segredo de Sessão na Aplicação**
+
+Configure sua aplicação para uma falha de segredo seguro aleatório se a
+variável de ambiente `SESSION_SECRET` não estiver disponível.
+
+Como ponto adicional use a
+[gem sysrandom](https://github.com/cryptosphere/sysrandom#readme) da seguinte
+forma:
 
 ```ruby
-set :session_secret, 'super secret'
+require 'securerandom'
+# -or- require 'sysrandom/securearandom'
+set :session_secret, ENV.fecth(`SESSION_SECRET`) { SecureRandom.hex(64) }
 ```
 
-Se você quiser fazer outras configurações, você também pode guardar um hash com as opções nas configurações da `session`:
+#### Configuração de Sessão
+
+Se você deseja configurar isso adicionalmente, você pode salvar um hash com
+opções na definição de `sessions`:
 
 ```ruby
 set :sessions, :domain => 'foo.com'
 ```
 
-Para compartilhar sua sessão entre outros aplicativos em um subdomínio de foo.com, utilize o prefixo *.*:
+Para compartilhar sua sessão com outras aplicações no subdomínio de foo.com,
+adicione um *.* antes do domínio como no exemplo abaixo:
 
 ```ruby
 set :sessions, :domain => '.foo.com'
 ```
 
-### Halting
+#### Escolhendo Seu Próprio Middleware de Sessão
+
+Perceba que `enable :sessions` na verdade guarda todos seus dados num cookie.
+Isto pode não ser o que você deseja sempre (armazenar muitos dados irá aumentar
+seu tráfego, por exemplo). Você pode usar qualquer middleware de sessão Rack
+para fazer isso, um dos seguintes métodos pode ser usado:
+
+```ruby
+enable :sessions
+set :session_store, Rack::Session::Pool
+```
+
+Ou definir as sessões com um hash de opções:
+
+```ruby
+set :sessions, :expire_after => 2592000
+set :session_store, Rack::Session::Pool
+```
+
+Outra opção é **não** usar `enable :sessions`, mas ao invés disso trazer seu
+middleware escolhido como você faria com qualquer outro middleware.
+
+É importante lembrar que usando esse método, a proteção baseada na sessão
+**não estará habilitada por padrão**.
+
+Para o middleware Rack fazer isso, será preciso que isso também seja adicionado:
+
+```ruby
+use Rack::Session::Pool, :expire_after => 2592000
+use Rack::Protection::RemoteToken
+use Rack::Protection::SessionHijacking
+```
+Veja '[Configurando proteção a ataques](#configurando-proteção-a-ataques)' para
+mais informações.
+
+### Parando
 
 Para parar imediatamente uma requisição com um filtro ou rota utilize:
 
@@ -1336,31 +1595,31 @@ Para parar imediatamente uma requisição com um filtro ou rota utilize:
 halt
 ```
 
-Você também pode especificar o status quando parar…
+Você também pode especificar o status quando parar:
 
 ```ruby
 halt 410
 ```
 
-Ou com corpo de texto…
+Ou o corpo:
 
 ```ruby
-halt 'isso será o corpo do texto'
+halt 'isso será o corpo'
 ```
 
-Ou também…
+Ou ambos:
 
 ```ruby
-halt 401, 'vamos embora!'
+halt 401, 'vá embora!'
 ```
 
-Com cabeçalhos…
+Com cabeçalhos:
 
 ```ruby
 halt 402, {'Content-Type' => 'text/plain'}, 'revanche'
 ```
 
-É obviamente possivel combinar um template com o `halt`:
+Também é obviamente possível combinar um template com o `halt`:
 
 ```ruby
 halt erb(:error)
@@ -1383,12 +1642,14 @@ end
 ```
 
 O bloqueio da rota é imediatamente encerrado e o controle continua com a
-próxima rota de parâmetro. Se o parâmetro da rota não for encontrado, um
+próxima rota compatível. Se nenhuma rota compatível for encontrada, um
 404 é retornado.
 
 ### Desencadeando Outra Rota
 
-As vezes o `pass` não é o que você quer, ao invés dele talvez você queira obter o resultado chamando outra rota. Utilize o método `call` neste caso:
+As vezes o `pass` não é o que você quer, ao invés dele talvez você queira obter
+o resultado chamando outra rota. Simplesmente utilize o método `call` neste
+caso:
 
 ```ruby
 get '/foo' do
@@ -1401,271 +1662,1963 @@ get '/bar' do
 end
 ```
 
-Note que no exemplo acima você ganharia performance ao simplemente mover o `"bar"` em um helper usado por ambos `/foo` e `/bar`.
+Note que no exemplo acima você ganharia performance e facilitaria os testes ao
+simplesmente mover `"bar"` para um método auxiliar usado por ambos `/foo`
+e `/bar`.
 
-Se você quer que a requisição seja enviada para a mesma instancia da aplicação ao invês de uma duplicada, use `call!` no lugar de `call`.
+Se você quer que a requisição seja enviada para a mesma instância da aplicação
+no lugar de uma duplicada, use `call!` no lugar de `call`.
 
 Veja a especificação do Rack se você quer aprender mais sobre o `call`.
 
-## Configuração
+### Definindo Corpo, Código de Status e Cabeçalhos
 
-Rodando uma vez, na inicialização, em qualquer ambiente:
+É possível e recomendado definir o código de status e o corpo da resposta com o
+valor retornado do bloco da rota. Entretanto, em alguns cenários você pode
+querer definir o corpo em um ponto arbitrário do fluxo de execução. Você pode
+fazer isso com o metódo auxiliar `body`. Se você fizer isso, poderá usar esse
+metódo de agora em diante para acessar o body:
 
 ```ruby
-configure do
-  ...
+get '/foo' do
+  body "bar"
+end
+
+after do
+  puts body
 end
 ```
 
-Rodando somente quando o ambiente (`APP_ENV` environment variável) é
-setado para `:production`:
+Também é possivel passar um bloco para `body`, que será executado pelo
+manipulador Rack (isso pode ser usado para implementar transmissão,
+[veja "Retorno de Valores"](#retorno-de-valores)).
+
+Similar ao corpo, você pode também definir o código de status e cabeçalhos:
 
 ```ruby
-configure :production do
-  ...
+get '/foo' do
+  status 418
+  headers \
+    "Allow" => "BREW, POST, GET, PROPFIND, WHEN"
+    "Refresh" => "Refresh: 20; https://ietf.org/rfc/rfc2324.txt"
+  body "Eu sou um bule de chá!"
 end
 ```
 
-Rodando quando o ambiente é setado para `:production` ou `:test`:
+Assim como `body`, `headers` e `status` sem argumentos podem ser usados para
+acessar seus valores atuais.
+
+### Transmitindo Respostas
+
+As vezes você quer começar a mandar dados enquanto está gerando partes do corpo
+da resposta. Em exemplos extremos, você quer continuar enviando dados até o
+cliente encerrar a conexão. Você pode usar o método auxiliar `stream` para
+evitar criar seu próprio empacotador:
 
 ```ruby
-configure :production, :test do
-  ...
+get '/' do
+  stream do |out|
+    out << "Isso será len -\n"
+    sleep 0.5
+    out << " Aguarde \n"
+    sleep 1
+    out << " dário!\n"
+  end
 end
 ```
 
-## Tratamento de Erros
-
-Tratamento de erros rodam dentro do mesmo contexto como rotas e filtros
-before, o que significa que você pega todos os presentes que tem para
-oferecer, como `haml`, `erb`, `halt`, etc.
+Isso permite você implementar APIs de Transmissão,
+[Eventos Enviados pelo Servidor](https://w3c.github.io/eventsource/), e pode
+ser usado como a base para
+[WebSockets](https://en.wikipedia.org/wiki/WebSocket). Pode ser usado também
+para aumentar a taxa de transferência se algum, mas não todo, conteúdo depender
+de um recurso lento.
 
-### Não Encontrado
+Perceba que o comportamento da transmissão, especialmente o número de
+requisições concorrentes, depende altamente do servidor web usado para servir a
+aplicação. Alguns servidores podem até mesmo não suportar transmissão de
+maneira alguma. Se o servidor não suportar transmissão, o corpo será enviado
+completamente após que o bloco passado para `stream` terminar de executar.
+Transmissão não funciona de nenhuma maneira com Shotun.
 
-Quando um `Sinatra::NotFound` exception é levantado, ou o código de
-status da reposta é 404, o manipulador `not_found` é invocado:
+Se o parâmetro opcional é definido como `keep_open`, ele não chamará `close` no
+objeto transmitido, permitindo você a fecha-lo em algum outro ponto futuro no
+fluxo de execução. Isso funciona apenas em servidores orientados a eventos,
+como Thin e Rainbows. Outros servidores irão continuar fechando a transmissão:
 
 ```ruby
-not_found do
-  'Isto está longe de ser encontrado'
+# long polling
+
+set :server, :thin
+conexoes = []
+
+get '/assinar' do
+  # registra o interesse de um cliente em servidores de eventos
+  stream(:keep_open) do |saida|
+    conexoes << saida
+    # retire conexões mortas
+    conexoes.reject!(&:closed?)
+  end
 end
-```
 
-### Erro
+post '/:messagem' do
+  conexoes.each do |saida|
+    # notifica o cliente que uma nova mensagem chegou
+    saida << params['messagem'] << "\n"
 
-O manipulador `error` é invocado toda a vez que uma exceção é lançada a
-partir de um bloco de rota ou um filtro. O objeto da exceção pode ser
-obtido a partir da variável Rack `sinatra.error`:
+    # indica ao cliente para se conectar novamente
+    saida.close
+  end
 
-```ruby
-error do
-  'Desculpe, houve um erro desagradável - ' + env['sinatra.error'].message
+  # confirma
+  "messagem recebida"
 end
 ```
 
-Erros customizados:
+Também é possivel para o cliente fechar a conexão quando está tentando escrever
+para o socket. Devido a isso, é recomendado checar `out.closed?` antes de
+tentar escrever.
+
+### Usando Logs
+
+No escopo da requisição, o método auxiliar `logger` expõe uma instância
+`Logger`:
 
 ```ruby
-error MeuErroCustomizado do
-  'Então que aconteceu foi...' + env['sinatra.error'].message
+get '/' do
+  logger.info "loading data"
+  # ...
 end
 ```
 
-Então, se isso acontecer:
+Esse logger irá automaticamente botar as configurações de log do manipulador
+Rack na sua conta. Se a produção de logs estiver desabilitads, esse método
+retornará um objeto dummy, então você não terá que se preocupar com suas rotas
+e filtros.
+
+Perceba que a produção de logs está habilitada apenas para
+`Sinatra::Application` por padrão, então se você herdar de `Sinatra::Base`,
+você provavelmente irá querer habilitar:
 
 ```ruby
-get '/' do
-  raise MeuErroCustomizado, 'alguma coisa ruim'
-end
+  class MyApp < Sinatra::Base
+    configure :production, :development do
+      enable :logging
+    end
+  end
 ```
 
-Você receberá isso:
+Para evitar que qualquer middleware de logs seja configurado, defina a
+configuração `logging` como `nil`. Entretanto, tenha em mente que `logger`
+retornará, nesse caso, `nil`. Um caso de uso comum é quando você quer definir
+seu próprio logger. Sinatra irá usar qualquer um que ele achar
+em `env['rack.logger']`
 
-    Então que aconteceu foi... alguma coisa ruim
+### Tipos Mime
 
-Alternativamente, você pode instalar manipulador de erro para um código
-de status:
+Quando se está usando `send_file` ou arquivos estáticos, você pode ter tipos
+mime que o Sinatra não entende. Use `mime_type` para registrá-los pela extensão
+do arquivo:
 
 ```ruby
-error 403 do
-  'Accesso negado'
-end
-
-get '/secreto' do
-  403
+configure do
+  mime_type :foo, 'text/foo'
 end
 ```
 
-Ou um range:
+Você pode utilizar também com o método auxiliar `content_type`:
 
 ```ruby
-error 400..510 do
-  'Boom'
+get '/' do
+  content-type :foo
+  "foo foo foo"
 end
 ```
 
-O Sinatra instala os manipuladores especiais `not_found` e `error`
-quando roda sobre o ambiente de desenvolvimento.
-
-## Mime Types
+### Gerando URLs
 
-Quando utilizamos `send_file` ou arquivos estáticos você pode ter mime
-types Sinatra não entendidos. Use `mime_type` para registrar eles por
-extensão de arquivos:
+Para gerar URLs você deve usar o metódo auxiliar `url` no Haml:
 
 ```ruby
-mime_type :foo, 'text/foo'
+%a{:href => url('/foo')} foo
 ```
 
-Você também pode utilizar isto com o helper `content_type`:
-
-```ruby
-content_type :foo
-```
+Isso inclui proxies reversos e rotas Rack, se presentes.
 
-## Rack Middleware
+Esse método é também apelidado para `to` (veja
+[abaixo](#redirecionamento-do-browser) para um exemplo).
 
-O Sinatra roda no [Rack](http://rack.github.io/), uma interface
-padrão mínima para frameworks web em Ruby. Um das capacidades mais
-interessantes do Rack para desenvolver aplicativos é suporte a
-“middleware” – componentes que ficam entre o servidor e sua aplicação
-monitorando e/ou manipulando o request/response do HTTP para prover
-vários tipos de funcionalidades comuns.
+### Redirecionamento do Browser
 
-O Sinatra faz construtores pipelines do middleware Rack facilmente em um
-nível superior utilizando o método `use`:
+Você pode lançar um redirecionamento no browser com o metódo auxiliar
+`redirect`:
 
 ```ruby
-require 'sinatra'
-require 'meu_middleware_customizado'
+get '/foo' do
+  redirect to('/bar')
+end
+```
 
-use Rack::Lint
-use MeuMiddlewareCustomizado
+Quaisquer paramêtros adicionais são interpretados como argumentos passados
+ao `halt`:
 
-get '/ola' do
-  'Olá mundo'
-end
+```ruby
+redirect to('/bar'), 303
+redirect 'http://www.google.com/', 'lugar errado, amigo'
 ```
 
-A semântica de `use` é idêntica aquela definida para a DSL
-[Rack::Builder](http://www.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:
+Você pode também facilmente redirecionar para a página da qual o usuário veio
+com `redirect back`:
 
 ```ruby
-use Rack::Auth::Basic do |usuario, senha|
-  usuario == 'admin' && senha == 'secreto'
+get '/foo' do
+  "<a href='/bar'>do something</a>"
+end
+
+get '/bar' do
+  do_something
+  redirect back
 end
 ```
 
-O Rack é distribuido com uma variedade de middleware padrões para logs,
-debugs, rotas de URL, autenticação, e manipuladores de sessão. Sinatra
-utilizada muitos desses componentes automaticamente baseando sobre
-configuração, então, tipicamente você não tem `use` explicitamente.
+Para passar argumentos com um redirecionamento, adicione-os a query:
 
-## Testando
+```ruby
+redirect to('/bar?sum=42')
+```
 
-Testes no Sinatra podem ser escritos utilizando qualquer biblioteca ou
-framework de teste baseados no Rack.
-[Rack::Test](http://gitrdoc.com/brynary/rack-test) é recomendado:
+Ou use uma sessão:
 
 ```ruby
-require 'minha_aplicacao_sinatra'
-require 'rack/test'
+enable :sessions
 
-class MinhaAplicacaoTeste < Minitest::Test
-  include Rack::Test::Methods
+get '/foo' do
+  session[:secret] = 'foo'
+  redirect to('/bar')
+end
 
-  def app
-    Sinatra::Application
-  end
+get '/bar' do
+  session[:secret]
+end
+```
 
-  def meu_test_default
-    get '/'
-    assert_equal 'Ola Mundo!', last_response.body
-  end
+### Controle de Cache
 
-  def teste_com_parametros
-    get '/atender', :name => 'Frank'
-    assert_equal 'Olá Frank!', last_response.bodymeet
-  end
+Definir sues cabeçalhos corretamente é o principal passo para uma correta cache
+HTTP.
 
-  def test_com_ambiente_rack
-    get '/', {}, 'HTTP_USER_AGENT' => 'Songbird'
-    assert_equal "Você está utilizando o Songbird!", last_response.body
-  end
+Você pode facilmente definir o cabeçalho de Cache-Control como:
+
+```ruby
+get '/' do
+  cache_control :public
+  "guarde isso!"
 end
 ```
 
-NOTA: Os módulos de classe embutidos `Sinatra::Test` e
-`Sinatra::TestHarness` são depreciados na versão 0.9.2.
+Dica profissional: Configure a cache em um filtro anterior:
 
-## Sinatra::Base - Middleware, Bibliotecas e aplicativos modulares
+```ruby
+before do
+  cache_control :public, :must_revalidate, :max_age => 60
+end
+```
 
-Definir sua aplicação em um nível superior de trabalho funciona bem para
-micro aplicativos, mas tem consideráveis incovenientes na construção de
-componentes reutilizáveis como um middleware Rack, metal Rails,
-bibliotecas simples como um componente de servidor, ou mesmo extensões
-Sinatra. A DSL de nível superior polui o espaço do objeto e assume um
-estilo de configuração de micro aplicativos (exemplo: uma simples
-arquivo de aplicação, diretórios `./public` e `./views`, logs, página de
-detalhes de exceção, etc.). É onde o `Sinatra::Base` entra em jogo:
+Se você está usando o método auxiliar `expires` para definir seu cabeçalho
+correspondente, `Cache-Control` irá ser definida automaticamente para você:
 
 ```ruby
-require 'sinatra/base'
+before do
+  expires 500, :public, :must_revalidate
+end
+```
 
-class MinhaApp < Sinatra::Base
-  set :sessions, true
-  set :foo, 'bar'
+Para usar propriciamente caches, você deve considerar usar `etag` ou
+`last_modified`. É recomendado chamar esses métodos auxiliares *antes* de fazer
+qualquer tipo de processamento pesado, já que eles irão imediatamente retornar
+uma resposta se o cliente já possui a versão atual na sua cache:
 
-  get '/' do
-    'Ola mundo!'
-  end
+```ruby
+get "/artigo/:id" do
+  @artigo = Artigo.find params['id']
+  last_modified @artigo.updated_at
+  etag @artigo.sha1
+  erb :artigo
 end
 ```
 
-A classe `MinhaApp` é um componente Rack independente que pode agir como
-um middleware Rack, uma aplicação Rack, ou metal Rails. Você pode
-utilizar ou executar esta classe com um arquivo rackup `config.ru`;
-ou, controlar um componente de servidor fornecendo como biblioteca:
+Também é possível usar uma
+[ETag fraca](https://en.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation):
 
 ```ruby
-MinhaApp.run! :host => 'localhost', :port => 9090
+etag @article.sha1, :weak
 ```
+Esses métodos auxiliares não irão fazer nenhum processo de cache para você, mas
+irão alimentar as informações necessárias para sua cache. Se você está
+pesquisando por uma solução rápida de fazer cache com proxy-reverso, tente
+[rack-cache](https://github.com/rtomayko/rack-cache#readme):
 
-Os métodos disponíveis para subclasses `Sinatra::Base` são exatamente como
-aqueles disponíveis via a DSL de nível superior. Aplicações de nível
-mais alto podem ser convertidas para componentes `Sinatra::Base` com duas
-modificações:
-
--   Seu arquivo deve requerer `sinatra/base` ao invés de `sinatra`;
-    outra coisa, todos os métodos DSL do Sinatra são importados para o
-    espaço principal.
+```ruby
+require "rack/cache"
+require "sinatra"
 
--   Coloque as rotas da sua aplicação, manipuladores de erro, filtros e
-    opções na subclasse de um `Sinatra::Base`.
+use Rack::Cache
 
-`Sinatra::Base` é um quadro branco. Muitas opções são desabilitadas por
+get '/' do
+  cache_control :public, :max_age => 36000
+  sleep 5
+  "olá"
+end
+```
+
+Use a configuração `:static_cache_control` (veja [acima]#(controle-de-cache))
+para adicionar o cabeçalho de informação `Cache-Control` para arquivos
+estáticos.
+
+De acordo com a RFC 2616, sua aplicação deve se comportar diferentemente se o
+cabeçalho If-Match ou If-None-Match é definido para `*`, dependendo se o
+recurso requisitado já existe. Sinatra assume que recursos para requisições
+seguras (como get) e idempotentes (como put) já existem, enquanto que para
+outros recursos (por exemplo requisições post) são tratados como novos
+recursos. Você pode mudar esse comportamento passando em uma opção
+`:new_resource`:
+
+```ruby
+get '/create' do
+  etag '', :new_resource => true
+  Artigo.create
+  erb :novo_artigo
+end
+```
+
+Se você quer continuar usando um ETag fraco, passe em uma opção `:kind`:
+
+```ruby
+etag '', :new_resource => true, :kind => :weak
+```
+
+### Enviando Arquivos
+
+Para retornar os conteúdos de um arquivo como as resposta, você pode usar o
+metódo auxiliar `send_file`:
+
+```ruby
+get '/' do
+  send_file 'foo.png'
+end
+```
+
+Também aceita opções:
+
+```ruby
+send_file 'foo.png', :type => :jpg
+```
+
+As opções são:
+
+<dl>
+  <dt>filename</dt>
+    <dd>Nome do arquivo a ser usado na respota,
+    o padrão é o nome do arquivo reak</dd>
+  <dt>last_modified</dt>
+    <dd>Valor do cabeçalho Last-Modified, o padrão corresponde ao mtime do
+    arquivo.</dd>
+
+  <dt>type</dt>
+    <dd>Valor do cabeçalho Content-Type, extraído da extensão do arquivo se
+    inexistente.</dd>
+
+  <dt>disposition</dt>
+    <dd>
+      Valor do cabeçalho Content-Disposition, valores possíveis: <tt>nil</tt>
+      (default), <tt>:attachment</tt> and <tt>:inline</tt>
+    </dd>
+
+  <dt>length</dt>
+    <dd>Valor do cabeçalho Content-Length, o padrão corresponde ao tamanho do
+    arquivo.</dd>
+
+  <dt>status</dt>
+    <dd>
+      Código de status a ser enviado. Útil quando está se enviando um arquivo
+      estático como uma página de erro. Se suportado pelo handler do Rack,
+      outros meios além de transmissão do processo do Ruby serão usados.
+      So você usar esse metódo auxiliar, o Sinatra irá automaticamente lidar com
+      requisições de alcance.
+    </dd>
+</dl>
+
+### Acessando o Objeto da Requisção
+
+O objeto vindo da requisição pode ser acessado do nível de requsição (filtros,
+rotas, manipuladores de erro) através do método `request`:
+
+```ruby
+# app rodando em http://exemplo.com/exemplo
+get '/foo' do
+  t = %w[text/css text/html application/javascript]
+  request.accept              # ['text/html', '*/*']
+  request.accept? 'text/xml'  # true
+  request.preferred_type(t)   # 'text/html'
+  request.body                # corpo da requisição enviado pelo cliente (veja abaixo)
+  request.scheme              # "http"
+  request.script_name         # "/exemplo"
+  request.path_info           # "/foo"
+  request.port                # 80
+  request.request_method      # "GET"
+  request.query_string        # ""
+  request.content_length      # tamanho do request.body
+  request.media_type          # tipo de mídia of request.body
+  request.host                # "exemplo.com"
+  request.get?                # true (metodo similar para outros tipos de requisição)
+  request.form_data?          # false
+  request["algum_ param"]     # valor do paramêtro 'algum_param'. [] é um atalho para o hash de parametros
+  request.referrer            # a referência do cliente ou '/'
+  request.user_agent          # agente de usuário (usado por :agent condition)
+  request.cookies             # hash dos cookies do browser
+  request.xhr?                # isto é uma requisição ajax?
+  request.url                 # "http://exemplo.com/exemplo/foo"
+  request.path                # "/exemplo/foo"
+  request.ip                  # endereço de IP do cliente
+  request.secure?             # false (seria true se a conexão fosse ssl)
+  request.forwarded?          # true (se está rodando por um proxy reverso)
+  request.env                 # raw env hash handed in by Rack
+end
+```
+
+Algumas opções, como `script_name` ou `path_info, podem ser escritas como:
+
+```ruby
+before { request.path_info = "/" }
+
+get "/" do
+  "todas requisições acabam aqui"
+end
+```
+`request.body` é uma ES ou um objeo StringIO:
+
+```ruby
+post "/api" do
+  request.body.rewind  # em caso de algo já ter lido
+  data = JSON.parse request.body.read
+  "Oi #{data['nome']}!"
+end
+```
+
+### Anexos
+
+Você pode usar o método auxiliar `attachment` para dizer ao navegador que a
+reposta deve ser armazenada no disco no lugar de ser exibida no browser:
+
+```ruby
+get '/' do
+  attachment "info.txt"
+  "salve isso!"
+end
+```
+
+### Trabalhando com Data e Hora
+
+O Sinatra oferece um método auxiliar `time_for` que gera um objeto Time do
+valor dado. É também possível converter `DateTime`, `Date` e classes similares:
+
+
+```ruby
+get '/' do
+  pass if Time.now > time_for('Dec 23, 2016')
+  "continua no tempo"
+end
+```
+
+Esse método é usado internamente por `expires`, `last_modified` e akin. Você
+pode portanto facilmente estender o comportamento desses métodos sobrescrevendo
+`time_for` na sua aplicação:
+
+```ruby
+helpers do
+  def time_for(valor)
+    case valor
+    when :ontem then Time.now - 24*60*60
+    when :amanha then Time.now + 24*60*60
+    else super
+    end
+  end
+end
+
+get '/' do
+  last_modified :ontem
+  expires :amanha
+  "oi"
+end
+```
+
+### Pesquisando por Arquivos de Template
+
+O método auxiliar `find_template` é usado para encontrar arquivos de template
+para renderizar:
+
+```ruby
+find_template settings.views, 'foo', Tilt[:haml] do |arquivo|
+  puts "pode ser #{arquivo}"
+end
+```
+
+Isso não é realmente útil. Mas é útil que você possa na verdade sobrescrever
+esse método para conectar no seu próprio mecanismo de pesquisa. Por exemplo, se
+você quer ser capaz de usar mais de um diretório de view:
+
+```ruby
+set :views, ['views', 'templates']
+
+helpers do
+  def find_template(views, name, engine, &block)
+    Array(views).each { |v| super(v, name, engine, &block) }
+  end
+end
+```
+
+Outro exemplo seria utilizando diretórios diferentes para motores (engines)
+diferentes:
+
+```ruby
+set :views, :sass => 'views/sass', :haml => 'templates', :default => 'views'
+
+helpers do
+  def find_template(views, name, engine, &block)
+    _, folder = views.detect { |k,v| engine == Tilt[k] }
+    folder ||= views[:default]
+    super(folder, name, engine, &block)
+  end
+end
+```
+
+Você pode facilmente embrulhar isso é uma extensão e compartilhar com outras
+pessoas!
+
+Perceba que `find_template` não verifica se o arquivo realmente existe. Ao
+invés disso, ele chama o bloco dado para todos os caminhos possíveis. Isso não
+significa um problema de perfomance, já que `render` irá usar `break` assim que
+o arquivo é encontrado. Além disso, as localizações (e conteúdo) de templates
+serão guardados na cache se você não estiver rodando no modo de
+desenvolvimento. Você deve se lembrar disso se você escrever um método
+realmente maluco.
+
+## Configuração
+
+É possível e recomendado definir o código de status e o corpo da resposta com o
+valor retornado do bloco da rota. Entretanto, em alguns cenários você pode
+querer definir o corpo em um ponto arbitrário do fluxo de execução. Você pode
+fazer isso com o metódo auxiliar `body`. Se você fizer isso, poderá usar esse
+metódo de agora em diante para acessar o body:
+
+```ruby
+get '/foo' do
+  body "bar"
+end
+
+after do
+  puts body
+end
+```
+
+Também é possivel passar um bloco para `body`, que será executado pelo
+manipulador Rack (isso pode ser usado para implementar transmissão,
+[veja "Retorno de Valores"](#retorno-de-valores)).
+
+Similar ao corpo, você pode também definir o código de status e cabeçalhos:
+
+```ruby
+get '/foo' do
+  status 418
+  headers \
+    "Allow" => "BREW, POST, GET, PROPFIND, WHEN"
+    "Refresh" => "Refresh: 20; https://ietf.org/rfc/rfc2324.txt"
+  body "Eu sou um bule de chá!"
+end
+```
+
+Assim como `body`, `headers` e `status` sem argumentos podem ser usados para
+acessar seus valores atuais.
+
+### Transmitindo Respostas
+
+As vezes você quer começar a mandar dados enquanto está gerando partes do corpo
+da resposta. Em exemplos extremos, você quer continuar enviando dados até o
+cliente encerrar a conexão. Você pode usar o método auxiliar `stream` para
+evitar criar seu próprio empacotador:
+
+```ruby
+get '/' do
+  stream do |out|
+    out << "Isso será len -\n"
+    sleep 0.5
+    out << " Aguarde \n"
+    sleep 1
+    out << " dário!\n"
+  end
+end
+```
+
+Isso permite você implementar APIs de Transmissão,
+[Eventos Enviados pelo Servidor](https://w3c.github.io/eventsource/), e pode
+ser usado como a base para
+[WebSockets](https://en.wikipedia.org/wiki/WebSocket). Pode ser usado também
+para aumentar a taxa de transferência se algum, mas não todo, conteúdo depender
+de um recurso lento.
+
+Perceba que o comportamento da transmissão, especialmente o número de
+requisições concorrentes, depende altamente do servidor web usado para servir a
+aplicação. Alguns servidores podem até mesmo não suportar transmissão de
+maneira alguma. Se o servidor não suportar transmissão, o corpo será enviado
+completamente após que o bloco passado para `stream` terminar de executar.
+Transmissão não funciona de nenhuma maneira com Shotun.
+
+Se o parâmetro opcional é definido como `keep_open`, ele não chamará `close` no
+objeto transmitido, permitindo você a fecha-lo em algum outro ponto futuro no
+fluxo de execução. Isso funciona apenas em servidores orientados a eventos,
+como Thin e Rainbows. Outros servidores irão continuar fechando a transmissão:
+
+```ruby
+# long polling
+
+set :server, :thin
+conexoes = []
+
+get '/assinar' do
+  # registra o interesse de um cliente em servidores de eventos
+  stream(:keep_open) do |saida|
+    conexoes << saida
+    # retire conexões mortas
+    conexoes.reject!(&:closed?)
+  end
+end
+
+post '/:messagem' do
+  conexoes.each do |saida|
+    # notifica o cliente que uma nova mensagem chegou
+    saida << params['messagem'] << "\n"
+
+    # indica ao cliente para se conectar novamente
+    saida.close
+  end
+
+  # confirma
+  "messagem recebida"
+end
+```
+
+Também é possivel para o cliente fechar a conexão quando está tentando escrever
+para o socket. Devido a isso, é recomendado checar `out.closed?` antes de
+tentar escrever.
+
+### Usando Logs
+
+No escopo da requisição, o método auxiliar `logger` expõe uma instância
+`Logger`:
+
+```ruby
+get '/' do
+  logger.info "loading data"
+  # ...
+end
+```
+
+Esse logger irá automaticamente botar as configurações de log do manipulador
+Rack na sua conta. Se a produção de logs estiver desabilitads, esse método
+retornará um objeto dummy, então você não terá que se preocupar com suas rotas
+e filtros.
+
+Perceba que a produção de logs está habilitada apenas para
+`Sinatra::Application` por padrão, então se você herdar de `Sinatra::Base`,
+você provavelmente irá querer habilitar:
+
+```ruby
+  class MyApp < Sinatra::Base
+    configure :production, :development do
+      enable :logging
+    end
+  end
+```
+
+Para evitar que qualquer middleware de logs seja configurado, defina a
+configuração `logging` como `nil`. Entretanto, tenha em mente que `logger`
+retornará, nesse caso, `nil`. Um caso de uso comum é quando você quer definir
+seu próprio logger. Sinatra irá usar qualquer um que ele achar em
+`env['rack.logger']`
+
+### Tipos Mime
+
+Quando se está usando `send_file` ou arquivos estáticos, você pode ter tipos
+Mime que o Sinatra não entende. Use `mime_type` para registrá-los pela extensão
+do arquivo:
+
+```ruby
+configure do
+  mime_type :foo, 'text/foo'
+end
+```
+
+Você pode utilizar também com o método auxiliar `content_type`:
+
+```ruby
+get '/' do
+  content-type :foo
+  "foo foo foo"
+end
+```
+
+### Gerando URLs
+
+Para gerar URLs você deve usar o metódo auxiliar `url` no Haml:
+
+```ruby
+%a{:href => url('/foo')} foo
+```
+
+Isso inclui proxies reversos e rotas Rack, se presentes.
+
+Esse método é também apelidado para `to` (veja
+[abaixo](#redirecionamento-do-browser) para um exemplo).
+
+### Redirecionamento do Browser
+
+Você pode lançar um redirecionamento no browser com o metódo auxiliar
+`redirect`:
+
+```ruby
+get '/foo' do
+  redirect to('/bar')
+end
+```
+
+Quaisquer paramêtros adicionais são interpretados como argumentos passados ao
+`halt`:
+
+```ruby
+redirect to('/bar'), 303
+redirect 'http://www.google.com/', 'lugar errado, amigo'
+```
+
+Você pode também facilmente redirecionar para a página da qual o usuário veio
+com `redirect back`:
+
+```ruby
+get '/foo' do
+  "<a href='/bar'>do something</a>"
+end
+
+get '/bar' do
+  do_something
+  redirect back
+end
+```
+
+Para passar argumentos com um redirecionamento, adicione-os a query:
+
+```ruby
+redirect to('/bar?sum=42')
+```
+
+Ou use uma sessão:
+
+```ruby
+enable :sessions
+
+get '/foo' do
+  session[:secret] = 'foo'
+  redirect to('/bar')
+end
+
+get '/bar' do
+  session[:secret]
+end
+```
+
+### Controle de Cache
+
+Definir sues cabeçalhos corretamente é o principal passo para uma correta cache
+HTTP.
+
+Você pode facilmente definir o cabeçalho de Cache-Control como:
+
+```ruby
+get '/' do
+  cache_control :public
+  "guarde isso!"
+end
+```
+
+Dica profissional: Configure a cache em um filtro anterior:
+
+```ruby
+before do
+  cache_control :public, :must_revalidate, :max_age => 60
+end
+```
+
+Se você está usando o método auxiliar `expires` para definir seu cabeçalho
+correspondente, `Cache-Control` irá ser definida automaticamente para você:
+
+```ruby
+before do
+  expires 500, :public, :must_revalidate
+end
+```
+
+Para usar propriciamente caches, você deve considerar usar `etag` ou
+`last_modified`. É recomendado chamar esses métodos auxiliares *antes* de fazer
+qualquer tipo de processamento pesado, já que eles irão imediatamente retornar
+uma resposta se o cliente já possui a versão atual na sua cache:
+
+```ruby
+get "/artigo/:id" do
+  @artigo = Artigo.find params['id']
+  last_modified @artigo.updated_at
+  etag @artigo.sha1
+  erb :artigo
+end
+```
+
+Também é possível usar uma
+[ETag fraca](https://en.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation):
+
+```ruby
+etag @article.sha1, :weak
+```
+Esses métodos auxiliares não irão fazer nenhum processo de cache para você, mas
+irão alimentar as informações necessárias para sua cache. Se você está
+pesquisando por uma solução rápida de fazer cache com proxy-reverso, tente
+[rack-cache](https://github.com/rtomayko/rack-cache#readme):
+
+```ruby
+require "rack/cache"
+require "sinatra"
+
+use Rack::Cache
+
+get '/' do
+  cache_control :public, :max_age => 36000
+  sleep 5
+  "olá"
+end
+```
+
+Use a configuração `:static_cache_control` (veja [acima]#(controle-de-cache))
+para adicionar o cabeçalho de informação `Cache-Control` para arquivos
+estáticos.
+
+De acordo com a RFC 2616, sua aplicação deve se comportar diferentemente se o
+cabeçalho If-Match ou If-None-Match é definido para `*`, dependendo se o
+recurso requisitado já existe. Sinatra assume que recursos para requisições
+seguras (como get) e idempotentes (como put) já existem, enquanto que para
+outros recursos (por exemplo requisições post) são tratados como novos
+recursos. Você pode mudar esse comportamento passando em uma opção
+`:new_resource`:
+
+```ruby
+get '/create' do
+  etag '', :new_resource => true
+  Artigo.create
+  erb :novo_artigo
+end
+```
+
+Se você quer continuar usando um ETag fraco, passe em uma opção `:kind`:
+
+```ruby
+etag '', :new_resource => true, :kind => :weak
+```
+
+### Enviando Arquivos
+
+Para retornar os conteúdos de um arquivo como as resposta, você pode usar o
+metódo auxiliar `send_file`:
+
+```ruby
+get '/' do
+  send_file 'foo.png'
+end
+```
+
+Também aceita opções:
+
+```ruby
+send_file 'foo.png', :type => :jpg
+```
+
+As opções são:
+
+<dl>
+  <dt>filename</dt>
+    <dd>Nome do arquivo a ser usado na respota,
+    o padrão é o nome do arquivo reak</dd>
+  <dt>last_modified</dt>
+    <dd>Valor do cabeçalho Last-Modified, o padrão corresponde ao mtime do
+    arquivo.</dd>
+
+  <dt>type</dt>
+    <dd>Valor do cabeçalho Content-Type, extraído da extensão do arquivo se
+    inexistente.</dd>
+
+  <dt>disposition</dt>
+    <dd>
+      Valor do cabeçalho Content-Disposition, valores possíveis: <tt>nil</tt>
+      (default), <tt>:attachment</tt> and <tt>:inline</tt>
+    </dd>
+
+  <dt>length</dt>
+    <dd>Valor do cabeçalho Content-Length, o padrão corresponde ao tamanho do
+    arquivo.</dd>
+
+  <dt>status</dt>
+    <dd>
+      Código de status a ser enviado. Útil quando está se enviando um arquivo
+      estático como uma página de erro. Se suportado pelo handler do Rack,
+      outros meios além de transmissão do processo do Ruby serão usados.
+      So você usar esse metódo auxiliar, o Sinatra irá automaticamente lidar
+      com requisições de alcance.
+    </dd>
+</dl>
+
+### Acessando o Objeto da Requisção
+
+O objeto vindo da requisição pode ser acessado do nível de requsição (filtros,
+rotas, manipuladores de erro) através do método `request`:
+
+```ruby
+# app rodando em http://exemplo.com/exemplo
+get '/foo' do
+  t = %w[text/css text/html application/javascript]
+  request.accept              # ['text/html', '*/*']
+  request.accept? 'text/xml'  # true
+  request.preferred_type(t)   # 'text/html'
+  request.body                # corpo da requisição enviado pelo cliente (veja abaixo)
+  request.scheme              # "http"
+  request.script_name         # "/exemplo"
+  request.path_info           # "/foo"
+  request.port                # 80
+  request.request_method      # "GET"
+  request.query_string        # ""
+  request.content_length      # tamanho do request.body
+  request.media_type          # tipo de mídia of request.body
+  request.host                # "exemplo.com"
+  request.get?                # true (metodo similar para outros tipos de requisição)
+  request.form_data?          # false
+  request["algum_ param"]     # valor do paramêtro 'algum_param'. [] é um atalho para o hash de parametros
+  request.referrer            # a referência do cliente ou '/'
+  request.user_agent          # agente de usuário (usado por :agent condition)
+  request.cookies             # hash dos cookies do browser
+  request.xhr?                # isto é uma requisição ajax?
+  request.url                 # "http://exemplo.com/exemplo/foo"
+  request.path                # "/exemplo/foo"
+  request.ip                  # endereço de IP do cliente
+  request.secure?             # false (seria true se a conexão fosse ssl)
+  request.forwarded?          # true (se está rodando por um proxy reverso)
+  request.env                 # raw env hash handed in by Rack
+end
+```
+
+Algumas opções, como `script_name` ou `path_info, podem ser escritas como:
+
+```ruby
+before { request.path_info = "/" }
+
+get "/" do
+  "todas requisições acabam aqui"
+end
+```
+`request.body` é uma ES ou um objeo StringIO:
+
+```ruby
+post "/api" do
+  request.body.rewind  # em caso de algo já ter lido
+  data = JSON.parse request.body.read
+  "Oi #{data['nome']}!"
+end
+```
+
+### Anexos
+
+Você pode usar o método auxiliar `attachment` para dizer ao navegador que a
+reposta deve ser armazenada no disco no lugar de ser exibida no browser:
+
+```ruby
+get '/' do
+  attachment "info.txt"
+  "salve isso!"
+end
+```
+
+### Trabalhando com Data e Hora
+
+O Sinatra oferece um método auxiliar `time_for` que gera um objeto Time do
+valor dado. É também possível converter `DateTime`, `Date` e classes similares:
+
+
+```ruby
+get '/' do
+  pass if Time.now > time_for('Dec 23, 2016')
+  "continua no tempo"
+end
+```
+
+Esse método é usado internamente por `expires`, `last_modified` e akin. Você
+pode portanto facilmente estender o comportamento desses métodos sobrescrevendo
+`time_for` na sua aplicação:
+
+```ruby
+helpers do
+  def time_for(valor)
+    case valor
+    when :ontem then Time.now - 24*60*60
+    when :amanha then Time.now + 24*60*60
+    else super
+    end
+  end
+end
+
+get '/' do
+  last_modified :ontem
+  expires :amanha
+  "oi"
+end
+```
+
+### Pesquisando por Arquivos de Template
+
+O método auxiliar `find_template` é usado para encontrar arquivos de template
+para renderizar:
+
+```ruby
+find_template settings.views, 'foo', Tilt[:haml] do |arquivo|
+  puts "pode ser #{arquivo}"
+end
+```
+
+Isso não é realmente útil. Mas é útil que você possa na verdade sobrescrever
+esse método para conectar no seu próprio mecanismo de pesquisa. Por exemplo, se
+você quer ser capaz de usar mais de um diretório de view:
+
+```ruby
+set :views, ['views', 'templates']
+
+helpers do
+  def find_template(views, name, engine, &block)
+    Array(views).each { |v| super(v, name, engine, &block) }
+  end
+end
+```
+
+Outro exemplo seria utilizando diretórios diferentes para motores (engines)
+diferentes:
+
+```ruby
+set :views, :sass => 'views/sass', :haml => 'templates', :default => 'views'
+
+helpers do
+  def find_template(views, name, engine, &block)
+    _, folder = views.detect { |k,v| engine == Tilt[k] }
+    folder ||= views[:default]
+    super(folder, name, engine, &block)
+  end
+end
+```
+
+Você pode facilmente embrulhar isso é uma extensão e compartilhar com outras
+pessoas!
+
+Perceba que `find_template` não verifica se o arquivo realmente existe. Ao
+invés disso, ele chama o bloco dado para todos os caminhos possíveis. Isso não
+significa um problema de perfomance, já que `render` irá usar `break` assim que
+o arquivo é encontrado. Além disso, as localizações (e conteúdo) de templates
+serão guardados na cache se você não estiver rodando no modo de
+desenvolvimento. Você deve se lembrar disso se você escrever um método
+realmente maluco.
+
+## Configuração
+
+Rode uma vez, na inicialização, em qualquer ambiente:
+
+```ruby
+configure do
+  ...
+end
+```
+
+```ruby
+configure do
+  # configurando uma opção
+  set :option, 'value'
+
+  # configurando múltiplas opções
+  set :a => 1, :b => 2
+
+  # o mesmo que `set :option, true`
+  enable :option
+
+  # o mesmo que `set :option, false`
+  disable :option
+
+  # você pode também ter configurações dinâmicas com blocos
+  set(:css_dir) { File.join(views, 'css') }
+end
+```
+
+Rode somente quando o ambiente (`APP_ENV` variável de ambiente) é definida para
+`:production`:
+
+```ruby
+configure :production do
+  ...
+end
+```
+
+Rode quando o ambiente é definido para `:production` ou `:test`:
+
+```ruby
+configure :production, :test do
+  ...
+end
+```
+
+Você pode acessar essas opções por meio de `settings`:
+
+```ruby
+configure do
+  set :foo, 'bar'
+end
+
+get '/' do
+  settings.foo? # => true
+  settings.foo  # => 'bar'
+  ...
+end
+```
+
+### Configurando proteção a ataques
+
+O Sinatra está usando
+[Rack::Protection](https://github.com/sinatra/sinatra/tree/master/rack-protection#readme)
+para defender sua aplicação contra ataques oportunistas comuns. Você pode
+facilmente desabilitar esse comportamento (o que irá abrir sua aplicação à
+toneladas de vulnerabilidades comuns):
+
+```ruby
+disable :protection
+```
+
+Para pular uma única camada de defesa, defina `protection` como um hash de
+opções:
+
+```ruby
+set :protection, :except => :path_traversal
+```
+
+Você também pode definir em um array, visando desabilitar uma lista de
+proteções:
+
+```ruby
+set :protection, :except => [:path_traversal, :session_hijacking]
+```
+
+Por padrão, o Sinatra irá configurar apenas sessões com proteção se `:sessions`
+tiver sido habilitado. Veja '[Utilizando Sessões](#utilizando-sessões)'. As
+vezes você pode querer configurar sessões "fora" da aplicação do Sinatra, como
+em config.ru ou com uma instância de `Rack::Builder` separada. Nesse caso, você
+pode continuar configurando uma sessão com proteção passando a opção `:session`:
+
+```ruby
+set :protection, :session => true
+```
+
+### Configurações Disponíveis
+
+<dl>
+  <dt>absolute_redirects</dt>
+    <dd>
+      Se desabilitada, o Sinatra irá permitir redirecionamentos relativos,
+      entretanto, isso não estará conforme a RFC 2616 (HTTP 1.1), que permite
+      apenas redirecionamentos absolutos.
+    </dd>
+    <dd>
+      Habilite se sua aplicação estiver rodando antes de um proxy reverso que
+      não foi configurado corretamente. Note que o método auxiliar <tt>url</tt>
+      irá continuar produzindo URLs absolutas, a não ser que você passe
+      <tt>false</tt> como segundo parâmetro.
+    </dd>
+    <dd>Desabilitado por padrão.</dd>
+
+  <dt>add_charset</dt>
+    <dd>
+      Para tipos Mime o método auxiliar <tt>content_type</tt> irá
+      automaticamente adicionar a informção de codificação. Você deve adcionar
+      isto no lugar de sobrescrever essa opção:
+      <tt>settings.add_charset << "application/foobar"</tt>
+    </dd>
+
+  <dt>app_file</dt>
+    <dd>
+      Caminho para o arquivo principal da aplicação, usado para detectar a raíz
+      do projeto, views e pastas públicas e templates inline.
+    </dd>
+
+  <dt>bind</dt>
+    <dd>
+      Endereço IP a ser ligado (padrão: <tt>0.0.0.0</tt> ou <tt>localhost</tt>
+      se seu ambiente está definido como desenvolvimento). Usado apenas para
+      servidor embutido.
+    </dd>
+
+  <dt>default_encoding</dt>
+    <dd>Codificação assumida caso a mesma seja desconhecida (padrão corresponde
+    a <tt>"utf-8"</tt>).</dd>
+
+  <dt>dump_errors</dt>
+    <dd>Exibe erros no log.</dd>
+
+  <dt>environment</dt>
+    <dd>
+      Ambiente atual. O padrão é <tt>ENV['APP_ENV']</tt>, ou
+      <tt>"development"</tt> se o primeiro não estiver disponível.
+    </dd>
+
+  <dt>logging</dt>
+    <dd>Usa o logger.</dd>
+
+  <dt>lock</dt>
+    <dd>
+      Coloca um bloqueio em torno de cada requisição, executando apenas
+      processamento sob requisição por processo Ruby simultaneamente.
+    </dd>
+    <dd>Habilitado se sua aplicação não for 'thread-safe'. Desabilitado por
+    padrão.</dd>
+
+  <dt>method_override</dt>
+    <dd>
+      Use a mágica <tt>_method</tt> para permitir formulários put/delete em
+      navegadores que não oferecem suporte à essas operações.
+    </dd>
+
+  <dt>mustermann_opts</dt>
+    <dd>
+      Um hash de opções padrão para passar a Mustermann.new quando se está
+      compilado os caminho de roteamento.
+    </dd>
+
+  <dt>port</dt>
+    <dd>Porta a ser escutada. Usado apenas para servidores embutidos.</dd>
+
+  <dt>prefixed_redirects</dt>
+    <dd>
+      Inserir ou não inserir <tt>request.script_name</tt> nos redirecionamentos
+      se nenhum caminho absoluto for dado. Dessa forma <tt>redirect '/foo'</tt>
+      irá se comportar como <tt>redirect to('/foo').</tt>
+    </dd>
+    <dd>Desabilitado por padrão.</dd>
+
+  <dt>protection</dt>
+    <dd>
+      Habilitar ou não proteções a ataques web. Veja a sessão de proteção acima.
+    </dd>
+
+  <dt>public_dir</dt>
+    <dd>Apelido para <tt>public_folder</tt>. Veja abaixo.</dd>
+
+  <dt>public_folder</dt>
+    <dd>
+      Caminho para o diretório de arquivos públicos. Usado apenas se a exibição
+      de arquivos estáticos estiver habilitada (veja a configuração
+      <tt>static</tt> abaixo). Deduzido da configuração <tt>app_file</tt> se
+      não for definido.
+    </dd>
+
+  <dt>quiet</dt>
+    <dd>
+      Desabilita logs gerados pelos comandos de inicio e parada do Sinatra.
+      <tt>false</tt> por padrão.
+    </dd>
+
+  <dt>reload_templates</dt>
+    <dd>
+      Se deve ou não recarregar templates entre as requisições. Habilitado no
+      modo de desenvolvimento.
+    </dd>
+
+  <dt>root</dt>
+    <dd>
+      Caminho para o diretório raíz do projeto. Deduzido da configuração
+      <tt>app_file</tt> se não for definido.
+    </dd>
+
+  <dt>raise_errors</dt>
+    <dd>
+      Lança exceções (irá para a aplicação). Habilitado por padrão quando o
+      ambiente está definido para <tt>"test</tt>, desabilitado em caso
+      contrário.
+    </dd>
+
+  <dt>run</dt>
+    <dd>
+      Se habilitado, o Sinatra irá lidar com o início do servidor web. Não
+      habilite se estiver usando rackup ou outros meios.
+    </dd>
+
+  <dt>running</dt>
+    <dd>É o servidor embutido que está rodando agora? Não mude essa
+    configuração!</dd>
+
+  <dt>server</dt>
+    <dd>
+      Servidor ou listas de servidores para usar o servidor embutido. A ordem
+      indica prioridade, por padrão depende da implementação do Ruby
+    </dd>
+
+  <dt>server_settings</dt>
+    <dd>
+      Se você estiver usando um servidor web WEBrick, presumidamente para seu
+      ambiente de desenvolvimento, você pode passar um hash de opções para
+      <tt>server_settings</tt>, tais como <tt>SSLEnable</tt> ou
+      <tt>SSLVerifyClient</tt>. Entretanto, servidores web como Puma e Thin não
+      suportam isso, então você pode definir <tt>server_settings</tt> como um
+      metódo quando chamar <tt>configure</tt>.
+    </dd>
+
+  <dt>sessions</dt>
+    <dd>
+      Habilita o suporte a sessões baseadas em cookie usando
+      <tt>Rack::Session::Cookie</tt>. Veja a seção 'Usando Sessões' para mais
+      informações.
+    </dd>
+
+  <dt>session_store</dt>
+    <dd>
+      O middleware de sessão Rack usado. O padrão é
+      <tt>Rack::Session::Cookie</tt>. Veja a sessão 'Usando Sessões' para mais
+      informações.
+    </dd>
+
+  <dt>show_exceptions</dt>
+    <dd>
+      Mostra um relatório de erros no navegador quando uma exceção ocorrer.
+      Habilitado por padrão quando o <tt>ambiente</tt> é definido como
+      <tt>"development"</tt>, desabilitado caso contrário.
+    </dd>
+    <dd>
+      Pode também ser definido para <tt>:after_handler</tt> para disparar um
+      manipulador de erro específico da aplicação antes de mostrar um relatório
+      de erros no navagador.
+    </dd>
+
+  <dt>static</dt>
+    <dd>
+    Define se o Sinatra deve lidar com o oferecimento de arquivos
+    estáticos.
+    </dd>
+    <dd>
+    Desabilitado quando está utilizando um servidor capaz de fazer isso
+    sozinho.
+    </dd>
+    <dd>Desabilitar irá aumentar a perfomance</dd>
+    <dd>
+      Habilitado por padrão no estilo clássico, desabilitado para aplicações
+      modulares.
+    </dd>
+
+  <dt>static_cache_control</dt>
+    <dd>
+      Quando o Sinatra está oferecendo arquivos estáticos, definir isso irá
+      adicionar cabeçalhos <tt>Cache-Control</tt> nas respostas. Usa o método
+      auxiliar <tt>cache-control</tt>. Desabilitado por padrão.
+    </dd>
+    <dd>
+      Use um array explícito quando estiver definindo múltiplos valores:
+      <tt>set :static_cache_control, [:public, :max_age => 300]</tt>
+    </dd>
+
+  <dt>threaded</dt>
+    <dd>
+      Se estiver definido como <tt>true</tt>, irá definir que o Thin use
+      <tt>EventMachine.defer</tt> para processar a requisição.
+    </dd>
+
+  <dt>traps</dt>
+    <dd>Define se o Sinatra deve lidar com sinais do sistema.</dd>
+
+  <dt>views</dt>
+    <dd>
+      Caminho para o diretório de views. Deduzido da configuração
+      <tt>app_file</tt> se não estiver definido.
+    </dd>
+
+  <dt>x_cascade</dt>
+    <dd>
+      Se deve ou não definir o cabeçalho X-Cascade se nenhuma rota combinar.
+      Definido como padrão <tt>true</tt>
+    </dd>
+</dl>
+
+## Ambientes
+
+Existem três `environments` (ambientes) pré-definidos: `"development"`
+(desenvolvimento), `"production"` (produção) e `"test"` (teste). Ambientes
+podem ser definidos através da variável de ambiente `APP_ENV`. O valor padrão é
+`"development"`. No ambiente `"development"` todos os templates são
+recarregados entre as requisições e manipuladores especiais como `not_found` e
+`error` exibem relatórios de erros no seu navegador. Nos ambientes de
+`"production"` e `"test"`, os templates são guardos em cache por padrão.
+
+Para rodar diferentes ambientes, defina a variável de ambiente `APP_ENV`:
+
+```shell
+APP_ENV=production ruby minha_app.rb
+```
+
+Você pode usar métodos pré-definidos: `development?`, `test?` e `production?`
+para checar a configuração atual de ambiente:
+
+```ruby
+get '/' do
+  if settings.development?
+    "desenvolvimento!"
+  else
+    "não está em desenvolvimento!"
+  end
+end
+```
+
+## Tratamento de Erros
+
+Manipuladores de erros rodam dentro do mesmo contexto como rotas e filtros
+before, o que significa que você pega todos os "presentes" que eles têm para
+oferecer, como `haml`, `erb`, `halt`, etc.
+
+### Não Encontrado
+
+Quando uma exceção `Sinatra::NotFound` é lançada, ou o código de
+status da reposta é 404, o manipulador `not_found` é invocado:
+
+```ruby
+not_found do
+  'Isto está longe de ser encontrado'
+end
+```
+
+### Erro
+
+O manipulador `error` é invocado toda a vez que uma exceção é lançada a
+partir de um bloco de rota ou um filtro. Note que em desenvolvimento, ele irá
+rodar apenas se você tiver definido a opção para exibir exceções em
+`:after_handler`:
+
+```ruby
+set :show_exceptions, :after_handler
+```
+
+O objeto da exceção pode ser
+obtido a partir da variável Rack `sinatra.error`:
+
+```ruby
+error do
+  'Desculpe, houve um erro desagradável - ' + env['sinatra.error'].message
+end
+```
+
+Erros customizados:
+
+```ruby
+error MeuErroCustomizado do
+  'Então que aconteceu foi...' + env['sinatra.error'].message
+end
+```
+
+Então, se isso acontecer:
+
+```ruby
+get '/' do
+  raise MeuErroCustomizado, 'alguma coisa ruim'
+end
+```
+
+Você receberá isso:
+
+```
+Então que aconteceu foi... alguma coisa ruim
+````
+
+Alternativamente, você pode instalar um manipulador de erro para um código
+de status:
+
+```ruby
+error 403 do
+  'Accesso negado'
+end
+
+get '/secreto' do
+  403
+end
+```
+
+Ou um alcance:
+
+```ruby
+error 400..510 do
+  'Boom'
+end
+```
+
+O Sinatra instala os manipuladores especiais `not_found` e `error`
+quando roda sobre o ambiente de desenvolvimento para exibir relatórios de erros
+bonitos e informações adicionais de "debug" no seu navegador.
+
+## Rack Middleware
+
+O Sinatra roda no [Rack](http://rack.github.io/), uma interface
+padrão mínima para frameworks web em Ruby. Um das capacidades mais
+interessantes do Rack para desenvolver aplicativos é suporte a
+“middleware” – componentes que ficam entre o servidor e sua aplicação
+monitorando e/ou manipulando o request/response do HTTP para prover
+vários tipos de funcionalidades comuns.
+
+O Sinatra faz construtores pipelines do middleware Rack facilmente em um
+nível superior utilizando o método `use`:
+
+```ruby
+require 'sinatra'
+require 'meu_middleware_customizado'
+
+use Rack::Lint
+use MeuMiddlewareCustomizado
+
+get '/ola' do
+  'Olá mundo'
+end
+```
+
+A semântica de `use` é idêntica aquela definida para a DSL
+[Rack::Builder](http://www.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:
+
+```ruby
+use Rack::Auth::Basic do |usuario, senha|
+  usuario == 'admin' && senha == 'secreto'
+end
+```
+
+O Rack é distribuido com uma variedade de middleware padrões para logs,
+debugs, rotas de URL, autenticação, e manipuladores de sessão. Sinatra
+utilizada muitos desses componentes automaticamente baseando sobre
+configuração, então, tipicamente você não tem `use` explicitamente.
+
+Você pode achar middlwares utéis em
+[rack](https://github.com/rack/rack/tree/master/lib/rack),
+[rack-contrib](https://github.com/rack/rack-contrib#readme),
+ou em [Rack wiki](https://github.com/rack/rack/wiki/List-of-Middleware).
+
+## Testando
+
+Testes no Sinatra podem ser escritos utilizando qualquer biblioteca ou
+framework de teste baseados no Rack.
+[Rack::Test](http://gitrdoc.com/brynary/rack-test) é recomendado:
+
+```ruby
+require 'minha_aplicacao_sinatra'
+require 'minitest/autorun'
+require 'rack/test'
+
+class MinhaAplicacaoTeste < Minitest::Test
+  include Rack::Test::Methods
+
+  def app
+    Sinatra::Application
+  end
+
+  def meu_test_default
+    get '/'
+    assert_equal 'Ola Mundo!', last_response.body
+  end
+
+  def teste_com_parametros
+    get '/atender', :name => 'Frank'
+    assert_equal 'Olá Frank!', last_response.bodymeet
+  end
+
+  def test_com_ambiente_rack
+    get '/', {}, 'HTTP_USER_AGENT' => 'Songbird'
+    assert_equal "Você está utilizando o Songbird!", last_response.body
+  end
+end
+```
+
+NOTA: Se você está usando o Sinatra no estilo modular, substitua
+`Sinatra::Application' acima com o nome da classe da sua aplicação
+
+## Sinatra::Base - Middleware, Bibliotecas e aplicativos modulares
+
+Definir sua aplicação em um nível superior de trabalho funciona bem para
+micro aplicativos, mas tem consideráveis incovenientes na construção de
+componentes reutilizáveis como um middleware Rack, metal Rails,
+bibliotecas simples como um componente de servidor, ou mesmo extensões
+Sinatra. A DSL de nível superior polui o espaço do objeto e assume um
+estilo de configuração de micro aplicativos (exemplo: uma simples
+arquivo de aplicação, diretórios `./public` e `./views`, logs, página de
+detalhes de exceção, etc.). É onde o `Sinatra::Base` entra em jogo:
+
+```ruby
+require 'sinatra/base'
+
+class MinhaApp < Sinatra::Base
+  set :sessions, true
+  set :foo, 'bar'
+
+  get '/' do
+    'Ola mundo!'
+  end
+end
+```
+
+Os métodos disponíveis para subclasses `Sinatra::Base` são exatamente como
+aqueles disponíveis via a DSL de nível superior. Aplicações de nível
+mais alto podem ser convertidas para componentes `Sinatra::Base` com duas
+modificações:
+
+* Seu arquivo deve requerer `sinatra/base` ao invés de `sinatra`; caso
+contrário, todos os métodos DSL do Sinatra são importados para o espaço de
+nomes principal.
+
+* Coloque as rotas da sua aplicação, manipuladores de erro, filtros e opções
+numa subclasse de `Sinatra::Base`.
+
+`Sinatra::Base` é um quadro branco. Muitas opções são desabilitadas por
 padrão, incluindo o servidor embutido. Veja [Opções e
 Configurações](http://www.sinatrarb.com/configuration.html) para
-detalhes de opções disponíveis e seus comportamentos.
-
-SIDEBAR: A DSL de alto nível do Sinatra é implementada utilizando um simples
-sistema de delegação. A classe `Sinatra::Application` – uma subclasse especial
-da `Sinatra::Base` – recebe todos os `:get`, `:put`, `:post`, `:delete`,
-`:before`, `:error`, `:not_found`, `:configure`, e `:set messages` enviados
-para o alto nível. Dê uma olhada no código você mesmo: aqui está o
-[Sinatra::Delegator
-mixin](http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128)
-sendo [incluido dentro de um espaço
-principal](http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/main.rb#L28)
+detalhes de opções disponíveis e seus comportamentos. Se você quer
+comportamento mais similiar à quando você definiu sua aplicação em nível mais
+alto (também conhecido como estilo Clássico), você pode usar subclasses de
+`Sinatra::Application`:
+
+```ruby
+require 'sinatra/base'
+
+class MinhaApp < Sinatra::Application
+  get '/' do
+    'Olá mundo!'
+  end
+end
+```
+
+### Estilo Clássico vs. Modular
+
+Ao contrário da crença comum, não há nada de errado com o estilo clássico. Se
+encaixa com sua aplicação, você não tem que mudar para uma aplicação modular.
+
+As desvantagens principais de usar o estilo clássico no lugar do estilo modular
+é que você ira ter apenas uma aplicação Sinatra por processo Ruby. Se seu plano
+é usar mais de uma, mude para o estilo modular. Não há nenhum impedimento para
+você misturar os estilos clássico e modular.
+
+Se vai mudar de um estilo para outro, você deve tomar cuidado com algumas
+configurações diferentes:
+
+<table>
+  <tr>
+    <th>Configuração</th>
+    <th>Clássico</th>
+    <th>Modular</th>
+    <th>Modular</th>
+  </tr>
+
+  <tr>
+    <td>app_file</td>
+    <td>arquivo carregando sinatra</td>
+    <td>arquivo usando subclasse Sinatra::Base</td>
+    <td>arquivo usando subclasse Sinatra::Application</td>
+  </tr>
+
+  <tr>
+    <td>run</td>
+    <td>$0 == app_file</td>
+    <td>false</td>
+    <td>false</td>
+  </tr>
+
+  <tr>
+    <td>logging</td>
+    <td>true</td>
+    <td>false</td>
+    <td>true</td>
+  </tr>
+
+  <tr>
+    <td>method_override</td>
+    <td>true</td>
+    <td>false</td>
+    <td>true</td>
+  </tr>
+
+  <tr>
+    <td>inline_templates</td>
+    <td>true</td>
+    <td>false</td>
+    <td>true</td>
+  </tr>
+
+  <tr>
+    <td>static</td>
+    <td>true</td>
+    <td>File.exist?(public_folder)</td>
+    <td>true</td>
+  </tr>
+</table>
+
+### Servindo uma Aplicação Modular:
+
+Existem duas opções comuns para começar uma aplicação modular, ativamente
+começando com `run!`:
+
+```ruby
+# minha_app.rb
+require 'sinatra/base'
+
+class MinhaApp < Sinatra::Base
+  # ... código da aplicação aqui ...
+
+  # inicie o servidor se o arquivo ruby foi executado diretamente
+  run! if app_file == $0
+end
+```
+
+Inicie com with:
+
+```shell
+ruby minha_app.rb
+```
+
+Ou com um arquivo `config.ru`, que permite você usar qualquer manipulador Rack:
+
+```ruby
+# config.ru (roda com rackup)
+require './minha_app'
+run MinhaApp
+```
+
+Rode:
+
+```shell
+rackup -p 4567
+```
+
+### Usando uma Aplicação de Estilo Clássico com um config.ru:
+
+Escreva o arquivo da sua aplicação:
+
+```ruby
+# app.rb
+require 'sinatra'
+
+get '/' do
+  'Olá mundo!'
+end
+```
+
+E um `config.ru` correspondente:
+
+```ruby
+require './app'
+run Sinatra::Application
+```
+
+### Quando usar um config.ru?
+
+Um arquivo `config.ru` é recomendado se:
+
+* Você quer lançar com um manipulador Rack diferente (Passenger, Unicorn,
+Heroku, ...).
+
+* Você quer usar mais de uma subclasse de `Sinatra::Base`.
+* Você quer usar Sinatra apenas como middleware, mas não como um "endpoint".
+
+**Não há necessidade de mudar para um `config.ru` simplesmente porque você mudou para o estilo modular, e você não tem que usar o estilo modular para rodar com um `config.ru`.**
+
+### Usando Sinatra como Middleware
+
+O Sinatra não é capaz apenas de usar outro middleware Rack, qualquer aplicação
+Sinatra pode ser adicionada na frente de qualquer "endpoint" Rack como
+middleware. Esse endpoint pode ser outra aplicação Sinatra, ou qualquer outra
+aplicação baseada em Rack (Rails/Hanami/Roda/...):
+
+```ruby
+require 'sinatra/base'
+
+class TelaLogin < Sinatra::Base
+  enable :sessions
+
+  get('/login') { haml :login }
+
+  post('/login') do
+    if params['nome'] == 'admin' && params['senha'] == 'admin'
+      session['nome_usuario'] = params['nome']
+    else
+      redirect '/login'
+    end
+  end
+end
+
+class MinhaApp < Sinatra::Base
+  # middleware irá rodar filtros before
+  use TelaLogin
+
+  before do
+    unless session['nome_usuario']
+      halt "Acesso negado, por favor <a href='/login'>login</a>."
+    end
+  end
+
+  get('/') { "Olá #{session['nome_usuario']}." }
+end
+```
+
+### Criação de Aplicações Dinâmicas
+
+Às vezes, você quer criar novas aplicações em tempo de execução sem ter que
+associa-las a uma constante. Você pode fazer isso com `Sinatra.new`:
+
+```ruby
+require 'sinatra/base'
+minha_app = Sinatra.new { get('/') { "oi" } }
+minha_app.run!
+```
+
+Isso leva a aplicação à herdar como um argumento opcional:
+
+```ruby
+# config.ru (roda com rackup)
+require 'sinatra/base'
+
+controller = Sinatra.new do
+  enable :logging
+  helpers MeusHelpers
+end
+
+map('/a') do
+  run Sinatra.new(controller) { get('/') { 'a' } }
+end
+
+map('/b') do
+  run Sinatra.new(controller) { get('/') { 'b' } }
+end
+```
+
+Isso é especialmente útil para testar extensões do Sinatra ou usar Sinatra na
+sua própria biblioteca.
+
+Isso também faz o uso do Sinatra como middleware extremamente fácil:
+
+```ruby
+require 'sinatra/base'
+
+use Sinatra do
+  get('/') { ... }
+end
+
+run RailsProject::Application
+```
+
+# Escopos e Ligação
+
+O escopo que você está atualmente determina quais métodos e varáveis está
+disponíveis.
+
+### Escopo de Aplicação/Classe
+
+Toda aplicação Sinatra corresponde à um subclasse de `Sinatra::Base`. Se você
+está utilizando a DSL de nível mais alto (`require 'sinatra`), então esta
+classe é `Sinatra::Application`, caso contrário é a subclasse que você criou
+explicitamente. No nível de classe você tem métodos como `get` ou `before`, mas
+você não pode acessar os objetos `request` ou `session`, como existe apenas uma
+única classe de aplicativo para todas as solicitações.
+
+Opções criadas via `set` são métodos a nível de classe:
+
+```ruby
+class MinhaApp < Sinatra::Base
+  # Hey, eu estou no escopo da aplicação!
+  set :foo, 42
+  foo # => 42
+
+  get '/foo' do
+    # Hey, eu não estou mais no escopo da aplicação!
+  end
+end
+```
+
+Você tem a ligação ao escopo da aplicação dentro:
+
+* Do corpo da classe da sua aplicação
+* De métodos definidos por extensões
+* Do bloco passado a `helpers`
+* De Procs/Blocos usados como valor para `set``
+* Do bloco passado a `Sinatra.new``
+
+Você pode atingir o escopo do objeto (a classe) de duas maneiras:
+
+* Por meio do objeto passado aos blocos "configure" (`configure { |c| ...}`)
+* `settings` de dentro do escopo da requisição
+
+### Escopo de Instância/Requisição
+
+Para toda requsição que chega, uma nova instância da classe da sua aplicação é
+criada e todos blocos de manipulação rodam nesse escopo. Dentro desse escopo
+você pode acessar os objetos `request` e `session` ou chamar métodos de
+renderização como `erb` ou `haml`. Você pode acessar o escopo da aplicação de
+dentro do escopo da requisição através do método auxiliar `settings`:
+
+```ruby
+class MinhaApp < Sinatra::Base
+  # Hey, eu estou no escopo da aplicação!
+  get '/define_rota/:nome' do
+    # Escopo da requisição para '/define_rota/:nome'
+    @valor = 42
+
+    settings.get("/#{params['nome']}") do
+      # Escopo da requisição para "/#{params['nome']}"
+      @valor # => nil (não é a mesma requisição)
+    end
+
+    "Rota definida!"
+  end
+end
+```
+
+Você tem a ligação ao escopo da requisição dentro dos:
+
+* blocos get, head, post, put, delete, options, patch, link e unlink
+* filtros after e before
+* métodos "helper" (auxiliares)
+* templates/views
+
+### Escopo de Delegação
+
+O escopo de delegação apenas encaminha métodos ao escopo da classe. Entretando,
+ele não se comporta exatamente como o escopo da classse já que você não tem a
+ligação da classe. Apenas métodos marcados explicitamente para delegação
+estarão disponíveis e você não compartilha variáveis/estado com o escopo da
+classe (leia: você tem um `self` diferente). Você pode explicitamente adicionar
+delegações de métodos chamando `Sinatra::Delegator.delegate :method_name`.
+
+Você tem a ligação com o escopo delegado dentro:
+
+* Da ligação de maior nível, se você digitou `require "sinatra"`
+* De um objeto estendido com o mixin `Sinatra::Delegator`
+
+Dê uma olhada no código você mesmo: aqui está [Sinatra::Delegator mixin](https://github.com/sinatra/sinatra/blob/ca06364/lib/sinatra/base.rb#L1609-1633) em [estendendo o objeto principal](https://github.com/sinatra/sinatra/blob/ca06364/lib/sinatra/main.rb#L28-30).
 
 ## Linha de Comando
 
 Aplicações Sinatra podem ser executadas diretamente:
 
 ```shell
-ruby minhaapp.rb [-h] [-x] [-e AMBIENTE] [-p PORTA] [-o HOST] [-s SERVIDOR]
+ruby minhaapp.rb [-h] [-x] [-q] [-e AMBIENTE] [-p PORTA] [-o HOST] [-s MANIPULADOR]
 ```
 
 As opções são:
@@ -1676,19 +3629,20 @@ As opções são:
 -o # define o host (padrão é 0.0.0.0)
 -e # define o ambiente (padrão é development)
 -s # especifica o servidor/manipulador rack (padrão é thin)
--x # ativa o bloqueio (padrão é desligado)
+-x # ativa o bloqueio mutex (padrão é desligado)
 ```
 
 ### Multi-threading
 
 _Parafraseando [esta resposta no StackOverflow](resposta-so) por Konstantin_
 
-Sinatra não impõe nenhum modelo de concorrencia, mas deixa isso como responsabilidade
-do Rack (servidor) subjacente como o Thin, Puma ou WEBrick. Sinatra por si só é thread-safe,
-então não há nenhum problema se um Rack handler usar um modelo de thread de concorrência. Isso
-significaria que ao iniciar o servidor, você teria que espeficiar o método de invocação correto
-para o Rack handler específico. Os seguintes exemplos é uma demonstração de como iniciar um
-servidor Thin multi-thread:
+Sinatra não impõe nenhum modelo de concorrencia, mas deixa isso como
+responsabilidade do Rack (servidor) subjacente como o Thin, Puma ou WEBrick.
+Sinatra por si só é thread-safe, então não há nenhum problema se um Rack
+handler usar um modelo de thread de concorrência. Isso significaria que ao
+iniciar o servidor, você teria que espeficiar o método de invocação correto
+para o Rack handler específico. Os seguintes exemplos é uma demonstração de
+como iniciar um servidor Thin multi-thread:
 
 ```ruby
 # app.rb
@@ -1710,51 +3664,124 @@ Para iniciar o servidor seria:
 thin --threaded start
 ```
 
-[resposrta-so]: http://stackoverflow.com/questions/6278817/is-sinatra-multi-threaded/6282999#6282999)
+## Requerimentos
+
+As seguintes versões do Ruby são oficialmente suportadas:
+<dl>
+  <dt>Ruby 2.2</dt>
+  <dd>
+    2.2 é totalmente suportada e recomendada. Atualmente não existem planos
+    para para o suporte oficial para ela.
+  </dd>
+
+  <dt>Rubinius</dt>
+  <dd>
+    Rubinius é oficialmente suportado (Rubinius >= 2.x). É recomendado rodar
+    <tt>gem install puma</tt>.
+  </dd>
+
+  <dt>JRuby</dt>
+  <dd>
+    A útlima versão estável lançada do JRuby é oficialmente suportada. Não é
+    recomendado usar extensões em C com o JRuby. É recomendado rodar
+    <tt>gem install trinidad</tt>.
+  </dd>
+</dl>
+
+Versões do Ruby antes da 2.2.2 não são mais suportadas pelo Sinatra 2.0.
+
+Nós também estamos de olhos em versões futuras do Ruby.
+
+As seguintes implementações do Ruby não são oficialmente suportadas mas sabemos
+que rodam o Sinatra:
+
+* Versões antigas do JRuby e Rubinius
+* Ruby Enterprise Edition
+* MacRuby, Maglev, IronRuby
+* Ruby 1.9.0 e 1.9.1 (mas nós não recomendamos o uso dessas)
+
+Não ser oficialmente suportada significa que se algo quebrar e não estiver nas
+plataformas suporta, iremos assumir que não é um problema nosso e sim das
+plataformas.
+
+Nós também rodas nossa IC sobre ruby-head (lançamentos futuros do MRI), mas nós
+não podemos garantir nada, já que está em constante mudança. Espera-se que
+lançamentos futuros da versão 2.x sejam totalmente suportadas.
+
+Sinatra deve funcionar em qualquer sistema operacional suportado pela
+implementação Ruby escolhida.
+
+Se você rodar MacRuby, você deve rodar `gem install control_tower`.
+
+O Sinatra atualmente não roda em Cardinal, SmallRuby, BlueRuby ou qualquer
+versão do Ruby anterior ao 2.2.
 
 ## A última versão
 
-Se você gostaria de utilizar o código da última versão do Sinatra, crie
-um clone local e execute sua aplicação com o diretório `sinatra/lib` no
-`LOAD_PATH`:
+Se você gostaria de utilizar o código da última versão do Sinatra, sinta-se
+livre para rodar a aplicação com o ramo master, ele deve ser estável.
+
+Nós também lançamos pré-lançamentos de gems de tempos em tempos, então você
+pode fazer:
+
+```shell
+gem install sinatra --pre
+```
+
+para obter alguma das últimas funcionalidades.
+
+### Com Bundler
+
+Se você quer rodar sua aplicação com a última versão do Sinatra usando
+[Bundler](https://bundler.io) é recomendado fazer dessa forma.
+
+Primeiramente, instale o Bundler, se você ainda não tiver:
 
 ```shell
-cd minhaapp
-git clone git://github.com/sinatra/sinatra.git
-ruby -I sinatra/lib minhaapp.rb
+gem install bundler
 ```
 
-Alternativamente, você pode adicionar o diretório do `sinatra/lib` no
-`LOAD_PATH` do seu aplicativo:
+Então, no diretório do seu projeto, crie uma `Gemfile`:
 
 ```ruby
-$LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib'
-require 'rubygems'
-require 'sinatra'
+source 'https://rubygems.org'
+gem 'sinatra', :github => 'sinatra/sinatra'
 
-get '/sobre' do
-  "Estou rodando a versão" + Sinatra::VERSION
-end
+# outras dependências
+gem 'haml'                    # por exemplo, se você usar haml
 ```
 
-Para atualizar o código do Sinatra no futuro:
+Perceba que você terá que listar todas suas dependências de aplicação no
+`Gemfile`. As dependências diretas do Sinatra (Rack e Tilt) irão, entretanto,
+ser automaticamente recuperadas e adicionadas pelo Bundler.
+
+Então você pode rodar sua aplicação assim:
 
 ```shell
-cd meuprojeto/sinatra
-git pull
+bundle exec ruby myapp.rb
 ```
 
+## Versionando
+
+O Sinatras segue [Versionamento Semântico](https://semver.org/), tanto SemVer
+como SemVerTag.
+
 ## Mais
 
 * [Website do Projeto](http://www.sinatrarb.com/) - Documentação
-    adicional, novidades e links para outros recursos.
-* [Contribuir](http://www.sinatrarb.com/contributing) - Encontrar um
-    bug? Precisa de ajuda? Tem um patch?
-* [Acompanhar Questões](https://github.com/sinatra/sinatra/issues)
+adicional, novidades e links para outros recursos.
+* [Contribuir](http://www.sinatrarb.com/contributing) - Encontrou um
+bug? Precisa de ajuda? Tem um patch?
+* [Acompanhar Problemas](https://github.com/sinatra/sinatra/issues)
 * [Twitter](https://twitter.com/sinatra)
 * [Lista de Email](http://groups.google.com/group/sinatrarb/topics)
-* [Sinatra Book](https://github.com/sinatra/sinatra-book/) Livro de Receitas
-* Documentação da API para a [última release](http://www.rubydoc.info/gems/sinatra)
-* [IRC: \#sinatra](irc://chat.freenode.net/#sinatra) em
-    [freenode.net](http://freenode.net)
+* [Sinatra & Amigos](https://sinatrarb.slack.com) no Slack
+([consiga um convite](https://sinatra-slack.herokuapp.com/))
+* [Sinatra Book](https://github.com/sinatra/sinatra-book/) - Livro de "Receitas"
+* [Sinatra Recipes](http://recipes.sinatrarb.com/) - "Receitas" de
+contribuições da comunidade
+* Documentação da API para a
+[última release](http://www.rubydoc.info/gems/sinatra)
+ou para o [HEAD atual](http://www.rubydoc.info/github/sinatra/sinatra)
+no [Ruby Doc](http://www.rubydoc.info/)
 * [Servidor de CI](https://travis-ci.org/sinatra/sinatra)