sinatra 1.2.9 → 1.3.0.a

data/CHANGES

@@ -1,127 +1,25 @@
-= 1.2.9 (backports release) / 2013-03-15
+= 1.3.0 / Not Yet Released
 
-IMPORTANT: THIS IS THE LAST 1.2.x RELEASE, PLEASE UPGRADE.
+ * Added support for HTTP PATCH requests. (Konstantin Haase)
 
- * Display EOL warning when loading Sinatra. (Konstantin Haase)
+ * Set up `Rack::Logger` or `Rack::NullLogger` depending on whether logging
+   was enabled or not. Also, expose that logger with the `logger` helper
+   method. (Konstantin Haase)
 
- * Improve documentation. (Anurag Priyam, Konstantin Haase)
+ * The sessions setting now may be an options hash. (Konstantin Haase)
 
- * Do not modify the load path. (Konstantin Haase)
+ * Important: 1.8.6 support has been dropped. It is still usable if you use the
+   backports gem, but no longer officially supported. (Konstantin Haase)
 
- * Display deprecation warning if RUBY_IGNORE_CALLERS is used. (Konstantin Haase)
+ * It is now possible to use a different target class for the top level DLS (aka
+   classic style) than `Sinatra::Application` by setting `Delegator.target`.
+   This was mainly introduced to ease testing. (Konstantin Haase)
 
- * Add backports library so we can still run on Ruby 1.8.6. (Konstantin Haase)
-
-= 1.2.8 (backports release) / 2011-12-30
-
-Backported from 1.3.2:
-
-* Fix bug where rendering a second template in the same request after the
-  first one raised an exception skipped the default layout (Nathan Baum)
-
-= 1.2.7 (backports release) / 2011-09-30
-
-Custom changes:
-
- * Fix Ruby 1.8.6 issue with Accept header parsing. (Konstantin Haase)
-
-Backported from 1.3.0:
-
- * Ignore `to_ary` on response bodies. Fixes compatibility to Rails 3.1.
-   (Konstantin Haase)
-
- * `Sinatra.run!` now prints to stderr rather than stdout. (Andrew Armenia)
-
- * Automatic `app_file` detection now works in directories containing brackets
-   (Konstantin Haase)
-
- * Improved documentation. (Emanuele Vicentini, Peter Higgins, Takanori
-   Ishikawa, Konstantin Haase)
-
- * Also specify charset in Content-Type header for JSON. (Konstantin Haase)
-
- * Rack handler names will not be converted to lower case internally, this
-   allows you to run Sinatra with custom Rack handlers, like Kirk or Mongrel2.
-   Example: `ruby app.rb -s Mongrel2` (Konstantin Haase)
-
- * Fix uninitialized instance variable warning. (David Kellum)
-
- * Command line options now complain if value passed to `-p` is not a valid
-   integer. (Konstantin Haase)
-
- * Fix handling of broken query params when displaying exceptions. (Luke
-   Jahnke)
-
-= 1.2.6 / 2011-05-01
-
- * Fix broken delegation, backport delegation tests from Sinatra 1.3.
-   (Konstantin Haase)
-
-= 1.2.5 / 2011-04-30
-
- * Restore compatibility with Ruby 1.8.6. (Konstantin Haase)
-
-= 1.2.4 / 2011-04-30
-
- * Sinatra::Application (classic style) does not use a session secret in
-   development mode, so sessions are not invalidated after every request when
-   using Shotgun. (Konstantin Haase)
-
- * The request object was shared between multiple Sinatra instances in the
-   same middleware chain. This caused issues if any non-sinatra routing
-   happend in-between two of those instances, or running a request twice
-   against an application (described in the README). The caching was reverted.
-   See GH#239 and GH#256 for more infos. (Konstantin Haase)
-
- * Fixes issues where the top level DSL was interfering with method_missing
-   proxies. This issue surfaced when Rails 3 was used with older Sass versions
-   and Sinatra >= 1.2.0. (Konstantin Haase)
-
- * Sinatra::Delegator.delegate is now able to delegate any method names, even
-   those containing special characters. This allows better integration into
-   other programming languages on Rubinius (probably on the JVM, too), like
-   Fancy. (Konstantin Haase)
-
- * Remove HEAD request logic and let Rack::Head handle it instead. (Paolo
-   "Nusco" Perrotta)
-
-= 1.2.3 / 2011-04-13
-
- * This release is compatible with Tilt 1.3, it will still work with Tilt 1.2.2,
-   however, if you want to use a newer Tilt version, you have to upgrade to at
-   least this version of Sinatra. (Konstantin Haase)
-
- * Helpers dealing with time, like `expires`, handle objects that pretend to be
-   numbers, like `ActiveSupport::Duration`, better. (Konstantin Haase)
-
-= 1.2.2 / 2011-04-08
-
- * The `:provides => :js` condition now matches both `application/javascript`
-   and `text/javascript`. The `:provides => :xml` condition now matches both
-   `application/xml` and `text/xml`. The `Content-Type` header is set
-   accordingly. If the client accepts both, the `application/*` version is
-   preferred, since the `text/*` versions are deprecated. (Konstantin Haase)
-
- * The `provides` condition now handles wildcards in `Accept` headers correctly.
-   Thus `:provides => :html` matches `text/html`, `text/*` and `*/*`.
-   (Konstantin Haase)
-
- * When parsing `Accept` headers, `Content-Type` preferences are honored
-   according to RFC 2616 section 14.1. (Konstantin Haase)
+= 1.2.2 / Not Yet Released
 
  * URIs passed to the `url` helper or `redirect` may now use any schema to be
    identified as absolute URIs, not only `http` or `https`. (Konstantin Haase)
 
- * Handles `Content-Type` strings that already contain parameters correctly in
-   `content_type` (example: `content_type "text/plain; charset=utf-16"`).
-   (Konstantin Haase)
-
- * If a route with an empty pattern is defined (`get("") { ... }`) requests with
-   an empty path info match this route instead of "/". (Konstantin Haase)
-
- * In development environment, when running under a nested path, the image URIs
-   on the error pages are set properly. (Konstantin Haase)
-
 = 1.2.1 / 2011-03-17
 
  * Use a generated session secret when using `enable :sessions`. (Konstantin
@@ -184,10 +82,6 @@ Backported from 1.3.0:
  * Sinatra now ships with a Gemfile for development dependencies, since it eases
    supporting different platforms, like JRuby. (Konstantin Haase)
 
-= 1.1.4 (backports release) / 2011-04-13
-
- * Compatible with Tilt 1.3. (Konstantin Haase)
-
 = 1.1.3 / 2011-02-20
 
  * Fixed issues with `user_agent` condition if the user agent header is missing.

data/Gemfile

@@ -1,5 +1,5 @@
 # Why use bundler?
-# Well, not all development dependencies install on all rubies. Moreover, `gem 
+# Well, not all development dependencies install on all rubies. Moreover, `gem
 # install sinatra --development` doesn't work, as it will also try to install
 # development dependencies of our dependencies, and those are not conflict free.
 # So, here we are, `bundle install`.
@@ -7,50 +7,36 @@
 # If you have issues with a gem: `bundle install --without-coffee-script`.
 
 RUBY_ENGINE = 'ruby' unless defined? RUBY_ENGINE
+
 source :rubygems unless ENV['QUICK']
 gemspec
 
-gem 'rake', '~> 0.8.7'
+gem 'rake'
 gem 'rack-test', '>= 0.5.6'
-gem 'ci_reporter', :group => :ci
-
-# Allows stuff like `tilt=1.2.2 bundle install` or `tilt=master ...`.
-# Used by the CI.
-github = "git://github.com/%s.git"
-repos = { 'tilt' => github % "rtomayko/tilt", 'rack' => github % "rack/rack" }
-%w[tilt rack].each do |lib|
-  dep = (ENV[lib] || 'stable').sub "#{lib}-", ''
-  dep = nil if dep == 'stable'
-  dep = {:git => repos[lib], :branch => dep} if dep and dep !~ /(\d+\.)+\d+/
-  dep ||= '~> 1.1.0' if lib == 'rack' and RUBY_VERSION == '1.8.6'
-  gem lib, dep
-end
 
-gem 'haml', '~> 3.0.0', :group => 'haml'
+gem 'haml', '>= 3.0', :group => 'haml'
 gem 'builder', :group => 'builder'
 gem 'erubis', :group => 'erubis'
+gem 'less', :group => 'less'
 gem 'liquid', :group => 'liquid'
+gem 'nokogiri', :group => 'nokogiri'
+gem 'slim', :group => 'slim'
+gem 'RedCloth', :group => 'redcloth'
+gem 'coffee-script', '>= 2.0', :group => 'coffee-script'
+gem 'rdoc', :group => 'rdoc'
+
+platforms :ruby do
+  gem 'rdiscount', :group => 'rdiscount'
+end
 
-if RUBY_VERSION > '1.8.6'
-  #gem 'less', '~> 1.0', :group => 'less'
-  gem 'slim', :group => 'slim'
-  gem 'RedCloth', :group => 'redcloth' if RUBY_VERSION < "1.9.3" and RUBY_ENGINE != 'macruby'
-
-  if RUBY_ENGINE == 'jruby'
-    gem 'nokogiri', '!= 1.5.0'
-  elsif RUBY_ENGINE != 'maglev'
-    gem 'nokogiri'
-  end
-  gem 'coffee-script', '>= 2.0', :group => 'coffee-script'
-  gem 'rdoc', '< 3.10', :group => 'rdoc'
-
-  platforms :ruby do
-    gem 'rdiscount', :group => 'rdiscount'
-  end
+platforms :ruby_18, :jruby do
+  gem 'json', :group => 'coffee-script'
+  gem 'markaby', :group => 'markaby'
+  gem 'radius', :group => 'radius'
+end
 
-  if RUBY_VERSION < '1.9'
-    gem 'json', :group => 'coffee-script'
-    gem 'markaby', :group => 'markaby'
-    gem 'radius', :group => 'radius'
-  end
+platforms :mri_18 do
+  # bundler platforms are broken
+  next if RUBY_ENGINE != 'ruby' or RUBY_VERSION > "1.8"
+  gem 'rcov', :group => 'rcov'
 end

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2007, 2008, 2009, 2010, 2011 Blake Mizerany
+Copyright (c) 2007, 2008, 2009, 2010 Blake Mizerany
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/README.de.rdoc

@@ -903,8 +903,8 @@ Manchmal entspricht +pass+ nicht den Anforderungen, wenn das Ergebnis einer
 anderen Route gefordert wird. Um das zu erreichen, lässt sich +call+ nutzen:
 
   get '/foo' do
-    status, headers, body = call env.merge("PATH_INFO" => '/bar')
-    [status, headers, body.map(&:upcase)]
+    status, headers, body = call request.env.merge("PATH_INFO" => '/bar')
+    [status, body.upcase]
   end
 
   get '/bar' do
@@ -947,7 +947,7 @@ Vergleichbar mit +body+ lassen sich auch Status-Code und Header setzen:
   get '/foo' do
     status 418
     headers \
-      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
+      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN"
       "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
     halt "Ich bin ein Teekesselchen"
   end
@@ -1018,7 +1018,7 @@ Um Argumente an ein Redirect weiterzugeben, können sie entweder dem Query
 
 oder eine Session verwendet werden:
 
-  enable :sessions
+  enable :session
   
   get '/foo' do
     session[:secret] = 'foo'
@@ -1357,7 +1357,7 @@ Routen-Block oder in einem Filter geworfen wurde. Die Exception kann über die
 Benutzerdefinierte Fehler:
 
   error MeinFehler do
-    'Au weia, ' + env['sinatra.error'].message
+    'Au weia, ' + request.env['sinatra.error'].message
   end
 
 Dann, wenn das passiert:
@@ -1561,7 +1561,7 @@ Oder über eine <tt>config.ru</tt>-Datei, die es erlaubt, einen beliebigen
 Rack-Handler zu verwenden:
 
   # config.ru
-  require './mein_app'
+  require 'mein_app'
   run MeineApp
 
 Starte:
@@ -1582,7 +1582,7 @@ Schreibe eine Anwendungsdatei:
 
 sowie eine dazugehörige <tt>config.ru</tt>-Datei:
 
-  require './app'
+  require 'app'
   run Sinatra::Application
 
 
@@ -1819,10 +1819,10 @@ die so installiert werden:
 === Mit Bundler
 
 Wenn die Applikation mit der neuesten Version von Sinatra und
-{Bundler}[http://gembundler.com/] genutzt werden soll, empfehlen wir den
-nachfolgenden Weg.
+{Bundler}[http://gembundler.com/] genutzt werden soll, schlagen wir folgenden
+Weg vor:
 
-Soweit Bundler noch nicht installiert ist:
+Soweit Bundler noch nicht installiert ist, folgendes:
 
   gem install bundler
 
@@ -1897,13 +1897,9 @@ SemVer und SemVerTag.
 * {Projekt-Website}[http://sinatra.github.com/] - Ergänzende Dokumentation,
   News und Links zu anderen Ressourcen.
 * {Hilfe beisteuern}[http://sinatra.github.com/contributing.html] - Einen
-  Fehler gefunden? Brauchst du Hilfe? Hast du einen Patch?
+Fehler gefunden? Brauchst du Hilfe? Hast du einen Patch?
 * {Issue-Tracker}[http://github.com/sinatra/sinatra/issues]
 * {Twitter}[http://twitter.com/sinatra]
 * {Mailing-Liste}[http://groups.google.com/group/sinatrarb]
 * {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] auf http://freenode.net
 
-* API Dokumentation für die {aktuelle Version}[http://rubydoc.info/gems/sinatra]	
-  oder für {HEAD}[http://rubydoc.info/github/sinatra/sinatra] auf 
-  http://rubydoc.info
-

data/README.es.rdoc

@@ -35,7 +35,11 @@ Cada ruta se asocia con un bloque:
   end
 
   put '/' do
-    .. actualizar algo ..
+    .. reemplazar algo ..
+  end
+
+  patch '/' do
+    .. modificar algo ..
   end
 
   delete '/' do
@@ -825,6 +829,11 @@ compartan un único secreto, tenés que definirlo vos:
 
   set :session_secret, 'super secreto'
 
+Si necesitás una configuración más específica, +sessions+ acepta un
+Hash con opciones:
+
+  set :sessions, :domain => 'foo.com'
+
 === Interrupción
 
 Para detener inmediatamente una petición dentro de un filtro o una ruta usá:
@@ -874,8 +883,8 @@ Cuando querés obtener el resultado de la llamada a una ruta, +pass+ no te va a
 servir.  Para lograr esto, podés usar +call+:
 
   get '/foo' do
-    status, headers, body = call env.merge("PATH_INFO" => '/bar')
-    [status, headers, body.map(&:upcase)]
+    status, headers, body = call request.env.merge("PATH_INFO" => '/bar')
+    [status, body.upcase]
   end
 
   get '/bar' do
@@ -916,7 +925,7 @@ De manera similar, también podés asignar el código de estado y encabezados:
   get '/foo' do
     status 418
     headers \
-      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN",
+      "Allow"   => "BREW, POST, GET, PROPFIND, WHEN"
       "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
     body "I'm a tea pot!"
   end
@@ -924,6 +933,31 @@ De manera similar, también podés asignar el código de estado y encabezados:
 También, al igual que +body+, tanto +status+ como +headers+ pueden utilizarse
 para obtener sus valores cuando no se les pasa argumentos.
 
+=== Log (Registro)
+
+En el ámbito de la petición, el helper +logger+ (registrador) expone
+una instancia de +Logger+:
+
+  get '/' do
+    logger.info "cargando datos"
+    # ...
+  end
+
+Este logger tiene en cuenta la configuración de logueo de tu Rack
+handler.  Si el logueo está desactivado, este método va a devolver un
+objeto que se comporta como un logger pero que en realidad no hace
+nada.  Así, no vas a tener que preocuparte por esta situación.
+
+Tené en cuenta que el logueo está habilitado por defecto únicamente
+para <tt>Sinatra::Application</tt>.  Si heredaste de
+<tt>Sinatra::Base</tt>, probablemente quieras habilitarlo manualmente:
+
+  class MiApp < Sinatra::Base
+    configure(:production, :development) do
+      enable :logging
+    end
+  end
+
 === Tipos Mime
 
 Cuando usás <tt>send_file</tt> o archivos estáticos tal vez tengas tipos mime
@@ -983,7 +1017,7 @@ búsqueda:
 
 O usar una sesión:
 
-  enable :sessions
+  enable :session
 
   get '/foo' do
     session[:secreto] = 'foo'
@@ -1305,9 +1339,7 @@ Podés acceder a estas opciones utilizando el método <tt>settings</tt>:
 
 [reload_templates]    define si se recargan las plantillas entre peticiones.
 
-                      Se encuentra activado en el entorno de desarrollo y en
-                      Ruby 1.8.6 (para compoensar un bug en Ruby que provoca una
-                      pérdida de memoria).
+                      Se encuentra activado en el entorno de desarrollo.
 
 [root]                directorio raíz del proyecto.
 
@@ -1331,11 +1363,9 @@ Podés acceder a estas opciones utilizando el método <tt>settings</tt>:
 [static]              define si Sinatra debe encargarse de servir archivos
                       estáticos.
 
-                      Deshabilitala cuando usés un servidor capaz de
-                      hacerlo por sí solo, porque mejorará el
-                      rendimiento.  Se encuentra habilitada por
-                      defecto en el estilo clásico y desactivado en el
-                      el modular.
+                      Deshabilitala cuando usés un servidor capaz de hacerlo
+                      por sí solo, porque mejorará el rendimiento.  Se encuentra
+                      habilitada por defecto.
 
 [views]               directorio de las vistas.
 
@@ -1367,7 +1397,7 @@ obtener de la variable Rack <tt>sinatra.error</tt>:
 Errores personalizados:
 
   error MiErrorPersonalizado do
-    'Lo que pasó fue...' + env['sinatra.error'].message
+    'Lo que pasó fue...' request.env['sinatra.error'].message
   end
 
 Entonces, si pasa esto:
@@ -1536,7 +1566,6 @@ entre sus configuraciones:
   logging             true                         false
   method_override     true                         false
   inline_templates    true                         false
-  static              true                         false
 
 === Sirviendo una Aplicación Modular
 
@@ -1560,7 +1589,7 @@ Iniciar con:
 O, con un archivo <tt>config.ru</tt>, que permite usar cualquier handler Rack:
 
   # config.ru
-  require './mi_app'
+  require 'mi_app'
   run MiApp
 
 Después ejecutar:
@@ -1580,7 +1609,7 @@ Escribí el archivo de tu aplicación:
 
 Y el <tt>config.ru</tt> correspondiente:
 
-  require './app'
+  require 'app'
   run Sinatra::Application
 
 === ¿Cuándo Usar config.ru?
@@ -1632,48 +1661,6 @@ aplicación basada en Rack (Rails/Ramaze/Camping/...):
     get('/') { "Hola #{session['nombre_de_usuario']}." }
   end
 
-=== Creación Dinámica de Aplicaciones
-
-Puede que en algunas ocasiones quieras crear nuevas aplicaciones en
-tiempo de ejecución sin tener que asignarlas a una constante.  Para
-esto tenés <tt>Sinatra.new</tt>:
-
-  require 'sinatra/base'
-  mi_app = Sinatra.new { get('/') { "hola" } }
-  mi_app.run!
-
-Acepta como argumento opcional una aplicación desde la que se
-heredará:
-
-  require 'sinatra/base'
-
-  controller = Sinatra.new do
-    enable :logging
-    helpers MisHelpers
-  end
-
-  map('/a') do
-    run Sinatra.new(controller) { get('/') { 'a' } }
-  end
-
-  map('/b') do
-    run Sinatra.new(controller) { get('/') { 'b' } }
-  end
-
-Construir aplicaciones de esta forma resulta especialmente útil para
-testear extensiones Sinatra o para usar Sinatra en tus librerías.
-
-Por otro lado, hace extremadamente sencillo usar Sinatra como
-middleware:
-
-  require 'sinatra/base'
-
-  use Sinatra do
-    get('/') { ... }
-  end
-
-  run ProyectoRails::Application
-
 == Ámbitos y Ligaduras
 
 El ámbito en el que te encontrás determina que métodos y variables están
@@ -1775,22 +1762,10 @@ Las opciones son:
   -s # especifica el servidor/manejador rack (thin es usado por defecto)
   -x # activa el mutex lock (está desactivado por defecto)
 
-== Requerimientos
-
-Se recomienda instalar Sinatra en Ruby 1.8.7, 1.9.2, JRuby o Rubinius.
+== Versiones de Ruby Soportadas
 
 Las siguientes versiones de Ruby son soportadas oficialmente:
 
-[ Ruby 1.8.6 ]
-  No se recomienda utilizar Sinatra en 1.8.6. Sin embargo, esta versión será
-  soportada oficialmente hasta que se libere Sinatra 1.3.0.  RDoc y CoffeeScript
-  no son soportadas por esta versión de Ruby. 1.8.6 contiene una falla
-  importante de pérdida de memoria en su implementación de Hash, que afecta a
-  las versiones de Sinatra anteriores a 1.1.1.  La versión actual evita
-  explícitamente esta falla a expensas de una disminución del rendimiento.  Por
-  último, Rack >= 1.2 dejó de soportar 1.8.6, por lo que vas a tener que usar
-  alguna versión 1.1.x.
-
 [ Ruby 1.8.7 ]
   1.8.7 es soportado completamente.  Sin embargo, si no hay nada que te lo
   prohíba, te recomendamos que usés 1.9.2 o cambies a JRuby o Rubinius.
@@ -1812,6 +1787,8 @@ Las siguientes versiones de Ruby son soportadas oficialmente:
   soporte de JRuby para extensiones C se encuentra en una etapa
   experimental, sin embargo, de momento solo RDiscount se ve afectada.
 
+<b>Hemos dejado de soportar Ruby 1.8.6.</b>
+
 Siempre le prestamos atención a las nuevas versiones de Ruby.
 
 Las siguientes implementaciones de Ruby no se encuentran soportadas
@@ -1820,6 +1797,7 @@ oficialmente.  De cualquier manera, pueden ejecutar Sinatra:
 * Versiones anteriores de JRuby y Rubinius
 * MacRuby, Maglev e IronRuby
 * Ruby 1.9.0 y 1.9.1
+* Ruby 1.8.6 con {backports}[https://github.com/marcandre/backports/#readme]
 
 No estar soportada oficialmente, significa que si las cosas solamente se rompen
 ahí y no en una plataforma soportada, asumimos que no es nuestro problema sino
@@ -1912,7 +1890,3 @@ siguiendo las especificaciones SemVer y SemVerTag.
 * {Twitter}[http://twitter.com/sinatra]
 * {Lista de Correo}[http://groups.google.com/group/sinatrarb/topics]
 * {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] en http://freenode.net
-* Documentación de la API para la
-  {última versión liberada}[http://rubydoc.info/gems/sinatra] o para la
-  {rama de desarrollo actual}[http://rubydoc.info/github/sinatra/sinatra]
-  en http://rubydoc.info/