X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=dda9c79605e07686719f75d083b3305ea259ce8d;hb=7f1e42e5548210a1ffe1e6034e5c1f056bf6010b;hp=c51b83260d00ccd63168364c65fa1bc52b886fb1;hpb=5793372db71cd07cda2ab25c9555b7088d04038b;p=dbsrgits%2FSQL-Translator.git diff --git a/README b/README index c51b832..dda9c79 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ SQL::Translator README -The SQL::Translator is a group of Perl modules that converts +SQL::Translator is a group of Perl modules that converts vendor-specific SQL table definitions into other formats, such as other vendor-specific SQL, ER diagrams, documentation (POD and HTML), XML, and Class::DBI classes. The main focus of SQL::Translator is @@ -13,56 +13,68 @@ via the built-in object model. Presently only the definition parts of SQL are handled (CREATE, ALTER), not the manipulation of data (INSERT, UPDATE, DELETE). -As of version 0.02, parsers exist for the following: +As of version 0.03, parsers exist for the following: - Excel - MySQL - Oracle - PostgreSQL - Sybase - xSV (arbitrarily delimited text files) + Databases: + MySQL + Oracle + PostgreSQL + Sybase + + Other: + xSV : arbitrarily delimited text files + Excel : Microsoft Excel spreadsheets + XML-SQLFairy: SQLFairy's XML format And the following producers exist: - ClassDBI: Class::DBI classes - Diagram: quasi-ER diagrams using libgd - GraphViz: ER diagrams using GraphViz - HTML: HTML documentation of schema - MySQL: MySQL-specific schema - Oracle: Oracle-specific schema - POD: Plain Old Documenation of schema - PostgreSQL: PostgreSQL-specific schema - SQLite: SQLite-specific schema - Sybase: Sybase-specific schema - XML: structure of the schema described in XML + Databases: + MySQL + Oracle + PostgreSQL + SQLite + Sybase + + + Code Generators: + ClassDBI: Class::DBI classes + + Documentation: + Diagram : quasi-ER diagrams using libgd + GraphViz : ER diagrams using GraphViz + HTML : HTML documentation of schema + POD : Plain Old Documenation of schema + + Other: + XML-SQLFairy: structure of the schema described in SQLFairy's XML Included in this distribution are a few scripts designed to be user interfaces for the actual SQL::Translator modules. In the "bin" directory, you will find: -* sqlt-diagram.pl -* sqlt-graph.pl -* sql_translator.cgi -* sql_translator.pl - -All scripts ending in ".pl" are meant to be run from the command line -with various switches to control the input and output of the scripts, -while the ".cgi" script is a web-form frontend. The script you'll -probably find most useful is the "sql_translator.pl" script which is -meant to be the main interface for translating from text-to-text. The -graphic producers, however, have many extra switches, so there are -scripts specific for each of the the GraphViz and ER-diagram producers. -All scripts start with "sql" so it will be easier to identify them on -your system. All the "*.pl" scripts will be installed in the normal -installation process, but you'll have to put the CGI script into your -web CGI directory to use it. +* sqlt-diagram +* sqlt-graph +* sqlt-dumper +* sqlt +* sqlt.cgi + +All scripts not ending in ".cgi" are meant to be run from the command +line with various switches to control the input and output of the +scripts, while the ".cgi" script is a web-form frontend. The script +you'll probably find most useful is "sqlt" which is meant to be the +main interface for translating from text-to-text. The graphic +producers, however, have many extra switches, so there are scripts +specific for each of the the GraphViz and ER-diagram producers. All +scripts start with "sqlt" so it will be easier to identify them on +your system. All the non-CGI scripts will be installed in a system +path when you "make install," but you'll have to manually place the +CGI script into your web CGI directory to use it. If you're more interested in using the SQL::Translator modules directly, then you might be more interested to examine some of the -test scripts in the "t" directory. While the test suite isn't -currently as thorough as it should be, you will definitely get the -idea of how to parse a file and manipulate the SQL::Translator::Schema -objects. +test scripts in the "t" directory. The test suite is relatively +thorough and should give you an idea of how to parse a file and +manipulate the SQL::Translator::Schema objects. INSTALLATION @@ -74,16 +86,6 @@ The regular method: $ su - # make install -AUTHORS - -Ken Y. Clark, , -darren chamberlain , -Chris Mungall , -Allen Day , -Sam Angiuoli , -Ying Zhang , -Mike Mellilo . - COPYRIGHT This program is free software; you can redistribute it and/or modify it @@ -103,6 +105,11 @@ BUGS Please use http://rt.cpan.org/ for reporting bugs. +PRAISE + +If you find this module useful, please use +"http://cpanratings.perl.org/rate/?distribution=SQL-Translator" to rate it. + SEE ALSO Check out the SQLFairy homepage at Sourceforge for more information,