mirror of
https://github.com/sinatra/sinatra
synced 2023-03-27 23:18:01 -04:00
904 lines
37 KiB
Text
904 lines
37 KiB
Text
= 1.3.0 / Not Yet Released
|
|
|
|
* Added support for HTTP PATCH requests. (Konstantin Haase)
|
|
|
|
* Support for Creole templates, Creole is a standardized wiki markup,
|
|
supported by many wiki implementations. (Konstanin Haase)
|
|
|
|
* The `erubis` method has been deprecated. If Erubis is available, Sinatra
|
|
will automatically use it for rendering ERB templates. `require 'erb'`
|
|
explicitly to prevent that behavior. (Magnus Holm, Ryan Tomayko, Konstantin
|
|
Haase)
|
|
|
|
* Patterns now match against the escaped URLs rather than the unescaped
|
|
version. This makes Sinatra confirm with RFC 2396 section 2.2 and RFC 2616
|
|
section 3.2.3 (escaped reserved characters should not be treated like the
|
|
unescaped version), meaning that "/:name" will also match `/foo%2Fbar`, but
|
|
not `/foo/bar`. To avoid incompatibility, pattern matching has been adjusted.
|
|
Moreover, since we do no longer need to keep an unescaped version of
|
|
path_info around, we handle all changes to `env['PATH_INFO']` correctly.
|
|
(Konstantin Haase)
|
|
|
|
* `settings.app_file` now defaults to the file subclassing `Sinatra::Base` in
|
|
modular applications. (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)
|
|
|
|
* The sessions setting now may be an options hash. (Konstantin Haase)
|
|
|
|
* Important: 1.8.6 support has been dropped. This version also depends on at
|
|
least Rack 1.3.0. This means that it is incompatible to Rails prior to 3.1.0.
|
|
Please use 1.2.x if you require an earlier version for Ruby or Rack, which we
|
|
will continue to supply with bug fixes. (Konstantin Haase)
|
|
|
|
* It is now possible to use a different target class for the top level DSL (aka
|
|
classic style) than `Sinatra::Application` by setting `Delegator.target`.
|
|
This was mainly introduced to ease testing. (Konstantin Haase)
|
|
|
|
* Error handlers defined for an error class will now also handle subclasses of
|
|
that class, unless more specific error handlers exist. (Konstantin Haase)
|
|
|
|
* Error handling respects Exception#code, again. (Konstantin Haase)
|
|
|
|
* Changing a setting will merge hashes: `set(:x, :a => 1); set(:x :b => 2)`
|
|
will result in `{:a => 1, :b => 2}`. Use `set(:x, {:a => 1}, true)` to avoid
|
|
this behavior. (Konstantin Haase)
|
|
|
|
* Added `request.accept?` and `request.preferred_type` to ease dealing with
|
|
`Accept` headers. (Konstantin Haase)
|
|
|
|
* Uses SecureRandom to generate default session secret. (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)
|
|
|
|
* Middleware setup is now distributed across multiple methods, allowing Sinatra
|
|
extensions to easily hook into the setup process. (Konstantin Haase)
|
|
|
|
* Internal refactoring and minor performance improvements. (Konstantin Haase)
|
|
|
|
= 1.2.7 (backports release) / Not Yet Released
|
|
|
|
Custom changes:
|
|
|
|
* Fix Ruby 1.8.6 issue with Accept header parsing. (Konstantin Haase)
|
|
|
|
Backported from 1.3.0:
|
|
|
|
* `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)
|
|
|
|
= 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)
|
|
|
|
* 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
|
|
Haase)
|
|
|
|
* Fixed a bug where the wrong content type was used if no content type was set
|
|
and a template engine was used with a different engine for the layout with
|
|
different default content types, say Less embedded in Slim. (Konstantin
|
|
Haase)
|
|
|
|
* README translations improved (Gabriel Andretta, burningTyger, Sylvain Desvé,
|
|
Gregor Schmidt)
|
|
|
|
= 1.2.0 / 2011-03-03
|
|
|
|
* Added `slim` rendering method for rendering Slim templates. (Steve
|
|
Hodgkiss)
|
|
|
|
* The `markaby` rendering method now allows passing a block, making inline
|
|
usage possible. Requires Tilt 1.2 or newer. (Konstantin Haase)
|
|
|
|
* All render methods now take a `:layout_engine` option, allowing to use a
|
|
layout in a different template language. Even more useful than using this
|
|
directly (`erb :index, :layout_engine => :haml`) is setting this globally for
|
|
a template engine that otherwise does not support layouts, like Markdown or
|
|
Textile (`set :markdown, :layout_engine => :erb`). (Konstantin Haase)
|
|
|
|
* Before and after filters now support conditions, both with and without
|
|
patterns (`before '/api/*', :agent => /Songbird/`). (Konstantin Haase)
|
|
|
|
* Added a `url` helper method which constructs absolute URLs. Copes with
|
|
reverse proxies and Rack handlers correctly. Aliased to `to`, so you can
|
|
write `redirect to('/foo')`. (Konstantin Haase)
|
|
|
|
* If running on 1.9, patterns for routes and filters now support named
|
|
captures: `get(%r{/hi/(?<name>[^/?#]+)}) { "Hi #{params['name']}" }`.
|
|
(Steve Price)
|
|
|
|
* All rendering methods now take a `:scope` option, which renders them in
|
|
another context. Note that helpers and instance variables will be
|
|
unavailable if you use this feature. (Paul Walker)
|
|
|
|
* The behavior of `redirect` can now be configured with `absolute_redirects`
|
|
and `prefixed_redirects`. (Konstantin Haase)
|
|
|
|
* `send_file` now allows overriding the Last-Modified header, which defaults
|
|
to the file's mtime, by passing a `:last_modified` option. (Konstantin Haase)
|
|
|
|
* You can use your own template lookup method by defining `find_template`.
|
|
This allows, among other things, using more than one views folder.
|
|
(Konstantin Haase)
|
|
|
|
* Largely improved documentation. (burningTyger, Vasily Polovnyov, Gabriel
|
|
Andretta, Konstantin Haase)
|
|
|
|
* Improved error handling. (cactus, Konstantin Haase)
|
|
|
|
* Skip missing template engines in tests correctly. (cactus)
|
|
|
|
* 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.
|
|
(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
|
|
|
|
* README has been translated to Russian (Nickolay Schwarz, Vasily Polovnyov)
|
|
and Portuguese (Luciano Sousa).
|
|
|
|
* Nested templates without a `:layout` option can now be used from the layout
|
|
template without causing an infinite loop. (Konstantin Haase)
|
|
|
|
* Inline templates are now encoding aware and can therefore be used with
|
|
unicode characters on Ruby 1.9. Magic comments at the beginning of the file
|
|
will be honored. (Konstantin Haase)
|
|
|
|
* Default `app_file` is set correctly when running with bundler. Using
|
|
bundler caused Sinatra not to find the `app_file` and therefore not to find
|
|
the `views` folder on it's own. (Konstantin Haase)
|
|
|
|
* Better handling of Content-Type when using `send_file`: If file extension
|
|
is unknown, fall back to `application/octet-stream` and do not override
|
|
content type if it has already been set, except if `:type` is passed
|
|
explicitly (Konstantin Haase)
|
|
|
|
* Path is no longer cached if changed between handlers that do pattern
|
|
matching. This means you can change `request.path_info` in a pattern
|
|
matching before filter. (Konstantin Haase)
|
|
|
|
* 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
|
|
ability to use captures: "before('/user/:name') { |name| ... }". This
|
|
avoids manual path checking. No performance loss if patterns are avoided.
|
|
(Konstantin Haase)
|
|
|
|
* It is now possible to render SCSS files with the `scss` method, which
|
|
behaves exactly like `sass` except for the different file extension and
|
|
assuming the SCSS syntax. (Pedro Menezes, Konstantin Haase)
|
|
|
|
* Added `liquid`, `markdown`, `nokogiri`, `textile`, `rdoc`, `radius`,
|
|
`markaby`, and `coffee` rendering methods for rendering Liquid, Markdown,
|
|
Nokogiri, Textile, RDoc, Radius, Markaby and CoffeeScript templates.
|
|
(Konstantin Haase)
|
|
|
|
* Now supports byte-range requests (the HTTP_RANGE header) for static files.
|
|
Multi-range requests are not supported, however. (Jens Alfke)
|
|
|
|
* You can now use #settings method from class and top level for convenience.
|
|
(Konstantin Haase)
|
|
|
|
* Setting multiple values now no longer relies on #to_hash and therefore
|
|
accepts any Enumerable as parameter. (Simon Rozet)
|
|
|
|
* Nested templates default the `layout` option to `false` rather than `true`.
|
|
This eases the use of partials. If you wanted to render one haml template
|
|
embedded in another, you had to call `haml :partial, {}, :layout => false`.
|
|
As you almost never want the partial to be wrapped in the standard layout
|
|
in this situation, you now only have to call `haml :partial`. Passing in
|
|
`layout` explicitly is still possible. (Konstantin Haase)
|
|
|
|
* If a the return value of one of the render functions is used as a response
|
|
body and the content type has not been set explicitly, Sinatra chooses a
|
|
content type corresponding to the rendering engine rather than just using
|
|
"text/html". (Konstantin Haase)
|
|
|
|
* README is now available in Chinese (Wu Jiang), French (Mickael Riga),
|
|
German (Bernhard Essl, Konstantin Haase, burningTyger), Hungarian (Janos
|
|
Hardi) and Spanish (Gabriel Andretta). The extremely outdated Japanese
|
|
README has been updated (Kouhei Yanagita).
|
|
|
|
* It is now possible to access Sinatra's template_cache from the outside.
|
|
(Nick Sutterer)
|
|
|
|
* The `last_modified` method now also accepts DateTime instances and makes
|
|
sure the header will always be set to a string. (Konstantin Haase)
|
|
|
|
* 599 now is a legal status code. (Steve Shreeve)
|
|
|
|
* This release is compatible with Ruby 1.9.2. Sinatra was trying to read
|
|
non existent files Ruby added to the call stack. (Shota Fukumori,
|
|
Konstantin Haase)
|
|
|
|
* Prevents a memory leak on 1.8.6 in production mode. Note, however, that
|
|
this is due to a bug in 1.8.6 and request will have the additional overhead
|
|
of parsing templates again on that version. It is recommended to use at
|
|
least Ruby 1.8.7. (Konstantin Haase)
|
|
|
|
* Compares last modified date correctly. `last_modified` was halting only
|
|
when the 'If-Modified-Since' header date was equal to the time specified.
|
|
Now, it halts when is equal or later than the time specified (Gabriel
|
|
Andretta).
|
|
|
|
* Sinatra is now usable in combination with Rails 3. When mounting a Sinatra
|
|
application under a subpath in Rails 3, the PATH_INFO is not prefixed with
|
|
a slash and no routes did match. (José Valim)
|
|
|
|
* Better handling of encodings in 1.9, defaults params encoding to UTF-8.
|
|
(Konstantin Haase)
|
|
|
|
* `show_exeptions` handling is now triggered after custom error handlers, if
|
|
it is set to `:after_handlers`, thus not disabling those handler in
|
|
development mode. (pangel, Konstantin Haase)
|
|
|
|
* Added ability to handle weighted HTTP_ACCEPT headers. (Davide D'Agostino)
|
|
|
|
* `send_file` now always respects the `:type` option if set. Previously it
|
|
was discarded if no matching mime type was found, which made it impossible
|
|
to directly pass a mime type. (Konstantin Haase)
|
|
|
|
* `redirect` always redirects to an absolute URI, even if a relative URI was
|
|
passed. Ensures compatibility with RFC 2616 section 14.30. (Jean-Philippe
|
|
Garcia Ballester, Anthony Williams)
|
|
|
|
* Broken examples for using Erubis, Haml and Test::Unit in README have been
|
|
fixed. (Nick Sutterer, Doug Ireton, Jason Stewart, Eric Marden)
|
|
|
|
* Sinatra now handles SIGTERM correctly. (Patrick Collison)
|
|
|
|
* Fixes an issue with inline templates in modular applications that manually
|
|
call `run!`. (Konstantin Haase)
|
|
|
|
* Spaces after inline template names are now ignored (Konstantin Haase)
|
|
|
|
* It's now possible to use Sinatra with different package management
|
|
systems defining a custom require. (Konstantin Haase)
|
|
|
|
* Lighthouse has been dropped in favor of GitHub issues.
|
|
|
|
* Tilt is now a dependency and therefore no longer ships bundled with
|
|
Sinatra. (Ryan Tomayko, Konstantin Haase)
|
|
|
|
* Sinatra now depends on Rack 1.1 or higher. Rack 1.0 is no longer supported.
|
|
(Konstantin Haase)
|
|
|
|
= 1.0 / 2010-03-23
|
|
|
|
* It's now possible to register blocks to run after each request using
|
|
after filters. After filters run at the end of each request, after
|
|
routes and error handlers. (Jimmy Schementi)
|
|
|
|
* Sinatra now uses Tilt <http://github.com/rtomayko/tilt> for rendering
|
|
templates. This adds support for template caching, consistent
|
|
template backtraces, and support for new template engines, like
|
|
mustache and liquid. (Ryan Tomayko)
|
|
|
|
* ERB, Erubis, and Haml templates are now compiled the first time
|
|
they're rendered instead of being string eval'd on each invocation.
|
|
Benchmarks show a 5x-10x improvement in render time. This also
|
|
reduces the number of objects created, decreasing pressure on Ruby's
|
|
GC. (Ryan Tomayko)
|
|
|
|
* New 'settings' method gives access to options in both class and request
|
|
scopes. This replaces the 'options' method. (Chris Wanstrath)
|
|
|
|
* New boolean 'reload_templates' setting controls whether template files
|
|
are reread from disk and recompiled on each request. Template read/compile
|
|
is cached by default in all environments except development. (Ryan Tomayko)
|
|
|
|
* New 'erubis' helper method for rendering ERB template with Erubis. The
|
|
erubis gem is required. (Dylan Egan)
|
|
|
|
* New 'cache_control' helper method provides a convenient way of
|
|
setting the Cache-Control response header. Takes a variable number
|
|
of boolean directives followed by a hash of value directives, like
|
|
this: cache_control :public, :must_revalidate, :max_age => 60
|
|
(Ryan Tomayko)
|
|
|
|
* New 'expires' helper method is like cache_control but takes an
|
|
integer number of seconds or Time object:
|
|
expires 300, :public, :must_revalidate
|
|
(Ryan Tomayko)
|
|
|
|
* New request.secure? method for checking for an SSL connection.
|
|
(Adam Wiggins)
|
|
|
|
* Sinatra apps can now be run with a `-o <addr>` argument to specify
|
|
the address to bind to. (Ryan Tomayko)
|
|
|
|
* Rack::Session::Cookie is now added to the middleware pipeline when
|
|
running in test environments if the :sessions option is set.
|
|
(Simon Rozet)
|
|
|
|
* Route handlers, before filters, templates, error mappings, and
|
|
middleware are now resolved dynamically up the inheritance hierarchy
|
|
when needed instead of duplicating the superclass's version when
|
|
a new Sinatra::Base subclass is created. This should fix a variety
|
|
of issues with extensions that need to add any of these things
|
|
to the base class. (Ryan Tomayko)
|
|
|
|
* Exception error handlers always override the raise_errors option now.
|
|
Previously, all exceptions would be raised outside of the application
|
|
when the raise_errors option was enabled, even if an error handler was
|
|
defined for that exception. The raise_errors option now controls
|
|
whether unhandled exceptions are raised (enabled) or if a generic 500
|
|
error is returned (disabled). (Ryan Tomayko)
|
|
|
|
* The X-Cascade response header is set to 'pass' when no matching route
|
|
is found or all routes pass. (Josh Peek)
|
|
|
|
* Filters do not run when serving static files anymore. (Ryan Tomayko)
|
|
|
|
* pass takes an optional block to be used as the route handler if no
|
|
subsequent route matches the request. (Blake Mizerany)
|
|
|
|
The following Sinatra features have been obsoleted (removed entirely) in
|
|
the 1.0 release:
|
|
|
|
* The `sinatra/test` library is obsolete. This includes the `Sinatra::Test`
|
|
module, the `Sinatra::TestHarness` class, and the `get_it`, `post_it`,
|
|
`put_it`, `delete_it`, and `head_it` helper methods. The
|
|
[`Rack::Test` library](http://gitrdoc.com/brynary/rack-test) should
|
|
be used instead.
|
|
|
|
* Test framework specific libraries (`sinatra/test/spec`,
|
|
`sinatra/test/bacon`,`sinatra/test/rspec`, etc.) are obsolete. See
|
|
http://www.sinatrarb.com/testing.html for instructions on setting up a
|
|
testing environment under each of these frameworks.
|
|
|
|
* `Sinatra::Default` is obsolete; use `Sinatra::Base` instead.
|
|
`Sinatra::Base` acts more like `Sinatra::Default` in development mode.
|
|
For example, static file serving and sexy development error pages are
|
|
enabled by default.
|
|
|
|
* Auto-requiring template libraries in the `erb`, `builder`, `haml`,
|
|
and `sass` methods is obsolete due to thread-safety issues. You must
|
|
require the template libraries explicitly in your app.
|
|
|
|
* The `:views_directory` option to rendering methods is obsolete; use
|
|
`:views` instead.
|
|
|
|
* The `:haml` and `:sass` options to rendering methods are obsolete.
|
|
Template engine options should be passed in the second Hash argument
|
|
instead.
|
|
|
|
* The `use_in_file_templates` method is obsolete. Use
|
|
`enable :inline_templates` or `set :inline_templates, 'path/to/file'`
|
|
|
|
* The 'media_type' helper method is obsolete. Use 'mime_type' instead.
|
|
|
|
* The 'mime' main and class method is obsolete. Use 'mime_type' instead.
|
|
|
|
* The request-level `send_data` method is no longer supported.
|
|
|
|
* The `Sinatra::Event` and `Sinatra::EventContext` classes are no longer
|
|
supported. This may effect extensions written for versions prior to 0.9.2.
|
|
See [Writing Sinatra Extensions](http://www.sinatrarb.com/extensions.html)
|
|
for the officially supported extensions API.
|
|
|
|
* The `set_option` and `set_options` methods are obsolete; use `set`
|
|
instead.
|
|
|
|
* The `:env` setting (`settings.env`) is obsolete; use `:environment`
|
|
instead.
|
|
|
|
* The request level `stop` method is obsolete; use `halt` instead.
|
|
|
|
* The request level `entity_tag` method is obsolete; use `etag`
|
|
instead.
|
|
|
|
* The request level `headers` method (HTTP response headers) is obsolete;
|
|
use `response['Header-Name']` instead.
|
|
|
|
* `Sinatra.application` is obsolete; use `Sinatra::Application` instead.
|
|
|
|
* Using `Sinatra.application = nil` to reset an application is obsolete.
|
|
This should no longer be necessary.
|
|
|
|
* Using `Sinatra.default_options` to set base configuration items is
|
|
obsolete; use `Sinatra::Base.set(key, value)` instead.
|
|
|
|
* The `Sinatra::ServerError` exception is obsolete. All exceptions raised
|
|
within a request are now treated as internal server errors and result in
|
|
a 500 response status.
|
|
|
|
* The `:methodoverride' option to enable/disable the POST _method hack is
|
|
obsolete; use `:method_override` instead.
|
|
|
|
= 0.9.2 / 2009-05-18
|
|
|
|
* This version is compatible with Rack 1.0. [Rein Henrichs]
|
|
|
|
* The development-mode unhandled exception / error page has been
|
|
greatly enhanced, functionally and aesthetically. The error
|
|
page is used when the :show_exceptions option is enabled and an
|
|
exception propagates outside of a route handler or before filter.
|
|
[Simon Rozet / Matte Noble / Ryan Tomayko]
|
|
|
|
* Backtraces that move through templates now include filenames and
|
|
line numbers where possible. [#51 / S. Brent Faulkner]
|
|
|
|
* All templates now have an app-level option for setting default
|
|
template options (:haml, :sass, :erb, :builder). The app-level
|
|
option value must be a Hash if set and is merged with the
|
|
template options specified to the render method (Base#haml,
|
|
Base#erb, Base#builder). [S. Brent Faulkner, Ryan Tomayko]
|
|
|
|
* The method signature for all template rendering methods has
|
|
been unified: "def engine(template, options={}, locals={})".
|
|
The options Hash now takes the generic :views, :layout, and
|
|
:locals options but also any template-specific options. The
|
|
generic options are removed before calling the template specific
|
|
render method. Locals may be specified using either the
|
|
:locals key in the options hash or a second Hash option to the
|
|
rendering method. [#191 / Ryan Tomayko]
|
|
|
|
* The receiver is now passed to "configure" blocks. This
|
|
allows for the following idiom in top-level apps:
|
|
configure { |app| set :foo, app.root + '/foo' }
|
|
[TJ Holowaychuck / Ryan Tomayko]
|
|
|
|
* The "sinatra/test" lib is deprecated and will be removed in
|
|
Sinatra 1.0. This includes the Sinatra::Test module and
|
|
Sinatra::TestHarness class in addition to all the framework
|
|
test helpers that were deprecated in 0.9.1. The Rack::Test
|
|
lib should be used instead: http://gitrdoc.com/brynary/rack-test
|
|
[#176 / Simon Rozet]
|
|
|
|
* Development mode source file reloading has been removed. The
|
|
"shotgun" (http://rtomayko.github.com/shotgun/) program can be
|
|
used to achieve the same basic functionality in most situations.
|
|
Passenger users should use the "tmp/always_restart.txt"
|
|
file (http://tinyurl.com/c67o4h). [#166 / Ryan Tomayko]
|
|
|
|
* Auto-requiring template libs in the erb, builder, haml, and
|
|
sass methods is deprecated due to thread-safety issues. You must
|
|
require the template libs explicitly in your app file. [Simon Rozet]
|
|
|
|
* A new Sinatra::Base#route_missing method was added. route_missing
|
|
is sent when no route matches the request or all route handlers
|
|
pass. The default implementation forwards the request to the
|
|
downstream app when running as middleware (i.e., "@app" is
|
|
non-nil), or raises a NotFound exception when no downstream app
|
|
is defined. Subclasses can override this method to perform custom
|
|
route miss logic. [Jon Crosby]
|
|
|
|
* A new Sinatra::Base#route_eval method was added. The method
|
|
yields to the block and throws :halt with the result. Subclasses
|
|
can override this method to tap into the route execution logic.
|
|
[TJ Holowaychuck]
|
|
|
|
* Fix the "-x" (enable request mutex / locking) command line
|
|
argument. Passing -x now properly sets the :lock option.
|
|
[S. Brent Faulkner, Ryan Tomayko]
|
|
|
|
* Fix writer ("foo=") and predicate ("foo?") methods in extension
|
|
modules not being added to the registering class.
|
|
[#172 / Pat Nakajima]
|
|
|
|
* Fix in-file templates when running alongside activesupport and
|
|
fatal errors when requiring activesupport before sinatra
|
|
[#178 / Brian Candler]
|
|
|
|
* Fix various issues running on Google AppEngine.
|
|
[Samuel Goebert, Simon Rozet]
|
|
|
|
* Fix in-file templates __END__ detection when __END__ exists with
|
|
other stuff on a line [Yoji Shidara]
|
|
|
|
= 0.9.1.1 / 2009-03-09
|
|
|
|
* Fix directory traversal vulnerability in default static files
|
|
route. See [#177] for more info.
|
|
|
|
= 0.9.1 / 2009-03-01
|
|
|
|
* Sinatra now runs under Ruby 1.9.1 [#61]
|
|
|
|
* Route patterns (splats, :named, or Regexp captures) are now
|
|
passed as arguments to the block. [#140]
|
|
|
|
* The "helpers" method now takes a variable number of modules
|
|
along with the normal block syntax. [#133]
|
|
|
|
* New request-level #forward method for middleware components: passes
|
|
the env to the downstream app and merges the response status, headers,
|
|
and body into the current context. [#126]
|
|
|
|
* Requests are now automatically forwarded to the downstream app when
|
|
running as middleware and no matching route is found or all routes
|
|
pass.
|
|
|
|
* New simple API for extensions/plugins to add DSL-level and
|
|
request-level methods. Use Sinatra.register(mixin) to extend
|
|
the DSL with all public methods defined in the mixin module;
|
|
use Sinatra.helpers(mixin) to make all public methods defined
|
|
in the mixin module available at the request level. [#138]
|
|
See http://www.sinatrarb.com/extensions.html for details.
|
|
|
|
* Named parameters in routes now capture the "." character. This makes
|
|
routes like "/:path/:filename" match against requests like
|
|
"/foo/bar.txt"; in this case, "params[:filename]" is "bar.txt".
|
|
Previously, the route would not match at all.
|
|
|
|
* Added request-level "redirect back" to redirect to the referring
|
|
URL.
|
|
|
|
* Added a new "clean_trace" option that causes backtraces dumped
|
|
to rack.errors and displayed on the development error page to
|
|
omit framework and core library backtrace lines. The option is
|
|
enabled by default. [#77]
|
|
|
|
* The ERB output buffer is now available to helpers via the @_out_buf
|
|
instance variable.
|
|
|
|
* It's now much easier to test sessions in unit tests by passing a
|
|
":session" option to any of the mock request methods. e.g.,
|
|
get '/', {}, :session => { 'foo' => 'bar' }
|
|
|
|
* The testing framework specific files ('sinatra/test/spec',
|
|
'sinatra/test/bacon', 'sinatra/test/rspec', etc.) have been deprecated.
|
|
See http://sinatrarb.com/testing.html for instructions on setting up
|
|
a testing environment with these frameworks.
|
|
|
|
* The request-level #send_data method from Sinatra 0.3.3 has been added
|
|
for compatibility but is deprecated.
|
|
|
|
* Fix :provides causing crash on any request when request has no
|
|
Accept header [#139]
|
|
|
|
* Fix that ERB templates were evaluated twice per "erb" call.
|
|
|
|
* Fix app-level middleware not being run when the Sinatra application is
|
|
run as middleware.
|
|
|
|
* Fixed some issues with running under Rack's CGI handler caused by
|
|
writing informational stuff to stdout.
|
|
|
|
* Fixed that reloading was sometimes enabled when starting from a
|
|
rackup file [#110]
|
|
|
|
* Fixed that "." in route patterns erroneously matched any character
|
|
instead of a literal ".". [#124]
|
|
|
|
= 0.9.0.4 / 2009-01-25
|
|
|
|
* Using halt with more than 1 args causes ArgumentError [#131]
|
|
* using halt in a before filter doesn't modify response [#127]
|
|
* Add deprecated Sinatra::EventContext to unbreak plugins [#130]
|
|
* Give access to GET/POST params in filters [#129]
|
|
* Preserve non-nested params in nested params hash [#117]
|
|
* Fix backtrace dump with Rack::Lint [#116]
|
|
|
|
= 0.9.0.3 / 2009-01-21
|
|
|
|
* Fall back on mongrel then webrick when thin not found. [#75]
|
|
* Use :environment instead of :env in test helpers to
|
|
fix deprecation warnings coming from framework.
|
|
* Make sinatra/test/rspec work again [#113]
|
|
* Fix app_file detection on windows [#118]
|
|
* Fix static files with Rack::Lint in pipeline [#121]
|
|
|
|
= 0.9.0.2 / 2009-01-18
|
|
|
|
* Halting a before block should stop processing of routes [#85]
|
|
* Fix redirect/halt in before filters [#85]
|
|
|
|
= 0.9.0 / 2009-01-18
|
|
|
|
* Works with and requires Rack >= 0.9.1
|
|
|
|
* Multiple Sinatra applications can now co-exist peacefully within a
|
|
single process. The new "Sinatra::Base" class can be subclassed to
|
|
establish a blank-slate Rack application or middleware component.
|
|
Documentation on using these features is forth-coming; the following
|
|
provides the basic gist: http://gist.github.com/38605
|
|
|
|
* Parameters with subscripts are now parsed into a nested/recursive
|
|
Hash structure. e.g., "post[title]=Hello&post[body]=World" yields
|
|
params: {'post' => {'title' => 'Hello', 'body' => 'World'}}.
|
|
|
|
* Regular expressions may now be used in route pattens; captures are
|
|
available at "params[:captures]".
|
|
|
|
* New ":provides" route condition takes an array of mime types and
|
|
matches only when an Accept request header is present with a
|
|
corresponding type. [cypher]
|
|
|
|
* New request-level "pass" method; immediately exits the current block
|
|
and passes control to the next matching route.
|
|
|
|
* The request-level "body" method now takes a block; evaluation is
|
|
deferred until an attempt is made to read the body. The block must
|
|
return a String or Array.
|
|
|
|
* New "route conditions" system for attaching rules for when a route
|
|
matches. The :agent and :host route options now use this system.
|
|
|
|
* New "dump_errors" option controls whether the backtrace is dumped to
|
|
rack.errors when an exception is raised from a route. The option is
|
|
enabled by default for top-level apps.
|
|
|
|
* Better default "app_file", "root", "public", and "views" location
|
|
detection; changes to "root" and "app_file" automatically cascade to
|
|
other options that depend on them.
|
|
|
|
* Error mappings are now split into two distinct layers: exception
|
|
mappings and custom error pages. Exception mappings are registered
|
|
with "error(Exception)" and are run only when the app raises an
|
|
exception. Custom error pages are registered with "error(status_code)",
|
|
where "status_code" is an integer, and are run any time the response
|
|
has the status code specified. It's also possible to register an error
|
|
page for a range of status codes: "error(500..599)".
|
|
|
|
* In-file templates are now automatically imported from the file that
|
|
requires 'sinatra'. The use_in_file_templates! method is still available
|
|
for loading templates from other files.
|
|
|
|
* Sinatra's testing support is no longer dependent on Test::Unit. Requiring
|
|
'sinatra/test' adds the Sinatra::Test module and Sinatra::TestHarness
|
|
class, which can be used with any test framework. The 'sinatra/test/unit',
|
|
'sinatra/test/spec', 'sinatra/test/rspec', or 'sinatra/test/bacon' files
|
|
can be required to setup a framework-specific testing environment. See the
|
|
README for more information.
|
|
|
|
* Added support for Bacon (test framework). The 'sinatra/test/bacon' file
|
|
can be required to setup Sinatra test helpers on Bacon::Context.
|
|
|
|
* Deprecated "set_option" and "set_options"; use "set" instead.
|
|
|
|
* Deprecated the "env" option ("options.env"); use "environment" instead.
|
|
|
|
* Deprecated the request level "stop" method; use "halt" instead.
|
|
|
|
* Deprecated the request level "entity_tag" method; use "etag" instead.
|
|
Both "entity_tag" and "etag" were previously supported.
|
|
|
|
* Deprecated the request level "headers" method (HTTP response headers);
|
|
use "response['Header-Name']" instead.
|
|
|
|
* Deprecated "Sinatra.application"; use "Sinatra::Application" instead.
|
|
|
|
* Deprecated setting Sinatra.application = nil to reset an application.
|
|
This should no longer be necessary.
|
|
|
|
* Deprecated "Sinatra.default_options"; use
|
|
"Sinatra::Default.set(key, value)" instead.
|
|
|
|
* Deprecated the "ServerError" exception. All Exceptions are now
|
|
treated as internal server errors and result in a 500 response
|
|
status.
|
|
|
|
* Deprecated the "get_it", "post_it", "put_it", "delete_it", and "head_it"
|
|
test helper methods. Use "get", "post", "put", "delete", and "head",
|
|
respectively, instead.
|
|
|
|
* Removed Event and EventContext classes. Applications are defined in a
|
|
subclass of Sinatra::Base; each request is processed within an
|
|
instance.
|
|
|
|
= 0.3.3 / 2009-01-06
|
|
|
|
* Pin to Rack 0.4.0 (this is the last release on Rack 0.4)
|
|
|
|
* Log unhandled exception backtraces to rack.errors.
|
|
|
|
* Use RACK_ENV environment variable to establish Sinatra
|
|
environment when given. Thin sets this when started with
|
|
the -e argument.
|
|
|
|
* BUG: raising Sinatra::NotFound resulted in a 500 response
|
|
code instead of 404.
|
|
|
|
* BUG: use_in_file_templates! fails with CR/LF (#45)
|
|
|
|
* BUG: Sinatra detects the app file and root path when run under
|
|
thin/passenger.
|
|
|
|
= 0.3.2
|
|
|
|
* BUG: Static and send_file read entire file into String before
|
|
sending. Updated to stream with 8K chunks instead.
|
|
|
|
* Rake tasks and assets for building basic documentation website.
|
|
See http://sinatra.rubyforge.org
|
|
|
|
* Various minor doc fixes.
|
|
|
|
= 0.3.1
|
|
|
|
* Unbreak optional path parameters [jeremyevans]
|
|
|
|
= 0.3.0
|
|
|
|
* Add sinatra.gemspec w/ support for github gem builds. Forks can now
|
|
enable the build gem option in github to get free username-sinatra.gem
|
|
builds: gem install username-sinatra.gem --source=http://gems.github.com/
|
|
|
|
* Require rack-0.4 gem; removes frozen rack dir.
|
|
|
|
* Basic RSpec support; require 'sinatra/test/rspec' instead of
|
|
'sinatra/test/spec' to use. [avdi]
|
|
|
|
* before filters can modify request environment vars used for
|
|
routing (e.g., PATH_INFO, REQUEST_METHOD, etc.) for URL rewriting
|
|
type functionality.
|
|
|
|
* In-file templates now uses @@ instead of ## as template separator.
|
|
|
|
* Top-level environment test predicates: development?, test?, production?
|
|
|
|
* Top-level "set", "enable", and "disable" methods for tweaking
|
|
app options. [rtomayko]
|
|
|
|
* Top-level "use" method for building Rack middleware pipelines
|
|
leading to app. See README for usage. [rtomayko]
|
|
|
|
* New "reload" option - set false to disable reloading in development.
|
|
|
|
* New "host" option - host/ip to bind to [cschneid]
|
|
|
|
* New "app_file" option - override the file to reload in development
|
|
mode [cschneid]
|
|
|
|
* Development error/not_found page cleanup [sr, adamwiggins]
|
|
|
|
* Remove a bunch of core extensions (String#to_param, String#from_param,
|
|
Hash#from_params, Hash#to_params, Hash#symbolize_keys, Hash#pass)
|
|
|
|
* Various grammar and formatting fixes to README; additions on
|
|
community and contributing [cypher]
|
|
|
|
* Build RDoc using Hanna template: http://sinatrarb.rubyforge.org/api
|
|
|
|
* Specs, documentation and fixes for splat'n routes [vic]
|
|
|
|
* Fix whitespace errors across all source files. [rtomayko]
|
|
|
|
* Fix streaming issues with Mongrel (body not closed). [bmizerany]
|
|
|
|
* Fix various issues with environment not being set properly (configure
|
|
blocks not running, error pages not registering, etc.) [cypher]
|
|
|
|
* Fix to allow locals to be passed to ERB templates [cschneid]
|
|
|
|
* Fix locking issues causing random errors during reload in development.
|
|
|
|
* Fix for escaped paths not resolving static files [Matthew Walker]
|
|
|
|
= 0.2.1
|
|
|
|
* File upload fix and minor tweaks.
|
|
|
|
= 0.2.0
|
|
|
|
* Initial gem release of 0.2 codebase.
|