mynyml-rack-accept-media-types 0.5 → 0.5.1

data/README

@@ -0,0 +1,25 @@
+===== Sumarry
+
+Rack convenience middleware for simplified handling of Accept header
+(env['HTTP_ACCEPT']). Allows ordering of its values (accepted media types)
+according to their "quality" (preference level).
+
+This wrapper is typically used to determine the request's prefered media
+type (see example below).
+
+===== Install
+
+  gem install mynyml-rack-accept-media-types --source=http://gems.github.com/
+
+===== Examples
+
+  env['HTTP_ACCEPT']  #=> 'application/xml;q=0.8,text/html,text/plain;q=0.9'
+
+  types = Rack::AcceptMediaTypes.new(env['HTTP_ACCEPT'])
+  types               #=> ['text/html', 'text/plain', 'application/xml']
+  types.prefered      #=>  'text/html'
+
+===== Links
+
+source:: http://github.com/mynyml/rack-accept-media-types
+rdocs::  http://docs.github.com/mynyml/rack-accept-media-types

data/Rakefile

@@ -22,7 +22,7 @@ end
 
 spec = Gem::Specification.new do |s|
   s.name            = 'rack-accept-media-types'
-  s.version         = '0.5'
+  s.version         = '0.5.1'
   s.summary         = "Rack convenience middleware for simplified handling of Accept header."
   s.description     = "Rack convenience middleware for simplified handling of Accept header."
   s.author          = "Martin Aumont"

data/examples.rb

@@ -0,0 +1,38 @@
+require 'pathname'
+require 'rubygems'
+require 'rack'
+require 'simple_example' # gem install mynyml-simple_example
+
+root = Pathname(__FILE__).dirname.expand_path
+require root + 'lib/rack/accept_media_types'
+
+include SimpleExample
+puts SimpleExample::Format.separator = '-'*10
+
+
+# simple
+env = {'HTTP_ACCEPT' => 'text/html,text/plain'}
+example do
+  types = Rack::AcceptMediaTypes.new(env['HTTP_ACCEPT'])
+  #=> ["text/html", "text/plain"]
+  types.prefered
+  #=> "text/html"
+end
+
+# with quality values
+env = {'HTTP_ACCEPT' => 'text/html;q=0.5,text/plain;q=0.9'}
+example do
+  types = Rack::AcceptMediaTypes.new(env['HTTP_ACCEPT'])
+  #=> ["text/plain", "text/html"]
+  types.prefered
+  #=> "text/plain"
+end
+
+# rejects types with invalid quality values
+env = {'HTTP_ACCEPT' => 'text/html;q=0,text/plain;q=1.1,application/xml'}
+example do
+  types = Rack::AcceptMediaTypes.new(env['HTTP_ACCEPT'])
+  #=> ["application/xml"]
+  types.prefered
+  #=> "application/xml"
+end

data/lib/rack/accept_media_types.rb

@@ -10,7 +10,7 @@ module Rack
   #
   # ===== Examples
   #
-  #   env['HTTP_ACCEPT']  #=> 'text/html,application/xml;q=0.8,text/plain;0.9'
+  #   env['HTTP_ACCEPT']  #=> 'application/xml;q=0.8,text/html,text/plain;q=0.9'
   #
   #   types = Rack::AcceptMediaTypes.new(env['HTTP_ACCEPT'])
   #   types               #=> ['text/html', 'text/plain', 'application/xml']

data/rack-accept-media-types.gemspec

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rack-accept-media-types
 version: !ruby/object:Gem::Version 
-  version: "0.5"
+  version: 0.5.1
 platform: ruby
 authors: 
 - Martin Aumont
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-06-05 00:00:00 -04:00
+date: 2009-06-06 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -31,6 +31,7 @@ files:
 - lib/rack
 - lib/rack/accept_media_types.rb
 - LICENSE
+- examples.rb
 - README
 has_rdoc: true
 homepage: ""

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mynyml-rack-accept-media-types
 version: !ruby/object:Gem::Version 
-  version: "0.5"
+  version: 0.5.1
 platform: ruby
 authors: 
 - Martin Aumont
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-06-04 21:00:00 -07:00
+date: 2009-06-05 21:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -31,6 +31,7 @@ files:
 - lib/rack
 - lib/rack/accept_media_types.rb
 - LICENSE
+- examples.rb
 - README
 has_rdoc: true
 homepage: ""