Commit Graph

11122 Commits

Author SHA1 Message Date
Mike Bayer befe7ffcb8 use ..deprecated directive w/ version in all cases
These changes should be ported from 1.3 back to 1.0 or
possibly 0.9 to the extent they are relevant in each
version. In 1.3 we hope to turn all deprecation documentation
into warnings.

(cherry picked from commit 77e9534673d58f2f4c33d16c0ed4e8671cea48b6)
(cherry picked from commit dcfe5a3f8929a11fd8d89b3b34449e1894bb2a3b)

Change-Id: I205186cde161af9389af513a425c62ce90dd54d8
2019-01-12 18:14:21 -05:00
Charles S. Givre 6c6b63b26e Update index.rst - Added link to Drill dialect.
Added link to Apache Drill dialect.

(cherry picked from commit 86f243a874)
2019-01-09 10:33:03 -05:00
Lele Gaifax 74838dda2f commit 1b774808c926665047bf353222ecd191679a95d1
Author: Lele Gaifax <lele@metapensiero.it>
Date:   Tue Dec 25 12:35:41 2018 +0100

    Consistently use "PostgreSQL", fixing also a few doc glitches

commit 0e382aaee4427193926f0dc10ad29056bc12c85e
Author: Lele Gaifax <lele@metapensiero.it>
Date:   Tue Dec 25 12:08:49 2018 +0100

    Remove duplicated words

Change-Id: Iaa586b9412f46a50fe6ff3bbb92e07d6cb1905c8
(cherry picked from commit c0f9708fde)
(cherry picked from commit 7ec092063a)
2018-12-30 21:23:37 -05:00
Mike Bayer f60a24a4e8 Add missing disambiguation to non-primary mapper example
The mapping to B over a join defines an alternate primary key
based on all the primary key columns in the join unless we
re-define it explicitly.   Similarly, people expect that
``.id`` looks the same.  make sure these line up with the
old mapping.

Change-Id: I1ab064c57019e79c34293f6588d1e033f7083974
(cherry picked from commit 16f08cbed5)
2018-12-28 09:36:37 -05:00
Mike Bayer e9564a44e4 - remove non-working dialects some of which are 404's
- put the five major dialect names on the front page
- remove old change messages

Change-Id: Ibf1dc2c499f10f98efb6c97d6c53e442e7746200
(cherry picked from commit eae62d0004)
2018-12-24 00:10:27 -05:00
Mike Bayer c3be61261b Rewrite the convert_unicode docs and add tons of dragons
These flags will all be going away as Python 3 has solved
all of this.

Change-Id: I4f581d8dd7826dd823b671d0d8e72250284236c8
(cherry picked from commit 7f12f63c3a)
2018-12-21 12:14:09 -05:00
Mike Bayer b7ad656e06 Document and support nested composites
Composites can behave in a "nested" fashion by defining the
class in that way.   To make the constructor more convenient,
a callable can be passed to :func:`.composite` instead of the
class itself.  This works now, so add a test to ensure this
pattern remains available.

Change-Id: Ia009f274fca7269f41d6d824e0f70b6fb0ada081
(cherry picked from commit d4a130bb1b)
2018-12-12 12:56:57 -05:00
Mike Bayer 5f7814707d Add versioned_update_old_row example
A modification to the "turn UPDATE into INSERT" recipe that
also UPDATEs the previous row.  The example is using timestamps
to maintain a relationship between two objects.

Change-Id: Ifdb8ee73616190384263bbe88c71d9278d616f6b
(cherry picked from commit 5851bf1138)
2018-12-07 14:02:37 -05:00
Mike Bayer 7907c17858 - fix formatting on examples to list the description first, some flake8
Change-Id: I57144a559f20abab02e745d052be5ff84edec7f8
(cherry picked from commit c89729cf67)
2018-12-07 12:18:28 -05:00
adriennefranke f54d61d68a Fixed typo in docs
Fixes: #4166
Fixes: #4399
Change-Id: I49494209463089114e77dfc737c811837d49ea20
(cherry picked from commit 09856b911b)
2018-12-05 20:32:21 -05:00
Mike Bayer c3272a32c9 All sphinx dependencies move under the github sqlalchemy organization
Change-Id: I7a0dc1ef320b6abad0eeac8b24c20f821e5b8c81
(cherry picked from commit 89f95e9bad)
2018-12-03 17:03:07 -05:00
Raphael 84d0cae53a typo
typo

(cherry picked from commit 0a0b36686d)
2018-11-30 10:10:20 -05:00
Mike Bayer fcb4c96cd8 Move links etc. to github, new alembic links
Change-Id: I59392d355a216ae59552a04c5508f548b901aa7b
(cherry picked from commit 50417cf758)
(cherry picked from commit d04575c554)
2018-11-26 23:01:26 -05:00
Mike Bayer 161747fbe6 - remove @HEAD indicator from docs requirements, fixes #4375
Change-Id: I50b1622c2c2236bf9e436f61c7eea31faaeaa3e1
(cherry picked from commit b5cb68ac43)
2018-11-26 00:17:44 -05:00
Mike Bayer 4c75dead12 Improve documentation re: Session.binds and partitioning strategies
Update documentation to include background on arbitrary superclass
usage, add full cross-linking between all related methods and parameters.
De-emphasize "twophase" and document that it is not well-supported
in drivers.

Change-Id: Id99894bb62cc506e896c9aa7c256e9f6e602243e
(cherry picked from commit 1f13c8c833)
2018-11-06 15:14:51 -05:00
Mike Bayer 92c20be2c2 Don't call rollback on DBAPI connection that's "closed"
Use the existence of ConnectionRecord.connection to estimate
that this connection is likely closed, and if so, don't
try to call "rollback" on it.  This rollback is normally harmless
but is causing segfaults in mysqlclient due to
https://github.com/PyMySQL/mysqlclient-python/issues/270.

Change-Id: I1d7c5f5a520527d8268b6334795c2051f7ceeea6
(cherry picked from commit a8781b51b4)
2018-10-14 19:17:40 -04:00
Mike Bayer ed735af55d - get the "now" date for this test in terms of the database to accommodate
for local timezone doesn't match that of the DB

Change-Id: I0899d9294e8a2bd8f7f2c3e66cf396e2e8bd4bcc
(cherry picked from commit 7405392299)
2018-10-12 23:02:45 -04:00
Mike Bayer f614a57e10 Add additional documentation for ORM fetched defaults
Add additional examples to the section first added as part
of #4317 to cover the use cases requested in #3921.

Fixes: #3921
Change-Id: I6ec283aa0a6fbabedef40bb4320751ab4cd990ea
(cherry picked from commit ffd27cef48)
2018-10-02 13:55:24 -04:00
Mike Bayer 3b60f3398e Add link to Code of Conduct
Change-Id: Ib07db7c2fc97739a172e541a0681176a67f89a2f
(cherry picked from commit 29d54ab69b)
2018-09-29 19:13:06 -04:00
Denis Kataev 5ce6c785ef Remove unnecessary unicode and raw string prefix
(cherry picked from commit fc5dbc3016)
2018-09-28 10:22:33 -04:00
Mike Bayer 0615c1ba48 Add non-primary mapper example illustrating a row-limited relationship
Change-Id: Ifcb3baa6b220e375dc029794dd10c111660eac94
(cherry picked from commit 888d122dcf)
2018-09-27 21:28:27 -04:00
Wouter Overmeire c630c42ffd Fix doc type
(cherry picked from commit 82006fcc93)
2018-09-17 09:21:03 -04:00
Glyph 2a2de61f02 minor spelling correction
(cherry picked from commit 35a458c782)
2018-09-07 17:34:00 -04:00
Mike Bayer 2734fa55c8 Clarify init_scalar event use case
Since I didn't even realize what this was for when reading the docs,
make it clearer that this is to mirror a Column default and remove
the extra verbiage about the mechanics of INSERTs.

Change-Id: Id2c6a29800f7b723573610e4707aec7e6ea38f5f
(cherry picked from commit 71b01adc7b)
2018-09-06 10:45:02 -04:00
Mike Bayer 1351fa1386 MariaDB 10.3 updates
MariaDB seems to handle some additional UPDATE/DELETE FROM
syntaxes as well as some forms of INTERSECT and EXCEPT. Open
up tests that expect failure for MySQL to allow success for
MariaDB 10.3.

Change-Id: Ia9341a82485ef7201bb8130d8dbf4a9b6976035a
(cherry picked from commit 081d4275cf)
2018-08-30 17:13:58 -04:00
Mike Bayer 2e0f06df91 Fix links and update verbiage for reset_on_return
Change-Id: I642056b78570b44fdefe7f0874a8e4c720389f14
(cherry picked from commit d8bb208a85)
2018-08-28 14:59:00 -04:00
Mike Bayer a40ef14325 Document binary_prefix for mysqlclient and PyMySQL
Also, remove the section on "use_unicode=0", there is no reason
anyone should be using that now.

Fixes: #4216
Change-Id: I5b8b53e40903adf339af2934a4f2d8b068818ebf
(cherry picked from commit c3869f2383)
2018-08-17 19:33:59 -04:00
Mike Bayer 36fbc9a0c7 Correct for the INSERT statement, typos
Change-Id: I036f3eb9b5e591515920678bc9a76f707fda142c
(cherry picked from commit c85378d984)
2018-08-09 14:36:28 -04:00
Mike Bayer 7f6b272507 Write a much better section about server defaults
Include information about eager_defaults etc.  These
docs were written before we had all the features
we do now.

Change-Id: Ie62e58c5986698824f717e9f8c802b07a27517d4
Fixes: #4317
(cherry picked from commit 82dfcf43de)
2018-08-09 13:35:24 -04:00
Kevin Horn fb049d4d24 Replace 'with' with 'which'
(cherry picked from commit 8601e86f11)
2018-07-31 22:06:43 -04:00
Mike Bayer 4cf0a327c1 Document sticky behavior of loader options
References #4301

Change-Id: If921e3b8369e2cd5312b5964a99bcf7731b3ecfc
(cherry picked from commit 3cc832992d)
2018-07-10 13:32:06 -04:00
Mike Bayer 36369f0b74 - add some context to the declarative section indicating this is not
the introductory material for these topics

Change-Id: I358ba8c32520ce3950a727216bc019e33377e7b9
(cherry picked from commit 284009683d)
2018-07-05 00:06:15 -04:00
Mike Bayer b539d24c16 - fix linking for the query.rst page
Change-Id: I269fdd72e372e1bf4f0f85e9fc8e6938adc4f686
(cherry picked from commit b6fb6f6b60)
2018-07-04 17:49:59 -04:00
Logan Rosen 064fb78103 Update URL for PyMySQL documentation
(cherry picked from commit b694a309e8)
2018-06-28 16:13:00 -04:00
Andrew Gaul af14ea4a07 Remove stale ON UPDATE/ON DELETE comment.
SQLite supports both of these features.

(cherry picked from commit 6bb50e1293)
2018-06-19 22:39:39 -04:00
Mike Bayer e8650d0cfa update client-side/server-side SQL default expression documentation
These docs were inaccurate and verbose, try to modernize them
with up to date information and add cues to allow the reader
to understand them quickly.

Change-Id: I997d9b8963d90c73f5960fe29d8f1b5005299da7
(cherry picked from commit da5323c2fa)
2018-06-13 12:02:31 -04:00
Mike Bayer 122ca52632 - add a tl;dr to postgresql search_path section as it's long
and will be easier to read if we know where it's going first.

Change-Id: I2766cf4655451ed514d4dc95ac60406b9f4a8ddb
(cherry picked from commit 513a6e5bce)
2018-05-06 09:02:56 -04:00
Mike Bayer 49a8e464b6 - modernize versioning examples
- add new example versioned_rows_w_versionid

Change-Id: I592cd5eb7db50162b4c4ad6191813d9def2b6d7c
(cherry picked from commit 70f8f6a169)
2018-05-05 18:21:31 -04:00
Mike Bayer 835118b3e2 - add sap-hana
Change-Id: Id3ddd78fceb31df40c5f00f8b21320b0da8488af
(cherry picked from commit 21b6ec97318e87ab1bf36acf469eb9deb9823e0e)
2018-05-03 09:59:57 -04:00
Mike Bayer 9007b6052f Fix bindparam type param fixes #4220
Change-Id: I0f40bc3145d4cab1a12d2174b9f0f60b4ce736f5
(cherry picked from commit 55371f4cff)
2018-04-01 10:34:07 -04:00
Mike Bayer 0cc1206ea0 Link to the ExpireRelationshipOnFKChange recipe for deletes
The recipe now supports interception of delete() and a
corresponding update of related objects.

Change-Id: I2aa3bfdd477ceccff6cfb3e66ed73311705010c7
2018-03-26 18:11:36 -04:00
Mike Bayer 4022e41d88 Make it much more clear that concrete mapping is limited
Change-Id: Icb2ea787b0defbf5f1244b144759c1e8acff3f0f
(cherry picked from commit ea20a11817)
2018-03-07 18:05:48 -05:00
Mike Bayer 2ae99b671c Add notes regarding flat=True
Start documenting that flat=True and aliased=True don't work
with selectable particularly when selectable is an aliased select
already.  References #4212

Change-Id: I6e576165f06387350ae97e43ad979e575a4912b9
(cherry picked from commit 39d7dfa08a)
2018-03-07 16:03:58 -05:00
Mike Bayer e2aea6e3e2 Version 1.1.19 placeholder 2018-03-06 14:10:39 -05:00
Mike Bayer fb8e01a7df - 1.1.18 rel_1_1_18 2018-03-06 14:04:26 -05:00
Mike Bayer cc6ec001b2 Only replace first occurrence for COLLATE/ARRAY syntax
Fixed bug in Postgresql COLLATE / ARRAY adjustment first introduced
in 🎫`4006` where new behaviors in Python 3.7 regular expressions
caused the fix to fail.

Change-Id: Ied3893d7cac210befa0277b55b3b895b0ba1f0d2
Fixes: #4208
(cherry picked from commit 7300469f71)
2018-03-05 15:53:06 -05:00
Mike Bayer 8064be5b00 Get MySQL version info from @@version
MySQL dialects now query the server version using ``SELECT @@version``
explicitly to the server to ensure we are getting the correct version
information back.   Proxy servers like MaxScale interfere with the value
that is passed to the DBAPI's connection.server_version value so this
is no longer reliable.

Change-Id: Iafd39be8c9bf1982d58b34cc997ae1016ad6c48c
Fixes: #4205
(cherry picked from commit 9ba77e8d3b682bff89fdab5e80271a96a52fe8c8)
(cherry picked from commit 5c1ebbc370)
2018-03-03 16:16:32 -05:00
Mike Bayer 1127fe7407 - add some seealsos for the transient object that loads use case
Change-Id: Ibfa79a3721f31806223906cccf4547673b3d42f1
(cherry picked from commit 5de2e17b6e)
2018-03-02 11:59:15 -05:00
Mike Bayer 6e2bb7686e Fix enable_relationship_loading() works fine w/ one-to-many
Change-Id: I6efb62afa02be4d42482cfdbec739a5c6ab32bd7
(cherry picked from commit fde2f77fd1978d4162ab01bc05bb5c793bc733b2)
2018-03-02 10:46:18 -05:00
Anton Vlasenko 6d975ec9ff Fix typo in python example
(cherry picked from commit 31d28179c2)
2018-02-27 14:46:47 -05:00