added width and height options for graphviz out. no docs
[dbsrgits/SQL-Translator.git] / lib / SQL / Translator / Producer / XML.pm
index 7621a62..326792c 100644 (file)
 package SQL::Translator::Producer::XML;
 
-#-----------------------------------------------------
-# $Id: XML.pm,v 1.1.1.1 2002-03-01 02:26:25 kycl4rk Exp $
+# -------------------------------------------------------------------
+# $Id: XML.pm,v 1.8 2003-05-06 12:47:27 dlc Exp $
+# -------------------------------------------------------------------
+# Copyright (C) 2003 Ken Y. Clark <kclark@cpan.org>,
+#                    darren chamberlain <darren@cpan.org>,
+#                    Chris Mungall <cjm@fruitfly.org>
 #
-# File       : SQL/Translator/Producer/XML.pm
-# Programmer : Ken Y. Clark, kclark@logsoft.com
-# Created    : 2002/02/27
-# Purpose    : XML output
-#-----------------------------------------------------
+# 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 SQL::Translator::Producer;
-use vars qw( $VERSION );
-$VERSION = (qw$Revision: 1.1.1.1 $)[-1];
-
-use XML::Dumper;
-
-use base qw[ SQL::Translator::Producer ];
-
-sub to { 'XML' }
-
-sub translate {
-    my ( $self, $data ) = @_;
-    my $dumper = XML::Dumper->new;
-    return $dumper->pl2xml( $data );
+use vars qw[ $VERSION ];
+$VERSION = sprintf "%d.%02d", q$Revision: 1.8 $ =~ /(\d+)\.(\d+)/;
+
+use IO::Scalar;
+use SQL::Translator::Utils qw(header_comment);
+use XML::Writer;
+
+my $sqlf_ns = 'http://sqlfairy.sourceforge.net/sqlfairy.xml';
+
+# -------------------------------------------------------------------
+sub produce {
+    my ( $translator, $data ) = @_;
+    #my $prargs = $translator->producer_args;
+    my $prargs = { };
+    my $io = IO::Scalar->new;
+
+    my $xml = XML::Writer->new(OUTPUT      => $io,
+                               NAMESPACES  => 1,
+                               PREFIX_MAP  => { $sqlf_ns => 'sqlf' },
+                               DATA_MODE   => 1,
+                               DATA_INDENT => 2);
+
+
+    $xml->xmlDecl("UTF-8");
+    $xml->comment(header_comment('', ''));
+    $xml->startTag([ $sqlf_ns => "schema" ]);
+
+    for my $table ( 
+        map  { $_->[1] }
+        sort { $a->[0] <=> $b->[0] }
+        map  { [ $_->{'order'}, $_ ] }
+        values %$data
+    ) {
+        $xml->startTag([ $sqlf_ns => "table" ]);
+
+        $xml->dataElement([ $sqlf_ns => "name" ], $table->{'table_name'});
+        $xml->dataElement([ $sqlf_ns => "order" ], $table->{'order'});
+
+        #
+        # Fields
+        #
+        $xml->startTag([ $sqlf_ns => "fields" ]);
+        for my $field ( 
+            map  { $_->[1] }
+            sort { $a->[0] <=> $b->[0] }
+            map  { [ $_->{'order'}, $_ ] }
+            values %{ $table->{'fields'} }
+        ) {
+            $xml->startTag([ $sqlf_ns => "field" ]);
+
+            for my $key ( keys %$field ) {
+                my $val = defined $field->{ $key } ? $field->{ $key } : '';
+                   $val = ref $val eq 'ARRAY' ? join(',', @$val) : $val;
+                $xml->dataElement([ $sqlf_ns => $key ], $val)
+                    if ($val || (!$val && $prargs->{'emit_empty_tags'}));
+            }
+
+            $xml->endTag([ $sqlf_ns => "field" ]);
+        }
+        $xml->endTag([ $sqlf_ns => "fields" ]);
+
+        #
+        # Indices
+        #
+        $xml->startTag([ $sqlf_ns => "indices" ]);
+        for my $index (@{$table->{'indices'}}) {
+            $xml->startTag([ $sqlf_ns => "index" ]);
+
+            for my $key (keys %$index) {
+                my $val = defined $index->{ $key } ? $index->{ $key } : '';
+                   $val = ref $val eq 'ARRAY' ? join(',', @$val) : $val;
+                $xml->dataElement([ $sqlf_ns => $key ], $val);
+            }
+
+            $xml->endTag([ $sqlf_ns => "index" ]);
+        }
+        $xml->endTag([ $sqlf_ns => "indices" ]);
+
+        $xml->endTag([ $sqlf_ns => "table" ]);
+    }
+
+    $xml->endTag([ $sqlf_ns => "schema" ]);
+    $xml->end;
+
+    return $io;
 }
 
 1;
+__END__
 
-#-----------------------------------------------------
+# -------------------------------------------------------------------
 # The eyes of fire, the nostrils of air,
 # The mouth of water, the beard of earth.
 # William Blake
-#-----------------------------------------------------
+# -------------------------------------------------------------------
 
 =head1 NAME
 
@@ -44,14 +129,72 @@ SQL::Translator::Producer::XML - XML output
 
 =head1 DESCRIPTION
 
-Blah blah blah.
+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>
+
+With C<emit_empty_tags> = 0, you'd get:
+
+  <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>
+
+This can lead to dramatic size savings.
+
+=back
+
+=pod
 
 =head1 AUTHOR
 
-Ken Y. Clark, kclark@logsoft.com
+Ken Y. Clark E<lt>kclark@cpan.orgE<gt>
 
 =head1 SEE ALSO
 
-perl(1).
+XML::Dumper;
 
 =cut