NAME

Gtk2::Ex::TreeMaker::FlatInterface - This module is not to be used directly. It is called from Gtk2::Ex::TreeMaker as a utility module.

DESCRIPTION

This module contains a utility method sub flat_to_tree. This utility method will accept an array of arrays (a set of relational records) as its input and then return a treelike data structure that is in-turn used by the Gtk2::Ex::TreeMaker to spin the Gtk2::TreeModel.

METHODS

Gtk2::Ex::TreeMaker::FlatInterface->new

Accepts no arguments. Just returns a reference to the object

Gtk2::Ex::TreeMaker::FlatInterface->flat_to_tree

Accepts an array of arrays (a set of relational records) as its input. Returns a special tree-like data structure that is then used by the Gtk2::Ex::TreeMaker to spin the Gtk2::TreeModel.

Here is a sample input:

   my $input = [
      ['Texas','Dallas','Fruits','Dec-2003','300'],
      ['Texas','Dallas','Veggies','Jan-2004','120'],
      ['Texas','Austin','Fruits','Nov-2003','310'],
      ['Texas','Austin','Veggies','Feb-2004','20']
   ];

Here is the corresponding output:

   my $output = {
             'Node' => [
                         {
                           'Node' => [
                                       {
                                         'Feb-2004' => '20',
                                         'Jun-2004' => '80',
                                         'Name' => 'Veggies'
                                       },
                                       {
                                         'Nov-2003' => '310',
                                         'Name' => 'Fruits'
                                       }
                                     ],
                           'Name' => 'Austin'
                         },
                         {
                           'Node' => [
                                       {
                                         'Jan-2004' => '120',
                                         'Name' => 'Veggies'
                                       },
                                       {
                                         'Dec-2003' => '300',
                                         'Name' => 'Fruits'
                                       }
                                     ],
                           'Name' => 'Dallas'
                         }
                       ],
             'Name' => 'Texas'
           };

This data structure is really the key input into the Gtk2::Ex::TreeMaker module. If you can provide this data structure through external means, then we can build Gtk2::Ex::TreeMaker using that. More on this later...

AUTHOR

Ofey Aikon, <ofey_aikon@yahoo.com>

BUGS

Please report any bugs or feature requests to bug-gtk2-ex-recordsfilter@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2004 Ofey Aikon, All Rights Reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.