[py-svn] r24276 - py/dist/py/documentation/talk

[hpk at codespeak.net]

Author: hpk
Date: Mon Mar 13 03:33:04 2006
New Revision: 24276

Modified:
   py/dist/py/documentation/talk/pytest-overview.txt
Log:
even more slides - some refinements


Modified: py/dist/py/documentation/talk/pytest-overview.txt
==============================================================================
--- py/dist/py/documentation/talk/pytest-overview.txt	(original)
+++ py/dist/py/documentation/talk/pytest-overview.txt	Mon Mar 13 03:33:04 2006
@@ -23,14 +23,35 @@
 - simplest possible "assert" approach 
 - clean setup/teardown semantics
 - stdout/stderr capturing per test
-- adding command line options
+- per-project/directory cmdline options
 - test selection support 
-- automated cusotmizable collection of tests
-- `more features`_
+- customizable auto-collection of tests
+- many `more features`_ 
 
 .. _`more features`: ../test.html#features
 
-Implementation
+Main User-Level entry points 
+===============================
+
+- ``conftest.py`` can modify almost arbitrary testing aspects
+  (but it's a bit involved) 
+- ``py.test.raises(Exc, func, *args, **kwargs)``
+- ``py.test.deprecated_call(func, *args, **kwargs)`` 
+- ``py.test.fail(msg)`` -> fail a test
+- ``py.test.skip(msg)`` -> skip a test 
+- ``py.test.ensuretemp(prefix)`` -> per-test session temporary directory 
+
+helpful py lib features 
+===============================
+
+- py.execnet provides ad-hoc means to distribute programs 
+- lazy import of "py", ``import py`` is enough
+- py.path objects abstract local and svn files 
+- py.log offers (preliminary) logging support 
+- py.xml.html for programmatic html generation 
+
+
+py.test Implementation
 ===============================
 
 - `basic picture`_
@@ -42,6 +63,22 @@
 
 .. _`basic picture`: ../test.html#basicpicture
 
+Session objects 
+===============================
+
+- responsible for driving the testing process
+- make use of iterative Collector hierarchies 
+- responsible for reporting (XXX)
+- can be split to a Frontend and BackendSession 
+  for distributed testing (GUI frontend uses it) 
+
+Collector objects 
+===============================
+
+- ``run()`` returns list of (test) names or runs the test
+- ``join(name)`` returns a sub collector/item 
+- various helper methods to determine file/location
+
 Extensions: ReST checking
 =========================================