package SQL::Translator::Producer::XML;
# -------------------------------------------------------------------
-# $Id: XML.pm,v 1.7 2003-05-03 15:21:12 kycl4rk Exp $
+# $Id$
# -------------------------------------------------------------------
-# Copyright (C) 2003 Ken Y. Clark <kclark@cpan.org>,
-# darren chamberlain <darren@cpan.org>,
-# Chris Mungall <cjm@fruitfly.org>
+# Copyright (C) 2002-4 SQLFairy Authors
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License as
# 02111-1307 USA
# -------------------------------------------------------------------
-use strict;
-use vars qw[ $VERSION $XML ];
-$VERSION = sprintf "%d.%02d", q$Revision: 1.7 $ =~ /(\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 = shift or return;
- my $indent = shift || 0;
- $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>:
+Previous versions of SQL::Translator included an XML producer, but the
+namespace has since been further subdivided. Therefore, this module is
+now just just an alias to the XML::SQLFairy producer.
-=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:
+=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 Y. Clark E<lt>kclark@cpan.orgE<gt>.
-=pod
+=cut
-=head1 AUTHOR
+# -------------------------------------------------------------------
-Ken Y. Clark E<lt>kclark@cpan.orgE<gt>
+use strict;
+use vars qw[ $VERSION $DEBUG ];
+$VERSION = sprintf "%d.%02d", q$Revision$ =~ /(\d+)\.(\d+)/;
+$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;
projects / dbsrgits/SQL-Translator.git / blobdiff