sinatra 2.0.8.1 → 2.1.0

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of sinatra might be problematic. Click here for more details.

checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d0a9fb798a1b2f906d9b84c950dd0095bbe7fa043468ffcc6b5a48f0320d14a1
4
- data.tar.gz: 9e05cfa93c2426526551ad0149562132157a7a01e6ebacc1f153f5d75bd4ea0b
3
+ metadata.gz: a13ef28ef13aa508887d370e6e666ec7af2aa27d464c2c3907fe72f3f3091fcb
4
+ data.tar.gz: 0aef31461f40ec12007e04dcfc8df077ce389a8710ef79c74466ba08eedd8085
5
5
  SHA512:
6
- metadata.gz: c2d1a38d64c63b2b5de785bc301843a1ce8a84daa752beceea399d3d936d3fdc3ed2e65d642c9f7ad736a3b67d5b66ae4b60078ab5a24841a67d6ccd9fe68d62
7
- data.tar.gz: a8382fe4d07c482efa87001d9b4de97dffbf48eb69ded2d177e202cae852898ddf394095bc108f170f789ba2e47b8a45900191efcb8aa81b6e9df5289cf682e4
6
+ metadata.gz: b93f4761e873891715668e34a695e35bb0f57983f7bf260440a7d06ead5e4b88cdeb173f4f093e74aada601b54773df47211d882ea30880fe98c0f4225cd4846
7
+ data.tar.gz: 2aaa6acfcbcb7f2e875820ba61b243916de46c0c689182afbb13f59a168a74f0bff6a0c546e47f29a60804311d960bc26cc5c897c15b05f9f26e677c60e939e3
@@ -1,3 +1,37 @@
1
+ ## 2.1.0 / 2020-09-05
2
+
3
+ * Fix additional Ruby 2.7 keyword warnings [#1586](https://github.com/sinatra/sinatra/pull/1586) by Stefan Sundin
4
+
5
+ * Drop Ruby 2.2 support [#1455](https://github.com/sinatra/sinatra/pull/1455) by Eloy Pérez
6
+
7
+ * Add Rack::Protection::ReferrerPolicy [#1291](https://github.com/sinatra/sinatra/pull/1291) by Stefan Sundin
8
+
9
+ * Add `default_content_type` setting. Fixes [#1238](https://github.com/sinatra/sinatra/pull/1238) [#1239](https://github.com/sinatra/sinatra/pull/1239) by Mike Pastore
10
+
11
+ * Allow `set :<engine>` in sinatra-namespace [#1255](https://github.com/sinatra/sinatra/pull/1255) by Christian Höppner
12
+
13
+ * Use prepend instead of include for helpers. Fixes [#1213](https://github.com/sinatra/sinatra/pull/1213) [#1214](https://github.com/sinatra/sinatra/pull/1214) by Mike Pastore
14
+
15
+ * Fix issue with passed routes and provides Fixes [#1095](https://github.com/sinatra/sinatra/pull/1095) [#1606](https://github.com/sinatra/sinatra/pull/1606) by Mike Pastore, Jordan Owens
16
+
17
+ * Add QuietLogger that excludes pathes from Rack::CommonLogger [1250](https://github.com/sinatra/sinatra/pull/1250) by Christoph Wagner
18
+
19
+ * Sinatra::Contrib dependency updates. Fixes [#1207](https://github.com/sinatra/sinatra/pull/1207) [#1411](https://github.com/sinatra/sinatra/pull/1411) by Mike Pastore
20
+
21
+ * Allow CSP to fallback to default-src. Fixes [#1484](https://github.com/sinatra/sinatra/pull/1484) [#1490](https://github.com/sinatra/sinatra/pull/1490) by Jordan Owens
22
+
23
+ * Replace `origin_whitelist` with `permitted_origins`. Closes [#1620](https://github.com/sinatra/sinatra/issues/1620) [#1625](https://github.com/sinatra/sinatra/pull/1625) by rhymes
24
+
25
+ * Use Rainbows instead of thin for async/stream features. Closes [#1624](https://github.com/sinatra/sinatra/issues/1624) [#1627](https://github.com/sinatra/sinatra/pull/1627) by Ryuichi KAWAMATA
26
+
27
+ * Enable EscapedParams if passed via settings. Closes [#1615](https://github.com/sinatra/sinatra/issues/1615) [#1632](https://github.com/sinatra/sinatra/issues/1632) by Anders Bälter
28
+
29
+ * Support for parameters in mime types. Fixes [#1141](https://github.com/sinatra/sinatra/issues/1141) by John Hope
30
+
31
+ * Handle null byte when serving static files [#1574](https://github.com/sinatra/sinatra/issues/1574) by Kush Fanikiso
32
+
33
+ * Improve development support and documentation and source code by Olle Jonsson, Pierre-Adrien Buisson, Shota Iguchi
34
+
1
35
  ## 2.0.8.1 / 2020-01-02
2
36
 
3
37
  * Allow multiple hashes to be passed in `merge` and `merge!` for `Sinatra::IndifferentHash` [#1572](https://github.com/sinatra/sinatra/pull/1572) by Shota Iguchi
data/Gemfile CHANGED
@@ -41,7 +41,8 @@ if RUBY_ENGINE == "ruby"
41
41
  gem 'puma'
42
42
  gem 'yajl-ruby'
43
43
  gem 'nokogiri'
44
- gem 'thin'
44
+ gem 'rainbows'
45
+ gem 'eventmachine'
45
46
  gem 'slim', '~> 2.0'
46
47
  gem 'coffee-script', '>= 2.0'
47
48
  gem 'rdoc'
@@ -434,7 +434,7 @@ Statische Dateien werden im `./public`-Ordner erwartet. Es ist möglich,
434
434
  einen anderen Ort zu definieren, indem man die `:public_folder`-Option setzt:
435
435
 
436
436
  ```ruby
437
- set :public_folder, File.dirname(__FILE__) + '/static'
437
+ set :public_folder, __dir__ + '/static'
438
438
  ```
439
439
 
440
440
  Zu beachten ist, dass der Ordnername `public` nicht Teil der URL ist.
@@ -3120,9 +3120,9 @@ thin --threaded start
3120
3120
  Die folgenden Versionen werden offiziell unterstützt:
3121
3121
 
3122
3122
  <dl>
3123
- <dt>Ruby 2.2</dt>
3123
+ <dt>Ruby 2.3</dt>
3124
3124
  <dd>
3125
- 2.2 wird vollständig unterstützt. Es gibt derzeit keine Pläne die
3125
+ 2.3 wird vollständig unterstützt. Es gibt derzeit keine Pläne die
3126
3126
  offizielle Unterstützung zu beenden
3127
3127
  </dd>
3128
3128
 
@@ -430,7 +430,7 @@ Los archivos estáticos son servidos desde el directorio público
430
430
  opción `:public_folder`:
431
431
 
432
432
  ```ruby
433
- set :public_folder, File.dirname(__FILE__) + '/static'
433
+ set :public_folder, __dir__ + '/static'
434
434
  ```
435
435
 
436
436
  Note que el nombre del directorio público no está incluido en la URL. Por
@@ -3083,9 +3083,9 @@ thin --threaded start
3083
3083
  Las siguientes versiones de Ruby son soportadas oficialmente:
3084
3084
 
3085
3085
  <dl>
3086
- <dt>Ruby 2.2</dt>
3086
+ <dt>Ruby 2.3</dt>
3087
3087
  <dd>
3088
- 2.2 Es totalmente compatible y recomendado. Actualmente no hay planes
3088
+ 2.3 Es totalmente compatible y recomendado. Actualmente no hay planes
3089
3089
  soltar el apoyo oficial para ello.
3090
3090
  </dd>
3091
3091
 
@@ -26,8 +26,12 @@ Puis lancez votre programme :
26
26
  ruby mon_application.rb
27
27
  ```
28
28
 
29
- Le résultat est visible sur :
30
- [http://localhost:4567](http://localhost:4567)
29
+ Le résultat est visible sur : [http://localhost:4567](http://localhost:4567)
30
+
31
+ Le code que vous avez modifié ne sera pas pris en compte tant que vous ne
32
+ redémarrerez pas le serveur. Pensez à redémarrer le serveur à chaque
33
+ modification ou utilisez
34
+ [sinatra/reloader](http://www.sinatrarb.com/contrib/reloader).
31
35
 
32
36
  Il est recommandé d'exécuter également `gem install thin`, pour que
33
37
  Sinatra utilise le server Thin quand il est disponible.
@@ -55,11 +59,13 @@ Sinatra utilise le server Thin quand il est disponible.
55
59
  * [Templates Markdown](#templates-markdown)
56
60
  * [Templates Textile](#templates-textile)
57
61
  * [Templates RDoc](#templates-rdoc)
62
+ * [Templates Asciidoc](#templates-asciidoc)
58
63
  * [Templates Radius](#templates-radius)
59
64
  * [Templates Markaby](#templates-markaby)
60
65
  * [Templates RABL](#templates-rabl)
61
66
  * [Templates Slim](#templates-slim)
62
67
  * [Templates Creole](#templates-creole)
68
+ * [Templates MediaWiki](#templates-mediawiki)
63
69
  * [Templates CoffeeScript](#templates-coffeescript)
64
70
  * [Templates Stylus](#templates-stylus)
65
71
  * [Templates Yajl](#templates-yajl)
@@ -70,6 +76,7 @@ Sinatra utilise le server Thin quand il est disponible.
70
76
  * [Templates nommés](#templates-nommés)
71
77
  * [Associer des extensions de fichier](#associer-des-extensions-de-fichier)
72
78
  * [Ajouter son propre moteur de rendu](#ajouter-son-propre-moteur-de-rendu)
79
+ * [Utiliser des règles personnalisées pour la recherche de templates](#utiliser-des-règles-personnalisées-pour-la-recherche-de-templates)
73
80
  * [Filtres](#filtres)
74
81
  * [Helpers](#helpers)
75
82
  * [Utiliser les sessions](#utiliser-les-sessions)
@@ -91,7 +98,7 @@ Sinatra utilise le server Thin quand il est disponible.
91
98
  * [Configuration](#configuration)
92
99
  * [Se protéger des attaques](#se-protéger-des-attaques)
93
100
  * [Paramètres disponibles](#paramètres-disponibles)
94
- * [Environements](#environements)
101
+ * [Environnements](#environnements)
95
102
  * [Gérer les erreurs](#gérer-les-erreurs)
96
103
  * [NotFound](#notfound)
97
104
  * [Error](#error)
@@ -157,9 +164,18 @@ unlink '/' do
157
164
  end
158
165
  ```
159
166
 
160
- Les routes sont évaluées dans l'ordre où elles ont été définies. La première
167
+ Les routes sont évaluées dans l'ordre où elles ont été définies. La première
161
168
  route qui correspond à la requête est appelée.
162
169
 
170
+ Les routes se terminant par un slash sont différentes de celles qui n'en
171
+ comportent pas :
172
+
173
+ ```ruby
174
+ get '/foo' do
175
+ # Ne correspond pas à "GET /foo/"
176
+ end
177
+ ```
178
+
163
179
  Les masques peuvent inclure des paramètres nommés, accessibles par
164
180
  l'intermédiaire du hash `params` :
165
181
 
@@ -242,10 +258,24 @@ get '/articles' do
242
258
  end
243
259
  ```
244
260
 
245
- A ce propos, à moins d'avoir désactivé la protection contre les attaques par
261
+ À ce propos, à moins d'avoir désactivé la protection contre les attaques par
246
262
  "path transversal" (voir plus loin), l'URL demandée peut avoir été modifiée
247
263
  avant d'être comparée à vos routes.
248
264
 
265
+ Vous pouvez personnaliser les options [Mustermann](https://github.com/sinatra/mustermann#readme)
266
+ utilisées pour une route donnée en fournissant un hash `:mustermann_opts` :
267
+
268
+ ```ruby
269
+ get '\A/articles\z', :mustermann_opts => { :type => :regexp, :check_anchors => false } do
270
+ # répond exactement à /articles, avec un ancrage explicite
271
+ "Si tu réponds à un pattern ancré tape dans tes mains !
272
+ end
273
+ ```
274
+
275
+ Cela ressemble à une [condition](#conditions), mais ce n'en est pas une !
276
+ Ces options seront mergées dans le hash global `:mustermann_opts` décrit
277
+ [plus bas](#paramètres-disponibles).
278
+
249
279
  ## Conditions
250
280
 
251
281
  Les routes peuvent définir toutes sortes de conditions, comme par exemple le
@@ -400,7 +430,7 @@ end
400
430
  Les fichiers du dossier `./public` sont servis de façon statique. Vous pouvez spécifier un autre dossier avec le paramètre `:public_folder` :
401
431
 
402
432
  ```ruby
403
- set :public_folder, File.dirname(__FILE__) + '/statique'
433
+ set :public_folder, __dir__ + '/statique'
404
434
  ```
405
435
 
406
436
  Notez que le nom du dossier public n'apparait pas dans l'URL. Le fichier
@@ -541,6 +571,15 @@ end
541
571
  ```
542
572
 
543
573
  Utilisera la chaine de caractères comme template pour générer la réponse.
574
+ Vous pouvez spécifier un `:path` et `:line` optionnels pour une trace plus
575
+ claire s'il existe un chemin dans le système de fichiers ou une ligne
576
+ associés à cette chaîne de caractères :
577
+
578
+ ```ruby
579
+ get '/' do
580
+ haml '%div.title Bonjour le monde', :path => 'exemples/fichier.haml', :line => 3
581
+ end
582
+ ```
544
583
 
545
584
  ### Langages de template disponibles
546
585
 
@@ -826,7 +865,28 @@ pas utiliser de layouts écrits en RDoc. Toutefois, il est
826
865
  possible d’utiliser un moteur de rendu différent pour le template et
827
866
  pour le layout en utilisant l’option `:layout_engine`.
828
867
 
868
+ #### Templates Asciidoc
869
+
870
+ <table>
871
+ <tr>
872
+ <td>Dépendances</td>
873
+ <td><a href="http://asciidoctor.org/" title="Asciidoctor">Asciidoctor</a></td>
874
+ </tr>
875
+ <tr>
876
+ <td>Extensions de fichier</td>
877
+ <td><tt>.asciidoc</tt>, <tt>.adoc</tt> and <tt>.ad</tt></td>
878
+ </tr>
879
+ <tr>
880
+ <td>Exemple</td>
881
+ <td><tt>asciidoc :README, :layout_engine => :erb</tt></td>
882
+ </tr>
883
+ </table>
884
+
885
+ Comme vous ne pouvez pas appeler de méthodes Ruby depuis un template
886
+ AsciiDoc, vous aurez sûrement à lui passer des variables locales.
887
+
829
888
  #### Templates Radius
889
+
830
890
  <table>
831
891
  <tr>
832
892
  <td>Dépendances</td>
@@ -936,6 +996,44 @@ pas utiliser de layouts écrits en Creole. Toutefois, il est possible
936
996
  d'utiliser un moteur de rendu différent pour le template et pour le layout
937
997
  en utilisant l'option `:layout_engine`.
938
998
 
999
+ #### Templates MediaWiki
1000
+
1001
+ <table>
1002
+ <tr>
1003
+ <td>Dépendances</td>
1004
+ <td><a href="https://github.com/nricciar/wikicloth" title="WikiCloth">WikiCloth</a></td>
1005
+ </tr>
1006
+ <tr>
1007
+ <td>Extensions de fichier</td>
1008
+ <td><tt>.mediawiki</tt> and <tt>.mw</tt></td>
1009
+ </tr>
1010
+ <tr>
1011
+ <td>Exemple</td>
1012
+ <td><tt>mediawiki :wiki, :layout_engine => :erb</tt></td>
1013
+ </tr>
1014
+ </table>
1015
+
1016
+ Il n’est pas possible d’appeler de méthodes Ruby depuis Mediawiki, ni de lui
1017
+ passer de variables locales. Par conséquent, il sera souvent utilisé en
1018
+ combinaison avec un autre moteur de rendu :
1019
+
1020
+ ```ruby
1021
+ erb :overview, :locals => { :text => mediawiki(:introduction) }
1022
+ ```
1023
+
1024
+ Notez que vous pouvez également appeler la méthode `mediawiki` depuis un
1025
+ autre template :
1026
+
1027
+ ```ruby
1028
+ %h1 Bonjour depuis Haml !
1029
+ %p= mediawiki(:bienvenue)
1030
+ ```
1031
+
1032
+ Comme vous ne pouvez pas appeler de méthodes Ruby depuis MediaWiki, vous ne pouvez
1033
+ pas utiliser de layouts écrits en MediaWiki. Toutefois, il est
1034
+ possible d’utiliser un moteur de rendu différent pour le template et
1035
+ pour le layout en utilisant l’option `:layout_engine`.
1036
+
939
1037
  #### Templates CoffeeScript
940
1038
 
941
1039
  <table>
@@ -1078,12 +1176,12 @@ get '/:id' do
1078
1176
  end
1079
1177
  ```
1080
1178
 
1081
- Ceci est généralement nécessaire lorsque l'on veut utiliser un template depuis un autre template (partiel) et qu'il faut donc adapter le nom des variables.
1179
+ Ceci est généralement nécessaire lorsque l'on veut utiliser un template depuis un autre template (partiel) et qu'il faut donc adapter le nom des variables.
1082
1180
 
1083
1181
  ### Templates avec `yield` et layouts imbriqués
1084
1182
 
1085
1183
  En général, un layout est un simple template qui appelle `yield`. Ce genre de
1086
- template peut s'utiliser via l'option `:template` comme décrit précédemment ou
1184
+ template peut s'utiliser via l'option `:template` comme décrit précédemment ou
1087
1185
  peut être rendu depuis un bloc :
1088
1186
 
1089
1187
  ```ruby
@@ -1203,6 +1301,23 @@ end
1203
1301
 
1204
1302
  Utilisera `./views/index.monmoteur`. Voir [le projet Github](https://github.com/rtomayko/tilt) pour en savoir plus sur Tilt.
1205
1303
 
1304
+ ### Utiliser des règles personnalisées pour la recherche de templates
1305
+
1306
+ Pour implémenter votre propre mécanisme de recherche de templates, vous
1307
+ pouvez écrire votre propre méthode `#find_template` :
1308
+
1309
+ ```ruby
1310
+ configure do
1311
+ set :views, [ './vues/a', './vues/b' ]
1312
+ end
1313
+
1314
+ def find_template(vues, nom, moteur, &bloc)
1315
+ Array(vues).each do |v|
1316
+ super(v, nom, moteur, &bloc)
1317
+ end
1318
+ end
1319
+ ```
1320
+
1206
1321
  ## Filtres
1207
1322
 
1208
1323
  Les filtres `before` sont exécutés avant chaque requête, dans le même contexte
@@ -1542,7 +1657,7 @@ post '/message' do
1542
1657
  # prévient le client qu'un nouveau message est arrivé
1543
1658
  out << params['message'] << "\n"
1544
1659
 
1545
- # indique au client de se connecter à nouveau
1660
+ # indique au client de se connecter à nouveau
1546
1661
  out.close
1547
1662
  end
1548
1663
 
@@ -1551,6 +1666,10 @@ post '/message' do
1551
1666
  end
1552
1667
  ```
1553
1668
 
1669
+ Il est aussi possible pour le client de fermer la connexion en essayant
1670
+ d'écrire sur le socket. Pour cette raison, il est recommandé de vérifier
1671
+ `out.closed?` avant d'essayer d'y écrire.
1672
+
1554
1673
  ### Journalisation (Logging)
1555
1674
 
1556
1675
  Dans le contexte de la requête, la méthode utilitaire `logger` expose une
@@ -1792,12 +1911,6 @@ Les options sont :
1792
1911
  le nom du fichier dans la réponse, par défaut le nom du fichier envoyé.
1793
1912
  </dd>
1794
1913
 
1795
- <dt>last_modified</dt>
1796
- <dd>
1797
- valeur pour l’en-tête Last-Modified, par défaut la date de modification du
1798
- fichier.
1799
- </dd>
1800
-
1801
1914
  <dt>type</dt>
1802
1915
  <dd>
1803
1916
  type de contenu à utiliser, deviné à partir de l’extension de fichier si
@@ -1816,7 +1929,6 @@ Les options sont :
1816
1929
  <dt>status</dt>
1817
1930
  <dd>
1818
1931
  code état à renvoyer. Utile quand un fichier statique sert de page d’erreur.
1819
-
1820
1932
  Si le gestionnaire Rack le supporte, d'autres moyens que le streaming via le
1821
1933
  processus Ruby seront utilisés. Si vous utilisez cette méthode, Sinatra gérera
1822
1934
  automatiquement les requêtes de type range.
@@ -1962,8 +2074,8 @@ vous pouvez utiliser plus d'un répertoire de vues :
1962
2074
  set :views, ['views', 'templates']
1963
2075
 
1964
2076
  helpers do
1965
- def find_template(views, name, engine, &block)
1966
- Array(views).each { |v| super(v, name, engine, &block) }
2077
+ def find_template(vues, nom, moteur, &bloc)
2078
+ Array(vues).each { |v| super(v, nom, moteur, &bloc) }
1967
2079
  end
1968
2080
  end
1969
2081
  ```
@@ -2142,6 +2254,12 @@ set :protection, :session => true
2142
2254
  <dt>port</dt>
2143
2255
  <dd>port à écouter. Utiliser seulement pour le serveur intégré.</dd>
2144
2256
 
2257
+ <dt>mustermann_opts</dt>
2258
+ <dd>
2259
+ Un hash d'options à passer à Mustermann.new lors de la compilation
2260
+ des chemins de routes
2261
+ </dd>
2262
+
2145
2263
  <dt>prefixed_redirects</dt>
2146
2264
  <dd>si oui ou non <tt>request.script_name</tt> doit être inséré dans les
2147
2265
  redirections si un chemin non absolu est utilisé. Ainsi, <tt>redirect
@@ -2161,6 +2279,12 @@ set :protection, :session => true
2161
2279
  paramètre <tt>static</tt>). Si non défini, il découle du paramètre
2162
2280
  <tt>app_file</tt>.</dd>
2163
2281
 
2282
+ <dt>quiet</dt>
2283
+ <dd>
2284
+ Désactive les journaux (logs) générés par les commandes start et stop
2285
+ de Sinatra. <tt>false</tt> par défaut.
2286
+ </dd>
2287
+
2164
2288
  <dt>reload_templates</dt>
2165
2289
  <dd>si oui ou non les templates doivent être rechargés entre les requêtes.
2166
2290
  Activé en mode développement.</dd>
@@ -2187,11 +2311,27 @@ set :protection, :session => true
2187
2311
  défaut [‘thin’, ‘mongrel’, ‘webrick’], l’ordre indiquant la
2188
2312
  priorité.</dd>
2189
2313
 
2314
+ <dt>server_settings</dt>
2315
+ <dd>
2316
+ Si vous utilisez un serveur Webrick, sans doute pour votre environnement de
2317
+ développement, vous pouvez passer des options à <tt>server_settings</tt>,
2318
+ comme <tt>SSLEnable</tt> ou <tt>SSLVerifyClient</tt>. Cependant, les
2319
+ serveurs comme Puma et Thin ne le permettent pas, et vous pouvez donc
2320
+ définir <tt>server_settings</tt> en tant que méthode lorsque vous appelez
2321
+ <tt>configure</tt>.
2322
+ </dd>
2323
+
2190
2324
  <dt>sessions</dt>
2191
2325
  <dd>active le support des sessions basées sur les cookies, en utilisant
2192
2326
  <tt>Rack::Session::Cookie</tt>. Reportez-vous à la section ‘Utiliser les
2193
2327
  sessions’ pour plus d’informations.</dd>
2194
2328
 
2329
+ <dt>session_store</dt>
2330
+ <dd>
2331
+ Le middleware Rack utilisé pour les sessions. <tt>Rack::Session::Cookie</tt>
2332
+ par défaut. Voir la section 'Utiliser les sessions' pour plus de détails.
2333
+ </dd>
2334
+
2195
2335
  <dt>show_exceptions</dt>
2196
2336
  <dd>affiche la trace de l’erreur dans le navigateur lorsqu’une exception se
2197
2337
  produit. Désactivé par défaut sauf lorsque <tt>environment</tt> est
@@ -2214,6 +2354,9 @@ set :protection, :session => true
2214
2354
  <dd>à définir à <tt>true</tt> pour indiquer à Thin d’utiliser
2215
2355
  <tt>EventMachine.defer</tt> pour traiter la requête.</dd>
2216
2356
 
2357
+ <dt>traps</dt>
2358
+ <dd>Indique si Sinatra doit gérer les signaux système.</dd>
2359
+
2217
2360
  <dt>views</dt>
2218
2361
  <dd>chemin pour le dossier des vues. Si non défini, il découle du paramètre
2219
2362
  <tt>app_file</tt>.</dd>
@@ -2225,10 +2368,10 @@ set :protection, :session => true
2225
2368
  </dd>
2226
2369
  </dl>
2227
2370
 
2228
- ## Environements
2371
+ ## Environnements
2229
2372
 
2230
2373
  Il existe trois environnements prédéfinis : `"development"`,
2231
- `"production"` et `"test"`. Les environements peuvent être
2374
+ `"production"` et `"test"`. Les environnements peuvent être
2232
2375
  sélectionné via la variable d'environnement `APP_ENV`. Sa valeur par défaut
2233
2376
  est `"development"`. Dans ce mode, tous les templates sont rechargés à
2234
2377
  chaque requête. Des handlers spécifiques pour `not_found` et
@@ -2276,7 +2419,15 @@ end
2276
2419
  ### Error
2277
2420
 
2278
2421
  Le gestionnaire `error` est invoqué à chaque fois qu'une exception est
2279
- soulevée dans une route ou un filtre. L'objet exception est accessible via la
2422
+ soulevée dans une route ou un filtre. Notez qu'en développement, il ne
2423
+ sera exécuté que si vous définissez l'option show exceptions à
2424
+ `:after_handler` :
2425
+
2426
+ ```ruby
2427
+ set :show_exceptions, :after_handler
2428
+ ```
2429
+
2430
+ L'objet exception est accessible via la
2280
2431
  variable Rack `sinatra.error` :
2281
2432
 
2282
2433
  ```ruby
@@ -2285,7 +2436,7 @@ error do
2285
2436
  end
2286
2437
  ```
2287
2438
 
2288
- Erreur sur mesure :
2439
+ Erreur personnalisée :
2289
2440
 
2290
2441
  ```ruby
2291
2442
  error MonErreurSurMesure do
@@ -2412,6 +2563,9 @@ class MonTest < Minitest::Test
2412
2563
  end
2413
2564
  ```
2414
2565
 
2566
+ Note : si vous utilisez le style modulaire de Sinatra, remplacez
2567
+ `Sinatra::Application` par le nom de la classe de votre application.
2568
+
2415
2569
  ## Sinatra::Base - Les Middlewares, Bibliothèques, et Applications Modulaires
2416
2570
 
2417
2571
  Définir votre application au niveau supérieur fonctionne bien dans le cas des
@@ -2818,9 +2972,9 @@ multi-threaded:
2818
2972
  require 'sinatra/base'
2819
2973
 
2820
2974
  classe App < Sinatra::Base
2821
-   get '/' do
2975
+ get '/' do
2822
2976
  'Bonjour le monde !'
2823
-   end
2977
+ end
2824
2978
  end
2825
2979
 
2826
2980
  App.run!
@@ -2839,31 +2993,9 @@ thin --threaded start
2839
2993
  Les versions suivantes de Ruby sont officiellement supportées :
2840
2994
 
2841
2995
  <dl>
2842
- <dt>Ruby 1.8.7</dt>
2843
- <dd>
2844
- 1.8.7 est complètement supporté, toutefois si rien ne vous en empêche,
2845
- nous vous recommandons de faire une mise à jour ou bien de passer à JRuby
2846
- ou Rubinius. Le support de Ruby 1.8.7 ne sera pas supprimé avant la sortie
2847
- de Sinatra 2.0. Ruby 1.8.6 n’est plus supporté.
2848
- </dd>
2849
-
2850
- <dt>Ruby 1.9.2</dt>
2851
- <dd>
2852
- 1.9.2 est totalement supporté. N’utilisez pas 1.9.2p0 car il provoque des
2853
- erreurs de segmentation à l’exécution de Sinatra. Son support continuera
2854
- au minimum jusqu’à la sortie de Sinatra 1.5.
2855
- </dd>
2856
-
2857
- <dt>Ruby 1.9.3</dt>
2858
- <dd>
2859
- 1.9.3 est totalement supporté et recommandé. Nous vous rappelons que passer
2860
- à 1.9.3 depuis une version précédente annulera toutes les sessions. 1.9.3
2861
- sera supporté jusqu'à la sortie de Sinatra 2.0.
2862
- </dd>
2863
-
2864
- <dt>Ruby 2.0.0</dt>
2996
+ <dt>Ruby 2.2</dt>
2865
2997
  <dd>
2866
- 2.0.0 est totalement supporté et recommandé. L'abandon de son support
2998
+ 2.2 est totalement supporté et recommandé. L'abandon de son support
2867
2999
  officiel n'est pas à l'ordre du jour.
2868
3000
  </dd>
2869
3001
 
@@ -2881,6 +3013,8 @@ Les versions suivantes de Ruby sont officiellement supportées :
2881
3013
  </dd>
2882
3014
  </dl>
2883
3015
 
3016
+ Les versions antérieures à 2.2.2 ne sont plus supportées depuis Sinatra 2.0.
3017
+
2884
3018
  Nous gardons également un oeil sur les versions Ruby à venir.
2885
3019
 
2886
3020
  Les implémentations Ruby suivantes ne sont pas officiellement supportées mais
@@ -2953,43 +3087,6 @@ Vous pouvez alors lancer votre application de la façon suivante :
2953
3087
  bundle exec ruby myapp.rb
2954
3088
  ```
2955
3089
 
2956
- ### Faire un clone local
2957
-
2958
- Si vous ne souhaitez pas employer Bundler, vous pouvez cloner Sinatra en local
2959
- dans votre projet et démarrez votre application avec le dossier `sinatra/lib`
2960
- dans le `$LOAD_PATH` :
2961
-
2962
- ```shell
2963
- cd myapp
2964
- git clone git://github.com/sinatra/sinatra.git
2965
- ruby -I sinatra/lib myapp.rb
2966
- ```
2967
-
2968
- Et de temps en temps, vous devrez récupérer la dernière version du code source
2969
- de Sinatra :
2970
-
2971
- ```shell
2972
- cd myapp/sinatra
2973
- git pull
2974
- ```
2975
-
2976
- ### Installer globalement
2977
-
2978
- Une dernière méthode consiste à construire la gem vous-même :
2979
-
2980
- ```shell
2981
- git clone git://github.com/sinatra/sinatra.git
2982
- cd sinatra
2983
- rake sinatra.gemspec
2984
- rake install
2985
- ```
2986
-
2987
- Si vous installez les gems en tant que root, vous devez encore faire un :
2988
-
2989
- ```shell
2990
- sudo rake install
2991
- ```
2992
-
2993
3090
  ## Versions
2994
3091
 
2995
3092
  Sinatra se conforme aux [versions sémantiques](http://semver.org/), aussi bien