sinatra 1.1.2 → 1.1.3

data/README.ru.rdoc

@@ -90,7 +90,7 @@ Sinatra — это предметно-ориентированный язык (D
   end
 
   get '/foo' do
-    # соответствует с non-songbird браузерам
+    # соответствует non-songbird браузерам
   end
 
 Другими доступными условиями являются +host_name+ и +provides+:
@@ -122,7 +122,7 @@ Sinatra — это предметно-ориентированный язык (D
 === Возвращаемые значения
 
 Возвращаемое значение блока маршрута ограничивается телом ответа, которое будет передано HTTP клиенту,
-или следующей подпрограммой (middleware) в Rack стеке. Чаще всего это строка, как в вышеизложенных примерах.
+или следующей "прослойкой" (middleware, промежуточная программа) в Rack стеке. Чаще всего это строка, как в вышеизложенных примерах.
 Но и другие значения также приемлемы.
 
 Вы можете вернуть любой объект, который будет либо корректным Rack ответом, Rack
@@ -334,16 +334,31 @@ rdiscount gem/библиотека необходима для рендерин
 Отрисует <tt>./views/index.markdown</tt> (+md+ и +mkd+ также являются допустимыми файловыми
 расширениями).
 
-В markdown невозможно вызывать методы или передавать локальные переменные. Следовательно, вам скорее всего придется 
-использовать этот шаблон совместно с другим движком рендеринга:
+В Markdown невозможно вызывать методы или передавать локальные переменные.
+Следовательно, вам скорее всего придется использовать этот шаблон совместно с другим
+движком рендеринга:
 
   erb :overview, :locals => { :text => markdown(:introduction) }
 
-Заметьте, что вы можете вызывать метод markdown из других шаблонов:
+Заметьте, что вы можете вызывать метод +markdown+ из других шаблонов:
 
   %h1 Hello From Haml!
   %p= markdown(:greetings)
 
+Также возможно обрабатывать Markdown с помощью BlueCloth, а не RDiscount:
+
+  require 'bluecloth'
+
+  Tilt.register 'markdown', BlueClothTemplate
+  Tilt.register 'mkd',      BlueClothTemplate
+  Tilt.register 'md',       BlueClothTemplate
+
+  get '/' do
+    markdown :index
+  end
+
+Отрисует <tt>./views/index.md</tt> с помощью BlueCloth.
+
 === Textile шаблоны
 
 RedCloth gem/библиотека необходима для рендеринга Textile шаблонов:
@@ -434,13 +449,13 @@ coffee-script gem/библиотека и `coffee` бинарный файл н
 
 Отрисует <tt>./views/application.coffee</tt>.
 
-=== Внутристроковые шаблоны
+=== Встроенные шаблоны
 
   get '/' do
     haml '%div.title Hello World'
   end
 
-Отрисует внутристроковый шаблон.
+Отрисует встроенный (строчный) шаблон.
 
 === Доступ к переменным в шаблонах
 
@@ -501,7 +516,8 @@ coffee-script gem/библиотека и `coffee` бинарный файл н
   end
 
 Если шаблон с именем "layout" существует, то он будет использован каждый раз,
-когда шаблоны будут отрисовываться. Вы можете отключить layout-шаблон с помощью <tt>:layout => false</tt>.
+когда шаблоны будут отрисовываться. Вы можете отключать layout-шаблон в каждом конкретном случае с помощью
+<tt>:layout => false</tt> или отключить его для всего приложения, например, так: <tt>set :haml, :layout => false</tt>.
 
   get '/' do
     haml :index, :layout => !request.xhr?
@@ -729,15 +745,15 @@ Sinatra устанавливает специальные <tt>not_found</tt> и
 
   content_type :foo
 
-== Rack подпрограммы
+== Rack "прослойки"
 
 Sinatra использует Rack[http://rack.rubyforge.org/], минимальный стандартный 
 интерфейс для веб-фреймворков на Ruby. Одной из самых интересных для разработчиков возможностей Rack
-является поддержка подпрограмм ("middleware") -- компонентов,
+является поддержка "прослоек" ("middleware") — компонентов,
 "сидящих" между сервером и вашим приложением, которые отслеживают и/или манипулируют
 HTTP запросами/ответами для предоставления различной функциональности.
 
-В Sinatra очень просто использовать такие Rack подпрограммы с помощью метода +use+:
+В Sinatra очень просто использовать такие "прослойки" с помощью метода +use+:
 
   require 'sinatra'
   require 'my_custom_middleware'
@@ -758,7 +774,7 @@ Rack::Builder[http://rack.rubyforge.org/doc/classes/Rack/Builder.html] DSL
     username == 'admin' && password == 'secret'
   end
 
-Rack распространяется с различными стандартными подпрограммами
+Rack распространяется с различными стандартными "прослойками"
 для логирования, отладки, маршрутизации URL, аутентификации, обработки сессий. Sinatra использует
 многие из этих компонентов автоматически, основываясь на конфигурации, чтобы вам не приходилось
 регистрировать/использовать (+use+) их вручную.
@@ -798,13 +814,12 @@ Rack распространяется с различными стандартн
 Заметьте: Встроенные модули Sinatra::Test и Sinatra::TestHarness являются
 устаревшими, начиная с 0.9.2 релиза.
 
-== Sinatra::Base - Подпрограммы, библиотеки и модульные приложения
+== Sinatra::Base — "прослойки", библиотеки и модульные приложения
 
 Описание своего приложения самым простейшим способом (с помощью DSL верхнего уровня, как в примерах выше)
-работает отлично для крохотных приложений, но имеет множество недостатков, когда надо
-создать компоненты, такие как Rack
-middleware, Rails metal, простые библиотеки с серверными компонентами,
-Sinatra расширения.
+работает отлично для крохотных приложений, но имеет множество недостатков, когда надо создать компоненты, такие как
+Rack middleware ("прослойки"), Rails metal, простые библиотеки с серверными компонентами,
+расширения Sinatra.
 DSL верхнего уровня загрязняет пространство имен <tt>Object</tt> и подразумевает стиль конфигурации
 микро-приложения (например, единый файл приложения, ./public и
 ./views директории, создание логов, страницу деталей об исключениях 
@@ -821,13 +836,6 @@ DSL верхнего уровня загрязняет пространство
     end
   end
 
-MyApp класс является независимым Rack компонентом, который может исполнять роли
-Rack подпрограммы, Rack приложения, Rails metal. Вы можете +use+ (использовать) или
-+run+ (запустить) этот класс из rackup файла +config.ru+; или контролировать серверную
-часть из библиотеки:
-
-   MyApp.run! :host => 'localhost', :port => 9090
-
 Методы, доступные Sinatra::Base сабклассам идентичны тем, что доступны
 в DSL верхнего уровня. Большинство приложений верхнего уровня могут быть
 конвертированы в Sinatra::Base компоненты с помощью двух модификаций:
@@ -840,10 +848,68 @@ Rack подпрограммы, Rack приложения, Rails metal. Вы мо
 Смотрите {Опции и Конфигурация}[http://www.sinatrarb.com/configuration.html] для детальной информации
 об опциях и их поведении.
 
-=== Использование Sinatra как подпрограммы
+=== Запуск модульных приложений
+
+Есть два общепринятых способа запускать модульные приложения: запуск напрямую с помощью <tt>run!</tt>:
+
+  # my_app.rb
+  require 'sinatra/base'
+
+  class MyApp < Sinatra::Base
+    # ... здесь код приложения ...
+
+    # запускаем сервер, если исполняется текущий файл
+    run! if app_file == $0
+  end
+
+И запускаем с помощью:
+
+  ruby my_app.rb
+
+Или с помощью конфигурационного файла <tt>config.ru</tt>, который позволяет использовать любой
+Rack-совместимый сервер приложений.
+
+  # config.ru
+  require 'my_app'
+  run MyApp
+
+Запускаем:
+
+  rackup -p 4567
+
+=== Запуск "классических" приложений с config.ru
+
+Файл приложения:
+
+  # app.rb
+  require 'sinatra'
+
+  get '/' do
+    'Hello world!'
+  end
+
+И соответствующий <tt>config.ru</tt>:
+
+  require 'app'
+  run Sinatra::Application
+
+=== Когда использовать config.ru?
+
+Вот несколько причин, по которым вы, возможно, захотите использовать <tt>config.ru</tt>:
+
+* вы хотите разворачивать свое приложение на различных Rack-совместимых серверах (Passenger, Unicorn,
+  Heroku, ...).
+* вы хотите использовать более одного сабкласса <tt>Sinatra::Base</tt>.
+* вы хотите использовать Sinatra только в качестве "прослойки" Rack.
+
+<b>Совсем необязательно переходить на использование <tt>config.ru</tt> лишь потому, что вы стали
+использовать модульный стиль приложения. И необязательно использовать модульный стиль, чтобы
+запускать приложение с помощью <tt>config.ru</tt>.</b>
+
+=== Использование Sinatra в качестве "прослойки"
 
-Не только сама Sinatra может использовать подпрограммы Rack, любое Sinatra приложение
-само может быть добавлено к любому Rack эндпоинту в качестве подпрограммы. Этим эндпоинтом
+Не только сама Sinatra может использовать "прослойки" Rack, но и любое Sinatra приложение
+само может быть добавлено к любому Rack эндпоинту в качестве "прослойки". Этим эндпоинтом
 может быть другое Sinatra приложение, или приложение, основанное на Rack (Rails/Ramaze/Camping/...).
 
   require 'sinatra/base'
@@ -863,7 +929,7 @@ Rack подпрограммы, Rack приложения, Rails metal. Вы мо
   end
   
   class MyApp < Sinatra::Base
-    # подпрограмма будет запущена перед фильтрами
+    # "прослойка" будет запущена перед фильтрами
     use LoginScreen
     
     before do

data/Rakefile

@@ -6,6 +6,8 @@ require 'date'
 task :default => :test
 task :spec => :test
 
+CLEAN.include "**/*.rbc"
+
 def source_version
   line = File.read('lib/sinatra/base.rb')[/^\s*VERSION = .*/]
   line.match(/.*VERSION = '(.*)'/)[1]
@@ -17,21 +19,11 @@ task :test do
   ENV.delete 'LC_CTYPE'
 end
 
-if !ENV['NO_TEST_FIX'] and RUBY_VERSION == '1.9.2' and RUBY_PATCHLEVEL == 0
-  # Avoids seg fault
-  task(:test) do
-    second_run  = %w[settings rdoc markaby templates static textile].map { |l| "test/#{l}_test.rb" }
-    first_run   = Dir.glob('test/*_test.rb') - second_run
-    [first_run, second_run].each { |f| sh "testrb #{f.join ' '}" }
-  end
-else
-  Rake::TestTask.new(:test) do |t|
-    t.test_files = FileList['test/*_test.rb']
-    t.ruby_opts = ['-rubygems'] if defined? Gem
-    t.ruby_opts << '-I.'
-  end
+Rake::TestTask.new(:test) do |t|
+  t.test_files = FileList['test/*_test.rb']
+  t.ruby_opts = ['-rubygems'] if defined? Gem
+  t.ruby_opts << '-I.'
 end
-
 # Rcov ================================================================
 namespace :test do
   desc 'Mesures test coverage'

data/lib/sinatra/base.rb

@@ -7,7 +7,7 @@ require 'sinatra/showexceptions'
 require 'tilt'
 
 module Sinatra
-  VERSION = '1.1.2'
+  VERSION = '1.1.3'
 
   # The request object. See Rack::Request for more info:
   # http://rack.rubyforge.org/doc/classes/Rack/Request.html
@@ -324,10 +324,17 @@ module Sinatra
     # with a '304 Not Modified' response.
     def last_modified(time)
       return unless time
-      time = time.to_time if time.respond_to?(:to_time)
-      time = Time.parse time.strftime('%FT%T%:z') if time.respond_to?(:strftime)
-      response['Last-Modified'] = time.respond_to?(:httpdate) ? time.httpdate : time.to_s
-      halt 304 if Time.httpdate(request.env['HTTP_IF_MODIFIED_SINCE']) >= time
+      if time.respond_to?(:to_time)
+          time = time.to_time
+      else
+          ## make a best effort to convert something else to a time object
+          ## if this fails, this should throw an ArgumentError, then the
+          # rescue will result in an http 200, which should be safe
+          time = Time.parse(time.to_s)
+      end
+      response['Last-Modified'] = time.httpdate
+      # compare based on seconds since epoch
+      halt 304 if Time.httpdate(request.env['HTTP_IF_MODIFIED_SINCE']).to_i >= time.to_i
     rescue ArgumentError
     end
 
@@ -498,13 +505,12 @@ module Sinatra
             template.new(path, line.to_i, options) { body }
           else
             found = false
-            path = ::File.join(views, "#{data}.#{engine}")
             Tilt.mappings.each do |ext, klass|
-              break if found = File.exists?(path)
               next unless klass == template
               path = ::File.join(views, "#{data}.#{ext}")
+              break if found = File.exists?(path)
             end
-            throw :layout_missing if eat_errors and !found
+            throw :layout_missing if eat_errors and not found
             template.new(path, 1, options)
           end
         when data.is_a?(Proc) || data.is_a?(String)
@@ -986,7 +992,7 @@ module Sinatra
       # Will set params[:agent].
       def user_agent(pattern)
         condition do
-          if request.user_agent =~ pattern
+          if request.user_agent.to_s =~ pattern
             @params[:agent] = $~[1..-1]
             true
           else
@@ -1003,7 +1009,7 @@ module Sinatra
         condition do
           matching_types = (request.accept & types)
           unless matching_types.empty?
-            response.headers['Content-Type'] = matching_types.first
+            content_type matching_types.first
             true
           else
             false
@@ -1062,7 +1068,7 @@ module Sinatra
       def compile(path)
         keys = []
         if path.respond_to? :to_str
-          special_chars = %w{. + ( )}
+          special_chars = %w{. + ( ) $}
           pattern =
             path.to_str.gsub(/((:\w+)|[\*#{special_chars.join}])/) do |match|
               case match

data/sinatra.gemspec

@@ -3,8 +3,8 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
 
   s.name = 'sinatra'
-  s.version = '1.1.2'
-  s.date = '2010-12-25'
+  s.version = '1.1.3'
+  s.date = '2011-02-20'
 
   s.description = "Classy web-development dressed in a DSL"
   s.summary     = "Classy web-development dressed in a DSL"
@@ -71,6 +71,7 @@ Gem::Specification.new do |s|
     test/templates_test.rb
     test/textile_test.rb
     test/views/ascii.haml
+    test/views/calc.html.erb
     test/views/error.builder
     test/views/error.erb
     test/views/error.erubis
@@ -114,7 +115,7 @@ Gem::Specification.new do |s|
 
   s.extra_rdoc_files = %w[README.rdoc README.de.rdoc README.jp.rdoc README.fr.rdoc README.es.rdoc README.hu.rdoc README.zh.rdoc LICENSE]
   s.add_dependency 'rack', '~> 1.1'
-  s.add_dependency 'tilt', '~> 1.2'
+  s.add_dependency 'tilt', '>= 1.2.2', '< 2.0'
   s.add_development_dependency 'rake'
   s.add_development_dependency 'shotgun', '~> 0.6'
   s.add_development_dependency 'rack-test', '>= 0.5.6'

data/test/helpers_test.rb

@@ -592,6 +592,9 @@ class HelpersTest < Test::Unit::TestCase
             get '/compare', {}, { 'HTTP_IF_MODIFIED_SINCE' => 'Sun, 26 Sep 2010 23:43:52 GMT' }
             assert_equal 200, status
             assert_equal 'foo', body
+            get '/compare', {}, { 'HTTP_IF_MODIFIED_SINCE' => 'Sun, 26 Sep 2100 23:43:52 GMT' }
+            assert_equal 304, status
+            assert_equal '', body
           end
         end
 

data/test/routing_test.rb

@@ -247,7 +247,7 @@ class RoutingTest < Test::Unit::TestCase
     assert_equal 'right on', body
   end
 
-  it "literally matches . in paths" do
+  it "literally matches dot in paths" do
     route_def '/test.bar'
 
     get '/test.bar'
@@ -256,14 +256,14 @@ class RoutingTest < Test::Unit::TestCase
     assert not_found?
   end
 
-  it "literally matches $ in paths" do
+  it "literally matches dollar sign in paths" do
     route_def '/test$/'
 
     get '/test$/'
     assert ok?
   end
 
-  it "literally matches + in paths" do
+  it "literally matches plus sign in paths" do
     route_def '/te+st/'
 
     get '/te%2Bst/'
@@ -272,7 +272,7 @@ class RoutingTest < Test::Unit::TestCase
     assert not_found?
   end
 
-  it "literally matches () in paths" do
+  it "literally matches parens in paths" do
     route_def '/test(bar)/'
 
     get '/test(bar)/'
@@ -611,6 +611,18 @@ class RoutingTest < Test::Unit::TestCase
     assert_equal 'Hello World', body
   end
 
+  it "treats missing user agent like an empty string" do
+    mock_app do
+      user_agent(/.*/)
+      get '/' do
+        "Hello World"
+      end
+    end
+    get '/'
+    assert_equal 200, status
+    assert_equal 'Hello World', body
+  end
+
   it "makes captures in user agent pattern available in params[:agent]" do
     mock_app {
       user_agent(/Foo (.*)/)
@@ -636,7 +648,7 @@ class RoutingTest < Test::Unit::TestCase
     get '/', {}, { 'HTTP_ACCEPT' => 'application/xml' }
     assert ok?
     assert_equal 'application/xml', body
-    assert_equal 'application/xml', response.headers['Content-Type']
+    assert_equal 'application/xml;charset=utf-8', response.headers['Content-Type']
 
     get '/', {}, { :accept => 'text/html' }
     assert !ok?

data/test/templates_test.rb

@@ -207,6 +207,12 @@ class TemplatesTest < Test::Unit::TestCase
     assert ok?
     assert_equal 'template in subclass', body
   end
+
+  it "is possible to register another template" do
+    Tilt.register "html.erb", Tilt[:erb]
+    render_app { render :erb, :calc }
+    assert_equal '2', body
+  end
 end
 
 # __END__ : this is not the real end of the script.

data/test/views/calc.html.erb

@@ -0,0 +1 @@
+<%= 1 + 1 %>

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: sinatra
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: false
+  hash: 21
+  prerelease: 
   segments: 
   - 1
   - 1
-  - 2
-  version: 1.1.2
+  - 3
+  version: 1.1.3
 platform: ruby
 authors: 
 - Blake Mizerany
@@ -18,7 +18,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-25 00:00:00 +01:00
+date: 2011-02-20 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -42,13 +42,21 @@ dependencies:
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
-        hash: 11
+        hash: 27
         segments: 
         - 1
         - 2
-        version: "1.2"
+        - 2
+        version: 1.2.2
+    - - <
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
   type: :runtime
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
@@ -339,6 +347,7 @@ files:
 - test/templates_test.rb
 - test/textile_test.rb
 - test/views/ascii.haml
+- test/views/calc.html.erb
 - test/views/error.builder
 - test/views/error.erb
 - test/views/error.erubis
@@ -410,7 +419,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: sinatra
-rubygems_version: 1.3.7
+rubygems_version: 1.5.2
 signing_key: 
 specification_version: 2
 summary: Classy web-development dressed in a DSL