wurfl_client 0.5.1 → 0.5.3

data/README

@@ -22,7 +22,7 @@ The WURFL Client can then be implemented f.i. as a thin Rack service, see Exampl
 
 == Requirements
 
-Ruby 1.9: (.ord!) -> Possibly integrate http://gist.github.com/251465 as a fix
+Ruby Version supporting String.ord -> Possibly integrate http://gist.github.com/251465 as a fix
 WURFL gem (http://github.com/pwim/wurfl): Handset, UserAgentMatcher, WURFL Loader
 
 
@@ -45,7 +45,7 @@ To setup the environment, you have to execute following steps:
  
 3.) prepare the lookup tables (builds them into ./lookup directory by default). This will take some time!
 
-    lookup_prepare.rb 
+    wurfl_prepare_lookup.rb 
 
 Now, you are ready for device detection. If you make an automated script to do this update regularly, you must not forget to clear the lookup directory first. 
 The preparation script doesn't overwrite files. For minimal effect on your running webservice, you should use another lookup directory there and copy the 
@@ -58,7 +58,7 @@ Here is an example automatic update script:
     gunzip wurfl-latest.xml.gz
     wurfl_minimize.rb 
     rm lookup/*
-    lookup_prepare.rb
+    wurfl_prepare_lookup.rb
     cp lookup/* /path/to/production/lookup
 
 
@@ -73,27 +73,39 @@ The device detection is as simple as this call:
     
     puts "DEVICE: #{hs["brand_name"]} #{hs["model_name"]}"
     
-You can easily put the WURFL detection into a Rack (http://rack.rubyforge.org/) middleware. 
-Using following 'config.ru', you can put this online using 'rackup':
+You can easily put the WURFL detection into a Rack (http://rack.rubyforge.org/) middleware. I chose to output the data in JSON format. 
+Using following 'config.ru', you can put this online using 'rackup'. 
 
     require "wurfl_client"
 
     class RackInterface
-  
+    
+      def getJSON(handset)
+        result = %Q{"WURFL-Client":1}
+        if handset
+          handset.keys.each do |key|
+            result << %Q{,"#{key}":"#{handset[key]}"}
+          end
+        end
+        "{#{result}}"
+      end
+    
       def call(env)
         user_agent = env["HTTP_USER_AGENT"]
         
         hs = WurflClient.detectMobileDevice(user_agent)
-        hsinfo = flash.collect { |k, v| "#{k}: #{v};" }.join
-  
-        [200, {"Content-Type" => "text/plain"}, ["#{hsinfo}"] ]
+    
+        [200, {"Content-Type" => "text/javascript"}, ["#{getJSON(hs)}"] ]
       end
-  
+    
     end
-
+    
     run RackInterface.new
 
-  
+Test by opening f.i. http://localhost:9292/. You should see the response
+    {"WURFL-Client":1}
+
+You can get results for mobile devices by using the UserAgentSwitcher Firefox extension (http://chrispederick.com/work/user-agent-switcher/).
 This can be further extended by a caching mechanism to reduce the server load. Being a Rack layer, it should 
 also be possible to integrate this into a rails app. If you know, how to do so, I would really appreciate your 
 contribution.

data/VERSION

@@ -1 +1 @@
-0.5.1
+0.5.3

data/examples/config.ru

@@ -0,0 +1,26 @@
+# this script needs the lookup folder to be set up!
+require "wurfl_client"
+
+class RackInterface
+
+	def getJSON(handset)
+		result = %Q{"WURFL-Client":1}
+		if handset
+			handset.keys.each do |key|
+				result << %Q{,"#{key}":"#{handset[key]}"}
+			end
+		end
+		"{#{result}}"
+	end
+
+	def call(env)
+		user_agent = env["HTTP_USER_AGENT"]
+		
+		hs = WurflClient.detectMobileDevice(user_agent)
+
+		[200, {"Content-Type" => "text/javascript"}, ["#{getJSON(hs)}"] ]
+	end
+
+end
+
+run RackInterface.new

data/test/data/wurfl-test.xml

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<wurfl>
+  <version>
+    <ver>Test Version</ver>
+  </version>
+  <devices>
+  <device id="generic" user_agent="" fall_back="root">
+    <group id="display">
+      <capability name="physical_screen_height" value="27"/>
+      <capability name="columns" value="11"/>
+      <capability name="physical_screen_width" value="27"/>
+      <capability name="rows" value="6"/>
+      <capability name="max_image_width" value="90"/>
+      <capability name="resolution_height" value="40"/>
+      <capability name="resolution_width" value="90"/>
+      <capability name="max_image_height" value="35"/>
+    </group>
+  </device>
+  <device id="generic_xhtml" user_agent="Mozz" fall_back="generic">
+    <group id="display">
+      <capability name="max_image_width" value="120"/>
+      <capability name="resolution_height" value="92"/>
+      <capability name="resolution_width" value="128"/>
+      <capability name="max_image_height" value="92"/>
+    </group>
+    <group id="product_info">
+      <capability name="mobile_browser" value="Safari"/>
+    </group>
+  </device>
+  <device id="apple_generic" user_agent="Mozilla/5.0 (iPhone;" fall_back="generic_xhtml">
+    <group id="display">
+      <capability name="columns" value="20"/>
+      <capability name="max_image_width" value="300"/>
+      <capability name="rows" value="20"/>
+      <capability name="resolution_width" value="300"/>
+      <capability name="resolution_height" value="300"/>
+      <capability name="max_image_height" value="300"/>
+    </group>
+  </device>
+  <device id="apple_iphone_ver1" user_agent="Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Version/3.0 Mobile/1A538a Safari/419.3" fall_back="apple_generic" actual_device_root="true">
+    <group id="product_info">
+      <capability name="mobile_browser" value="Safari"/>
+      <capability name="pointing_method" value="touchscreen"/>
+      <capability name="model_name" value="iPhone"/>
+      <capability name="device_os_version" value="1.0"/>
+    </group>
+    <group id="display">
+      <capability name="physical_screen_height" value="74"/>
+      <capability name="dual_orientation" value="true"/>
+      <capability name="physical_screen_width" value="49"/>
+      <capability name="max_image_width" value="320"/>
+      <capability name="resolution_height" value="480"/>
+      <capability name="resolution_width" value="320"/>
+      <capability name="max_image_height" value="360"/>
+    </group>
+  </device>
+</devices>
+</wurfl>

data/wurfl_client.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{wurfl_client}
-  s.version = "0.5.1"
+  s.version = "0.5.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Guido Pinkas"]
@@ -23,12 +23,14 @@ Gem::Specification.new do |s|
      "VERSION",
      "bin/wurfl_minimize.rb",
      "bin/wurfl_prepare_lookup.rb",
+     "examples/config.ru",
      "lib/wurfl_client.rb",
      "lib/wurfl_client/device_profile.rb",
      "lib/wurfl_client/lookup_helper.rb",
      "lib/wurfl_client/lookup_preparer.rb",
      "lib/wurfl_client/ua_device_detector.rb",
      "test/data/iphone.pstore",
+     "test/data/wurfl-test.xml",
      "test/device_profile_test.rb",
      "test/lookup_helper_test.rb",
      "test/ua_device_detector_test.rb",

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 5
-  - 1
-  version: 0.5.1
+  - 3
+  version: 0.5.3
 platform: ruby
 authors: 
 - Guido Pinkas
@@ -48,12 +48,14 @@ files:
 - VERSION
 - bin/wurfl_minimize.rb
 - bin/wurfl_prepare_lookup.rb
+- examples/config.ru
 - lib/wurfl_client.rb
 - lib/wurfl_client/device_profile.rb
 - lib/wurfl_client/lookup_helper.rb
 - lib/wurfl_client/lookup_preparer.rb
 - lib/wurfl_client/ua_device_detector.rb
 - test/data/iphone.pstore
+- test/data/wurfl-test.xml
 - test/device_profile_test.rb
 - test/lookup_helper_test.rb
 - test/ua_device_detector_test.rb