diff options
| author | jonathan vanasco <jonathan@2xlp.com> | 2021-08-23 16:25:21 -0400 |
|---|---|---|
| committer | jonathan vanasco <jonathan@2xlp.com> | 2021-08-23 16:25:21 -0400 |
| commit | 369edbbd674c2dcdc121072a20b3f9d259f9ee91 (patch) | |
| tree | 92c8f145ce641e8170a48e900c54e2eac22be42d /doc/build/tutorial/data_select.rst | |
| parent | 207ec35c2e175f5fcf68e886d5e61a0678c2d6fc (diff) | |
| download | sqlalchemy-369edbbd674c2dcdc121072a20b3f9d259f9ee91.tar.gz | |
standardizing docs #6821
(redo of 2999/I5609025feee8cfdecc09b55bfbf1bd13fa2e6602)
This PR is designed to bring more clarity within the docs by renaming object
instances that may be consfusingly similar to class, method, and attribute names.
For example, instances of the class `MetaData` are available on some objects as
`.metadata` property, and had appeared within the docs as both `meta` and
`metadata` which has confused some users in the past. By this PR, the docs now
utilize the following naming convention:
* MetaData - SQLAlchemy class
* .metadata - SQLAlchemy API attributes
* metadata_obj - developer instantiated metadata objects or references
Detailed Changes:
* standardized `meta` and `metadata` instances to `metadata_obj`. note: the docs were evenly split between 'meta' and 'metadata'.
* standardized 'cursor' to 'cursor_obj' to avoid confusion with the method.
* standardized a 'scalar_subquery = ' to 'scalar_subq' to avoid confusion with the method.
* standardized a 'cte = ' to 'cte_obj' to avoid confusion with the method
Change-Id: I79c98aee16c5fc6649289b2dd7d6dfc368222fb4
Diffstat (limited to 'doc/build/tutorial/data_select.rst')
| -rw-r--r-- | doc/build/tutorial/data_select.rst | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/doc/build/tutorial/data_select.rst b/doc/build/tutorial/data_select.rst index bcd533cc6..6ff47087c 100644 --- a/doc/build/tutorial/data_select.rst +++ b/doc/build/tutorial/data_select.rst @@ -903,8 +903,8 @@ Another example follows, which is exactly the same except it makes use of the .. sourcecode:: python+sql - >>> cte = select(Address).where(~Address.email_address.like('%@aol.com')).cte() - >>> address_cte = aliased(Address, cte) + >>> cte_obj = select(Address).where(~Address.email_address.like('%@aol.com')).cte() + >>> address_cte = aliased(Address, cte_obj) >>> stmt = select(User, address_cte).join_from(User, address_cte).order_by(User.id, address_cte.id) >>> with Session(engine) as session: ... for user, address in session.execute(stmt): |
