sinatra 1.4.5 → 1.4.6

data/README.fr.md

@@ -164,8 +164,8 @@ l'intermédiaire du hash `params` :
 ``` ruby
 get '/bonjour/:nom' do
   # répond aux requêtes "GET /bonjour/foo" et "GET /bonjour/bar"
-  # params[:nom] est 'foo' ou 'bar'
-  "Bonjour #{params[:nom]} !"
+  # params['nom'] est 'foo' ou 'bar'
+  "Bonjour #{params['nom']} !"
 end
 ```
 
@@ -175,24 +175,24 @@ paramètres du bloc comme ceci :
 ``` ruby
 get '/bonjour/:nom' do |n|
   # répond aux requêtes "GET /bonjour/foo" et "GET /bonjour/bar"
-  # params[:nom] est 'foo' ou 'bar'
-  # n contient params[:nom]
+  # params['nom'] est 'foo' ou 'bar'
+  # n contient params['nom']
   "Bonjour #{n} !"
 end
 ```
 
 Une route peut contenir un splat (caractère joker), accessible par
-l'intermédiaire du tableau `params[:splat]` :
+l'intermédiaire du tableau `params['splat']` :
 
 ``` ruby
 get '/dire/*/a/*' do
   # répond à /dire/bonjour/a/monde
-  params[:splat] # => ["bonjour", "monde"]
+  params['splat'] # => ["bonjour", "monde"]
 end
 
 get '/telecharger/*.*' do
   # répond à /telecharger/chemin/vers/fichier.xml
-  params[:splat] # => ["chemin/vers/fichier", "xml"]
+  params['splat'] # => ["chemin/vers/fichier", "xml"]
 end
 ```
 
@@ -207,8 +207,8 @@ end
 Une route peut aussi être définie par une expression régulière :
 
 ``` ruby
-get %r{/bonjour/([\w]+)} do
-  "Bonjour, #{params[:captures].first} !"
+get /\A\/bonjour\/([\w]+)\z/ do
+  "Bonjour, #{params['captures'].first} !"
 end
 ```
 
@@ -228,6 +228,17 @@ get '/posts.?:format?' do
 end
 ```
 
+Ainsi que des paramètres d'URL :
+
+``` ruby
+get '/posts' do
+  # répond à "GET /posts?titre=foo&auteur=bar"
+  titre = params['titre']
+  auteur = params['auteur']
+  # utilise les variables titre et auteur, ces paramètres d'URL sont optionnels pour la route /posts
+end
+```
+
 A ce propos, à moins d'avoir désactivé la protection contre les attaques par
 "path transversal" (voir plus loin), l'URL demandée peut avoir été modifiée
 avant d'être comparée à vos routes.
@@ -239,7 +250,7 @@ Les routes peuvent définir toutes sortes de conditions, comme par exemple le
 
 ``` ruby
 get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
-  "Vous utilisez Songbird version #{params[:agent][0]}"
+  "Vous utilisez Songbird version #{params['agent'][0]}"
 end
 
 get '/foo' do
@@ -588,7 +599,7 @@ get('/') { markdown :index }
   <tr>
     <td>Dépendances</td>
     <td>
-      <a href="http://builder.rubyforge.org/" title="builder">builder</a>
+      <a href="https://github.com/jimweirich/builder" title="builder">builder</a>
     </td>
   </tr>
   <tr>
@@ -709,8 +720,8 @@ locales.
       <a href="https://github.com/rtomayko/rdiscount" title="RDiscount">RDiscount</a>,
       <a href="https://github.com/vmg/redcarpet" title="RedCarpet">RedCarpet</a>,
       <a href="http://deveiate.org/projects/BlueCloth" title="BlueCloth">BlueCloth</a>,
-      <a href="http://kramdown.rubyforge.org/" title="kramdown">kramdown</a>,
-      <a href="http://maruku.rubyforge.org/" title="maruku">maruku</a>
+      <a href="http://kramdown.gettalong.org/" title="kramdown">kramdown</a>,
+      <a href="https://github.com/bhollis/maruku" title="maruku">maruku</a>
     </td>
   </tr>
 
@@ -788,7 +799,7 @@ pour le layout en utilisant l’option `:layout_engine`.
 <table>
   <tr>
     <td>Dépendances</td>
-    <td><a href="http://rdoc.rubyforge.org/" title="RDoc">RDoc</a></td>
+    <td><a href="http://rdoc.sourceforge.net/" title="RDoc">RDoc</a></td>
   </tr>
   <tr>
     <td>Extensions de fichier</td>
@@ -825,7 +836,7 @@ pour le layout en utilisant l’option `:layout_engine`.
 <table>
   <tr>
     <td>Dépendances</td>
-    <td><a href="http://radius.rubyforge.org/" title="Radius">Radius</a></td>
+    <td><a href="https://github.com/jlong/radius" title="Radius">Radius</a></td>
   </tr>
   <tr>
     <td>Extensions de fichier</td>
@@ -1060,7 +1071,7 @@ gestionnaire de route sont directement accessibles dans le template :
 
 ``` ruby
 get '/:id' do
-  @foo = Foo.find(params[:id])
+  @foo = Foo.find(params['id'])
   haml '%h1= @foo.nom'
 end
 ```
@@ -1069,7 +1080,7 @@ Alternativement, on peut passer un hash contenant des variables locales :
 
 ``` ruby
 get '/:id' do
-  foo = Foo.find(params[:id])
+  foo = Foo.find(params['id'])
   haml '%h1= foo.nom', :locals => { :foo => foo }
 end
 ```
@@ -1217,7 +1228,7 @@ end
 
 get '/foo/*' do
   @note #=> 'Coucou !'
-  params[:splat] #=> 'bar/baz'
+  params['splat'] #=> 'bar/baz'
 end
 ```
 
@@ -1245,7 +1256,7 @@ before '/secret/*' do
 end
 
 after '/faire/:travail' do |travail|
-  session[:dernier_travail] = travail
+  session['dernier_travail'] = travail
 end
 ```
 
@@ -1274,7 +1285,7 @@ helpers do
 end
 
 get '/:nom' do
-  bar(params[:nom])
+  bar(params['nom'])
 end
 ```
 
@@ -1304,11 +1315,11 @@ activées, vous avez un hash de session par session utilisateur :
 enable :sessions
 
 get '/' do
-  "valeur = " << session[:valeur].inspect
+  "valeur = " << session['valeur'].inspect
 end
 
 get '/:value' do
-  session[:valeur] = params[:valeur]
+  session['valeur'] = params['valeur']
 end
 ```
 
@@ -1323,11 +1334,11 @@ choix comme vous le feriez pour n'importe quel autre middleware :
 use Rack::Session::Pool, :expire_after => 2592000
 
 get '/' do
-  "valeur = " << session[:valeur].inspect
+  "valeur = " << session['valeur'].inspect
 end
 
 get '/:value' do
-  session[:valeur] = params[:valeur]
+  session['valeur'] = params['valeur']
 end
 ```
 
@@ -1402,7 +1413,7 @@ avec `pass` :
 
 ``` ruby
 get '/devine/:qui' do
-  pass unless params[:qui] == 'Frank'
+  pass unless params['qui'] == 'Frank'
   "Tu m'as eu !"
 end
 
@@ -1529,19 +1540,17 @@ connexions = []
 
 get '/souscrire' do
   # abonne un client aux évènements du serveur
-  stream(:keep_open) { |out| connexions << out }
-
-  # purge les connexions abandonnées
-  connexions.reject!(&:closed?)
-
-  # compte-rendu
-  "abonné"
+  stream(:keep_open) do |out|
+    connexions << out
+    # purge les connexions abandonnées
+    connexions.reject!(&:closed?)
+  end
 end
 
 post '/message' do
   connexions.each do |out|
     # prévient le client qu'un nouveau message est arrivé
-    out << params[:message] << "\n"
+    out << params['message'] << "\n"
 
     # indique au client de se connecter à nouveau
     out.close
@@ -1666,12 +1675,12 @@ Ou bien utilisez une session :
 enable :sessions
 
 get '/foo' do
-  session[:secret] = 'foo'
+  session['secret'] = 'foo'
   redirect to('/bar')
 end
 
 get '/bar' do
-  session[:secret]
+  session['secret']
 end
 ```
 
@@ -1712,7 +1721,7 @@ si le client a déjà la version courante dans son cache :
 
 ``` ruby
 get '/article/:id' do
-  @article = Article.find params[:id]
+  @article = Article.find params['id']
   last_modified @article.updated_at
   etag @article.sha1
   erb :article
@@ -2098,13 +2107,13 @@ set :protection, :session => true
 
   <p>Désactivé par défaut.</p></dd>
 
-  <dt>add_charsets</dt>
+  <dt>add_charset</dt>
   <dd><p>types mime pour lesquels la méthode <tt>content_type</tt> va
   automatiquement ajouter l’information du <tt>charset</tt>.</p>
 
   <p>Vous devriez lui ajouter des valeurs plutôt que de l’écraser :</p>
 
-  <pre>settings.add_charsets >> "application/foobar"</pre></dd>
+  <pre>settings.add_charset >> "application/foobar"</pre></dd>
 
   <dt>app_file</dt>
   <dd><p>chemin pour le fichier de l’application principale, utilisé pour
@@ -2283,7 +2292,7 @@ variable Rack `sinatra.error` :
 
 ``` ruby
 error do
-  'Désolé mais une méchante erreur est survenue - ' + env['sinatra.error'].name
+  'Désolé mais une méchante erreur est survenue - ' + env['sinatra.error'].message
 end
 ```
 
@@ -2334,7 +2343,7 @@ Sinatra installe pour vous quelques gestionnaires `not_found` et
 
 ## Les Middlewares Rack
 
-Sinatra tourne avec [Rack](http://rack.rubyforge.org/), une interface standard
+Sinatra tourne avec [Rack](http://rack.github.io/), une interface standard
 et minimale pour les web frameworks Ruby. Un des points forts de Rack est le
 support de ce que l'on appelle des "middlewares" -- composant qui vient se
 situer entre le serveur et votre application, et dont le but est de
@@ -2357,7 +2366,7 @@ end
 ```
 
 La sémantique de `use` est identique à celle définie dans le DSL de
-[Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html)
+[Rack::Builder](http://rubydoc.info/github/rack/rack/master/Rack/Builder)
 (le plus souvent utilisé dans un fichier rackup). Par exemple, la méthode
 `use` accepte divers arguments ainsi que des blocs :
 
@@ -2385,10 +2394,10 @@ recommandé :
 
 ``` ruby
 require 'mon_application_sinatra'
-require 'test/unit'
+require 'minitest/autorun'
 require 'rack/test'
 
-class MonTest < Test::Unit::TestCase
+class MonTest < Minitest::Test
   include Rack::Test::Methods
 
   def app
@@ -2449,7 +2458,20 @@ pour transformer la plupart des applications de haut niveau en un composant
 `Sinatra::Base` est une page blanche. La plupart des options sont
 désactivées par défaut, y compris le serveur intégré. Reportez-vous à
 [Options et Configuration](http://sinatra.github.com/configuration.html)
-pour plus d'informations sur les options et leur fonctionnement.
+pour plus d'informations sur les options et leur fonctionnement. Si vous
+souhaitez un comportement plus proche de celui obtenu lorsque vous définissez
+votre application au niveau supérieur (aussi connu sous le nom de style
+Classique), vous pouvez créer une classe héritant de `Sinatra::Application`.
+
+``` ruby
+require 'sinatra/base'
+
+class MyApp < Sinatra::Application
+  get '/' do
+    'Bonjour le monde !'
+  end
+end
+```
 
 ### Style modulaire vs. style classique
 
@@ -2465,14 +2487,56 @@ classique et style modulaire.
 Si vous passez d'un style à l'autre, souvenez-vous des quelques différences
 mineures en ce qui concerne les paramètres par défaut :
 
-  Paramètre         Classique                   Modulaire
+<table>
+  <tr>
+    <th>Paramètre</th>
+    <th>Classique</th>
+    <th>Modulaire</th>
+    <th>Modulaire</th>
+  </tr>
+
+  <tr>
+    <td>app_file</td>
+    <td>fichier chargeant sinatra</td>
+    <td>fichier héritant de Sinatra::Base</td>
+    <td>fichier héritant de 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>
 
-  app_file          fichier chargeant sinatra   fichier héritant de Sinatra::Base
-  run               $0 == app_file              false
-  logging           true                        false
-  method_override   true                        false
-  inline_templates  true                        false
-  static            true                        false
+  <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>false</td>
+    <td>true</td>
+  </tr>
+</table>
 
 ### Servir une application modulaire
 
@@ -2563,8 +2627,8 @@ class EcranDeConnexion < Sinatra::Base
   get('/connexion') { haml :connexion }
 
   post('/connexion') do
-    if params[:nom] = 'admin' && params[:motdepasse] = 'admin'
-      session['nom_utilisateur'] = params[:nom]
+    if params['nom'] = 'admin' && params['motdepasse'] = 'admin'
+      session['nom_utilisateur'] = params['nom']
     else
       redirect '/connexion'
     end
@@ -2689,8 +2753,8 @@ class MonApp < Sinatra::Base
     # Contexte de la requête pour '/ajouter_route/:nom'
     @value = 42
 
-    settings.get("/#{params[:nom]}") do
-      # Contexte de la requête pour "/#{params[:nom]}"
+    settings.get("/#{params['nom']}") do
+      # Contexte de la requête pour "/#{params['nom']}"
       @value # => nil (on est pas au sein de la même requête)
     end
 
@@ -2915,7 +2979,7 @@ SemVer que SemVerTag.
 * [Twitter](http://twitter.com/sinatra)
 * [Mailing List](http://groups.google.com/group/sinatrarb/topics)
 * IRC : [#sinatra](irc://chat.freenode.net/#sinatra) sur http://freenode.net
-* [Sinatra Book](http://sinatra-book.gittr.com) Tutoriels et recettes
+* [Sinatra Book](https://github.com/sinatra/sinatra-book/) Tutoriels et recettes
 * [Sinatra Recipes](http://recipes.sinatrarb.com/) trucs et astuces rédigés par
   la communauté
 * Documentation API de la [dernière version](http://rubydoc.info/gems/sinatra)

data/README.hu.md

@@ -1,6 +1,6 @@
 # Sinatra
 *Fontos megjegyzés: Ez a dokumentum csak egy fordítása az angol nyelvű
-változat, és lehet, hogy nem naprakész.*
+változatnak, és lehet, hogy nem naprakész.*
 
 A Sinatra egy [DSL](http://en.wikipedia.org/wiki/Domain-specific_language)
 webalkalmazások Ruby nyelven történő fejlesztéséhez, minimális
@@ -56,8 +56,8 @@ hash-ből érhetünk el:
 ```ruby
   get '/hello/:name' do
     # illeszkedik a "GET /hello/foo" és a "GET /hello/bar" útvonalakra
-    # ekkor params[:name] értéke 'foo' vagy 'bar' lesz
-    "Helló #{params[:name]}!"
+    # ekkor params['name'] értéke 'foo' vagy 'bar' lesz
+    "Helló #{params['name']}!"
   end
 ```
 
@@ -71,25 +71,25 @@ is el tudod érni:
 ```
 
 Az útvonalmintákban szerepelhetnek joker paraméterek is, melyeket a
-`params[:splat]` tömbön keresztül tudunk elérni.
+`params['splat']` tömbön keresztül tudunk elérni.
 
 ```ruby
   get '/say/*/to/*' do
     # illeszkedik a /say/hello/to/world mintára
-    params[:splat] # => ["hello", "world"]
+    params['splat'] # => ["hello", "world"]
   end
 
   get '/download/*.*' do
     # illeszkedik a /download/path/to/file.xml mintára
-    params[:splat] # => ["path/to/file", "xml"]
+    params['splat'] # => ["path/to/file", "xml"]
   end
 ```
 
 Reguláris kifejezéseket is felvehetünk az útvonalba:
 
 ```ruby
-  get %r{/hello/([\w]+)} do
-    "Helló, #{params[:captures].first}!"
+  get /\A\/hello\/([\w]+)\z/ do
+    "Helló, #{params['captures'].first}!"
   end
 ```
 
@@ -106,7 +106,7 @@ tervezhetők, így például az user agent karakterláncot alapul véve:
 
 ```ruby
   get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
-    "A Songbird #{params[:agent][0]} verzióját használod"
+    "A Songbird #{params['agent'][0]} verzióját használod"
   end
 
   get '/foo' do
@@ -122,7 +122,7 @@ mégpedig a :public_folder kapcsoló beállításával:
 
   set :public_folder, File.dirname(__FILE__) + '/static'
 
-Fontos mgejegyezni, hogy a nyilvános könyvtár neve nem szerepel az URL-ben.
+Fontos megjegyezni, hogy a nyilvános könyvtár neve nem szerepel az URL-ben.
 A ./public/css/style.css fájl az
 `http://example.com/css/style.css` URL-en lesz elérhető.
 
@@ -244,7 +244,7 @@ változók közvetlenül elérhetőek lesznek a sablonokban:
 
 ```ruby
   get '/:id' do
-    @foo = Foo.find(params[:id])
+    @foo = Foo.find(params['id'])
     haml '%h1= @foo.name'
   end
 ```
@@ -253,7 +253,7 @@ De megadhatod egy lokális változókat tartalmazó explicit hash-ben is:
 
 ```ruby
   get '/:id' do
-    foo = Foo.find(params[:id])
+    foo = Foo.find(params['id'])
     haml '%h1= foo.name', :locals => { :foo => foo }
   end
 ```
@@ -332,7 +332,7 @@ használni:
   end
 
   get '/:name' do
-    bar(params[:name])
+    bar(params['name'])
   end
 ```
 
@@ -351,7 +351,7 @@ az útvonalakban és a sablonokban is:
 
   get '/foo/*' do
     @note #=> 'Szeva!'
-    params[:splat] #=> 'bar/baz'
+    params['splat'] #=> 'bar/baz'
   end
 ```
 
@@ -388,7 +388,7 @@ a `pass` függvényhívással:
 
 ```ruby
   get '/guess/:who' do
-    pass unless params[:who] == 'Frici'
+    pass unless params['who'] == 'Frici'
     "Elkaptál!"
   end
 
@@ -454,7 +454,7 @@ előszűrő kivételt vált ki. A kivétel objektum lehívható a
 
 ```ruby
   error do
-    'Elnézést, de valami szörnyű hiba lépett fel - ' + env['sinatra.error'].name
+    'Elnézést, de valami szörnyű hiba lépett fel - ' + env['sinatra.error'].message
   end
 ```
 
@@ -495,7 +495,7 @@ bevezetéséhez:
 ## Rack Middleware
 
 A Sinatra egy Ruby keretrendszerek számára kifejlesztett egyszerű és szabványos
-interfészre, a [Rack](http://rack.rubyforge.org/) -re épül. A Rack fejlesztői
+interfészre, a [Rack](http://rack.github.io/) -re épül. A Rack fejlesztői
 szempontból egyik legérdekesebb jellemzője, hogy támogatja az úgynevezett
 "middleware" elnevezésű komponenseket, amelyek beékelődnek a szerver és az
 alkalmazás közé, így képesek megfigyelni és/vagy módosítani a HTTP
@@ -518,7 +518,7 @@ A Sinatra keretrendszerben gyerekjáték a Rack middleware-ek behúzása a
 ```
 
 A `use` metódus szemantikája megegyezik a
-[Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html) DSL-ben
+[Rack::Builder](http://rubydoc.info/github/rack/rack/master/Rack/Builder) DSL-ben
 használt +use+ metóduséval (az említett DSL-t leginkább rackup állományokban
 használják). Hogy egy példát említsünk, a `use` metódus elfogad
 változókat és blokkokat egyaránt, akár kombinálva is ezeket:
@@ -545,7 +545,7 @@ könyvtárat ajánljuk:
   require 'my_sinatra_app'
   require 'rack/test'
 
-  class MyAppTest < Test::Unit::TestCase
+  class MyAppTest < Minitest::Test
     include Rack::Test::Methods
 
     def app