sinatra 1.1.4 → 1.2.0.a

data/AUTHORS

@@ -36,15 +36,6 @@ Sinatra would not be possible:
 * Rick Olson (technoweenie) for the killer plug at RailsConf '08.
 * Steven Garcia for the amazing custom artwork you see on 404's and 500's
 * Pat Nakajima (nakajima) for fixing non-nested params in nested params Hash's.
-* Konstantin Haase for his hard work and ongoing commitment to improving 
-  Sinatra, for 1.1.0, 1.2.0 and beyond..
-* Zachary Scott for adding Konstantin to the AUTHORS file. He also did help
-  writing the book, but mainly for adding Konstantin.
-* Gabriel Andretta for having people wonder whether our documentation is
-  actually in English or in Spanish.
-* Vasily Polovnyov, Nickolay Schwarz, Luciano Sousa, Wu Jiang, Mickael Riga,
-  Bernhard Essl, Janos Hardi, Kouhei Yanagita and "burningTyger" for willingly
-  translating whatever ends up in the README.
 
 and last but not least:
 

data/CHANGES

@@ -1,31 +1,12 @@
-= 1.1.4 / 2011-04-13
+= 1.2.0 / Not Yet Released
 
- * Compatible with Tilt 1.3. (Konstantin Haase)
+ * Added `slim` rendering method for rendering Slim templates. (Steve
+   Hodgkiss)
 
-= 1.1.3 / 2011-02-20
+ * The `markaby` rendering method now allows passing a block, making inline
+   usage possible. Requires Tilt 1.2 or newer. (Konstantin Haase)
 
- * Fixed issues with `user_agent` condition if the user agent header is missing.
-   (Konstantin Haase)
-
- * Fix some routing tests that have been skipped by accident (Ross A. Baker)
-
- * Fix rendering issues with Builder and Nokogiri (Konstantin Haase)
-
- * Replace last_modified helper with better implementation. (cactus,
-   Konstantin Haase)
-
- * Fix issue with charset not being set when using `provides` condition.
-   (Konstantin Haase)
-
- * Fix issue with `render` not picking up all alternative file extensions for
-   a rendering engine - it was not possible to register ".html.erb" without
-   tricks. (Konstantin Haase)
-
-= 1.1.2 / 2010-10-25
-
-Like 1.1.1, but with proper CHANGES file.
-
-= 1.1.1 / 2010-10-25
+= 1.1.1 / Not Yet Released
 
  * README has been translated to Russian (Nickolay Schwarz, Vasily Polovnyov)
    and Portuguese (Luciano Sousa).
@@ -53,10 +34,6 @@ Like 1.1.1, but with proper CHANGES file.
  * Headers set by cache_control now always set max_age as an Integer, making
    sure it is compatible with RFC2616. (Konstantin Haase)
 
- * Further improved handling of string encodings on Ruby 1.9, templates now
-   honor default_encoding and URLs support unicode characters. (Konstantin
-   Haase)
-
 = 1.1.0 / 2010-10-24
 
  * Before and after filters now support pattern matching, including the

data/README.de.rdoc

@@ -433,6 +433,19 @@ Das markaby gem wird benötigt, um Markaby-Templates rendern zu können:
 
 Dieser Code rendert <tt>./views/index.mab</tt>.
 
+=== Slim-Templates
+
+Das slim gem wird benötigt, um Slim-Templates rendern zu können:
+
+  ## slim muss eingebunden werden
+  require 'slim'
+
+  get '/' do
+    slim :index
+  end
+
+Dieser Code rendert <tt>./views/index.slim</tt>.
+
 === CoffeeScript-Templates
 
 Das coffee-script gem und das `coffee`-Programm werden benötigt, um CoffeScript-Templates rendern zu können:
@@ -571,6 +584,16 @@ Filter können optional auch mit einem Pattern ausgestattet werden, welche auf d
     session[:last_slug] = slug
   end
 
+Ähnlich wie Routen können Filter auch mit weiteren Bedingungen eingeschränkt werden:
+
+  before :agent => /Songbird/ do
+    # ...
+  end
+  
+  after '/blog/*', :host_name => 'example.com' do
+    # ...
+  end
+
 == Anhalten
 
 Zum sofortigen stoppen eines Request in einem Filter oder einer Route:

data/README.es.rdoc

@@ -39,6 +39,11 @@ Cada ruta se asocia con un bloque:
     .. aniquilar algo ..
   end
 
+  options '/' do
+    .. informar algo ..
+  end
+
+
 Las rutas son comparadas en el orden en el que son definidas. La primer ruta
 que coincide con la petición es invocada.
 
@@ -146,7 +151,7 @@ De esa manera podemos, por ejemplo, implementar fácilmente un streaming:
 
     get('/') { Stream.new }
 
-== Archivos Estáticos
+== Archivos estáticos
 
 Los archivos estáticos son servidos desde el directorio público
 <tt>./public</tt>. Podés especificar una ubicación diferente ajustando la
@@ -173,7 +178,7 @@ les pase como argumento.
 
 === Plantillas Haml
 
-La gem/librería <tt>haml</tt> es necesaria para para renderizar plantillas HAML:
+La gem/librería haml es necesaria para para renderizar plantillas HAML:
 
   ## Vas a necesitar requerir haml en tu app
   require 'haml'
@@ -206,9 +211,9 @@ y reemplazadas individualmente.
 
 Renderiza <tt>./views/index.erb</tt>
 
-=== Plantillas Erubis
+=== Erubis
 
-La gem/librería <tt>erubis</tt> es necesaria para renderizar plantillas Erubis:
+La gem/librería erubis es necesaria para renderizar plantillas erubis:
 
   ## Vas a necesitar requerir erubis en tu app
   require 'erubis'
@@ -217,23 +222,11 @@ La gem/librería <tt>erubis</tt> es necesaria para renderizar plantillas Erubis:
     erubis :index
   end
 
-Renderiza <tt>./views/index.erubis</tt>.
-
-También es posible reemplazar Erb con Erubis:
-
-  require 'erubis'
-  Tilt.register :erb, Tilt[:erubis]
-
-  get '/' do
-    erb :index
-  end
-
-Renderiza <tt>./views/index.erb</tt> con Erubis.
+Renderiza <tt>./views/index.erubis</tt>
 
 === Plantillas Builder
 
-La gem/librería <tt>builder</tt> es necesaria para renderizar plantillas
-builder:
+La gem/librería builder es necesaria para renderizar plantillas builder:
 
   ## Vas a necesitar requerir builder en tu app
   require 'builder'
@@ -246,8 +239,7 @@ Renderiza <tt>./views/index.builder</tt>.
 
 === Plantillas Nokogiri
 
-La gem/librería <tt>nokogiri</tt> es necesaria para renderizar plantillas
-nokogiri:
+La gem/librería nokogiri es necesaria para renderizar plantillas nokogiri:
 
   ## Vas a necesitar requerir nokogiri en tu app
   require 'nokogiri'
@@ -260,8 +252,7 @@ Renderiza <tt>./views/index.nokogiri</tt>.
 
 === Plantillas Sass
 
-La gem/librería <tt>haml</tt> o <tt>sass</tt> es necesaria para renderizar
-plantillas Sass:
+La gem/librería haml es necesaria para renderizar plantillas Sass:
 
   ## Vas a necesitar requerir haml o sass en tu app
   require 'sass'
@@ -285,8 +276,7 @@ y reemplazadas individualmente.
 
 === Plantillas Scss
 
-La gem/librería <tt>haml</tt> o <tt>sass</tt>es necesaria para renderizar
-plantillas Scss:
+La gem/librería haml es necesaria para renderizar plantillas Scss:
 
   ## Vas a necesitar requerir haml o sass en tu app
   require 'sass'
@@ -310,7 +300,7 @@ y reemplazadas individualmente.
 
 === Plantillas Less
 
-La gem/librería <tt>less</tt> es necesaria para renderizar plantillas Less:
+La gem/librería less es necesaria para renderizar plantillas Less:
 
   ## Vas a necesitar requerir less en tu app
   require 'less'
@@ -323,7 +313,7 @@ Renderiza <tt>./views/stylesheet.less</tt>.
 
 === Plantillas Liquid
 
-La gem/librería <tt>liquid</tt> es necesaria para renderizar plantillas Liquid:
+La gem/librería liquid es necesaria para renderizar plantillas Liquid:
 
   ## Vas a necesitar requerir liquid en tu app
   require 'liquid'
@@ -341,8 +331,7 @@ plantilla Liquid, casi siempre vas a querer pasarle locales:
 
 === Plantillas Markdown
 
-La gem/librería <tt>rdiscount</tt> es necesaria para renderizar plantillas
-Markdown:
+La gem/librería rdiscount es necesaria para renderizar plantillas Markdown:
 
   ## Vas a necesitar requerir rdiscount en tu app
   require "rdiscount"
@@ -359,30 +348,15 @@ generalmente vas a usarlo en combinación con otro motor de renderizado:
 
   erb :resumen, :locals => { :texto => markdown(:introduccion) }
 
-Tené en cuenta que también podés llamar al método +markdown+ desde otras
+Tené en cuenta que también podés llamar al método markdown desde otras
 plantillas:
 
   %h1 Hola Desde Haml!
   %p= markdown(:saludos)
 
-También es posible parsear Markdown con BlueCloth en lugar de RDiscount:
+=== Plantilla Textile
 
-  require 'bluecloth'
-
-  Tilt.register 'markdown', BlueClothTemplate
-  Tilt.register 'mkd',      BlueClothTemplate
-  Tilt.register 'md',       BlueClothTemplate
-
-  get '/' do
-    markdown :index
-  end
-
-Renderiza <tt>./views/index.md</tt> con BlueCloth.
-
-=== Plantillas Textile
-
-La gem/librería <tt>RedCloth</tt> es necesaria para renderizar plantillas
-Textile:
+La gem/librería RedCloth es necesaria para renderizar plantillas Textile:
 
   ## Vas a necesitar requerir redcloth en tu app
   require "redcloth"
@@ -398,7 +372,7 @@ generalmente vas a usarlo en combinación con otro motor de renderizado:
 
   erb :resumen, :locals => { :texto => textile(:introduccion) }
 
-Tené en cuenta que también podés llamar al método +textile+ desde otras
+Tené en cuenta que también podés llamar al método textile desde otras
 plantillas:
 
   %h1 Hola Desde Haml!
@@ -406,7 +380,7 @@ plantillas:
 
 === Plantillas RDoc
 
-La gem/librería <tt>rdoc</tt> es necesaria para renderizar plantillas RDoc:
+La gem/librería RDoc es necesaria para renderizar plantillas RDoc:
 
   ## Vas a necesitar requerir rdoc en tu app
   require "rdoc"
@@ -422,7 +396,7 @@ generalmente vas a usarlo en combinación con otro motor de renderizado:
 
   erb :resumen, :locals => { :texto => rdoc(:introduccion) }
 
-Tené en cuenta que también podés llamar al método +rdoc+ desde otras
+Tené en cuenta que también podés llamar al método rdoc desde otras
 plantillas:
 
   %h1 Hola Desde Haml!
@@ -430,7 +404,7 @@ plantillas:
 
 === Plantillas Radius
 
-La gem/librería <tt>radius</tt> es necesaria para renderizar plantillas Radius:
+La gem/librería radius es necesaria para renderizar plantillas Radius:
 
   ## Vas a necesitar requerir radius en tu app
   require 'radius'
@@ -448,8 +422,7 @@ plantilla Radius, casi siempre vas a querer pasarle locales:
 
 === Plantillas Markaby
 
-La gem/librería <tt>markaby</tt> es necesaria para renderizar plantillas
-Markaby:
+La gem/librería markaby es necesaria para renderizar plantillas Markaby:
 
   ## Vas a necesitar requerir markaby en tu app
   require 'markaby'
@@ -460,16 +433,30 @@ Markaby:
 
 Renderiza <tt>./views/index.mab</tt>.
 
-=== Plantillas CoffeeScript
+Si tenés Tilt 1.2 o posterior, podés usar markaby inline:
 
-La gem/librería <tt>coffee-script</tt> y al menos <b>una</b> de las siguientes
-opciones para ejecutar JavaScript:
+  get '/' do
+    markaby { h1 "Bienvenido!" }
+  end
+
+
+=== Plantillas Slim
 
-* +node+ (de Node.js) en tu path
-* utilizar OSX
-* la gem/librería +therubyracer+
+La gem/librería slim es necesaria para renderizar plantillas Slim:
 
-son necesarios para renderizar plantillas CoffeeScript:
+  ## Vas a necesitar requerir slim en tu app
+  require 'slim'
+
+  get '/' do
+    slim :index
+  end
+
+Renderiza <tt>./views/index.slim</tt>.
+
+=== Plantillas CoffeeScript
+
+La gem/librería coffee-script y el binario `coffee` son necesarios para
+renderizar plantillas CoffeeScript:
 
   ## Vas a necesitar requerir coffee-script en tu app
   require 'coffee-script'
@@ -480,13 +467,13 @@ son necesarios para renderizar plantillas CoffeeScript:
 
 Renderiza <tt>./views/application.coffee</tt>.
 
-=== Plantillas Embebidas
+=== Plantillas Inline
 
   get '/' do
     haml '%div.titulo Hola Mundo'
   end
 
-Renderiza el template embebido en el string.
+Renderiza el template contenido en el string.
 
 === Accediendo a Variables en Plantillas
 
@@ -552,39 +539,13 @@ Las plantillas también pueden ser definidas usando el método top-level
   end
 
 Si existe una plantilla con el nombre "layout", va a ser usada cada vez que
-una plantilla es renderizada. Podés desactivar los layouts individualmente
-pasando <tt>:layout => false</tt> o globalmente con
-<tt>set :haml, :layout => false</tt>.
+una plantilla es renderizada. Podés desactivar los layouts pasando
+<tt>:layout => false</tt>.
 
   get '/' do
     haml :index, :layout => !request.xhr?
   end
 
-=== Asociando Extensiones de Archivo
-
-Para asociar una extensión de archivo con un motor de renderizado, usá
-<tt>Tilt.register</tt>. Por ejemplo, si querés usar la extensión +tt+ para
-las plantillas Textile, podés hacer lo siguiente:
-
-  Tilt.register :tt, Tilt[:textile]
-
-=== Agregando Tu Propio Motor de Renderizado
-
-Primero, registrá tu motor con Tilt, y después, creá tu método de renderizado:
-
-  Tilt.register :mipg, MiMotorParaPlantillaGenial
-
-  helpers do
-    def mypg(*args) render(:mypg, *args) end
-  end
-
-  get '/' do
-    mypg :index
-  end
-
-Renderiza <tt>./views/index.mypg</tt>. Mirá https://github.com/rtomayko/tilt
-para aprender más de Tilt.
-
 == Ayudantes
 
 Usá el método top-level <tt>helpers</tt> para definir métodos ayudantes que
@@ -638,6 +599,16 @@ patrón:
     session[:ultimo_slug] = slug
   end
 
+Al igual que las rutas, los filtros también aceptan condiciones:
+
+  before :agent => /Songbird/ do
+    # ...
+  end
+
+  after '/blog/*', :host_name => 'ejemplo.com' do
+    # ...
+  end
+
 == Interrupción
 
 Para detener inmediatamente una petición dentro de un filtro o una ruta usá:
@@ -747,7 +718,7 @@ Ejecutar cuando el entorno es <tt>:production</tt> o <tt>:test</tt>:
     ...
   end
 
-== Manejo de Errores
+== Manejo de errores
 
 Los manejadores de errores se ejecutan dentro del mismo contexto que las rutas
 y los filtros before, lo que significa que podés usar, por ejemplo,
@@ -913,6 +884,13 @@ etc.). Ahí es donde Sinatra::Base entra en el juego:
     end
   end
 
+La clase MiApp es un componente Rack independiente que puede actuar como Rack
+middleware, una aplicación Rack, o Rails metal. Podés usar (con +use+) o
+ejecutar (con +run+) esta clase desde un archivo rackup +config.ru+; o,
+controlar un componente de servidor provisto como una librería:
+
+   MiApp.run! :host => 'localhost', :port => 9090
+
 Las subclases de Sinatra::Base tienen disponibles exactamente los mismos
 métodos que los provistos por el DSL de top-level. La mayoría de las
 aplicaciones top-level se pueden convertir en componentes Sinatra::Base con
@@ -929,64 +907,6 @@ desactivadas por defecto, incluyendo el servidor incorporado. Mirá
 {Opciones y Configuraciones}[http://sinatra.github.com/configuration.html]
 para detalles sobre las opciones disponibles y su comportamiento.
 
-=== Sirviendo una Aplicación Modular
-
-Las dos opciones más comunes para iniciar una aplicación modular son, iniciarla
-activamente con <tt>run!</tt>:
-
-  # mi_app.rb
-  require 'sinatra/base'
-
-  class MiApp < Sinatra::Base
-    # ... código de la app  ...
-
-    # iniciar el servidor si el archivo fue ejecutado directamente
-    run! if app_file == $0
-  end
-
-Iniciar con:
-
-  ruby mi_app.rb
-
-O, con un archivo <tt>config.ru</tt>, que permite usar cualquier handler Rack:
-
-  # config.ru
-  require 'mi_app'
-  run MiApp
-
-Después ejecutar:
-
-  rackup -p 4567
-
-=== Usando una Aplicación Clásica con un Archivo config.ru
-
-Escribí el archivo de tu aplicación:
-
-  # app.rb
-  require 'sinatra'
-
-  get '/' do
-    'Hola mundo!'
-  end
-
-Y el <tt>config.ru</tt> correspondiente:
-
-  require 'app'
-  run Sinatra::Application
-
-=== ¿Cuándo Usar config.ru?
-
-Indicadores de que probablemente querés usar <tt>config.ru</tt>:
-
-* Querés realizar el deploy con un hanlder Rack distinto (Passenger, Unicorn,
-  Heroku, ...).
-* Querés usar más de una subclase de <tt>Sinatra::Base</tt>.
-* Querés usar Sinatra únicamente para middleware, pero no como un endpoint.
-
-<b>No hay necesidad de utilizar un archivo <tt>config.ru</tt> exclusivamente
-porque tenés una aplicación modular, y no necesitás una aplicación modular para
-iniciarla con <tt>config.ru</tt>.</b>
-
 === Utilizando Sinatra como Middleware
 
 Sinatra no solo es capaz de usar otro Rack middleware, sino que a su vez,
@@ -996,7 +916,7 @@ aplicación basada en Rack (Rails/Ramaze/Camping/...).
 
   require 'sinatra/base'
 
-  class PantallaDeLogin< Sinatra::Base
+  class PantallaDeLogin < Sinatra::Base
     enable :sessions
 
     get('/login') { haml :login }
@@ -1086,7 +1006,7 @@ desde el ámbito de la petición utilizando `settings`:
 
 Tenés la ligadura al ámbito de la petición dentro de:
 
-* bloques pasados a get/head/post/put/delete
+* bloques pasados a get/head/post/put/delete/options
 * filtros before/after
 * métodos ayudantes
 * plantillas/vistas
@@ -1109,7 +1029,7 @@ Pegale una mirada al código: acá está el
 {Sinatra::Delegator mixin}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128]
 que es {incluido en el espacio de nombres principal}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/main.rb#L28].
 
-== Línea de Comandos
+== Línea de comandos
 
 Las aplicaciones Sinatra pueden ser ejecutadas directamente:
 
@@ -1124,71 +1044,33 @@ Las opciones son:
   -s # especifica el servidor/manejador rack (thin es usado por defecto)
   -x # activa el mutex lock (está desactivado por defecto)
 
-== A la Vanguardia
-
-Si querés usar el código de Sinatra más reciente, sentite libre de ejecutar
-tu aplicación sobre la rama master, en general es bastante estable.
-
-También liberamos prereleases de vez en cuando, así, podés hacer
-
-  gem install sinatra --pre
-
-Para obtener algunas de las últimas características.
-
-=== Con Bundler
-
-Esta es la manera recomendada para ejecutar tu aplicación sobre la última
-versión de Sinatra usando {Bundler}[http://gembundler.com/].
-
-Primero, instalá bundler si no lo hiciste todavía:
-
-  gem install bundler
-
-Después, en el directorio de tu proyecto, creá un archivo +Gemfile+:
-
-  source :rubygems
-  gem 'sinatra', :git => "git://github.com/sinatra/sinatra.git"
-
-  # otras dependencias
-  gem 'haml'                    # por ejemplo, si usás haml
-  gem 'activerecord', '~> 3.0'  # quizás también necesités ActiveRecord 3.x
-
-Tené en cuenta que tenés que listar todas las dependencias directas de tu
-aplicación. No es necesario listar las dependencias de Sinatra (Rack y Tilt)
-porque Bundler las agrega directamente.
+== A la vanguardia
 
-Ahora podés arrancar tu aplicación así:
-
-  bundle exec ruby miapp.rb
-
-=== Con Git
-
-Cloná el repositorio localmente y ejecutá tu aplicación, asegurándote que el
-directorio <tt>sinatra/lib</tt> esté en el <tt>LOAD_PATH</tt>:
+Si querés usar el código de Sinatra más reciente, cloná el repositorio
+localmente y ejecutá tu aplicación, asegurándote que el directorio
+<tt>sinatra/lib</tt> esté en el <tt>LOAD_PATH</tt>:
 
   cd miapp
   git clone git://github.com/sinatra/sinatra.git
   ruby -Isinatra/lib miapp.rb
 
-Para actualizar el código fuente de Sinatra en el futuro:
-
-  cd miapp/sinatra
-  git pull
-
-=== Instalación Global
+Otra opción consiste en agregar el directorio <tt>sinatra/lib</tt> al
+<tt>LOAD_PATH</tt> dentro de tu aplicación:
 
-Podés construir la gem vos mismo:
+  $LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib'
+  require 'rubygems'
+  require 'sinatra'
 
-  git clone git://github.com/sinatra/sinatra.git
-  cd sinatra
-  rake sinatra.gemspec
-  rake install
+  get '/acerca-de' do
+    "Estoy usando la versión " + Sinatra::VERSION
+  end
 
-Si instalás tus gems como root, el último paso debería ser
+Para actualizar el código fuente de Sinatra en el futuro:
 
-  sudo rake install
+  cd miproyecto/sinatra
+  git pull
 
-== Lecturas Recomendadas
+== Más
 
 * {Sito web del proyecto}[http://www.sinatrarb.com/] - Documentación
   adicional, noticias, y enlaces a otros recursos.