summaryrefslogtreecommitdiff
path: root/doc/build/orm/tutorial.rst
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2016-01-14 18:20:00 -0500
committerMike Bayer <mike_mp@zzzcomputing.com>2016-01-14 18:20:00 -0500
commit7bb578b1bd61ec9a2506d1bdb60bb28579204808 (patch)
tree3c96880e62a29af788d9f9424e77619a7bc07d8b /doc/build/orm/tutorial.rst
parent1f7a1f777d8fe1bdea1e793c8ec8ebb7c625e347 (diff)
downloadsqlalchemy-7bb578b1bd61ec9a2506d1bdb60bb28579204808.tar.gz
- illustrate these using the newer exception doctest format.
unfortunately we can't show the SQL unless we filtered it out from doctest...not worth it
Diffstat (limited to 'doc/build/orm/tutorial.rst')
-rw-r--r--doc/build/orm/tutorial.rst34
1 files changed, 8 insertions, 26 deletions
diff --git a/doc/build/orm/tutorial.rst b/doc/build/orm/tutorial.rst
index 6e98dfc9c..4349f75f2 100644
--- a/doc/build/orm/tutorial.rst
+++ b/doc/build/orm/tutorial.rst
@@ -861,37 +861,19 @@ database results. Here's a brief tour:
.. sourcecode:: python+sql
- {sql}>>> from sqlalchemy.orm.exc import MultipleResultsFound
- >>> try:
- ... user = query.one()
- ... except MultipleResultsFound as e:
- ... print(e)
- SELECT users.id AS users_id,
- users.name AS users_name,
- users.fullname AS users_fullname,
- users.password AS users_password
- FROM users
- WHERE users.name LIKE ? ORDER BY users.id
- ('%ed',)
- {stop}Multiple rows were found for one()
+ >>> user = query.one()
+ Traceback (most recent call last):
+ ...
+ MultipleResultsFound: Multiple rows were found for one()
With no rows found:
.. sourcecode:: python+sql
- {sql}>>> from sqlalchemy.orm.exc import NoResultFound
- >>> try:
- ... user = query.filter(User.id == 99).one()
- ... except NoResultFound as e:
- ... print(e)
- SELECT users.id AS users_id,
- users.name AS users_name,
- users.fullname AS users_fullname,
- users.password AS users_password
- FROM users
- WHERE users.name LIKE ? AND users.id = ? ORDER BY users.id
- ('%ed', 99)
- {stop}No row was found for one()
+ >>> user = query.filter(User.id == 99).one()
+ Traceback (most recent call last):
+ ...
+ NoResultFound: No row was found for one()
The :meth:`~.Query.one` method is great for systems that expect to handle
"no items found" versus "multiple items found" differently; such as a RESTful