From: Mike Bayer Date: Sat, 26 May 2012 17:11:26 +0000 (-0400) Subject: - upgrade DBAPI index to have links to all dialect toplevel pages X-Git-Tag: rel_0_7_8~22 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a9edddc5c35b17b72d9223a71f4d0933d9647176;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git - upgrade DBAPI index to have links to all dialect toplevel pages - add line for google DBAPI --- diff --git a/doc/build/core/engines.rst b/doc/build/core/engines.rst index aa2c1f29bd..1f01265a9d 100644 --- a/doc/build/core/engines.rst +++ b/doc/build/core/engines.rst @@ -62,49 +62,50 @@ translate as: information on current support. * \* - indicates the given DBAPI is the "default" for SQLAlchemy, i.e. when just the database name is specified -========================= =========================== =========== =========== =========== ================= ============ -Driver Connect string Py2K Py3K Jython Unix Windows -========================= =========================== =========== =========== =========== ================= ============ +=============================================================== =========================== =========== =========== =========== ================= ============ +Driver Connect string Py2K Py3K Jython Unix Windows +=============================================================== =========================== =========== =========== =========== ================= ============ **DB2/Informix IDS** -ibm-db_ thirdparty thirdparty thirdparty thirdparty thirdparty thirdparty -**Drizzle** -mysql-python_ ``drizzle+mysqldb``\* yes development no yes yes -**Firebird / Interbase** -kinterbasdb_ ``firebird+kinterbasdb``\* yes development no yes yes -**Informix** -informixdb_ ``informix+informixdb``\* yes development no unknown unknown -**MaxDB** -sapdb_ ``maxdb+sapdb``\* development development no yes unknown -**Microsoft Access** -pyodbc_ ``access+pyodbc``\* development development no unknown yes -**Microsoft SQL Server** -adodbapi_ ``mssql+adodbapi`` development development no no yes -`jTDS JDBC Driver`_ ``mssql+zxjdbc`` no no development yes yes -mxodbc_ ``mssql+mxodbc`` yes development no yes with FreeTDS_ yes -pyodbc_ ``mssql+pyodbc``\* yes development no yes with FreeTDS_ yes -pymssql_ ``mssql+pymssql`` yes development no yes yes -**MySQL** -`MySQL Connector/J`_ ``mysql+zxjdbc`` no no yes yes yes -`MySQL Connector/Python`_ ``mysql+mysqlconnector`` yes development no yes yes -mysql-python_ ``mysql+mysqldb``\* yes development no yes yes -OurSQL_ ``mysql+oursql`` yes yes no yes yes -pymysql_ ``mysql+pymysql`` yes development no yes yes -**Oracle** -cx_oracle_ ``oracle+cx_oracle``\* yes development no yes yes -`Oracle JDBC Driver`_ ``oracle+zxjdbc`` no no yes yes yes -**Postgresql** -pg8000_ ``postgresql+pg8000`` yes yes no yes yes -`PostgreSQL JDBC Driver`_ ``postgresql+zxjdbc`` no no yes yes yes -psycopg2_ ``postgresql+psycopg2``\* yes yes no yes yes -pypostgresql_ ``postgresql+pypostgresql`` no yes no yes yes -**SQLite** -pysqlite_ ``sqlite+pysqlite``\* yes yes no yes yes -sqlite3_ ``sqlite+pysqlite``\* yes yes no yes yes -**Sybase ASE** -mxodbc_ ``sybase+mxodbc`` development development no yes yes -pyodbc_ ``sybase+pyodbc``\* partial development no unknown unknown -python-sybase_ ``sybase+pysybase`` yes [1]_ development no yes yes -========================= =========================== =========== =========== =========== ================= ============ +ibm-db_ thirdparty thirdparty thirdparty thirdparty thirdparty thirdparty +**Drizzle** :ref:`(docs) ` +mysql-python_ ``drizzle+mysqldb``\* yes development no yes yes +**Firebird / Interbase** :ref:`(docs) ` +kinterbasdb_ ``firebird+kinterbasdb``\* yes development no yes yes +**Informix** :ref:`(docs) ` +informixdb_ ``informix+informixdb``\* yes development no unknown unknown +**MaxDB** :ref:`(docs) ` +sapdb_ ``maxdb+sapdb``\* development development no yes unknown +**Microsoft Access** :ref:`(docs) ` +pyodbc_ ``access+pyodbc``\* development development no unknown yes +**Microsoft SQL Server** :ref:`(docs) ` +adodbapi_ ``mssql+adodbapi`` development development no no yes +`jTDS JDBC Driver`_ ``mssql+zxjdbc`` no no development yes yes +mxodbc_ ``mssql+mxodbc`` yes development no yes with FreeTDS_ yes +pyodbc_ ``mssql+pyodbc``\* yes development no yes with FreeTDS_ yes +pymssql_ ``mssql+pymssql`` yes development no yes yes +**MySQL** :ref:`(docs) ` +`MySQL Connector/J`_ ``mysql+zxjdbc`` no no yes yes yes +`MySQL Connector/Python`_ ``mysql+mysqlconnector`` yes development no yes yes +mysql-python_ ``mysql+mysqldb``\* yes development no yes yes +OurSQL_ ``mysql+oursql`` yes yes no yes yes +pymysql_ ``mysql+pymysql`` yes development no yes yes +rdbms_ (Google Appengine) ``mysql+gaerdbms`` yes development no no no +**Oracle** :ref:`(docs) ` +cx_oracle_ ``oracle+cx_oracle``\* yes development no yes yes +`Oracle JDBC Driver`_ ``oracle+zxjdbc`` no no yes yes yes +**Postgresql** :ref:`(docs) ` +pg8000_ ``postgresql+pg8000`` yes yes no yes yes +`PostgreSQL JDBC Driver`_ ``postgresql+zxjdbc`` no no yes yes yes +psycopg2_ ``postgresql+psycopg2``\* yes yes no yes yes +pypostgresql_ ``postgresql+pypostgresql`` no yes no yes yes +**SQLite** :ref:`(docs) ` +pysqlite_ ``sqlite+pysqlite``\* yes yes no yes yes +sqlite3_ ``sqlite+pysqlite``\* yes yes no yes yes +**Sybase ASE** :ref:`(docs) ` +mxodbc_ ``sybase+mxodbc`` development development no yes yes +pyodbc_ ``sybase+pyodbc``\* partial development no unknown unknown +python-sybase_ ``sybase+pysybase`` yes [1]_ development no yes yes +=============================================================== =========================== =========== =========== =========== ================= ============ .. [1] The Sybase dialect currently lacks the ability to reflect tables. .. _psycopg2: http://www.initd.org/ @@ -114,6 +115,7 @@ python-sybase_ ``sybase+pysybase`` yes [1]_ development .. _MySQL Connector/Python: https://launchpad.net/myconnpy .. _OurSQL: http://packages.python.org/oursql/ .. _pymysql: http://code.google.com/p/pymysql/ +.. _rdbms: https://developers.google.com/cloud-sql/docs/developers_guide_python .. _PostgreSQL JDBC Driver: http://jdbc.postgresql.org/ .. _sqlite3: http://docs.python.org/library/sqlite3.html .. _pysqlite: http://pypi.python.org/pypi/pysqlite/ diff --git a/doc/build/dialects/access.rst b/doc/build/dialects/access.rst index 52a2ee3710..161ec1ffde 100644 --- a/doc/build/dialects/access.rst +++ b/doc/build/dialects/access.rst @@ -1,3 +1,5 @@ +.. _access_toplevel: + Microsoft Access ================ diff --git a/doc/build/dialects/drizzle.rst b/doc/build/dialects/drizzle.rst index ab1b703da3..114c6f9c94 100644 --- a/doc/build/dialects/drizzle.rst +++ b/doc/build/dialects/drizzle.rst @@ -1,3 +1,5 @@ +.. _drizzle_toplevel: + Drizzle ======= diff --git a/doc/build/dialects/firebird.rst b/doc/build/dialects/firebird.rst index dd6b6d0baf..000a8355e6 100644 --- a/doc/build/dialects/firebird.rst +++ b/doc/build/dialects/firebird.rst @@ -1,3 +1,5 @@ +.. _firebird_toplevel: + Firebird ======== diff --git a/doc/build/dialects/informix.rst b/doc/build/dialects/informix.rst index 617b8cd9dd..12eaa04381 100644 --- a/doc/build/dialects/informix.rst +++ b/doc/build/dialects/informix.rst @@ -1,3 +1,5 @@ +.. _informix_toplevel: + Informix ======== diff --git a/doc/build/dialects/maxdb.rst b/doc/build/dialects/maxdb.rst index 3edd55a775..c4f8a802c4 100644 --- a/doc/build/dialects/maxdb.rst +++ b/doc/build/dialects/maxdb.rst @@ -1,3 +1,5 @@ +.. _maxdb_toplevel: + MaxDB ===== diff --git a/doc/build/dialects/mysql.rst b/doc/build/dialects/mysql.rst index 2439d8aa2e..916df525eb 100644 --- a/doc/build/dialects/mysql.rst +++ b/doc/build/dialects/mysql.rst @@ -176,6 +176,11 @@ MySQL-Connector Notes .. automodule:: sqlalchemy.dialects.mysql.mysqlconnector +Google App Engine Notes +----------------------- + +.. automodule:: sqlalchemy.dialects.mysql.gaerdbms + pyodbc Notes -------------- diff --git a/doc/build/dialects/sybase.rst b/doc/build/dialects/sybase.rst index 724656a304..8200f223dc 100644 --- a/doc/build/dialects/sybase.rst +++ b/doc/build/dialects/sybase.rst @@ -1,3 +1,5 @@ +.. _sybase_toplevel: + Sybase ====== diff --git a/lib/sqlalchemy/dialects/access/base.py b/lib/sqlalchemy/dialects/access/base.py index 7c62dcc34d..29f10c5608 100644 --- a/lib/sqlalchemy/dialects/access/base.py +++ b/lib/sqlalchemy/dialects/access/base.py @@ -9,9 +9,10 @@ """ Support for the Microsoft Access database. -This dialect is *not* ported to SQLAlchemy 0.6 or 0.7. +.. note:: -This dialect is *not* tested on SQLAlchemy 0.6 or 0.7. + The Access dialect is **non-functional as of SQLAlchemy 0.6**, + pending development efforts to bring it up-to-date. """ diff --git a/lib/sqlalchemy/dialects/informix/base.py b/lib/sqlalchemy/dialects/informix/base.py index 7880d1c14a..6f96246efc 100644 --- a/lib/sqlalchemy/dialects/informix/base.py +++ b/lib/sqlalchemy/dialects/informix/base.py @@ -7,8 +7,11 @@ """Support for the Informix database. -This dialect is mostly functional as of SQLAlchemy 0.6.5. +.. note:: + The Informix dialect functions on current SQLAlchemy versions + but is not regularly tested, and may have many issues and + caveats not currently handled. """ diff --git a/lib/sqlalchemy/dialects/maxdb/base.py b/lib/sqlalchemy/dialects/maxdb/base.py index ce3aaaa1e7..cde839db9b 100644 --- a/lib/sqlalchemy/dialects/maxdb/base.py +++ b/lib/sqlalchemy/dialects/maxdb/base.py @@ -6,9 +6,10 @@ """Support for the MaxDB database. -This dialect is *not* ported to SQLAlchemy 0.6 or 0.7. +.. note:: -This dialect is *not* tested on SQLAlchemy 0.6 or 0.7. + The MaxDB dialect is **non-functional as of SQLAlchemy 0.6**, + pending development efforts to bring it up-to-date. Overview -------- diff --git a/lib/sqlalchemy/dialects/sybase/base.py b/lib/sqlalchemy/dialects/sybase/base.py index 4b8cc08bed..affef974cc 100644 --- a/lib/sqlalchemy/dialects/sybase/base.py +++ b/lib/sqlalchemy/dialects/sybase/base.py @@ -10,8 +10,12 @@ """Support for Sybase Adaptive Server Enterprise (ASE). -Note that this dialect is no longer specific to Sybase iAnywhere. -ASE is the primary support platform. +.. note:: + + The Sybase dialect functions on current SQLAlchemy versions + but is not regularly tested, and may have many issues and + caveats not currently handled. In particular, the table + and database reflection features are not implemented. """