deprecate pytest_namespace alltogether

[RonnyPfannschmidt]

with the merge of #2636 pytest itself no longer needs the pytest_namespace hook

the need for preinit is gone as well
so to follow up we should remind people that the hook is deprecated

• print deprecation warnings when hook definitions are found
• changelog
• notes about there not being a replacement
• deprecation roadmap entry

[nicoddemus]

What we need to do, from the top of my head:

1. In pytest, if pytest_namespace returns something other than [] issue the deprecation warning, including the dictionary keys to help users figure out which plugin is using pytest_namespace.
2. Include a note in the CHANGELOG, pointing out to the documentation;
3. Add a .. note: to the docs about the deprecation and when we plan to remove it; also make sure to provide an example about what to replace pytest_namespace with;
4. Add an entry to the Deprecation Roadmap.

[olymk2]

just curious, what the alternative to pytest_namespace ?

I am currently using this, so my functions are registered under pytest.myfunc, the only reference i could find to it being deprecated was in the test code, but nothing about what i should be using in its place ?

[RonnyPfannschmidt]

@olymk2 there will not be a replacement use own modules ^^

[olymk2]

not sure what you mean, currently i have my own plugin which I register a few methods in.

these are registered inside pytest_namespace as local functions and returned in the dictonary.

so are you saying i need to import every plugin I want to use now, and they dont auto register under pytest namespace ?

[RonnyPfannschmidt]

no plugin "auto-registers" under pytest - its just that pytest-namespace will no longer be called

it was never implemented correctly and prevents correcting horrendous bug in config initialization

[olymk2]

how does it auto register then.

if i take my function out of the namespace its not picked up, so there must be some other method of registering the function to pytest does it need a specific prefix in the function name perhaps ?

[RonnyPfannschmidt]

@olymk2 you will have to import from your plugin then instead of using pytest

[olymk2]

ah I see, I may leave that for another day then as that will break any software using this plugin, as you will need to add the import to any project using it.

Also not sure how that works when you use pytest command line to configure the plugin is that likely to still work if its a seperate plugin ?

[RonnyPfannschmidt]

@olymk2 there will be a major aka breaking pytest release to remove the feature
so right now you dont have to fear for your users, and you can prepare for the removal slowly as it will be a long time before the removal is finalized

first we will deprecate it, start to warn about it and work with the authors of public plugins to remove its uses gracefully

[olymk2]

okay thanks, feels like it would be nice to have another way like a hook to keep things under the same namespace.

@pytest_register_method
def myequals()
    return True

import pytest
assert pytest.myequals() is True

for example.

[nicoddemus]

I thought a possible workaround would be to import pytest and manually set your objects as attributes:

def pytest_configure():
    import pytest
    pytest.myequals = myequals

For setuptools-based plugins this should work for most cases, depending on how myequals is meant to be used.

[RonnyPfannschmidt]

@olymk2 one of the main idea is to stop things that are not part of pytest dump random code into its namespace

the other part is, its inherently incompatible with nested test runs and has no sane cleanup

its pretty much a broken way to do things

[olymk2]

okay, good to know @RonnyPfannschmidt I may start down that route then, or fall back to @nicoddemus suggestion if it takes to long I was actually considering some thing like that myself as a workaround.

but I will aim for separating it out into its own import.