1 new changeset in pytest:

http://bitbucket.org/hpk42/pytest/changeset/d7b5a083b1b4/
changeset:   d7b5a083b1b4
user:        hpk42
date:        2011-06-15 07:50:34
summary:     fix getting-started which claimed you need to avoid side effect in 
asserts
affected #:  2 files (502 bytes)

--- a/doc/assert.txt    Mon Jun 13 08:50:50 2011 -0500
+++ b/doc/assert.txt    Wed Jun 15 07:50:34 2011 +0200
@@ -129,9 +129,12 @@
 
 
 .. _assert-details:
+.. _`assert introspection`:
 
-Assertion introspection details
--------------------------------
+Advanced assertion introspection
+----------------------------------
+
+.. versionadded:: 2.1
 
 Reporting details about the failing assertion is achieved either by rewriting
 assert statements before they are run or re-evaluating the assert expression 
and


--- a/doc/getting-started.txt   Mon Jun 13 08:50:50 2011 -0500
+++ b/doc/getting-started.txt   Wed Jun 15 07:50:34 2011 +0200
@@ -61,20 +61,10 @@
 
 .. note::
 
-    You can simply use the ``assert`` statement for asserting
-    expectations because intermediate values will be presented to you.
-    This is arguably easier than learning all the `the JUnit legacy
-    methods`_.
-
-    However, there remains one caveat to using simple asserts: your
-    assertion expression should better be side-effect free.  Because
-    after an assertion failed py.test will re-evaluate the expression
-    in order to present intermediate values. You will get a nice warning
-    and you can easily fix it: compute the value ahead of the assert and
-    then do the assertion.  Or maybe just use the assert "explicit message"
-    syntax::
-
-       assert expr, "message" # show "message" if expr is not True
+    You can simply use the ``assert`` statement for asserting test
+    expectations.  pytest's :ref:`assert introspection` will intelligently
+    report intermediate values of the assert expression freeing
+    you from the need to learn the many names of `JUnit legacy methods`_.
 
 .. _`the JUnit legacy methods`: 
http://docs.python.org/library/unittest.html#test-cases

Repository URL: https://bitbucket.org/hpk42/pytest/

--

This is a commit notification from bitbucket.org. You are receiving
this because you have the service enabled, addressing the recipient of
this email.
_______________________________________________
py-svn mailing list
py-svn@codespeak.net
http://codespeak.net/mailman/listinfo/py-svn

Reply via email to