acceptable 0.2.1 → 0.2.2

data/README.rdoc

@@ -1,3 +1,59 @@
+=== DESCRIPTION:
+
+Provides definitive support for Accept-* headers, strictly compliant with RFC 2616.
+Includes negotiation algorithms for Media-Types, Charsets and Content-Codings.
+Also realizes perfectionistic LanguageTags support with basic/extended filtering (RFC 5646, RFC 4647).
+
+== FEATURES:
+
+* Accept-* headers support, strictly compliant with RFC 2616
+* Media-Type negotiation
+* Charset negotiation
+* Content-coding negotiation
+* LanguageTags (RFC 5646, RFC 4647)
+
+== EXAMPLES:
+
+=== Media
+
+  env = Rack::MockRequest.env_for('/','HTTP_ACCEPT' => 'text/plain;q=0,text/*')
+  request = Request.new(env)
+  p request.accept_media?('text/css') #=> true
+  p request.accept_media?('text/plain') #=> false
+  p request.accept_media?('video/quicktime') #=> false
+
+  env = Rack::MockRequest.env_for('/','HTTP_ACCEPT' => 'text/*;q=0.8,text/x-json;q=0.8,text/html;p=whatever')
+  request = Request.new(env)
+  p request.preferred_media_from('text/css','text/html') #=> "text/css"
+  p request.preferred_media_from('text/x-json','text/html;p=whatever') #=> "text/html;p=whatever"
+  p request.preferred_media_from('text/x-json','text/html;p=Whatever') #=> "text/x-json" #parameter values are case-sensitive.
+
+=== LanguageTags
+
+  langtag = Rack::Acceptable::LanguageTag.parse('SL-LATN-ROZAJ')
+
+  p langtag.variants #=> ["rozaj"]
+  p langtag.script #=> "Latn"
+
+  # basic filtering (RFC 4647)
+  p langtag.has_prefix?('sl-Latn') #=> true
+  p langtag.matched_by_basic_range?('sl-Latn') #=> true
+  p langtag.has_prefix?('sl-Latn-ro') #=> false
+  p langtag.has_prefix?('sl') #=> true
+
+  # extended filtering (RFC 4647)
+  p langtag.matched_by_extended_range?('*') #=> true
+  p langtag.matched_by_extended_range?('sl-*') #=> true
+  p langtag.matched_by_extended_range?('*-Latn') #=> true
+  p langtag.matched_by_extended_range?('sl-rozaj') #=> true
+  p langtag.matched_by_extended_range?('sl-nedis') #=> false
+
+
+== INSTALLATION:
+
+rack-acceptable is available via rubygems:
+  $gem in acceptable
+
 == REQUIREMENTS:
 
 rack (>=1.0.0)
@@ -6,7 +62,7 @@ rack (>=1.0.0)
 
 (The MIT License)
 
-Copyright (c) 2009
+Copyright (c) 2010
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/rack/acceptable/version.rb

@@ -1,6 +1,6 @@
 module Rack #:nodoc:
   module Acceptable #:nodoc:
-    VERSION = '0.2.1'
+    VERSION = '0.2.2'
   end
 end
 

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 2
-  - 1
-  version: 0.2.1
+  - 2
+  version: 0.2.2
 platform: ruby
 authors: 
 - SSDany
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-16 00:00:00 +04:00
+date: 2010-04-17 00:00:00 +04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -31,7 +31,11 @@ dependencies:
         version: 1.0.0
   type: :runtime
   version_requirements: *id001
-description: HTTP Accept parsers for Rack.
+description: |
+  Provides definitive support for Accept-* headers, strictly compliant with RFC 2616.
+  Includes negotiation algorithms for Media-Types, Charsets and Content-Codings.
+  Also realizes perfectionistic LanguageTags support with basic/extended filtering (RFC 5646, RFC 4647).
+
 email: inadsence@gmail.com
 executables: []