NAME
Tree::Compat - a compatibility layer for Tree
SYNOPSIS
use Tree::Compat 'Tree::Simple';
# or ...
use Tree::Compat;
Tree::Compat->load( 'Tree::Simple' );DESCRIPTION
This is meant to be a compatibility layer to aid in transition from various other Tree::* modules to Tree. As part of the transition, the REAL_TREE() method is provided in all the compatibility layers in order to access the Tree object underneath.
METHODS
load( $pkg_name )
This will load the compatibility layer for $pkg_name. If one hasn't been written yet, then load() will die.
COMPATIBILITY LAYERS
Compats have been written for:
LIMITATIONS
These compatibility layers provide compatibility with the published API of the specific module. If your code uses anything that begins with an underscore or directly accesses the internal state of the object, YOUR CODE WILL BREAK, and it will probably break at run-time.
In addition, the compatibility layer will most likely be slower than the original code. There's at least one (and often more) layer(s) of indirection involved in a true compatibility layer, especially between two modules with differing design philosophies.
CODE COVERAGE
We use Devel::Cover to test the code coverage of our tests. Below is the Devel::Cover report on this module's test suite.
---------------------------- ------ ------ ------ ------ ------ ------ ------
File stmt bran cond sub pod time total
---------------------------- ------ ------ ------ ------ ------ ------ ------
blib/lib/Tree/Compat.pm 94.1 50.0 n/a 100.0 100.0 0.5 88.9
...ree/Compat/Tree/Simple.pm 96.8 94.2 100.0 89.7 93.3 99.5 95.3
Total 96.6 92.2 100.0 90.9 93.5 100.0 94.9
---------------------------- ------ ------ ------ ------ ------ ------ ------SUPPORT
The mailing list is at TreeCPAN@googlegroups.com. I also read http://www.perlmonks.com on a daily basis.
AUTHORS
Rob Kinyon <rob.kinyon@iinteractive.com>
Stevan Little <stevan.little@iinteractive.com>
Thanks to Infinity Interactive for generously donating our time.
COPYRIGHT AND LICENSE
Copyright 2004, 2005 by Infinity Interactive, Inc.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.