Rob Kinyon > Tree-Compat-1.00 > Tree::Compat

Download:
Tree-Compat-1.00.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.00   Source  

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.

http://www.iinteractive.com

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: