From 6de02a79764f02582ce42508143a927f1454aac7 Mon Sep 17 00:00:00 2001 From: holger krekel Date: Fri, 19 Jun 2009 12:19:59 +0200 Subject: [PATCH] snapshot 1.0.0b2 --HG-- branch : trunk --- CHANGELOG | 2 +- doc/announce/release-1.0.0.txt | 3 +-- doc/download.txt | 2 ++ doc/index.txt | 2 ++ doc/test/extend.txt | 16 +++++++++------- 5 files changed, 15 insertions(+), 10 deletions(-) diff --git a/CHANGELOG b/CHANGELOG index 44c47c4ed..7e5219c08 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -1,4 +1,4 @@ -$Id: CHANGELOG 65791 2009-06-16 16:23:18Z hpk $ +$Id: CHANGELOG 65819 2009-06-18 18:09:57Z hpk $ Changes between 1.0.0b1 and 1.0.0b2 ============================================= diff --git a/doc/announce/release-1.0.0.txt b/doc/announce/release-1.0.0.txt index 3b9380e5f..a63b8b312 100644 --- a/doc/announce/release-1.0.0.txt +++ b/doc/announce/release-1.0.0.txt @@ -6,8 +6,7 @@ XXX draft Welcome to the 1.0.0 py lib release - a python library aiming to support agile and test-driven development. -It passes tests against Linux, OSX and Win32, on Python -2.3, 2.4, 2.5 and 2.6. +It works with Linux, OSX and Win32, on Python 2.3, 2.4, 2.5 and 2.6. Main API/Tool Features: diff --git a/doc/download.txt b/doc/download.txt index 519bd6309..e17fa0b8f 100644 --- a/doc/download.txt +++ b/doc/download.txt @@ -2,6 +2,8 @@ Downloading ============== +Latest Release: 1.0.0b2 + "easy_install py" =================================================== diff --git a/doc/index.txt b/doc/index.txt index 1f566bfe2..9d4fee142 100644 --- a/doc/index.txt +++ b/doc/index.txt @@ -1,6 +1,8 @@ py lib: Main tools and APIs =================================== +Latest Release: 1.0.0b2 + `py.test`_ write and deploy unit- and functional tests to multiple machines. `py.execnet`_ rapidly deploy local or remote processes from your program. diff --git a/doc/test/extend.txt b/doc/test/extend.txt index 8e89dba1b..c7032469e 100644 --- a/doc/test/extend.txt +++ b/doc/test/extend.txt @@ -8,11 +8,11 @@ py.test implements much of its functionality by calling `well specified hooks`_. Python modules which contain such hook functions are called plugins. Hook functions are discovered in ``conftest.py`` files or in **named** plugins. ``conftest.py`` files are sometimes called "anonymous" -or "local" plugins if they contain hooks. They allow to write and distribute -some extensions along with the test suite or the application package easily. -Named plugins are python modules or packages that have an all lowercase -``pytest_`` prefixed name and who are imported during tool startup or -the testing process. +or conftest plugins. They are useful for keeping test extensions close +to the application package. Named plugins are normal python modules or packages +that can be distributed separately. Named plugins need to follow a naming pattern; +they have an all lowercase ``pytest_`` prefixed name. While conftest plugins are +discovered automatically, named plugins must be explicitely specified. .. _`tool startup`: .. _`test tool starts up`: @@ -61,7 +61,7 @@ conftest.py as anonymous per-project plugins -------------------------------------------------- The purpose of ``conftest.py`` files is to allow `project-specific -test configuration`_. But they also make for a good place to implement +test configuration`_. They thus make for a good place to implement project-specific test related features through hooks. For example you may set the `collect_ignore`_ variable depending on a command line option by defining the following hook in a ``conftest.py`` file: @@ -91,7 +91,9 @@ reporting process. Upon loading of a plugin py.test performs strict checking on contained hook functions. Function and argument names need to match exactly one of `hook definition specification`_. It thus provides useful error reporting on mistyped hook or argument names -and minimizes version incompatibilites. +and minimizes version incompatibilites. Below you find some introductory +information on particular hooks. It's sensible to look at existing +plugins so see example usages and start off with your own plugin. .. _`hook definition specification`: http://bitbucket.org/hpk42/py-trunk/src/tip/py/test/plugin/hookspec.py