Bumping version to 1.61
[dbsrgits/SQL-Translator.git] / lib / SQL / Translator / Producer / XML.pm
index d17fdd9..02f6413 100644 (file)
 package SQL::Translator::Producer::XML;
 
-# -------------------------------------------------------------------
-# $Id: XML.pm,v 1.6 2003-04-25 11:47:25 dlc Exp $
-# -------------------------------------------------------------------
-# Copyright (C) 2003 Ken Y. Clark <kclark@cpan.org>,
-#                    darren chamberlain <darren@cpan.org>,
-#                    Chris Mungall <cjm@fruitfly.org>
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License as
-# published by the Free Software Foundation; version 2.
-#
-# This program 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
-# General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
-# 02111-1307  USA
-# -------------------------------------------------------------------
-
-use strict;
-use vars qw[ $VERSION $XML ];
-$VERSION = sprintf "%d.%02d", q$Revision: 1.6 $ =~ /(\d+)\.(\d+)/;
-
-use SQL::Translator::Utils qw(header_comment);
-
-# -------------------------------------------------------------------
-sub produce {
-    my ( $translator, $data ) = @_;
-    my $prargs = $translator->producer_args;
-    my $indent = 0;
-    aggregate('<?xml version="1.0"?>', $indent);
-    aggregate('<schema>', $indent);
-    aggregate('<!-- ' . header_comment('', '') . '-->');
-
-    $indent++;
-    for my $table ( 
-        map  { $_->[1] }
-        sort { $a->[0] <=> $b->[0] }
-        map  { [ $_->{'order'}, $_ ] }
-        values %$data
-    ) { 
-        aggregate( '<table>', $indent );
-        $indent++;
-
-        aggregate( "<name>$table->{'table_name'}</name>", $indent );
-        aggregate( "<order>$table->{'order'}</order>", $indent );
-
-        #
-        # Fields
-        #
-        aggregate( '<fields>', $indent );
-        for my $field ( 
-            map  { $_->[1] }
-            sort { $a->[0] <=> $b->[0] }
-            map  { [ $_->{'order'}, $_ ] }
-            values %{ $table->{'fields'} }
-        ) {
-            aggregate( '<field>', ++$indent );
-            $indent++;
-
-            for my $key ( keys %$field ) {
-                my $val = defined $field->{ $key } ? $field->{ $key } : '';
-                   $val = ref $val eq 'ARRAY' ? join(',', @$val) : $val;
-                aggregate("<$key>$val</$key>", $indent)
-                    if ($val || (!$val && $prargs->{'emit_empty_tags'}));
-            }
-
-            $indent--;
-            aggregate("</field>", $indent--);
-        }
-        aggregate( "</fields>", $indent );
-
-        #
-        # Indices
-        #
-        aggregate( '<indices>', $indent );
-        for my $index ( @{ $table->{'indices'} } ) {
-            aggregate( '<index>', ++$indent );
-            $indent++;
-
-            for my $key ( keys %$index ) {
-                my $val = defined $index->{ $key } ? $index->{ $key } : '';
-                   $val = ref $val eq 'ARRAY' ? join(',', @$val) : $val;
-                aggregate( "<$key>$val</$key>", $indent );
-            }
-
-            $indent--;
-            aggregate( "</index>", $indent-- );
-        }
-        aggregate( "</indices>", $indent );
-
-        $indent--;
-        aggregate( "</table>", $indent );
-    }
-
-    $indent--;
-    aggregate( '</schema>', $indent );
-
-    return $XML;
-}
-
-# -------------------------------------------------------------------
-sub aggregate {
-    my ( $text, $indent ) = @_;
-    $XML .= ('  ' x $indent) . "$text\n";
-}
-
-1;
-__END__
-
-# -------------------------------------------------------------------
-# The eyes of fire, the nostrils of air,
-# The mouth of water, the beard of earth.
-# William Blake
-# -------------------------------------------------------------------
+=pod
 
 =head1 NAME
 
-SQL::Translator::Producer::XML - XML output
-
-=head1 SYNOPSIS
-
-  use SQL::Translator::Producer::XML;
+SQL::Translator::Producer::XML - Alias to XML::SQLFairy producer
 
 =head1 DESCRIPTION
 
-Meant to create some sort of usable XML output.
-
-=head1 ARGS
-
-Takes the following optional C<producer_args>:
-
-=over 4
-
-=item emit_empty_tags
-
-If this is set to a true value, then tags corresponding to value-less
-elements will be emitted.  For example, take this schema:
-
-  CREATE TABLE random (
-    id int auto_increment PRIMARY KEY,
-    foo varchar(255) not null default '',
-    updated timestamp
-  );
-
-With C<emit_empty_tags> = 1, this will be dumped with XML similar to:
-
-  <table>
-    <name>random</name>
-    <order>1</order>
-    <fields>
-      <field>
-        <is_auto_inc>1</is_auto_inc>
-        <list></list>
-        <is_primary_key>1</is_primary_key>
-        <data_type>int</data_type>
-        <name>id</name>
-        <constraints></constraints>
-        <null>1</null>
-        <order>1</order>
-        <size></size>
-        <type>field</type>
-      </field>
+Previous versions of SQL::Translator included an XML producer, but the
+namespace has since been further subdivided.  Therefore, this module is
+now just an alias to the XML::SQLFairy producer.
 
-With C<emit_empty_tags> = 0, you'd get:
+=head1 SEE ALSO
 
-  <table>
-    <name>random</name>
-    <order>1</order>
-    <fields>
-      <field>
-        <is_auto_inc>1</is_auto_inc>
-        <is_primary_key>1</is_primary_key>
-        <data_type>int</data_type>
-        <name>id</name>
-        <null>1</null>
-        <order>1</order>
-        <type>field</type>
-      </field>
+SQL::Translator::Producer::XML::SQLFairy.
 
-This can lead to dramatic size savings.
+=head1 AUTHOR
 
-=back
+Ken Youens-Clark E<lt>kclark@cpan.orgE<gt>.
 
-=pod
-
-=head1 AUTHOR
+=cut
 
-Ken Y. Clark E<lt>kclark@cpan.orgE<gt>
+use strict;
+use warnings;
+our $DEBUG;
+our $VERSION = '1.61';
+$DEBUG = 1 unless defined $DEBUG;
 
-=head1 SEE ALSO
+use SQL::Translator::Producer::XML::SQLFairy;
 
-XML::Dumper;
+*produce = \&SQL::Translator::Producer::XML::SQLFairy::produce;
 
-=cut
+1;