test_ok1/ISSUES.txt

checks / deprecations for next release
---------------------------------------------------------------
tags: bug 1.4 core xdist

* reportinfo -> location in hooks and items
* check oejskit plugin compatibility
* terminal reporting - dot-printing
* some simple profiling 
* move pytest_nose out of pylib because it implicitely extends
  the protocol now - setup/teardown is called at module level.
  consider making calling of setup/teardown configurable

refine session initialization / fix custom collect crash
---------------------------------------------------------------
tags: bug 1.4 core xdist

When calling "py.test path/X" py.test can crash if the collection
of that directory is skipped.  Calling "py.test path" will give
proper output.  The reason is that for the very first colitems
getinitialnodes() and a collection is done before the fully
controlled session and pytest_make_collect_report protocol takes over.
Try to remove the redundant getinitialnodes related logic and amend
the session collect logic to care for this "initial" case as well.
Apart from simplification a side effect the dsession's session
and the core session probably converge some more.

do early-teardown of test modules
-----------------------------------------
tags: feature 1.3

currently teardowns are called when the next tests is setup
except for the function/method level where interally
"teardown_exact" tears down immediately.  Generalize
this to perform the "neccessary" teardown compared to
the "next" test item during teardown - this should
get rid of some irritations because otherwise e.g.
prints of teardown-code appear in the setup of the next test.

consider and document __init__ file usage in test directories
---------------------------------------------------------------
tags: bug 1.4 core

Currently, a test module is imported with its fully qualified
package path, determined by checking __init__ files upwards.
This has the side effect that a source package at the root
of the test dir could be imported as well.  This is somewhat
convenient but complicates the picture for running tests against
different versions of a package.  Also, implicit sys.path
manipulations are problematic per-se.  Maybe factorting out
a pytest_addsyspath hook which can be disabled from the command line
makes sense.  In any case documentation/recommendations for
certain scenarios makes sense.

relax requirement to have tests/testing contain an __init__
----------------------------------------------------------------
tags: feature 1.4
bb: http://bitbucket.org/hpk42/py-trunk/issue/64

A local test run of a "tests" directory may work
but a remote one fail because the tests directory
does not contain an "__init__.py". Either give
an error or make it work without the __init__.py
i.e. port the nose-logic of unloading a test module.

customize test function collection
-------------------------------------------------------
tags: feature 1.4

- introduce py.test.mark.nocollect for not considering a function for
  test collection at all.  maybe also introduce a py.test.mark.test to
  explicitely mark a function to become a tested one.  Lookup JUnit ways
  of tagging tests.

- allow an easy way to customize "test_", "Test" prefixes for file paths
  and test function/class names. the current customizable Item requires
  too much code/concepts to influence this collection matching.
  maybe introduce pytest_pycollect_filters = {
    'file': 'test*.py',
    'function': 'test*',
    'class': 'Test*',
  }

introduce py.test.mark.platform
-------------------------------------------------------
tags: feature 1.4

Introduce nice-to-spell platform-skipping, examples:

    @py.test.mark.platform("python3")
    @py.test.mark.platform("not python3")
    @py.test.mark.platform("win32 and not python3")
    @py.test.mark.platform("darwin")
    @py.test.mark.platform("not (jython and win32)")
    @py.test.mark.platform("not (jython and win32)", xfail=True)

etc. Idea is to allow Python expressions which can operate
on common spellings for operating systems and python
interpreter versions.

introduce py.test.mark registration
-----------------------------------------
tags: feature 1.4

introduce a hook that allows to register a named mark decorator
with documentation and add "py.test --marks" to get
a list of available marks.  Deprecate "dynamic" mark
definitions.

allow to non-intrusively apply skipfs/xfail/marks
---------------------------------------------------
tags: feature 1.4

use case: mark a module or directory structures
to be skipped on certain platforms (i.e. no import
attempt will be made).

consider introducing a hook/mechanism that allows to apply marks
from conftests or plugins.

explicit referencing of conftest.py files
-----------------------------------------
tags: feature 1.4

allow to name conftest.py files (in sub directories) that should
be imported early, as to include command line options.

a central py.test ini/yml file
----------------------------------
tags: feature 1.4

introduce a declarative configuration file that allows:
- default options
- to-be-collected test directories
- required plugins
- test func/class/file matching patterns
- skip/xfail (non-intrusive)
- pytest.ini and tox.ini and setup.cfg configuration in the same file

new documentation
----------------------------------
tags: feature 1.4

- logo py.test
- reference / customization
- writing a (local or global) plugin
- examples for unittest or functional testing
- resource management for functional testing
- patterns: page object
- parametrized testing
- better / more integrated plugin docs
  i.e. not per-plugin but per-feature referencing a plugin

generalize parametrized testing to generate combinations
-------------------------------------------------------------
tags: feature 1.4

think about extending metafunc.addcall or add a new method to allow to
generate tests with combinations of all generated versions - what to do
about "id" and "param" in such combinations though?

introduce py.test.mark.multi
-----------------------------------------
tags: feature 1.3

introduce py.test.mark.multi to specify a number
of values for a given function argument.

have imported module mismatch honour relative paths
--------------------------------------------------------
tags: bug 1.4

With 1.1.1 py.test fails at least on windows if an import
is relative and compared against an absolute conftest.py
path. Normalize.

make node._checkcollectable more robust
-------------------------------------------------
tags: bug 1.4

currently node._checkcollectable() can raise
exceptions for all kinds of reasons ('conftest.py' loading
problems, missing rsync-dirs, platform-skip-at-import-level
issues, ...).  It should just return True/False and cause
a good error message.

call termination with small timeout
-------------------------------------------------
tags: feature 1.4
test: testing/pytest/dist/test_dsession.py - test_terminate_on_hanging_node

Call gateway group termination with a small timeout if available.
Should make dist-testing less likely to leave lost processes.

consider globals: py.test.ensuretemp and config
--------------------------------------------------------------
tags: experimental-wish 1.4

consider deprecating py.test.ensuretemp and py.test.config
to further reduce py.test globality.  Also consider
having py.test.config and ensuretemp coming from
a plugin rather than being there from the start.

consider allowing funcargs for setup methods
--------------------------------------------------------------
tags: experimental-wish 1.4

Users have expressed the wish to have funcargs available to setup
functions.  Experiment with allowing funcargs there - it might
also help to make the py.test.ensuretemp and config deprecation.
For filling funcargs for setup methods, we could call funcarg
factories with a request object that not have a cls/function
attributes.  However, how to handle parametrized test functions
and funcargs?

setup_function -> request can be like it is now
setup_class -> request has no request.function
setup_module -> request has no request.cls

consider pytest_addsyspath hook
-----------------------------------------
tags: 1.4

py.test could call a new pytest_addsyspath() in order to systematically
allow manipulation of sys.path and to inhibit it via --no-addsyspath
in order to more easily run against installed packages.

Alternatively it could also be done via the config object
and pytest_configure.


show plugin information in test header
----------------------------------------------------------------
tags: feature 1.4

Now that external plugins are becoming more numerous
it would be useful to have external plugins along with
their versions displayed as a header line.

deprecate global py.test.config usage
----------------------------------------------------------------
tags: feature 1.4

py.test.ensuretemp and py.test.config are probably the last
objects containing global state.  Often using them is not
neccessary.  This is about trying to get rid of them, i.e.
deprecating them and checking with PyPy's usages as well
as others.

remove deprecated bits in collect.py
-------------------------------------------------------------------
tags: feature 1.4

In an effort to further simplify code, review and remove deprecated bits
in collect.py.  Probably good:
- inline consider_file/dir methods, no need to have them
  subclass-overridable because of hooks