Fallback Browser

The Fallback Browser is a program that creates an interactive graph of the children of a WURFL ID. Each node displayed in the graph is click-able and will redraw the graph with the clicked node as the new base WURFL IDs.

Usage

Base input

Base WURFL ID: A WURFL ID to graph other WURFL IDs who have their fallback set to the it. In other words the base ID is the point of focus for tracking its' lineage.
View size: The dimensions of the resulting graph in inches. The accepted input format is "width, height", invalid input will become "8.5, 11". If the size is empty, then the graph will display at its' internal full size.
Warning: Base IDs with a large number of children, such as generic, may cause your browser to become extremely slow and consume a large amount of RAM while attempting to display such IDs at full size.
Why inches? The command that dot takes to control the size is required in inches. If you know how to make dot read the size command in units other than inches, please tell me!

Graph Type

Tree: Draws the graph in a tree layout.
Circular: Draws the graph in a circular layout.
Radial: Draws the graph in a radial layout.

Options

Show Root: Shows the roots (or the fallbacks up to generic) of the base ID.
Show Children: Shows all the WURFL IDs who at some point have a parent whose fallback is the base ID.
Count Children: Shows the number of children that an ID has in the ID's label. If Show Children is also checked, then it will only count the number of children who themselves do not have children. I.e. ID's who create leaves in the tree.

Examples

Requirements

Ruby 1.8 or higher, because it makes use of Webrick that is installed with 1.8 and above.
Graphviz Note: that the tools to draw Circular and Radial graphs require 2.0 and above.
WURFL's Ruby tools

Running

Install all of the requirements.
Build a PStore database of a WURFL XML file by using the wurflloader.
Run the Fallback Browser:
```
fallback_brower.rb -d pstore_db
```
With a web browser go to http://127.0.0.1:2005/
Input a WURFL ID and enjoy!
For more options run
```
fallback_browser.rb -h
```

Acknowledgements

Thanks to Keisuke Seki for the providing the idea of graphing the fallbacks!