X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Findex.rst;h=84f0dd31e7247e9b4e3b45e3cd03870ac8426b5c;hb=6d0a03d91697c78a14b7ef31aa71b47b400fbb4b;hp=242918a82b9662afe66a49842caaa5a6d2d06e45;hpb=447c2ab10de0e28b7d6ecc95c3c2aaf0efddebd3;p=sqlconvert.git diff --git a/docs/index.rst b/docs/index.rst index 242918a..84f0dd3 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,57 +1,26 @@ -.. mysql2sql documentation master file, created by +.. sqlconvert documentation master file, created by sphinx-quickstart on Fri Jul 22 19:32:24 2016. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to mysql2sql's documentation! +Welcome to sqlconvert's documentation! ===================================== -This is mysql2sql, a mysql to sql converter. It is primary intended to -convert mysqldump (especially with extended INSERT syntax) to standard -SQL to load at least to PostgreSQL or SQLite. +This is sqlconvert, a library to implement SQL converters. It uses `sqlparse +`_ to parse SQL. -It uses `sqlparse `_ to parse -SQL. +The library is in the early stage of development and currently cannot do much. -The program is in its initial phase and currently cannot do much. +The first goal is to implement `mysql2sql `_, a script intended +primarily to convert mysqldump (especially with extended INSERT syntax) to +standard SQL to load at least to PostgreSQL or SQLite. -.. highlight:: none +Contents: -Command line ------------- +.. toctree:: + :maxdepth: 1 -mysql2sql -~~~~~~~~~ - -Usage:: - - mysql2sql [-e encoding] [-E output_encoding] [infile] [[-o] outfile] - -Options:: - - -e ENCODING, --encoding ENCODING - input/output encoding, default is utf-8 - -E OUTPUT_ENCODING, --output-encoding OUTPUT_ENCODING - separate output encoding, default is the same as - `-e` except for console; for console output charset - from the current locale is used - -P, --no-pbar Inhibit progress bar - infile Input file, stdin if absent or '-' - -o, --outfile outfile Output file, stdout if absent or '-' - -If stderr is connected to the console the program displays a text mode progress -bar. Option `-P/--no-pbar` inhibits it. - -Option `-o` is useful when infile is absent (input is redirected), for -example:: - - mysql2sql -o outfile.sql < infile.sql - cat infile.sql | mysql2sql -o outfile.sql - -But of course it simply can be:: - - mysql2sql - outfile.sql < infile.sql - cat infile.sql | mysql2sql - outfile.sql + mysql2sql Indices and tables