[py-dev] RFC for (hopefully) final commments on pytest-2.3 API

[Floris Bruynooghe]

Hi

Only providing feedback on the naming issues so far.  After some usage
of this API I have changed my mind slightly on these.

On 18 September 2012 14:14, holger krekel <holger at merlinux.eu> wrote:
> - rename @pytest.setup to @pytest.fixture

+1

> - rename @pytest.factory to @pytest.funcarg

I would rather like to keep @pytest.factory.  While writing plugin
code I find it much clearer thinking about a resource rather then a
funcarg.  And @factory is short for "resource factory" so that works.
I think consistently using the name resource in the documentation and
only mention pytest_funcarg__foo as a legacy aproach will be clearer.
I think it is also clearer to explain a resource and a fixture next to
each other, while for a funcarg the explanation would become longer.

Lastly I'd probably vote for "testcontext" as name for the funcarg
currently provided by "request".  This is a bit more annoying to type
but less likely to conflict with user provided resources.


Thanks for all the work this, and for putting up with all my requests
and questions.

Floris